How 102300671/grouphub works
Grouphub is a private QQ-group resource-sharing site with a Vue web client, FastAPI backend, and nonebot2 QQ bot. Members browse and contribute works, read or watch files, discuss and review works, and publish fanworks; membership and administrator controls gate access. The bot supports binding and member synchronization, work submission, and AI commands. The graph follows documented capabilities and sampled router wiring; some frontend-to-API and unsampled domain links are shown as unverified rather than asserted.
Main entry points: main.py API routing · models.py Domain records · cli_router.py Command router · storage.py Storage failover
Components 33
Web client
- Site interface
frontend/src/App.vue - Web API client
frontend/src/api/index.ts - Works and reader
frontend/src/views/WorksView.vue - Forum and fanworks
frontend/src/views/ForumView.vue - Admin console
frontend/src/views/admin/SettingsView.vue
Backend services
- API routing
backend/app/main.py - Registration and auth
backend/app/api/auth.py - Admin API
backend/app/api/admin.py - AI assistant API
backend/app/api/ai.py - AI service
backend/app/ai_service.py - Database session
backend/app/db.py - Domain records
backend/app/models.py - Access control
backend/app/security.py
Community content
- Works and reading API
backend/app/api/works.py - Reviews API
backend/app/api/reviews.py - Forum API
backend/app/api/forum.py - Fanworks API
backend/app/api/fanworks.py
File storage
- Storage failover
backend/app/storage.py - Zfile adapter
backend/app/zfile_client.py - Alist adapter
backend/app/alist_client.py - File services
QQ bot
- Bot entry
qqbot/bot.py - Command router
qqbot/plugins/cli_router.py - Command parser
qqbot/plugins/_lib/cli.py - Binding commands
qqbot/plugins/commands/auth.py - Work commands
qqbot/plugins/commands/work.py - AI commands
qqbot/plugins/commands/ai.py - AI tools
qqbot/plugins/_lib/aitools.py - Backend HTTP client
qqbot/plugins/_lib/client.py - Member sync
qqbot/plugins/group_member_sync.py - QQ adapters
qqbot/plugins/_lib/bots.py
Other components
- Group member
- QQ group
Connections 48
- Group member → Site interface: uses
- Site interface → Web API client: requests
- Site interface → Works and reader: presents
- Site interface → Forum and fanworks: presents
- Site interface → Admin console: presents
- Web API client → API routing: calls
- API routing → Registration and auth: registers
backend/app/main.py - API routing → Works and reading API: registers
backend/app/main.py - API routing → Reviews API: registers
backend/app/main.py - API routing → Forum API: registers
backend/app/main.py - API routing → Fanworks API: registers
backend/app/main.py - API routing → Admin API: registers
backend/app/main.py - API routing → AI assistant API: registers
backend/app/main.py - API routing → Database session: initializes
backend/app/main.py - Registration and auth → Domain records: queries
backend/app/api/auth.py - Registration and auth → Database session: uses session
backend/app/api/auth.py - Registration and auth → Access control: authenticates
backend/app/api/auth.py - Works and reading API → Domain records: queries
- Works and reading API → Database session: uses session
- Reviews API → Domain records: queries
backend/app/api/reviews.py - Reviews API → Database session: uses session
backend/app/api/reviews.py - Reviews API → Access control: checks access
backend/app/api/reviews.py - Forum API → Domain records: queries
- Fanworks API → Domain records: queries
backend/app/api/fanworks.py - Admin API → Domain records: queries
backend/app/api/admin.py - Admin API → Database session: uses session
backend/app/api/admin.py - Admin API → Access control: checks access
backend/app/api/admin.py - AI assistant API → AI service: delegates
backend/app/api/ai.py - AI assistant API → Domain records: queries
backend/app/api/ai.py - Storage failover → Zfile adapter: uses adapter
backend/app/storage.py - Storage failover → Alist adapter: uses adapter
backend/app/storage.py - Works and reading API → Storage failover: stores files
- Fanworks API → Storage failover: stores attachments
backend/app/api/fanworks.py - Reviews API → Storage failover: stores attachments
backend/app/api/reviews.py - File services → Storage failover: primary and fallback
- Bot entry → Command router: loads plugins
- QQ group → Command router: sends commands
- Command router → Command parser: parses
qqbot/plugins/cli_router.py - Command router → Binding commands: dispatches
qqbot/plugins/cli_router.py - Command router → Work commands: dispatches
qqbot/plugins/cli_router.py - Command router → AI commands: dispatches
qqbot/plugins/cli_router.py - Work commands → Backend HTTP client: calls backend
qqbot/plugins/commands/work.py - Binding commands → Backend HTTP client: calls backend
qqbot/plugins/commands/auth.py - Member sync → Backend HTTP client: calls backend
qqbot/plugins/group_member_sync.py - AI commands → AI tools: uses tools
qqbot/plugins/commands/ai.py - AI commands → Backend HTTP client: calls backend
- Backend HTTP client → Registration and auth: HTTP requests
- Backend HTTP client → Works and reading API: HTTP requests