How mfreeman451/dd-chatgpt-dm works
This repository is an early D&D game backend with a Nuxt character-management frontend, gRPC/Connect interfaces, persistent player/room state, and command/event scaffolding. The intended user workflow is character creation, game login or setup, then room navigation and command execution, with state retained server-side. The README also describes a DM/chat system and generated room art, but those integrations are goals rather than implemented components in the sampled evidence. Some subsystem paths are based on the tree and README; their internal wiring is not shown.
Main entry points: room.go Room navigation · proto RPC schemas · service.go Game service · db Database adapters
Components 22
Web character app
- Character UI
web/pages - Web API
web/server/api - Web RPC clients
web/pb/game.client.ts - Web protobuf
web/pb/game.ts
RPC and service
- RPC schemas
proto - Game RPC
gen/game/v1/gamev1connect/game.connect.go - Player RPC
gen/player/v1/playerv1connect/player.connect.go - Room RPC
gen/room/v1/roomv1connect/room.connect.go - Game service
server/internal/service/service.go - Connect server
server/internal/server/server.go - CLI client
client/main.go - Login helper
client/pkg/client/client.go
Game state
- Player state
server/internal/game/player.go - Room navigation
server/internal/game/room.go - Database adapters
server/pkg/db - Redis cache
server/pkg/db/cache/redis.go
Events and operations
- CQRS wiring
server/pkg/watermill/cqrs.go - Command handlers
server/pkg/watermill/handlers.go - Janitor
server/internal/janitor/janitor.go
Other components
- Player
- DM chat
- Generated room art
Connections 21
- Player → Character UI: creates character
- Character UI → Web API: submits character
- Web API → Web RPC clients: calls RPC
- Web RPC clients → Web protobuf: uses messages
web/pb/game.client.ts - Web protobuf → RPC schemas: defines contract
web/pb/game.ts - CLI client → Game RPC: calls game RPC
client/main.go - CLI client → Login helper: delegates login
client/main.go - Login helper → Player: returns placeholder token
client/pkg/client/client.go - Game RPC → RPC schemas: implements schema
gen/game/v1/gamev1connect/game.connect.go - Player RPC → RPC schemas: implements schema
gen/player/v1/playerv1connect/player.connect.go - Room RPC → RPC schemas: implements schema
gen/room/v1/roomv1connect/room.connect.go - Game service → Database adapters: reads and writes
server/internal/service/service.go - Game service → Redis cache: receives client
- Game service → CQRS wiring: publishes messages
server/internal/service/service.go - Database adapters → Player state: stores player data
- Database adapters → Room navigation: stores room data
- CQRS wiring → Command handlers: registers handlers
- Janitor → Command handlers: subscribes events
- DM chat → Room navigation: describes new rooms
- DM chat → Room navigation: saves descriptions
- Room navigation → Generated room art: inspires image