How slavakuntsov/flowix works
Flowix is a self-hosted video platform whose main workflow runs from browsing or uploading in the web app through gateway routing, asynchronous transcoding, metadata readiness, and HLS playback. The README documents the service pipeline and major streaming, security, and storage capabilities; sampled code confirms gateway routing and the auth service’s internal calls. Several backend and frontend paths are unsampled, so those relationships are shown only where documented.
Main entry points: main.go Route and proxy · video.go Video metadata API · api.ts API client · auth.py Auth endpoints
Components 21
Web application
- Video catalog
frontend/src/app/page.tsx - Login and registration
frontend/src/app/login/page.tsx - Upload interface
frontend/src/app/upload/page.tsx - Watch page
frontend/src/app/watch/[id]/page.tsx - HLS player
frontend/src/components/VideoPlayer.tsx - API client
frontend/src/lib/api.ts
API gateway
- Route and proxy
services/gateway/cmd/server/main.go
Identity service
- Auth endpoints
services/auth/src/routers/auth.py - Auth application
services/auth/src/main.py - Passwords and tokens
services/auth/src/core/security.py - Refresh-token store
services/auth/src/core/tokenstore.py - User database access
services/auth/src/core/db.py
Video services
- Video upload service
services/upload/internal/handler - Upload event publisher
services/upload/internal/queue/publisher.go - Transcoding worker
services/transcoder/app/consumer.py - Video metadata API
services/metadata/internal/handler/video.go
Storage and delivery
- Object storage
- Upload queue
- Postgres
- nginx-vod
Other components
- Viewer or uploader
Connections 29
- Viewer or uploader → Video catalog: browses
README.md - Viewer or uploader → Login and registration: signs in
README.md - Viewer or uploader → Upload interface: uploads video
README.md - Viewer or uploader → Watch page: watches video
README.md - Video catalog → API client: requests videos
- Login and registration → API client: requests auth
- Upload interface → API client: submits upload
- Watch page → API client: requests metadata
- Watch page → HLS player: renders player
- HLS player → nginx-vod: loads HLS
README.md - API client → Route and proxy: calls API
README.md - Route and proxy → Auth application: proxies auth
services/gateway/cmd/server/main.go - Route and proxy → Video upload service: proxies upload
services/gateway/cmd/server/main.go - Route and proxy → Video metadata API: proxies metadata
services/gateway/cmd/server/main.go - Route and proxy → nginx-vod: proxies HLS
services/gateway/cmd/server/main.go - Auth application → Auth endpoints: registers routes
services/auth/src/main.py - Auth endpoints → User database access: queries users
services/auth/src/routers/auth.py - Auth endpoints → Passwords and tokens: verifies and signs
services/auth/src/routers/auth.py - Auth endpoints → Refresh-token store: rotates tokens
services/auth/src/routers/auth.py - Video upload service → Object storage: stores raw video
README.md - Video upload service → Upload event publisher: publishes event
README.md - Upload event publisher → Upload queue: sends upload event
README.md - Upload queue → Transcoding worker: dispatches event
README.md - Transcoding worker → Object storage: writes renditions
README.md - Transcoding worker → Video metadata API: marks ready
README.md - Video metadata API → Postgres: reads and writes
README.md - Video metadata API → Object storage: deletes objects
README.md - nginx-vod → Object storage: packages renditions
README.md - nginx-vod → Video metadata API: reads video mapping
README.md