How as-aigc/transcripthub works
TranscriptHub is an AI audio-transcription platform with a Go web frontend and a Node.js backend. The main workflow is user upload → task API and scheduling → WhisperX transcription → task-status/result retrieval and download. The backend also documents authentication, multiple audio and output formats, HTTPS, and clustered workers; logging and SQL persistence support these stages. The README describes the frontend/API/backend boundary, while several frontend and worker connections are not visible in the sampled source, so those edges are marked unverified.
Main entry points: main.js HTTPS API and workers · task_controller.js Task endpoints · task_service.js Task lifecycle · router.go Web server routes
Components 19
Go frontend
- Web interface
apps/frontend/www/template/index.tpl - Web server routes
apps/frontend/router.go - Audio upload
apps/frontend/upload.go - File handling
apps/frontend/writefile.go - Job and transcript views
apps/frontend/jobs.go
Backend API
- HTTPS API and workers
apps/backend/main.js - Request validation
apps/backend/middlewares/validate_params.js - Task endpoints
apps/backend/controller/task_controller.js - Access checks
apps/backend/controller/auth_controller.js
Task processing
- Task lifecycle
apps/backend/services/task_service.js - Media validation and duration
apps/backend/utils.js - WhisperX engine
apps/backend/scripts/exec_whisperx_task_v1.2.py - Transcription outputs
apps/backend/config.js - Completion notification
apps/backend/utils.js
Persistence and operations
- SQL task and access data
apps/backend/sql/task.sql - SQL query templates
apps/backend/query_constants.js - Database connections
apps/backend/db.js - Logging
apps/backend/logger.js
Other components
- User
Connections 22
- User → Web interface: uses
README.md - Web interface → Web server routes: interacts with
- Web server routes → Audio upload: routes upload
- Audio upload → File handling: stores audio
- Web server routes → HTTPS API and workers: calls API
README.md - HTTPS API and workers → Request validation: validates requests
apps/backend/main.js - HTTPS API and workers → Task endpoints: routes tasks
apps/backend/main.js - Task endpoints → Access checks: checks access
apps/backend/controller/task_controller.js - Task endpoints → Task lifecycle: manages tasks
apps/backend/controller/task_controller.js - Task endpoints → Media validation and duration: checks duration
apps/backend/controller/task_controller.js - Task lifecycle → Database connections: queries database
apps/backend/services/task_service.js - Access checks → Database connections: queries access
apps/backend/controller/auth_controller.js - Database connections → SQL query templates: uses queries
apps/backend/db.js - SQL query templates → SQL task and access data: reads and writes
apps/backend/query_constants.js - Task lifecycle → WhisperX engine: dispatches work
- WhisperX engine → Transcription outputs: produces outputs
- Task endpoints → Transcription outputs: serves downloads
apps/backend/controller/task_controller.js - HTTPS API and workers → Completion notification: sends updates
apps/backend/main.js - Completion notification → Web server routes: notifies frontend
README.md - Job and transcript views → HTTPS API and workers: requests status
README.md - HTTPS API and workers → Logging: records events
apps/backend/main.js - Task lifecycle → Logging: records task events
apps/backend/services/task_service.js