How yannchav/dungeongame works
DungeonGame is a browser-based dungeon game organized as microservices. The user-facing journey runs from account signup/sign-in to selecting or creating a hero, entering and traversing a dungeon, and resolving fights; wins award gold, while combat updates hero health. The README documents the service roles, databases, and four RabbitMQ update queues. The graph includes those documented flows and sampled internal calls; frontend-to-service request details and some dungeon/monster internals were not shown, so those links are marked unverified.
Main entry points: AuthenticationController.java User service · FightController.java Fight service · App.jsx React frontend · HeroController.java Hero service
Components 23
Browser client
- React frontend
frontend-service/app/src/App.jsx - Account pages
frontend-service/app/src/pages/LoginPage/LoginPage.jsx - Hero pages
frontend-service/app/src/pages/HeroPage/HeroSelectionPage.jsx - Dungeon page
frontend-service/app/src/pages/DungeonPage/DungeonPage.jsx - WebSocket context
frontend-service/app/src/contexts/WebSocketContext.jsx
Gateway and messaging
- Backend gateway
backend-service/server.js - RabbitMQ
- Fight-to-hero health
README.md - Fight-to-user gold
README.md - Hero-to-frontend health
README.md - User-to-frontend gold
README.md
Identity and heroes
- User service
users-service/src/main/java/com/dungeongame/users/controller/AuthenticationController.java - Authentication
users-service/src/main/java/com/dungeongame/users/service/AuthenticationService.java - JWT service
users-service/src/main/java/com/dungeongame/users/service/JwtService.java - Users database
- Hero service
heroes-service/src/main/java/com/dungeongame/heroes/controller/HeroController.java - Hero creation and health
heroes-service/src/main/java/com/dungeongame/heroes/service/HeroService.java - Heroes database
Dungeon and combat
- Dungeon service
dungeons-service/routes/dungeon.js - Monster service
monsters-service/src/main/java/com/dungeongame/monsters/services/MonsterService.java - Fight service
fights-service/src/main/java/com/dungeongame/fights/controller/FightController.java - Fight resolution
fights-service/src/main/java/com/dungeongame/fights/service/FightService.java
Other components
- Player
Connections 30
- Player → React frontend: plays through
README.md - React frontend → Account pages: routes to
frontend-service/app/src/App.jsx - React frontend → Hero pages: routes to
frontend-service/app/src/App.jsx - React frontend → Dungeon page: routes to
frontend-service/app/src/App.jsx - Account pages → User service: requests account
- Hero pages → Hero service: requests heroes
- Dungeon page → Dungeon service: requests dungeon
- Dungeon page → Monster service: requests monsters
- Dungeon page → Fight service: submits fight
- Backend gateway → RabbitMQ: uses queues
README.md - User service → Authentication: delegates auth
users-service/src/main/java/com/dungeongame/users/controller/AuthenticationController.java - Authentication → Users database: reads and saves
users-service/src/main/java/com/dungeongame/users/service/AuthenticationService.java - User service → JWT service: creates token
users-service/src/main/java/com/dungeongame/users/controller/AuthenticationController.java - User service → Users database: stores users
README.md - Hero service → Hero creation and health: delegates hero work
heroes-service/src/main/java/com/dungeongame/heroes/controller/HeroController.java - Hero creation and health → Heroes database: reads and saves
heroes-service/src/main/java/com/dungeongame/heroes/service/HeroService.java - Hero creation and health → RabbitMQ: publishes health
heroes-service/src/main/java/com/dungeongame/heroes/service/HeroService.java - Fight service → Fight resolution: resolves fight
fights-service/src/main/java/com/dungeongame/fights/controller/FightController.java - Fight service → RabbitMQ: publishes outcomes
fights-service/src/main/java/com/dungeongame/fights/controller/FightController.java - Fight service → Fight-to-hero health: sends health update
README.md - Fight-to-hero health → Hero service: updates health
README.md - Fight service → Fight-to-user gold: sends gold award
README.md - Fight-to-user gold → User service: updates gold
README.md - Hero service → Hero-to-frontend health: sends health update
README.md - Hero-to-frontend health → Backend gateway: delivers update
README.md - Backend gateway → WebSocket context: forwards by WebSocket
README.md - User service → User-to-frontend gold: sends gold update
README.md - User-to-frontend gold → Backend gateway: delivers update
README.md - WebSocket context → React frontend: updates display
frontend-service/app/src/App.jsx - Hero service → Heroes database: persists heroes
README.md