How qianqiuzy/harei-backend works
harei-backend is a FastAPI service for authentication, a message box, music catalog management, rankings and tags, downloads, and captain/gift features. Users call its API routes; those routes provide domain operations backed by MySQL, with Redis supporting token sessions. A separate optional Bilibili listener tracks live-room and captain activity and produces reports. The README documents these capabilities, but several route implementations were not sampled; their presence and startup registration are shown, while uncertain internal flows are omitted.
Main entry points: main.py FastAPI application · session.py MySQL sessions · auth.py Auth dependencies · music_manage.py Music management API
Components 29
Runtime infrastructure
- FastAPI application
app/main.py - Settings
app/core/config.py - MySQL sessions
app/db/session.py - Redis client
app/core/redis.py - Authentication service
app/services/auth_service.py - Auth dependencies
app/deps/auth.py
API domains
- Authentication API
app/api/auth.py - Message box API
app/api/box.py - Download API
app/api/download.py - Emoji API
app/api/emoji.py - Huangdou rankings API
app/api/huangdou.py - Tag API
app/api/tag.py
Music catalog
- Music catalog API
app/api/music.py - Music management API
app/api/music_manage.py - Music management extras
app/api/music_manage_extra.py - Music import API
app/api/music_import.py - Music models
app/models/music.py
Captain and live
- Captains API
app/api/captains.py - Captain gifts API
app/api/captaingift.py - Live status API
app/api/live.py - Captain live listener
app/services/bili_captain_listener.py - Gift archive service
app/services/captain_gift_archive.py - Captain reports
app/services/captain_reports.py
Bilibili client
- WebSocket client
blivedm/clients/ws_base.py - Message handlers
blivedm/handlers.py - Web message models
blivedm/models/web.py - Open live models
blivedm/models/open_live.py - Gift V2 model
blivedm/models/send_gift_v2.py
Other components
- API clients
Connections 48
- API clients → FastAPI application: send requests
app/main.py - FastAPI application → Authentication API: registers route
app/main.py - FastAPI application → Message box API: registers route
app/main.py - FastAPI application → Download API: registers route
app/main.py - FastAPI application → Emoji API: registers route
app/main.py - FastAPI application → Huangdou rankings API: registers route
app/main.py - FastAPI application → Tag API: registers route
app/main.py - FastAPI application → Music catalog API: registers route
app/main.py - FastAPI application → Music management API: registers route
app/main.py - FastAPI application → Music management extras: registers route
app/main.py - FastAPI application → Music import API: registers route
app/main.py - FastAPI application → Captains API: registers route
app/main.py - FastAPI application → Captain gifts API: registers route
app/main.py - FastAPI application → Live status API: registers route
app/main.py - FastAPI application → Captain live listener: starts listener
app/main.py - FastAPI application → Gift archive service: runs migration
app/main.py - Authentication API → Authentication service: uses
app/api/auth.py - Authentication API → Auth dependencies: uses
app/api/auth.py - Auth dependencies → Authentication service: checks token
app/deps/auth.py - Auth dependencies → Redis client: gets client
app/deps/auth.py - Authentication service → Redis client: stores tokens
app/services/auth_service.py - Authentication service → Settings: reads credentials
app/services/auth_service.py - Message box API → MySQL sessions: uses sessions
app/api/box.py - Message box API → Auth dependencies: uses auth
app/api/box.py - Download API → MySQL sessions: uses sessions
app/api/download.py - Download API → Auth dependencies: uses auth
app/api/download.py - Huangdou rankings API → MySQL sessions: uses sessions
app/api/huangdou.py - Music catalog API → MySQL sessions: uses sessions
app/api/music.py - Music catalog API → Music models: queries models
app/api/music.py - Music management API → Music catalog API: reuses routes
app/api/music_manage.py - Music management API → MySQL sessions: uses sessions
app/api/music_manage.py - Music management API → Auth dependencies: uses auth
app/api/music_manage.py - Music management API → Music models: uses models
app/api/music_manage.py - Music management extras → Music management API: reuses management
app/api/music_manage_extra.py - Music management extras → MySQL sessions: uses sessions
app/api/music_manage_extra.py - Music management extras → Auth dependencies: uses auth
app/api/music_manage_extra.py - Captains API → MySQL sessions: uses sessions
app/api/captains.py - Captains API → Auth dependencies: uses auth
app/api/captains.py - Captains API → Captain reports: uses reports
app/api/captains.py - Captain gifts API → MySQL sessions: uses sessions
app/api/captaingift.py - Captain gifts API → Auth dependencies: uses auth
app/api/captaingift.py - Captain gifts API → Gift archive service: uses archive
app/api/captaingift.py - Live status API → Captain live listener: reads status
app/api/live.py - Captain live listener → MySQL sessions: writes records
app/services/bili_captain_listener.py - Captain live listener → Captain reports: uses reports
app/services/bili_captain_listener.py - Gift archive service → MySQL sessions: uses sessions
app/services/captain_gift_archive.py - WebSocket client → Message handlers: dispatches messages
blivedm/clients/ws_base.py - Message handlers → WebSocket client: receives commands
blivedm/handlers.py