# chrisag1502/citas-app architecture

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

- Interactive diagram: https://gitdiagram.com/chrisag1502/citas-app
- Repository: https://github.com/chrisag1502/citas-app

## Overview

This Spring MVC application is a Spanish-language marketplace connecting clients with professionals. Clients browse publications and request appointments; professionals register, publish service listings, and review listing statistics. The implementation separates web controllers, domain services, and JPA repositories. Appointment confirmation emails and scheduled reminders are also present. The excerpts show dashboard and service behavior, while other connections rely on the SOURCE INDEX; unsampled reminder and registration details are therefore represented conservatively.

Main entry points: [`src/main/java/azc/uam/app/service/PublicacionService.java`](https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/service/PublicacionService.java) (Publication service), [`src/main/java/azc/uam/app/repository/UsuarioRepository.java`](https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/repository/UsuarioRepository.java) (User repository), [`src/main/java/azc/uam/app/controller/DashboardController.java`](https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/controller/DashboardController.java) (Role dashboards), [`src/main/java/azc/uam/app/service/CitaService.java`](https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/service/CitaService.java) (Appointment service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_dashboard["Role dashboards"]
  node_clientpub["Client listings"]
  node_propub["Professional listings"]
  node_registration["Registration"]
  node_views["Server-rendered pages"]
end

subgraph group_market["Marketplace"]
  node_publication_service["Publication service"]
  node_publication_repository["Publication repository"]
  node_publication_data["Publication model<br/>[Publicacion.java]"]
  node_publication_dto["Publication DTO"]
end

subgraph group_appointments["Appointments"]
  node_appointment_service["Appointment service<br/>[CitaService.java]"]
  node_appointment_repository["Appointment repository"]
  node_appointment_data["Appointment model<br/>[Cita.java]"]
  node_reminders["Reminder scheduler"]
  node_email["Email service<br/>[EmailService.java]"]
end

subgraph group_identity["Identity and persistence"]
  node_registration_service["User service"]
  node_auth_service["Authentication service<br/>[AuthService.java]"]
  node_user_repository["User repository"]
  node_user_data["User model<br/>[Usuario.java]"]
  node_user_dto["User DTO<br/>[UsuarioDTO.java]"]
end

node_user(("Web user"))
node_mail_provider["Mail provider"]
node_database[("Relational database")]

node_user -->|"opens dashboard"| node_dashboard
node_dashboard -->|"loads listings and stats"| node_publication_service
node_dashboard -->|"loads user"| node_user_repository
node_dashboard -.->|"renders"| node_views
node_user -.->|"uses listings"| node_clientpub
node_clientpub -->|"requests listings"| node_publication_service
node_clientpub -->|"requests appointment"| node_appointment_service
node_user -.->|"manages listings"| node_propub
node_propub -->|"manages publication"| node_publication_service
node_propub -->|"accepts listing data"| node_publication_dto
node_publication_service -->|"reads and writes"| node_publication_repository
node_publication_service -->|"looks up owner"| node_user_repository
node_publication_repository -.->|"persists listings"| node_database
node_user -.->|"registers"| node_registration
node_registration -->|"saves account"| node_registration_service
node_registration -->|"accepts account data"| node_user_dto
node_registration_service -->|"persists account"| node_user_repository
node_user_repository -.->|"reads and writes"| node_database
node_auth_service -->|"uses user service"| node_user_repository
node_appointment_service -->|"reads and writes"| node_appointment_repository
node_appointment_service -->|"sends confirmation"| node_email
node_appointment_repository -.->|"persists appointments"| node_database
node_reminders -->|"checks appointments"| node_appointment_service
node_reminders -->|"sends reminders"| node_email
node_email -->|"sends mail"| node_mail_provider

click node_dashboard "https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/controller/DashboardController.java"
click node_clientpub "https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/controller/PublicacionClienteController.java"
click node_propub "https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/controller/PublicacionProfesionalController.java"
click node_registration "https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/controller/RegisterController.java"
click node_views "https://github.com/chrisag1502/citas-app/tree/master/src/main/webapp/WEB-INF/views"
click node_publication_service "https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/service/PublicacionService.java"
click node_publication_repository "https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/repository/PublicacionRepository.java"
click node_publication_data "https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/model/entity/Publicacion.java"
click node_publication_dto "https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/dto/PublicacionDTO.java"
click node_appointment_service "https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/service/CitaService.java"
click node_appointment_repository "https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/repository/CitaRepository.java"
click node_appointment_data "https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/model/entity/Cita.java"
click node_reminders "https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/scheduler/RecordatorioCitaScheduler.java"
click node_email "https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/service/EmailService.java"
click node_registration_service "https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/service/UsuarioServiceImpl.java"
click node_auth_service "https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/service/AuthService.java"
click node_user_repository "https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/repository/UsuarioRepository.java"
click node_user_data "https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/model/entity/Usuario.java"
click node_user_dto "https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/dto/UsuarioDTO.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_dashboard,node_clientpub,node_propub,node_registration,node_views,node_user toneBlue
class node_publication_service,node_publication_repository,node_publication_data,node_publication_dto,node_database toneAmber
class node_appointment_service,node_appointment_repository,node_appointment_data,node_reminders,node_email toneMint
class node_registration_service,node_auth_service,node_user_repository,node_user_data,node_user_dto toneRose
class node_mail_provider toneIndigo
```

## Components

### Web experience

- [Role dashboards](https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/controller/DashboardController.java): `src/main/java/azc/uam/app/controller/DashboardController.java`
- [Client listings](https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/controller/PublicacionClienteController.java): `src/main/java/azc/uam/app/controller/PublicacionClienteController.java`
- [Professional listings](https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/controller/PublicacionProfesionalController.java): `src/main/java/azc/uam/app/controller/PublicacionProfesionalController.java`
- [Registration](https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/controller/RegisterController.java): `src/main/java/azc/uam/app/controller/RegisterController.java`
- [Server-rendered pages](https://github.com/chrisag1502/citas-app/tree/master/src/main/webapp/WEB-INF/views): `src/main/webapp/WEB-INF/views`

### Marketplace

- [Publication service](https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/service/PublicacionService.java): `src/main/java/azc/uam/app/service/PublicacionService.java`
- [Publication repository](https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/repository/PublicacionRepository.java): `src/main/java/azc/uam/app/repository/PublicacionRepository.java`
- [Publication model](https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/model/entity/Publicacion.java): `src/main/java/azc/uam/app/model/entity/Publicacion.java`
- [Publication DTO](https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/dto/PublicacionDTO.java): `src/main/java/azc/uam/app/dto/PublicacionDTO.java`

### Appointments

- [Appointment service](https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/service/CitaService.java): `src/main/java/azc/uam/app/service/CitaService.java`
- [Appointment repository](https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/repository/CitaRepository.java): `src/main/java/azc/uam/app/repository/CitaRepository.java`
- [Appointment model](https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/model/entity/Cita.java): `src/main/java/azc/uam/app/model/entity/Cita.java`
- [Reminder scheduler](https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/scheduler/RecordatorioCitaScheduler.java): `src/main/java/azc/uam/app/scheduler/RecordatorioCitaScheduler.java`
- [Email service](https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/service/EmailService.java): `src/main/java/azc/uam/app/service/EmailService.java`

### Identity and persistence

- [User service](https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/service/UsuarioServiceImpl.java): `src/main/java/azc/uam/app/service/UsuarioServiceImpl.java`
- [Authentication service](https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/service/AuthService.java): `src/main/java/azc/uam/app/service/AuthService.java`
- [User repository](https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/repository/UsuarioRepository.java): `src/main/java/azc/uam/app/repository/UsuarioRepository.java`
- [User model](https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/model/entity/Usuario.java): `src/main/java/azc/uam/app/model/entity/Usuario.java`
- [User DTO](https://github.com/chrisag1502/citas-app/blob/master/src/main/java/azc/uam/app/dto/UsuarioDTO.java): `src/main/java/azc/uam/app/dto/UsuarioDTO.java`

### Other components

- **Web user**
- **Mail provider**
- **Relational database**

## Connections

- Web user → Role dashboards: opens dashboard (evidence: `src/main/java/azc/uam/app/controller/DashboardController.java`)
- Role dashboards → Publication service: loads listings and stats (evidence: `src/main/java/azc/uam/app/controller/DashboardController.java`)
- Role dashboards → User repository: loads user (evidence: `src/main/java/azc/uam/app/controller/DashboardController.java`)
- Role dashboards → Server-rendered pages: renders
- Web user → Client listings: uses listings
- Client listings → Publication service: requests listings (evidence: `src/main/java/azc/uam/app/controller/PublicacionClienteController.java`)
- Client listings → Appointment service: requests appointment (evidence: `src/main/java/azc/uam/app/controller/PublicacionClienteController.java`)
- Web user → Professional listings: manages listings
- Professional listings → Publication service: manages publication (evidence: `src/main/java/azc/uam/app/controller/PublicacionProfesionalController.java`)
- Professional listings → Publication DTO: accepts listing data (evidence: `src/main/java/azc/uam/app/controller/PublicacionProfesionalController.java`)
- Publication service → Publication repository: reads and writes (evidence: `src/main/java/azc/uam/app/service/PublicacionService.java`)
- Publication service → User repository: looks up owner (evidence: `src/main/java/azc/uam/app/service/PublicacionService.java`)
- Publication repository → Relational database: persists listings
- Web user → Registration: registers
- Registration → User service: saves account (evidence: `src/main/java/azc/uam/app/controller/RegisterController.java`)
- Registration → User DTO: accepts account data (evidence: `src/main/java/azc/uam/app/controller/RegisterController.java`)
- User service → User repository: persists account (evidence: `src/main/java/azc/uam/app/service/UsuarioServiceImpl.java`)
- User repository → Relational database: reads and writes
- Authentication service → User repository: uses user service (evidence: `src/main/java/azc/uam/app/service/AuthService.java`)
- Appointment service → Appointment repository: reads and writes (evidence: `src/main/java/azc/uam/app/service/CitaService.java`)
- Appointment service → Email service: sends confirmation (evidence: `src/main/java/azc/uam/app/service/CitaService.java`)
- Appointment repository → Relational database: persists appointments
- Reminder scheduler → Appointment service: checks appointments (evidence: `src/main/java/azc/uam/app/scheduler/RecordatorioCitaScheduler.java`)
- Reminder scheduler → Email service: sends reminders (evidence: `src/main/java/azc/uam/app/scheduler/RecordatorioCitaScheduler.java`)
- Email service → Mail provider: sends mail (evidence: `src/main/java/azc/uam/app/service/EmailService.java`)
