How green14712-byte/tripquest-server works
This is a NestJS backend for challenge-based missions, with user, institution, and administrator capabilities. The main participant workflow is to authenticate, discover an active challenge and its missions, then submit mission verification (location and/or QR) and manage completion photos. Institutions manage challenges, missions, and applications; administrators manage users. The graph reflects sampled calls and SOURCE INDEX references; unsampled modules are included as capability nodes, but their internal behavior and uncertain links are not inferred.
Main entry points: app.module.ts Nest app composition · db.ts ORM client · supabase-storage.ts Supabase storage · missions.service.ts Mission management
Components 27
Access and identity
- Auth endpoints
src/auth/auth.controller.ts - Identity and admin
src/auth/auth.service.ts - JWT guard
src/auth/jwt-auth.guard.ts - Role guard
src/auth/roles.guard.ts - Role metadata
src/auth/roles.decorator.ts - Email delivery
src/mail/mail.service.ts
Challenges and institutions
- Challenge endpoints
src/challenges/challenges.controller.ts - Challenge management
src/challenges/challenges.service.ts - Operating state
src/challenges/challenge-operation-time.ts - Institution applications
src/institution-applications/institution-applications.controller.ts - Application processing
src/institution-applications/institution-applications.service.ts - Institution endpoints
src/institutions/institutions.controller.ts - Institution queries
src/institutions/institutions.service.ts
Missions and participation
- Mission endpoints
src/missions/missions.controller.ts - Mission management
src/missions/missions.service.ts - QR token crypto
src/missions/mission-qr-crypto.ts - Participation endpoints
src/challenge-participations/challenge-participations.controller.ts - Challenge participation
src/challenge-participations/challenge-participations.service.ts - Completion endpoints
src/mission-completions/mission-completions.controller.ts - Mission verification
src/mission-completions/mission-completions.service.ts
Persistence and integrations
- Postgres database
- ORM client
src/prisma/db.ts - Supabase storage
src/storage/supabase-storage.ts - Nest app composition
src/app.module.ts - HTTP bootstrap
src/main.ts
Other components
- API clients
- Supabase service
Connections 41
- API clients → Auth endpoints: authenticates
src/auth/auth.controller.ts - API clients → Challenge endpoints: browses
src/challenges/challenges.controller.ts - API clients → Mission endpoints: manages missions
src/missions/missions.controller.ts - API clients → Participation endpoints: participates
src/challenge-participations/challenge-participations.controller.ts - API clients → Completion endpoints: verifies mission
src/mission-completions/mission-completions.controller.ts - API clients → Institution applications: applies
src/institution-applications/institution-applications.controller.ts - Auth endpoints → Identity and admin: calls
src/auth/auth.controller.ts - Identity and admin → ORM client: reads and writes
src/auth/auth.service.ts - Identity and admin → Email delivery: sends email
src/auth/auth.service.ts - JWT guard → ORM client: loads user
src/auth/jwt-auth.guard.ts - Role guard → Role metadata: reads roles
src/auth/roles.guard.ts - Challenge endpoints → Challenge management: calls
src/challenges/challenges.controller.ts - Challenge management → ORM client: reads and writes
src/challenges/challenges.service.ts - Challenge management → Operating state: checks operation time
src/challenges/challenges.service.ts - Challenge endpoints → Supabase storage: uploads cover
src/challenges/challenges.controller.ts - Institution applications → Application processing: calls
src/institution-applications/institution-applications.controller.ts - Application processing → ORM client: reads and writes
src/institution-applications/institution-applications.service.ts - Application processing → Supabase storage: stores evidence
src/institution-applications/institution-applications.service.ts - Institution endpoints → Institution queries: calls
src/institutions/institutions.controller.ts - Institution queries → ORM client: queries
src/institutions/institutions.service.ts - Mission endpoints → Mission management: calls
src/missions/missions.controller.ts - Mission management → ORM client: reads and writes
src/missions/missions.service.ts - Mission management → Supabase storage: manages photos
src/missions/missions.service.ts - Mission management → QR token crypto: uses
src/missions/missions.service.ts - Participation endpoints → Challenge participation: calls
src/challenge-participations/challenge-participations.controller.ts - Challenge participation → ORM client: reads and writes
src/challenge-participations/challenge-participations.service.ts - Challenge participation → Operating state: checks operation time
src/challenge-participations/challenge-participations.service.ts - Completion endpoints → Mission verification: calls
src/mission-completions/mission-completions.controller.ts - Mission verification → ORM client: reads and writes
src/mission-completions/mission-completions.service.ts - Mission verification → Operating state: checks operation time
src/mission-completions/mission-completions.service.ts - Mission verification → Supabase storage: manages completion photos
src/mission-completions/mission-completions.service.ts - Supabase storage → Supabase service: uploads files
src/storage/supabase-storage.ts - ORM client → Postgres database: connects
src/prisma/db.ts - HTTP bootstrap → Nest app composition: bootstraps
src/main.ts - Nest app composition → Auth endpoints: registers module
src/app.module.ts - Nest app composition → Challenge endpoints: registers module
src/app.module.ts - Nest app composition → Mission endpoints: registers module
src/app.module.ts - Nest app composition → Participation endpoints: registers module
src/app.module.ts - Nest app composition → Completion endpoints: registers module
src/app.module.ts - Nest app composition → Institution applications: registers module
src/app.module.ts - Nest app composition → Institution endpoints: registers module
src/app.module.ts