How gonzalolima004/fitzone-sports-g7-backend works
This repository is a NestJS backend for a fitness and sports-center platform: its domain modules cover locations, users and memberships, facility access, group classes, court bookings, and payments. The apparent user-to-result workflows are exposed through HTTP controllers; for example, payment requests enter through the payments controller, are handled by payment services, and may be confirmed from Mercado Pago webhooks. The README is only the NestJS starter template, so product capabilities are inferred from the source tree. Several domain modules were not excerpted; their internal call relationships are therefore not asserted.
Main entry points: app.module.ts Nest application · accesos.service.ts Access control · pagos.service.ts Payment processing · supabase-auth.guard.ts Supabase auth guard
Components 26
API platform
- Nest application
src/app.module.ts - Supabase auth guard
src/common/guards/supabase-auth.guard.ts - Supabase client
src/common/supabase/supabase.service.ts - PostgreSQL database
- Prisma service
src/database/prisma-service/prisma.service.ts
Identity and membership
- User management
src/modules/M1-usuarios/services/usuarios.service.ts - Membership management
src/modules/M1-usuarios/services/membresias.service.ts - Membership plans
src/modules/M1-usuarios/services/planes.service.ts - Profile photo storage
src/modules/M1-usuarios/services/foto-storage.service.ts
Facilities and bookings
- Locations API
src/modules/M0-sedes/controllers/sede.controller.ts - Cities API
src/modules/M0-sedes/controllers/ciudad.controller.ts - Court management
src/modules/M4-canchas/services/canchas.service.ts - Court pricing
src/modules/M4-canchas/services/precio-context.service.ts - Court reservations
src/modules/M4-canchas/services/reservas-canchas.service.ts - Court maintenance
src/modules/M4-canchas/services/mantenimiento.service.ts
Access and classes
- Access control
src/modules/M2-accesos/services/accesos.service.ts - QR access
src/modules/M2-accesos/services/qr.service.ts - Realtime occupancy
src/modules/M2-accesos/services/aforo-realtime.service.ts - Group classes
src/modules/M3-clases-grupales/services/clases.service.ts - Class reservations
src/modules/M3-clases-grupales/services/reservas-clases.service.ts - Class waitlist
src/modules/M3-clases-grupales/services/lista-espera.service.ts
Payments
- Payment processing
src/modules/M5-pagos/services/pagos.service.ts - Mercado Pago integration
src/modules/M5-pagos/services/mercadopago.service.ts - Receipt PDF generator
src/modules/M5-pagos/services/generador-pdf.service.ts
Other components
- HTTP clients
- Mercado Pago
Connections 32
- Nest application → Locations API: registers module
src/app.module.ts - Nest application → User management: registers module
src/app.module.ts - Nest application → Access control: registers module
src/app.module.ts - Nest application → Group classes: registers module
src/app.module.ts - Nest application → Court management: registers module
src/app.module.ts - Nest application → Payment processing: registers module
src/app.module.ts - HTTP clients → Supabase auth guard: presents token
src/common/guards/supabase-auth.guard.ts - Supabase auth guard → Supabase client: validates token
src/common/guards/supabase-auth.guard.ts - Supabase auth guard → User management: looks up account
src/common/guards/supabase-auth.guard.ts - HTTP clients → Locations API: requests locations
- HTTP clients → Cities API: requests cities
- HTTP clients → User management: requests user services
- HTTP clients → Membership management: requests membership
- HTTP clients → Membership plans: requests plans
- HTTP clients → Profile photo storage: uploads photos
- HTTP clients → Access control: requests access
- Access control → QR access: uses QR service
src/modules/M2-accesos/services/accesos.service.ts - Access control → Membership management: checks membership
src/modules/M2-accesos/services/accesos.service.ts - Access control → Realtime occupancy: updates occupancy
src/modules/M2-accesos/services/accesos.service.ts - HTTP clients → Group classes: requests classes
- HTTP clients → Class reservations: requests class booking
- Class reservations → Class waitlist: notifies waitlist
src/modules/M3-clases-grupales/services/reservas-clases.service.ts - HTTP clients → Court management: requests courts
- HTTP clients → Court reservations: requests court booking
- HTTP clients → Court maintenance: requests maintenance
- Court management → Court pricing: quotes pricing
- HTTP clients → Payment processing: starts payment
- Payment processing → Mercado Pago integration: creates preference
src/modules/M5-pagos/services/pagos.service.ts - Payment processing → Receipt PDF generator: generates receipt
src/modules/M5-pagos/services/pagos.service.ts - Mercado Pago → HTTP clients: sends webhook
- Payment processing → Mercado Pago integration: queries payment
src/modules/M5-pagos/services/pagos.service.ts - Prisma service → PostgreSQL database: connects
src/database/prisma-service/prisma.service.ts