How missgomezzz/dancesync_backend works
DanceSync is a multiplayer dance-battle backend. The principal workflow is: a frontend reaches the gateway, players join rooms and battle over HTTP/WebSocket, and completed matches are recorded by the users service. Battle play includes song selection, spectator chat and voting, live scoring, and timed word races; users-service also provides profiles and an auditable admin trail. The README documents service routing and persistence; sampled source confirms selected wiring, but many use-case and gateway internals were not inspected, so uncertain links are omitted.
Main entry points: server.ts Battle server · ApiGatewayApplication.java Gateway entry · rest User and match API · socketHandlers.ts Socket events
Components 26
API gateway
- Gateway entry
api-gateway/src/main/java/com/dancesync/gateway/ApiGatewayApplication.java - Auth and sessions
api-gateway/src/main/java/com/dancesync/gateway/security - Gateway audit
api-gateway/src/main/java/com/dancesync/gateway/audit - Rate limiting
api-gateway/src/main/java/com/dancesync/gateway/ratelimit - Gateway health
api-gateway/src/main/java/com/dancesync/gateway/observability/ApiPortHealthController.java
Real-time battles
- Battle server
battle-service/src/server.ts - HTTP routes
battle-service/src/infrastructure/http/routes.ts - Socket events
battle-service/src/infrastructure/ws/socketHandlers.ts - Room commands
battle-service/src/application/usecases - Battle commands
battle-service/src/application/usecases - Song selection
battle-service/src/domain/services/SongSelectionService.ts - Room rules
battle-service/src/domain/services/RoomService.ts - Room state
battle-service/src/domain/model/Room.ts - Word race
battle-service/src/domain/model/WordRace.ts - Race scheduler
battle-service/src/infrastructure/scheduling/WordRaceScheduler.ts - Match results
battle-service/src/application/usecases/RecordMatchResult.ts
Users and records
- User and match API
users-service/src/main/java/com/dancesync/users/infrastructure/adapter/in/rest - User services
users-service/src/main/java/com/dancesync/users/application/service/UserService.java - Match service
users-service/src/main/java/com/dancesync/users/application/service/MatchService.java - Audit ingestion
users-service/src/main/java/com/dancesync/users/infrastructure/adapter/in/rest/admin/AuditIngestController.java - Audit chain and queries
users-service/src/main/java/com/dancesync/users/application/service/AuditService.java - Admin alerts
users-service/src/main/java/com/dancesync/users/application/service/AdminAlertsService.java - Users service
users-service/src/main/java/com/dancesync/users/UsersServiceApplication.java
State and integrations
- PostgreSQL
- Redis
Other components
- Frontend
Connections 27
- Frontend → Gateway entry: sends HTTP/WebSocket
- Gateway entry → HTTP routes: routes HTTP
- Gateway entry → Socket events: routes sockets
- Gateway entry → Users service: routes user API
- Battle server → HTTP routes: mounts router
battle-service/src/server.ts - Battle server → Socket events: configures sockets
battle-service/src/server.ts - HTTP routes → Room commands: executes room actions
battle-service/src/infrastructure/http/routes.ts - Socket events → Room commands: dispatches room events
battle-service/src/infrastructure/ws/socketHandlers.ts - Socket events → Battle commands: dispatches battle events
battle-service/src/infrastructure/ws/socketHandlers.ts - Room commands → Room rules: applies room rules
battle-service/src/application/usecases/AwardWordBonus.ts - Battle commands → Room rules: updates battle state
battle-service/src/application/usecases/AwardWordBonus.ts - Room rules → Room state: computes room state
battle-service/src/domain/services/RoomService.ts - Room rules → Song selection: checks song selection
battle-service/src/domain/services/RoomService.ts - Battle server → Race scheduler: configures timers
battle-service/src/server.ts - Race scheduler → Word race: schedules rounds
- Battle server → Match results: wires match recording
battle-service/src/server.ts - Match results → User and match API: publishes match result
- User and match API → User services: handles user requests
- User and match API → Match service: handles match requests
users-service/src/main/java/com/dancesync/users/infrastructure/adapter/in/rest/MatchController.java - Match service → PostgreSQL: persists matches
- User services → PostgreSQL: persists profiles
- User and match API → Audit ingestion: accepts audit events
users-service/src/main/java/com/dancesync/users/infrastructure/adapter/in/rest/admin/AuditIngestController.java - Audit ingestion → Audit chain and queries: records events
users-service/src/main/java/com/dancesync/users/infrastructure/adapter/in/rest/admin/AuditIngestController.java - Audit chain and queries → PostgreSQL: stores audit records
- Admin alerts → Audit chain and queries: verifies audit chain
users-service/src/main/java/com/dancesync/users/application/service/AdminAlertsService.java - Battle server → Redis: uses shared state
- Users service → PostgreSQL: connects via JDBC