How somnath516/streambox works
StreamBox is a movie catalog and streaming application with an administrative upload and management workflow. Users browse movie records and request media; administrators authenticate to upload or edit titles, while the backend stores catalog metadata and serves video and related assets. The graph reflects the sampled routes and server wiring. Frontend-to-API behavior and some documented-by-structure features are not shown in excerpts, so those connections are marked unverified rather than asserted.
Main entry points: server.js Express server · upload.routes.js Upload routes · movies.routes.js Movie routes · db.service.js Movie catalog
Components 20
Client experience
- Web interface
frontend/index.js - Playback UI
frontend/player.html
HTTP application
- Express server
backend/server.js - Movie routes
backend/routes/movies.routes.js - Upload routes
backend/routes/upload.routes.js - Media routes
backend/routes/media.routes.js - Health routes
backend/routes/health.routes.js - Control routes
backend/routes/control.routes.js - Admin authentication
backend/middleware/auth.js
Catalog and media
- Movie catalog
backend/services/db.service.js - Upload handling
backend/services/upload.service.js - Upload sessions
backend/uploadSessionRegistry.js - Media streaming
backend/services/media.service.js - Subtitle validation
backend/utils/subtitle.js
Runtime support
- Runtime configuration
backend/services/config.service.js - Error responses
backend/middleware/errorContract.js - Application logging
backend/utils/logger.js - Async route wrapper
backend/utils/asyncHandler.js
Other components
- Viewer
- Administrator
Connections 31
- Viewer → Web interface: browses
- Administrator → Web interface: manages titles
- Web interface → Express server: calls API
- Playback UI → Media routes: requests media
- Express server → Runtime configuration: loads settings
backend/server.js - Express server → Movie catalog: initializes database
backend/server.js - Express server → Movie routes: mounts routes
backend/server.js - Express server → Upload routes: mounts routes
backend/server.js - Express server → Health routes: mounts routes
backend/server.js - Express server → Media routes: mounts routes
backend/server.js - Express server → Control routes: mounts routes
backend/server.js - Movie routes → Movie catalog: reads and updates
backend/routes/movies.routes.js - Movie routes → Admin authentication: protects mutations
backend/routes/movies.routes.js - Movie routes → Async route wrapper: wraps handlers
backend/routes/movies.routes.js - Movie routes → Error responses: sends errors
backend/routes/movies.routes.js - Upload routes → Admin authentication: protects uploads
backend/routes/upload.routes.js - Upload routes → Upload handling: validates files
backend/routes/upload.routes.js - Upload routes → Upload sessions: tracks sessions
backend/routes/upload.routes.js - Upload routes → Movie catalog: stores movie
- Upload routes → Async route wrapper: wraps handlers
backend/routes/upload.routes.js - Upload routes → Error responses: sends errors
backend/routes/upload.routes.js - Upload handling → Subtitle validation: validates subtitles
backend/services/upload.service.js - Upload handling → Upload sessions: registers files
backend/services/upload.service.js - Media routes → Media streaming: streams requests
backend/routes/media.routes.js - Health routes → Runtime configuration: reports settings
backend/routes/health.routes.js - Health routes → Async route wrapper: wraps handlers
backend/routes/health.routes.js - Health routes → Error responses: uses error contract
backend/routes/health.routes.js - Admin authentication → Application logging: logs decisions
backend/middleware/auth.js - Error responses → Application logging: logs failures
backend/middleware/errorContract.js - Movie catalog → Runtime configuration: uses data paths
backend/services/db.service.js - Movie catalog → Application logging: logs diagnostics
backend/services/db.service.js