Toju/toju-app/src/app/domains/game-activity/README.md

Game Activity Domain

Foreground-window-first game detection, RAWG matching, and P2P now-playing sync.

Cross-context contract: agents-docs/features/game-activity.md

Module map

game-activity/
├── domain/
│   ├── game-activity.models.ts    Shared-kernel types (re-exported)
│   └── game-activity-time.ts      formatGameActivityElapsed()
├── application/
│   ├── game-activity.service.ts   Scan loop, match cache, P2P broadcast
│   └── game-activity.service.spec.ts
└── index.ts

Public entry points

Export	Role
GameActivityService	Started from App bootstrap; updates user store + broadcasts
formatGameActivityElapsed()	Profile card / sidebar elapsed time label

Dependencies

• ElectronBridgeService — process names and foreground candidate (desktop only)
• ServerDirectoryFacade — POST /api/games/match base URL
• RealtimeSessionFacade — P2P game-activity send/receive

UI consumers

• Profile card components (formatGameActivityElapsed, user.gameActivity)
• Room side panel member list

Boundaries

• Does not own RAWG API keys (server configuration).
• Browser/mobile shells do not scan processes locally.