# jsampayo/la-cantera-reservas architecture

> Architecture diagram of the GitHub repository jsampayo/la-cantera-reservas, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jsampayo/la-cantera-reservas
- Repository: https://github.com/jsampayo/la-cantera-reservas

## Overview

La Cantera Reservas es una aplicación web Spring para administrar canchas y reservas. Clientes se registran o autentican, consultan disponibilidad por fecha, reservan y gestionan sus reservas; administradores gestionan reservas y usuarios. El mapa recoge las llamadas visibles en los controladores y servicios. Los templates representan las vistas entregadas, pero sus enlaces de renderizado no se muestran en los extractos; no infiero esas relaciones. El almacenamiento relacional se representa mediante repositorios JPA y entidades.

Main entry points: [`src/main/java/com/la_cantera_reservas/services/ServicioReserva.java`](https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/services/ServicioReserva.java) (Reservas y disponibilidad), [`src/main/java/com/la_cantera_reservas/controller/AdminController.java`](https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/controller/AdminController.java) (Flujos administración), [`src/main/java/com/la_cantera_reservas/services/ServicioCliente.java`](https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/services/ServicioCliente.java) (Cuentas cliente), [`src/main/java/com/la_cantera_reservas/controller/ClienteController.java`](https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/controller/ClienteController.java) (Flujos cliente)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web y vistas"]
  node_client_web["Flujos cliente"]
  node_admin_web["Flujos administración"]
  node_home_web["Inicio"]
  node_client_views["Vistas cliente"]
  node_admin_views["Vistas administración"]
end

subgraph group_domain["Dominio"]
  node_reservation_entity["Reserva<br/>[Reserva.java]"]
  node_court_entity["Cancha<br/>[Cancha.java]"]
  node_customer_entity["Cliente entidad<br/>[Cliente.java]"]
end

subgraph group_services["Servicios de aplicación"]
  node_booking_service["Reservas y disponibilidad"]
  node_client_service["Cuentas cliente"]
  node_admin_service["Validación admin<br/>[ServicioAdmin.java]"]
  node_reservation_generator["Generación de reservas"]
end

subgraph group_persistence["Persistencia"]
  node_reservation_repo[("Reservas JPA")]
  node_court_repo[("Canchas JPA")]
  node_customer_repo[("Clientes JPA")]
end

subgraph group_runtime["Tiempo y arranque"]
  node_time_config["Reloj zonal"]
  node_application["Aplicación Spring"]
end

node_client_actor(("Cliente"))
node_admin_actor(("Administrador"))

node_client_actor -->|"usa"| node_client_web
node_admin_actor -->|"usa"| node_admin_web
node_client_web -->|"gestiona cuentas"| node_client_service
node_client_web -->|"consulta y reserva"| node_booking_service
node_admin_web -->|"valida acceso"| node_admin_service
node_admin_web -->|"gestiona clientes"| node_client_service
node_admin_web -->|"administra reservas"| node_booking_service
node_client_service -->|"libera reservas"| node_booking_service
node_client_service -->|"lee y guarda"| node_customer_repo
node_booking_service -->|"lee y guarda"| node_reservation_repo
node_booking_service -->|"consulta canchas"| node_court_repo
node_booking_service -->|"consulta clientes"| node_customer_repo
node_reservation_generator -->|"dispara generación"| node_booking_service
node_booking_service -.->|"obtiene reloj"| node_time_config

click node_client_web "https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/controller/ClienteController.java"
click node_admin_web "https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/controller/AdminController.java"
click node_home_web "https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/controller/InicioController.java"
click node_client_views "https://github.com/jsampayo/la-cantera-reservas/tree/main/src/main/resources/templates"
click node_admin_views "https://github.com/jsampayo/la-cantera-reservas/tree/main/src/main/resources/templates"
click node_booking_service "https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/services/ServicioReserva.java"
click node_client_service "https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/services/ServicioCliente.java"
click node_admin_service "https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/services/ServicioAdmin.java"
click node_reservation_generator "https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/config/GeneradorReservas.java"
click node_reservation_entity "https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/model/Reserva.java"
click node_court_entity "https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/model/Cancha.java"
click node_customer_entity "https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/model/Cliente.java"
click node_reservation_repo "https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/repository/ReservaRepository.java"
click node_court_repo "https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/repository/CanchaRepository.java"
click node_customer_repo "https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/repository/ClienteRepository.java"
click node_time_config "https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/config/ConfiguracionTiempo.java"
click node_application "https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/LaCanteraReservasApplication.java"

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_client_web,node_admin_web,node_home_web,node_client_views,node_admin_views,node_client_actor toneBlue
class node_reservation_entity,node_court_entity,node_customer_entity toneAmber
class node_booking_service,node_client_service,node_admin_service,node_reservation_generator toneMint
class node_reservation_repo,node_court_repo,node_customer_repo toneRose
class node_time_config,node_application,node_admin_actor toneIndigo
```

## Components

### Web y vistas

- [Flujos cliente](https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/controller/ClienteController.java): `src/main/java/com/la_cantera_reservas/controller/ClienteController.java`
- [Flujos administración](https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/controller/AdminController.java): `src/main/java/com/la_cantera_reservas/controller/AdminController.java`
- [Inicio](https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/controller/InicioController.java): `src/main/java/com/la_cantera_reservas/controller/InicioController.java`
- [Vistas cliente](https://github.com/jsampayo/la-cantera-reservas/tree/main/src/main/resources/templates): `src/main/resources/templates`
- [Vistas administración](https://github.com/jsampayo/la-cantera-reservas/tree/main/src/main/resources/templates): `src/main/resources/templates`

### Dominio

- [Reserva](https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/model/Reserva.java): `src/main/java/com/la_cantera_reservas/model/Reserva.java`
- [Cancha](https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/model/Cancha.java): `src/main/java/com/la_cantera_reservas/model/Cancha.java`
- [Cliente entidad](https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/model/Cliente.java): `src/main/java/com/la_cantera_reservas/model/Cliente.java`

### Servicios de aplicación

- [Reservas y disponibilidad](https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/services/ServicioReserva.java): `src/main/java/com/la_cantera_reservas/services/ServicioReserva.java`
- [Cuentas cliente](https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/services/ServicioCliente.java): `src/main/java/com/la_cantera_reservas/services/ServicioCliente.java`
- [Validación admin](https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/services/ServicioAdmin.java): `src/main/java/com/la_cantera_reservas/services/ServicioAdmin.java`
- [Generación de reservas](https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/config/GeneradorReservas.java): `src/main/java/com/la_cantera_reservas/config/GeneradorReservas.java`

### Persistencia

- [Reservas JPA](https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/repository/ReservaRepository.java): `src/main/java/com/la_cantera_reservas/repository/ReservaRepository.java`
- [Canchas JPA](https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/repository/CanchaRepository.java): `src/main/java/com/la_cantera_reservas/repository/CanchaRepository.java`
- [Clientes JPA](https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/repository/ClienteRepository.java): `src/main/java/com/la_cantera_reservas/repository/ClienteRepository.java`

### Tiempo y arranque

- [Reloj zonal](https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/config/ConfiguracionTiempo.java): `src/main/java/com/la_cantera_reservas/config/ConfiguracionTiempo.java`
- [Aplicación Spring](https://github.com/jsampayo/la-cantera-reservas/blob/main/src/main/java/com/la_cantera_reservas/LaCanteraReservasApplication.java): `src/main/java/com/la_cantera_reservas/LaCanteraReservasApplication.java`

### Other components

- **Cliente**
- **Administrador**

## Connections

- Cliente → Flujos cliente: usa
- Administrador → Flujos administración: usa
- Flujos cliente → Cuentas cliente: gestiona cuentas (evidence: `src/main/java/com/la_cantera_reservas/controller/ClienteController.java`)
- Flujos cliente → Reservas y disponibilidad: consulta y reserva (evidence: `src/main/java/com/la_cantera_reservas/controller/ClienteController.java`)
- Flujos administración → Validación admin: valida acceso (evidence: `src/main/java/com/la_cantera_reservas/controller/AdminController.java`)
- Flujos administración → Cuentas cliente: gestiona clientes (evidence: `src/main/java/com/la_cantera_reservas/controller/AdminController.java`)
- Flujos administración → Reservas y disponibilidad: administra reservas (evidence: `src/main/java/com/la_cantera_reservas/controller/AdminController.java`)
- Cuentas cliente → Reservas y disponibilidad: libera reservas (evidence: `src/main/java/com/la_cantera_reservas/services/ServicioCliente.java`)
- Cuentas cliente → Clientes JPA: lee y guarda (evidence: `src/main/java/com/la_cantera_reservas/services/ServicioCliente.java`)
- Reservas y disponibilidad → Reservas JPA: lee y guarda (evidence: `src/main/java/com/la_cantera_reservas/services/ServicioReserva.java`)
- Reservas y disponibilidad → Canchas JPA: consulta canchas (evidence: `src/main/java/com/la_cantera_reservas/services/ServicioReserva.java`)
- Reservas y disponibilidad → Clientes JPA: consulta clientes (evidence: `src/main/java/com/la_cantera_reservas/services/ServicioReserva.java`)
- Generación de reservas → Reservas y disponibilidad: dispara generación (evidence: `src/main/java/com/la_cantera_reservas/config/GeneradorReservas.java`)
- Reservas y disponibilidad → Reloj zonal: obtiene reloj
