How hum2a/26 works
This is a hosted party quiz: guests join on phones and answer individually while a presenter’s big-screen stage follows the room; an administrator manages and rehearses the event. The API’s room routes coordinate room actions, while question packs provide quiz content. Distinct supporting capabilities include administrator sign-in, guest media, results/archive, and kart play. The README documents the overall experience; sampled excerpts show selected route and service calls, but do not establish every connection among subsystems.
Main entry points: admin-page.tsx Admin console · routes.ts Room API · join Room join · guest-play.tsx Question play
Components 21
Guest play
- Guest experience
apps/web/src/guest/guest-page.tsx - Room join
apps/web/src/join - Question play
apps/web/src/play/guest-play.tsx - Projector stage
apps/web/src/stage/stage-page.tsx
Room runtime
- Room API
apps/api/src/room/routes.ts - Party room
apps/api/src/room/party-room.ts - Room registry
apps/api/src/room/registry.ts
Game content
- Question runtime
apps/api/src/questions/runtime.ts - Birthday question pack
apps/api/src/questions/packs/birthday/manifest.ts - Question authoring
apps/api/src/questions/authoring.ts
Event operations
- Admin console
apps/web/src/admin/admin-page.tsx - Admin authentication
apps/api/src/auth/routes.ts - Media API
apps/api/src/media/routes.ts - Media storage
apps/api/src/media/store.ts - Results delivery
apps/api/src/results/delivery.ts - Room archive
apps/api/src/archive/store.ts
Additional modes
- Kart game mode
apps/api/src/room/kart - Troll effects
apps/api/src/troll/engine.ts
Other components
- Party guests
- Presenter
- Administrator
Connections 19
- Party guests → Room join: join by code
README.md - Room join → Guest experience: enter lobby
README.md - Party guests → Question play: play on phones
README.md - Presenter → Projector stage: present event
README.md - Administrator → Admin console: manage event
README.md - Admin console → Admin authentication: sign in
README.md - Room API → Party room: dispatch room actions
apps/api/src/room/routes.ts - Room API → Room registry: resolve rooms
- Admin console → Room API: manage and rehearse
README.md - Projector stage → Room API: follow room
README.md - Question play → Room API: submit answers
README.md - Birthday question pack → Question runtime: supply questions
- Question authoring → Birthday question pack: define questions
apps/api/src/questions/authoring.ts - Admin console → Media API: manage media
- Media API → Media storage: read and write
apps/api/src/media/routes.ts - Administrator → Results delivery: review results
- Results delivery → Room archive: deliver archived results
- Admin console → Kart game mode: configure kart mode
- Party room → Troll effects: apply room effects