# rulas54/rest-project architecture

> Architecture diagram of the GitHub repository rulas54/rest-project, 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/rulas54/rest-project
- Repository: https://github.com/rulas54/rest-project

## Overview

This Spring Boot backend serves AgendaKotlin and HTTP clients with REST endpoints for contacts, tasks, events, and user operations, plus an email endpoint. The main workflow is client request → controller → service → JPA repository → persisted entity; H2 is documented as the in-memory database. The graph includes the documented CRUD domains and the sampled login/password-recovery and email capabilities. Service-to-repository links are supported by the source index; unsampled wiring is not inferred.

Main entry points: [`src/main/java/edu/udelp/movil/restproject/repository/ContactoRepository.java`](https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/repository/ContactoRepository.java) (Contact repository), [`src/main/java/edu/udelp/movil/restproject/repository/TareaRepository.java`](https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/repository/TareaRepository.java) (Task repository), [`src/main/java/edu/udelp/movil/restproject/repository/EventoRepository.java`](https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/repository/EventoRepository.java) (Event repository), [`src/main/java/edu/udelp/movil/restproject/repository/UsuarioRepository.java`](https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/repository/UsuarioRepository.java) (User repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_contact_api["Contact endpoints"]
  node_task_api["Task endpoints"]
  node_event_api["Event endpoints"]
  node_user_api["User endpoints"]
  node_email_api["Email endpoint"]
end

subgraph group_domain["Agenda domains"]
  node_contact_service["Contact service"]
  node_task_service["Task service"]
  node_event_service["Event service"]
  node_contact_model["Contact entity<br/>[Contacto.java]"]
  node_task_model["Task entity<br/>[Tarea.java]"]
  node_event_model["Event entity<br/>[Evento.java]"]
end

subgraph group_persistence["Persistence"]
  node_contact_repo["Contact repository"]
  node_task_repo["Task repository"]
  node_event_repo["Event repository"]
  node_user_repo["User repository"]
  node_h2[("H2 database")]
end

subgraph group_integrations["Account and email"]
  node_user_model["User entity<br/>[Usuario.java]"]
  node_email_request["Email request<br/>[EmailRequest.java]"]
  node_user_service["User service"]
  node_email_service["Email service<br/>[EmailService.java]"]
end

node_client(("Mobile / HTTP client"))
node_mail_sender["Mail sender"]

node_client -->|"sends requests"| node_contact_api
node_client -->|"sends requests"| node_task_api
node_client -->|"sends requests"| node_event_api
node_contact_api -->|"calls"| node_contact_service
node_task_api -->|"calls"| node_task_service
node_event_api -->|"calls"| node_event_service
node_user_api -->|"calls"| node_user_service
node_email_api -->|"calls"| node_email_service
node_contact_service -->|"uses"| node_contact_repo
node_task_service -->|"uses"| node_task_repo
node_event_service -->|"uses"| node_event_repo
node_user_service -->|"uses"| node_user_repo
node_contact_repo -->|"persists"| node_contact_model
node_task_repo -->|"persists"| node_task_model
node_event_repo -->|"persists"| node_event_model
node_user_repo -->|"persists"| node_user_model
node_contact_repo -->|"stores records"| node_h2
node_task_repo -->|"stores records"| node_h2
node_event_repo -->|"stores records"| node_h2
node_user_repo -->|"stores records"| node_h2
node_email_service -->|"sends message"| node_mail_sender
node_email_api -->|"accepts"| node_email_request

click node_contact_api "https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/controller/ContactoController.java"
click node_task_api "https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/controller/TareaController.java"
click node_event_api "https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/controller/EventoController.java"
click node_user_api "https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/controller/UsuarioController.java"
click node_email_api "https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/controller/EmailController.java"
click node_contact_service "https://github.com/rulas54/rest-project/tree/main/src/main/java/edu/udelp/movil/restproject/service"
click node_task_service "https://github.com/rulas54/rest-project/tree/main/src/main/java/edu/udelp/movil/restproject/service"
click node_event_service "https://github.com/rulas54/rest-project/tree/main/src/main/java/edu/udelp/movil/restproject/service"
click node_contact_model "https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/model/Contacto.java"
click node_task_model "https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/model/Tarea.java"
click node_event_model "https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/model/Evento.java"
click node_user_model "https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/model/Usuario.java"
click node_email_request "https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/model/EmailRequest.java"
click node_user_service "https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/service/UsuarioServiceImpl.java"
click node_email_service "https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/service/EmailService.java"
click node_contact_repo "https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/repository/ContactoRepository.java"
click node_task_repo "https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/repository/TareaRepository.java"
click node_event_repo "https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/repository/EventoRepository.java"
click node_user_repo "https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/repository/UsuarioRepository.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_contact_api,node_task_api,node_event_api,node_user_api,node_email_api,node_client toneBlue
class node_contact_service,node_task_service,node_event_service,node_contact_model,node_task_model,node_event_model toneAmber
class node_contact_repo,node_task_repo,node_event_repo,node_user_repo,node_h2 toneMint
class node_user_model,node_email_request,node_user_service,node_email_service toneRose
class node_mail_sender toneIndigo
```

## Components

### REST API

- [Contact endpoints](https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/controller/ContactoController.java): `src/main/java/edu/udelp/movil/restproject/controller/ContactoController.java`
- [Task endpoints](https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/controller/TareaController.java): `src/main/java/edu/udelp/movil/restproject/controller/TareaController.java`
- [Event endpoints](https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/controller/EventoController.java): `src/main/java/edu/udelp/movil/restproject/controller/EventoController.java`
- [User endpoints](https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/controller/UsuarioController.java): `src/main/java/edu/udelp/movil/restproject/controller/UsuarioController.java`
- [Email endpoint](https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/controller/EmailController.java): `src/main/java/edu/udelp/movil/restproject/controller/EmailController.java`

### Agenda domains

- [Contact service](https://github.com/rulas54/rest-project/tree/main/src/main/java/edu/udelp/movil/restproject/service): `src/main/java/edu/udelp/movil/restproject/service`
- [Task service](https://github.com/rulas54/rest-project/tree/main/src/main/java/edu/udelp/movil/restproject/service): `src/main/java/edu/udelp/movil/restproject/service`
- [Event service](https://github.com/rulas54/rest-project/tree/main/src/main/java/edu/udelp/movil/restproject/service): `src/main/java/edu/udelp/movil/restproject/service`
- [Contact entity](https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/model/Contacto.java): `src/main/java/edu/udelp/movil/restproject/model/Contacto.java`
- [Task entity](https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/model/Tarea.java): `src/main/java/edu/udelp/movil/restproject/model/Tarea.java`
- [Event entity](https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/model/Evento.java): `src/main/java/edu/udelp/movil/restproject/model/Evento.java`

### Persistence

- [Contact repository](https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/repository/ContactoRepository.java): `src/main/java/edu/udelp/movil/restproject/repository/ContactoRepository.java`
- [Task repository](https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/repository/TareaRepository.java): `src/main/java/edu/udelp/movil/restproject/repository/TareaRepository.java`
- [Event repository](https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/repository/EventoRepository.java): `src/main/java/edu/udelp/movil/restproject/repository/EventoRepository.java`
- [User repository](https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/repository/UsuarioRepository.java): `src/main/java/edu/udelp/movil/restproject/repository/UsuarioRepository.java`
- **H2 database**

### Account and email

- [User entity](https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/model/Usuario.java): `src/main/java/edu/udelp/movil/restproject/model/Usuario.java`
- [Email request](https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/model/EmailRequest.java): `src/main/java/edu/udelp/movil/restproject/model/EmailRequest.java`
- [User service](https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/service/UsuarioServiceImpl.java): `src/main/java/edu/udelp/movil/restproject/service/UsuarioServiceImpl.java`
- [Email service](https://github.com/rulas54/rest-project/blob/main/src/main/java/edu/udelp/movil/restproject/service/EmailService.java): `src/main/java/edu/udelp/movil/restproject/service/EmailService.java`

### Other components

- **Mobile / HTTP client**
- **Mail sender**

## Connections

- Mobile / HTTP client → Contact endpoints: sends requests (evidence: `README.md`)
- Mobile / HTTP client → Task endpoints: sends requests (evidence: `README.md`)
- Mobile / HTTP client → Event endpoints: sends requests (evidence: `README.md`)
- Contact endpoints → Contact service: calls (evidence: `src/main/java/edu/udelp/movil/restproject/controller/ContactoController.java`)
- Task endpoints → Task service: calls (evidence: `src/main/java/edu/udelp/movil/restproject/controller/TareaController.java`)
- Event endpoints → Event service: calls (evidence: `src/main/java/edu/udelp/movil/restproject/controller/EventoController.java`)
- User endpoints → User service: calls (evidence: `src/main/java/edu/udelp/movil/restproject/controller/UsuarioController.java`)
- Email endpoint → Email service: calls (evidence: `src/main/java/edu/udelp/movil/restproject/controller/EmailController.java`)
- Contact service → Contact repository: uses (evidence: `src/main/java/edu/udelp/movil/restproject/service/ContactoServiceImpl.java`)
- Task service → Task repository: uses (evidence: `src/main/java/edu/udelp/movil/restproject/service/TareaServiceImpl.java`)
- Event service → Event repository: uses (evidence: `src/main/java/edu/udelp/movil/restproject/service/EventoServiceImpl.java`)
- User service → User repository: uses (evidence: `src/main/java/edu/udelp/movil/restproject/service/UsuarioServiceImpl.java`)
- Contact repository → Contact entity: persists (evidence: `src/main/java/edu/udelp/movil/restproject/repository/ContactoRepository.java`)
- Task repository → Task entity: persists (evidence: `src/main/java/edu/udelp/movil/restproject/repository/TareaRepository.java`)
- Event repository → Event entity: persists (evidence: `src/main/java/edu/udelp/movil/restproject/repository/EventoRepository.java`)
- User repository → User entity: persists (evidence: `src/main/java/edu/udelp/movil/restproject/repository/UsuarioRepository.java`)
- Contact repository → H2 database: stores records (evidence: `README.md`)
- Task repository → H2 database: stores records (evidence: `README.md`)
- Event repository → H2 database: stores records (evidence: `README.md`)
- User repository → H2 database: stores records (evidence: `README.md`)
- Email service → Mail sender: sends message (evidence: `src/main/java/edu/udelp/movil/restproject/service/EmailService.java`)
- Email endpoint → Email request: accepts (evidence: `src/main/java/edu/udelp/movil/restproject/controller/EmailController.java`)
