# gonzalolima004/fitzone-sports-g7-backend architecture

> Architecture diagram of the GitHub repository gonzalolima004/fitzone-sports-g7-backend, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gonzalolima004/fitzone-sports-g7-backend
- Repository: https://github.com/gonzalolima004/fitzone-sports-g7-backend

## Overview

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: [`src/app.module.ts`](https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/app.module.ts) (Nest application), [`src/modules/M2-accesos/services/accesos.service.ts`](https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M2-accesos/services/accesos.service.ts) (Access control), [`src/modules/M5-pagos/services/pagos.service.ts`](https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M5-pagos/services/pagos.service.ts) (Payment processing), [`src/common/guards/supabase-auth.guard.ts`](https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/common/guards/supabase-auth.guard.ts) (Supabase auth guard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_platform["API platform"]
  node_app["Nest application<br/>[app.module.ts]"]
  node_auth["Supabase auth guard"]
  node_supabase["Supabase client"]
  node_database[("PostgreSQL database")]
  node_prisma["Prisma service<br/>[prisma.service.ts]"]
end

subgraph group_identity["Identity and membership"]
  node_usuarios["User management"]
  node_membresias["Membership management"]
  node_planes["Membership plans<br/>[planes.service.ts]"]
  node_fotos["Profile photo storage"]
end

subgraph group_facilities["Facilities and bookings"]
  node_sedes["Locations API<br/>[sede.controller.ts]"]
  node_ciudades["Cities API"]
  node_canchas["Court management<br/>[canchas.service.ts]"]
  node_pricing["Court pricing"]
  node_reservas_cancha["Court reservations"]
  node_mantenimiento["Court maintenance"]
end

subgraph group_operations["Access and classes"]
  node_accesos["Access control<br/>[accesos.service.ts]"]
  node_qr["QR access<br/>[qr.service.ts]"]
  node_aforo["Realtime occupancy"]
  node_clases["Group classes<br/>[clases.service.ts]"]
  node_reservas_clase["Class reservations"]
  node_waitlist["Class waitlist"]
end

subgraph group_billing["Payments"]
  node_pagos["Payment processing<br/>[pagos.service.ts]"]
  node_mercadopago["Mercado Pago integration"]
  node_pdf["Receipt PDF generator"]
end

node_http(("HTTP clients"))
node_mp_service["Mercado Pago"]

node_app -->|"registers module"| node_sedes
node_app -->|"registers module"| node_usuarios
node_app -->|"registers module"| node_accesos
node_app -->|"registers module"| node_clases
node_app -->|"registers module"| node_canchas
node_app -->|"registers module"| node_pagos
node_http -->|"presents token"| node_auth
node_auth -->|"validates token"| node_supabase
node_auth -->|"looks up account"| node_usuarios
node_http -.->|"requests locations"| node_sedes
node_http -.->|"requests cities"| node_ciudades
node_http -.->|"requests user services"| node_usuarios
node_http -.->|"requests membership"| node_membresias
node_http -.->|"requests plans"| node_planes
node_http -.->|"uploads photos"| node_fotos
node_http -->|"requests access"| node_accesos
node_accesos -->|"uses QR service"| node_qr
node_accesos -->|"checks membership"| node_membresias
node_accesos -->|"updates occupancy"| node_aforo
node_http -.->|"requests classes"| node_clases
node_http -.->|"requests class booking"| node_reservas_clase
node_reservas_clase -->|"notifies waitlist"| node_waitlist
node_http -.->|"requests courts"| node_canchas
node_http -.->|"requests court booking"| node_reservas_cancha
node_http -.->|"requests maintenance"| node_mantenimiento
node_canchas -.->|"quotes pricing"| node_pricing
node_http -->|"starts payment"| node_pagos
node_pagos -->|"creates preference"| node_mercadopago
node_pagos -->|"generates receipt"| node_pdf
node_mp_service -->|"sends webhook"| node_http
node_pagos -->|"queries payment"| node_mercadopago
node_prisma -->|"connects"| node_database

click node_app "https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/app.module.ts"
click node_auth "https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/common/guards/supabase-auth.guard.ts"
click node_supabase "https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/common/supabase/supabase.service.ts"
click node_prisma "https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/database/prisma-service/prisma.service.ts"
click node_sedes "https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M0-sedes/controllers/sede.controller.ts"
click node_ciudades "https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M0-sedes/controllers/ciudad.controller.ts"
click node_usuarios "https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M1-usuarios/services/usuarios.service.ts"
click node_membresias "https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M1-usuarios/services/membresias.service.ts"
click node_planes "https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M1-usuarios/services/planes.service.ts"
click node_fotos "https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M1-usuarios/services/foto-storage.service.ts"
click node_accesos "https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M2-accesos/services/accesos.service.ts"
click node_qr "https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M2-accesos/services/qr.service.ts"
click node_aforo "https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M2-accesos/services/aforo-realtime.service.ts"
click node_clases "https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M3-clases-grupales/services/clases.service.ts"
click node_reservas_clase "https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M3-clases-grupales/services/reservas-clases.service.ts"
click node_waitlist "https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M3-clases-grupales/services/lista-espera.service.ts"
click node_canchas "https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M4-canchas/services/canchas.service.ts"
click node_pricing "https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M4-canchas/services/precio-context.service.ts"
click node_reservas_cancha "https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M4-canchas/services/reservas-canchas.service.ts"
click node_mantenimiento "https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M4-canchas/services/mantenimiento.service.ts"
click node_pagos "https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M5-pagos/services/pagos.service.ts"
click node_mercadopago "https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M5-pagos/services/mercadopago.service.ts"
click node_pdf "https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M5-pagos/services/generador-pdf.service.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_auth,node_supabase,node_database,node_prisma,node_http toneBlue
class node_usuarios,node_membresias,node_planes,node_fotos toneAmber
class node_sedes,node_ciudades,node_canchas,node_pricing,node_reservas_cancha,node_mantenimiento toneMint
class node_accesos,node_qr,node_aforo,node_clases,node_reservas_clase,node_waitlist toneRose
class node_pagos,node_mercadopago,node_pdf,node_mp_service toneIndigo
```

## Components

### API platform

- [Nest application](https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/app.module.ts): `src/app.module.ts`
- [Supabase auth guard](https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/common/guards/supabase-auth.guard.ts): `src/common/guards/supabase-auth.guard.ts`
- [Supabase client](https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/common/supabase/supabase.service.ts): `src/common/supabase/supabase.service.ts`
- **PostgreSQL database**
- [Prisma service](https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/database/prisma-service/prisma.service.ts): `src/database/prisma-service/prisma.service.ts`

### Identity and membership

- [User management](https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M1-usuarios/services/usuarios.service.ts): `src/modules/M1-usuarios/services/usuarios.service.ts`
- [Membership management](https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M1-usuarios/services/membresias.service.ts): `src/modules/M1-usuarios/services/membresias.service.ts`
- [Membership plans](https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M1-usuarios/services/planes.service.ts): `src/modules/M1-usuarios/services/planes.service.ts`
- [Profile photo storage](https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M1-usuarios/services/foto-storage.service.ts): `src/modules/M1-usuarios/services/foto-storage.service.ts`

### Facilities and bookings

- [Locations API](https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M0-sedes/controllers/sede.controller.ts): `src/modules/M0-sedes/controllers/sede.controller.ts`
- [Cities API](https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M0-sedes/controllers/ciudad.controller.ts): `src/modules/M0-sedes/controllers/ciudad.controller.ts`
- [Court management](https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M4-canchas/services/canchas.service.ts): `src/modules/M4-canchas/services/canchas.service.ts`
- [Court pricing](https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M4-canchas/services/precio-context.service.ts): `src/modules/M4-canchas/services/precio-context.service.ts`
- [Court reservations](https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M4-canchas/services/reservas-canchas.service.ts): `src/modules/M4-canchas/services/reservas-canchas.service.ts`
- [Court maintenance](https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M4-canchas/services/mantenimiento.service.ts): `src/modules/M4-canchas/services/mantenimiento.service.ts`

### Access and classes

- [Access control](https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M2-accesos/services/accesos.service.ts): `src/modules/M2-accesos/services/accesos.service.ts`
- [QR access](https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M2-accesos/services/qr.service.ts): `src/modules/M2-accesos/services/qr.service.ts`
- [Realtime occupancy](https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M2-accesos/services/aforo-realtime.service.ts): `src/modules/M2-accesos/services/aforo-realtime.service.ts`
- [Group classes](https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M3-clases-grupales/services/clases.service.ts): `src/modules/M3-clases-grupales/services/clases.service.ts`
- [Class reservations](https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M3-clases-grupales/services/reservas-clases.service.ts): `src/modules/M3-clases-grupales/services/reservas-clases.service.ts`
- [Class waitlist](https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M3-clases-grupales/services/lista-espera.service.ts): `src/modules/M3-clases-grupales/services/lista-espera.service.ts`

### Payments

- [Payment processing](https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M5-pagos/services/pagos.service.ts): `src/modules/M5-pagos/services/pagos.service.ts`
- [Mercado Pago integration](https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M5-pagos/services/mercadopago.service.ts): `src/modules/M5-pagos/services/mercadopago.service.ts`
- [Receipt PDF generator](https://github.com/gonzalolima004/fitzone-sports-g7-backend/blob/main/src/modules/M5-pagos/services/generador-pdf.service.ts): `src/modules/M5-pagos/services/generador-pdf.service.ts`

### Other components

- **HTTP clients**
- **Mercado Pago**

## Connections

- Nest application → Locations API: registers module (evidence: `src/app.module.ts`)
- Nest application → User management: registers module (evidence: `src/app.module.ts`)
- Nest application → Access control: registers module (evidence: `src/app.module.ts`)
- Nest application → Group classes: registers module (evidence: `src/app.module.ts`)
- Nest application → Court management: registers module (evidence: `src/app.module.ts`)
- Nest application → Payment processing: registers module (evidence: `src/app.module.ts`)
- HTTP clients → Supabase auth guard: presents token (evidence: `src/common/guards/supabase-auth.guard.ts`)
- Supabase auth guard → Supabase client: validates token (evidence: `src/common/guards/supabase-auth.guard.ts`)
- Supabase auth guard → User management: looks up account (evidence: `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 (evidence: `src/modules/M2-accesos/services/accesos.service.ts`)
- Access control → Membership management: checks membership (evidence: `src/modules/M2-accesos/services/accesos.service.ts`)
- Access control → Realtime occupancy: updates occupancy (evidence: `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 (evidence: `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 (evidence: `src/modules/M5-pagos/services/pagos.service.ts`)
- Payment processing → Receipt PDF generator: generates receipt (evidence: `src/modules/M5-pagos/services/pagos.service.ts`)
- Mercado Pago → HTTP clients: sends webhook
- Payment processing → Mercado Pago integration: queries payment (evidence: `src/modules/M5-pagos/services/pagos.service.ts`)
- Prisma service → PostgreSQL database: connects (evidence: `src/database/prisma-service/prisma.service.ts`)
