# desarrollo-backend/gestion-eventos-api architecture

> Architecture diagram of the GitHub repository desarrollo-backend/gestion-eventos-api, 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/desarrollo-backend/gestion-eventos-api
- Repository: https://github.com/desarrollo-backend/gestion-eventos-api

## Overview

This is an Express REST API for event management, with user registration, login, profile access and logout. The main event workflow is an HTTP request routed through event validation to a controller, which queries or mutates event data and returns JSON; user authentication uses signed tokens and a revocation list. The graph also shows the persistence boundary and scheduled revocation cleanup. Some capabilities, including update/delete validation and centralized error handling, are documented or visible in sampled code; unsampled implementations are represented only where the tree supports them.

Main entry points: [`src/app.js`](https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/app.js) (Express App), [`src/routes/usuarios.routes.js`](https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/routes/usuarios.routes.js) (User Routes), [`src/config/prisma.js`](https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/config/prisma.js) (Prisma Adapter), [`src/services/revocaciones.service.js`](https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/services/revocaciones.service.js) (Revocation Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_http["HTTP API"]
  node_app["Express App<br/>[app.js]"]
  node_event_routes["Event Routes<br/>[eventos.routes.js]"]
  node_user_routes["User Routes<br/>[usuarios.routes.js]"]
end

subgraph group_events["Event Management"]
  node_event_middleware["Event Validation"]
  node_event_schemas["Event Schemas<br/>[eventos.schemas.js]"]
  node_event_controller["Event Controller"]
  node_event_service["Event Service<br/>[eventos.service.js]"]
end

subgraph group_identity["Identity &amp; Sessions"]
  node_user_middleware["User Validation"]
  node_user_schemas["User Schemas"]
  node_auth_middleware["Authentication"]
  node_user_controller["User Controller"]
  node_session_controller["Session Controller"]
  node_user_service["User Service"]
  node_token_service["Token Service<br/>[tokens.service.js]"]
  node_revocation_service["Revocation Service"]
  node_cleanup_task["Revocation Cleanup"]
  node_jwt_config["JWT Configuration<br/>[jwt.js]"]
end

subgraph group_persistence["Persistence"]
  node_prisma_config["Prisma Adapter<br/>[prisma.js]"]
  node_event_data["Event Data Access"]
  node_database[("PostgreSQL")]
  node_data_model["Relational Model<br/>[schema.prisma]"]
end

node_client(("API Client"))

node_client -->|"sends HTTP"| node_app
node_app -->|"mounts routes"| node_event_routes
node_app -->|"mounts routes"| node_user_routes
node_app -->|"starts cleanup"| node_cleanup_task
node_event_routes -->|"validates requests"| node_event_middleware
node_event_middleware -->|"uses schemas"| node_event_schemas
node_event_routes -->|"dispatches requests"| node_event_controller
node_event_controller -->|"delegates create and list"| node_event_service
node_event_controller -->|"queries and mutates"| node_event_data
node_event_service -->|"queries events"| node_prisma_config
node_event_data -->|"uses Prisma"| node_prisma_config
node_user_routes -->|"validates credentials"| node_user_middleware
node_user_middleware -->|"uses schemas"| node_user_schemas
node_user_routes -->|"guards profile and logout"| node_auth_middleware
node_user_routes -->|"dispatches registration and login"| node_user_controller
node_user_routes -->|"dispatches logout"| node_session_controller
node_user_controller -->|"registers and authenticates"| node_user_service
node_user_controller -->|"creates login token"| node_token_service
node_auth_middleware -->|"verifies token"| node_token_service
node_auth_middleware -->|"checks revocation"| node_revocation_service
node_session_controller -->|"revokes token"| node_revocation_service
node_cleanup_task -->|"deletes expired entries"| node_revocation_service
node_user_service -->|"reads and writes users"| node_prisma_config
node_revocation_service -->|"reads and writes revocations"| node_prisma_config
node_token_service -->|"uses signing secret"| node_jwt_config
node_app -->|"loads configuration"| node_jwt_config
node_prisma_config -->|"connects via adapter"| node_database
node_data_model -->|"defines relational schema"| node_database

click node_app "https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/app.js"
click node_event_routes "https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/routes/eventos.routes.js"
click node_user_routes "https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/routes/usuarios.routes.js"
click node_event_middleware "https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/middlewares/eventos.middleware.js"
click node_event_schemas "https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/validators/eventos.schemas.js"
click node_event_controller "https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/controllers/eventos.controller.js"
click node_event_service "https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/services/eventos.service.js"
click node_user_middleware "https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/middlewares/usuarios.middleware.js"
click node_user_schemas "https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/validators/usuarios.schemas.js"
click node_auth_middleware "https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/middlewares/autenticacion.middleware.js"
click node_user_controller "https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/controllers/usuarios.controller.js"
click node_session_controller "https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/controllers/sesiones.controller.js"
click node_user_service "https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/services/usuarios.service.js"
click node_token_service "https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/services/tokens.service.js"
click node_revocation_service "https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/services/revocaciones.service.js"
click node_cleanup_task "https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/tareas/limpiezaRevocaciones.js"
click node_jwt_config "https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/config/jwt.js"
click node_prisma_config "https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/config/prisma.js"
click node_event_data "https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/controllers/eventos.controller.js"
click node_data_model "https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/prisma/schema.prisma"

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_event_routes,node_user_routes,node_client toneBlue
class node_event_middleware,node_event_schemas,node_event_controller,node_event_service toneAmber
class node_user_middleware,node_user_schemas,node_auth_middleware,node_user_controller,node_session_controller,node_user_service,node_token_service,node_revocation_service,node_cleanup_task,node_jwt_config toneMint
class node_prisma_config,node_event_data,node_database,node_data_model toneRose
```

## Components

### HTTP API

- [Express App](https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/app.js): `src/app.js`
- [Event Routes](https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/routes/eventos.routes.js): `src/routes/eventos.routes.js`
- [User Routes](https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/routes/usuarios.routes.js): `src/routes/usuarios.routes.js`

### Event Management

- [Event Validation](https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/middlewares/eventos.middleware.js): `src/middlewares/eventos.middleware.js`
- [Event Schemas](https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/validators/eventos.schemas.js): `src/validators/eventos.schemas.js`
- [Event Controller](https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/controllers/eventos.controller.js): `src/controllers/eventos.controller.js`
- [Event Service](https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/services/eventos.service.js): `src/services/eventos.service.js`

### Identity & Sessions

- [User Validation](https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/middlewares/usuarios.middleware.js): `src/middlewares/usuarios.middleware.js`
- [User Schemas](https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/validators/usuarios.schemas.js): `src/validators/usuarios.schemas.js`
- [Authentication](https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/middlewares/autenticacion.middleware.js): `src/middlewares/autenticacion.middleware.js`
- [User Controller](https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/controllers/usuarios.controller.js): `src/controllers/usuarios.controller.js`
- [Session Controller](https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/controllers/sesiones.controller.js): `src/controllers/sesiones.controller.js`
- [User Service](https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/services/usuarios.service.js): `src/services/usuarios.service.js`
- [Token Service](https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/services/tokens.service.js): `src/services/tokens.service.js`
- [Revocation Service](https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/services/revocaciones.service.js): `src/services/revocaciones.service.js`
- [Revocation Cleanup](https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/tareas/limpiezaRevocaciones.js): `src/tareas/limpiezaRevocaciones.js`
- [JWT Configuration](https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/config/jwt.js): `src/config/jwt.js`

### Persistence

- [Prisma Adapter](https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/config/prisma.js): `src/config/prisma.js`
- [Event Data Access](https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/src/controllers/eventos.controller.js): `src/controllers/eventos.controller.js`
- **PostgreSQL**
- [Relational Model](https://github.com/desarrollo-backend/gestion-eventos-api/blob/main/prisma/schema.prisma): `prisma/schema.prisma`

### Other components

- **API Client**

## Connections

- API Client → Express App: sends HTTP (evidence: `README.md`)
- Express App → Event Routes: mounts routes (evidence: `src/app.js`)
- Express App → User Routes: mounts routes (evidence: `src/app.js`)
- Express App → Revocation Cleanup: starts cleanup (evidence: `src/app.js`)
- Event Routes → Event Validation: validates requests (evidence: `src/routes/eventos.routes.js`)
- Event Validation → Event Schemas: uses schemas (evidence: `src/middlewares/eventos.middleware.js`)
- Event Routes → Event Controller: dispatches requests (evidence: `src/routes/eventos.routes.js`)
- Event Controller → Event Service: delegates create and list (evidence: `src/controllers/eventos.controller.js`)
- Event Controller → Event Data Access: queries and mutates (evidence: `src/controllers/eventos.controller.js`)
- Event Service → Prisma Adapter: queries events (evidence: `src/services/eventos.service.js`)
- Event Data Access → Prisma Adapter: uses Prisma (evidence: `src/controllers/eventos.controller.js`)
- User Routes → User Validation: validates credentials (evidence: `src/routes/usuarios.routes.js`)
- User Validation → User Schemas: uses schemas (evidence: `src/middlewares/usuarios.middleware.js`)
- User Routes → Authentication: guards profile and logout (evidence: `src/routes/usuarios.routes.js`)
- User Routes → User Controller: dispatches registration and login (evidence: `src/routes/usuarios.routes.js`)
- User Routes → Session Controller: dispatches logout (evidence: `src/routes/usuarios.routes.js`)
- User Controller → User Service: registers and authenticates (evidence: `src/controllers/usuarios.controller.js`)
- User Controller → Token Service: creates login token (evidence: `src/controllers/usuarios.controller.js`)
- Authentication → Token Service: verifies token (evidence: `src/middlewares/autenticacion.middleware.js`)
- Authentication → Revocation Service: checks revocation (evidence: `src/middlewares/autenticacion.middleware.js`)
- Session Controller → Revocation Service: revokes token (evidence: `src/controllers/sesiones.controller.js`)
- Revocation Cleanup → Revocation Service: deletes expired entries (evidence: `src/tareas/limpiezaRevocaciones.js`)
- User Service → Prisma Adapter: reads and writes users (evidence: `src/services/usuarios.service.js`)
- Revocation Service → Prisma Adapter: reads and writes revocations (evidence: `src/services/revocaciones.service.js`)
- Token Service → JWT Configuration: uses signing secret (evidence: `src/services/tokens.service.js`)
- Express App → JWT Configuration: loads configuration (evidence: `src/app.js`)
- Prisma Adapter → PostgreSQL: connects via adapter (evidence: `README.md`)
- Relational Model → PostgreSQL: defines relational schema (evidence: `README.md`)
