How escillex/joust-backend works
This appears to be a tournament-community backend: users and organizers manage tournaments, entrants, formats and match play, while participants follow results and discover community content. The README is unmodified NestJS starter text and does not document the product; the tree and sampled controllers/services support the feature map below. Some major subsystems are represented from their exact directory paths, but their internal wiring is omitted where source excerpts were unavailable.
Main entry points: tournament.controller.ts Tournament management · auth.controller.ts Accounts and sign-in · settings.controller.ts Settings and audit · match.controller.ts Match scoring
Components 23
Identity and access
- Accounts and sign-in
src/auth/auth.controller.ts - User profiles
src/user/user.controller.ts - Organizer tools
src/organizer/organizer.controller.ts
Tournament operations
- Tournament management
src/tournament/tournament.controller.ts - Entrants and invites
src/tournament/participant/participant.controller.ts - Formats and seeding
src/Formats/formats.service.ts - Rounds and brackets
src/tournament/round/round.controller.ts - Match scoring
src/tournament/match/match.controller.ts - Trackers and utilities
src/tournament/match/tracker/tracker.controller.ts - Game catalog
src/game/game.controller.ts
Community features
- Search and rankings
src/search/search.controller.ts - Builds and galleries
src/content/content.controller.ts - Image assets
src/images/images.controller.ts - Awards and showcases
src/award/award.controller.ts - Notifications and live updates
src/notification/notification.controller.ts - Store catalog
src/store/store.controller.ts
Platform services
- Settings and audit
src/settings/settings.controller.ts - Backup and restore
src/backup/backup.controller.ts - Analytics and dashboard
src/analytics/analytics.controller.ts - Application database
prisma/prisma.service.ts
Other components
- Visitor or user
- SMTP mail relay
- Google identity
Connections 21
- Visitor or user → Accounts and sign-in: signs in
- Accounts and sign-in → Application database: reads and writes
- Accounts and sign-in → Google identity: authenticates with
- Accounts and sign-in → User profiles: manages accounts
- Visitor or user → Tournament management: browses or creates
- Tournament management → Formats and seeding: uses format
- Tournament management → Game catalog: assigns game
- Tournament management → Entrants and invites: manages entrants
- Tournament management → Rounds and brackets: generates bracket
- Rounds and brackets → Match scoring: organizes play
- Visitor or user → Match scoring: reports scores
- Match scoring → Trackers and utilities: supports match play
- Visitor or user → Search and rankings: searches
- Visitor or user → Builds and galleries: submits builds
- Builds and galleries → Image assets: uploads media
- Visitor or user → Awards and showcases: views showcase
- Settings and audit → SMTP mail relay: tests delivery
- Visitor or user → Store catalog: browses catalog
- Settings and audit → Backup and restore: configures backups
- Settings and audit → Analytics and dashboard: views reports
- Organizer tools → Tournament management: organizes