How suhanarda/retrospective-game works
Retrospective Game Platform is a multiplayer party-game suite: players create or join rooms, enter a lobby, vote for a game, and launch it with room/player context. The web platform handles room and game selection; the ASP.NET server is authoritative for room and game-session state, while standalone game applications provide their own gameplay interfaces. Shared contracts and realtime clients connect the frontends. The README also identifies a demo AI question service and eight independently runnable games. Some subsystem links are documented rather than source-verified because their implementation files were not excerpted.
Main entry points: GameLauncher.ts Game Launcher · index.ts Realtime Client · server.ts AI Service · Program.cs Room Server
Components 23
Platform Web
- Platform Flow
apps/retro-platform-web/src/App.jsx - Room Pages
apps/retro-platform-web/src/pages - Room Services
apps/retro-platform-web/src/services - Game Launcher
apps/retro-platform-web/src/games/GameLauncher.ts
Room Authority
- Room Server
services/retrospective-server/Program.cs - Room Lifecycle
services/retrospective-server/Rooms/RoomManager.cs - Hide-and-Seek Authority
services/retrospective-server/Rooms/HideSeek/HideSeekManager.cs - Platform API
services/retro-platform-api/Program.cs
Game Applications
- Draw & Guess
games/draw-and-guess/src/app/App.tsx - Hide and Seek
games/hide-and-seek/src/app/App.tsx - Imposter
games/imposter/src/app/App.tsx - Retro Rush
games/retro-rush/src/app/App.tsx - Tank Battle
games/tank-battle/src/app/App.tsx - Rus Ruleti
games/rus-ruleti/src/app/App.tsx - Spin the Bottle
games/spin-the-bottle/app/page.tsx - Wheel of Fortune
games/wheel-of-fortune/src/App.tsx
Shared Frontend
- Launch Contracts
packages/platform-contracts/src/index.ts - Realtime Client
packages/realtime-client/src/index.ts
Question Service
- AI Service
ai-bot/src/server.ts - Question Generation
ai-bot/src/services/questionGenerator.ts - Question Bank
ai-bot/src/services/questionBank.ts - Room Question Store
ai-bot/src/services/roomQuestionStore.ts
Other components
- Players
Connections 27
- Players → Platform Flow: opens
- Platform Flow → Room Pages: routes to
apps/retro-platform-web/src/App.jsx - Room Pages → Room Services: uses
- Room Services → Room Server: synchronizes rooms
- Room Server → Room Lifecycle: registers
services/retrospective-server/Program.cs - Room Lifecycle → Hide-and-Seek Authority: delegates lifecycle
services/retrospective-server/Rooms/HideSeek/HideSeekManager.cs - Room Pages → Game Launcher: selects game
- Game Launcher → Launch Contracts: passes launch context
- Game Launcher → Draw & Guess: launches
- Game Launcher → Hide and Seek: launches
- Game Launcher → Imposter: launches
- Game Launcher → Retro Rush: launches
- Game Launcher → Tank Battle: launches
- Game Launcher → Rus Ruleti: launches
- Game Launcher → Spin the Bottle: launches
- Game Launcher → Wheel of Fortune: launches
- Draw & Guess → Realtime Client: uses
games/draw-and-guess/src/app/App.tsx - Hide and Seek → Realtime Client: uses
games/hide-and-seek/src/app/App.tsx - Imposter → Realtime Client: uses
games/imposter/src/app/App.tsx - Tank Battle → Realtime Client: uses
games/tank-battle/src/app/App.tsx - Rus Ruleti → Realtime Client: uses
games/rus-ruleti/src/app/App.tsx - Realtime Client → Room Server: exchanges room events
- Players → AI Service: requests questions
- AI Service → Question Generation: generates
ai-bot/src/server.ts - AI Service → Question Bank: persists and falls back
ai-bot/src/server.ts - AI Service → Room Question Store: prepares room questions
ai-bot/src/server.ts - Room Server → AI Service: configures question gateway
services/retrospective-server/Program.cs