# emanuel-ramayo/poncho-digital-api architecture

> Architecture diagram of the GitHub repository emanuel-ramayo/poncho-digital-api, 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/emanuel-ramayo/poncho-digital-api
- Repository: https://github.com/emanuel-ramayo/poncho-digital-api

## Overview

Poncho Digital es una API REST para administrar usuarios, artesanos, productos, stands y postulaciones. El flujo principal va de la solicitud HTTP a las rutas, que aplican validación y controles de acceso antes de invocar controladores y servicios; estos implementan reglas de negocio y persisten mediante Prisma en PostgreSQL. También ofrece login JWT con revocación, aprobación de postulaciones y documentación Swagger. Las rutas y servicios de varios módulos no se muestrearon completos; sus vínculos se incluyen solo cuando los respalda el índice o el README.

Main entry points: [`src/middlewares`](https://github.com/emanuel-ramayo/poncho-digital-api/tree/main/src/middlewares) (Validación de entrada), [`src/app.js`](https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/app.js) (Aplicación Express), [`src/config/prisma.js`](https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/config/prisma.js) (Cliente Prisma), [`src/routes/usuariosRoutes.js`](https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/routes/usuariosRoutes.js) (Rutas usuarios)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_http["API HTTP"]
  node_app["Aplicación Express<br/>[app.js]"]
  node_user_routes["Rutas usuarios<br/>[usuariosRoutes.js]"]
  node_artisan_routes["Rutas artesanos<br/>[artesanosRoutes.js]"]
  node_application_routes["Rutas catálogo y solicitudes"]
  node_validation["Validación de entrada"]
  node_artisans_validation["Esquemas artesanos"]
  node_applications_validation["Esquemas postulaciones"]
  node_products_validation["Esquemas productos"]
  node_users_validation["Esquemas usuarios"]
end

subgraph group_domain["Gestión de dominio"]
  node_users_controller["Controlador usuarios"]
  node_artisans_controller["Controlador artesanos"]
  node_applications_controller["Controlador postulaciones"]
  node_catalog_controllers["Controladores catálogo"]
  node_users_service["Servicio usuarios<br/>[usuariosService.js]"]
  node_artisans_service["Servicio artesanos"]
  node_applications_service["Servicio postulaciones"]
  node_catalog_services["Servicios catálogo"]
end

subgraph group_identity["Identidad y acceso"]
  node_authn["Autenticación JWT"]
  node_authz["Autorización por rol"]
  node_tokens["Tokens JWT<br/>[tokensService.js]"]
  node_revocations[("Revocaciones")]
  node_cleanup["Limpieza periódica"]
end

subgraph group_data["Persistencia"]
  node_prisma["Cliente Prisma<br/>[prisma.js]"]
  node_postgres[("PostgreSQL")]
end

subgraph group_docs["Documentación API"]
  node_schemas["Esquemas OpenAPI<br/>[esquemas.js]"]
  node_swagger["Swagger UI<br/>[app.js]"]
end

node_client(("Cliente HTTP"))

node_client -->|"envía solicitudes"| node_app
node_app -->|"monta rutas"| node_user_routes
node_app -->|"monta rutas"| node_artisan_routes
node_app -->|"monta rutas"| node_application_routes
node_user_routes -->|"aplica validación"| node_validation
node_artisan_routes -->|"aplica validación"| node_validation
node_application_routes -->|"aplica validación"| node_validation
node_validation -->|"valida datos"| node_artisans_validation
node_validation -->|"valida datos"| node_applications_validation
node_validation -->|"valida datos"| node_products_validation
node_validation -->|"valida datos"| node_users_validation
node_user_routes -->|"despacha a"| node_users_controller
node_user_routes -->|"ejecuta autenticación"| node_authn
node_artisan_routes -->|"despacha a"| node_artisans_controller
node_application_routes -->|"despacha a"| node_applications_controller
node_application_routes -->|"despacha a"| node_catalog_controllers
node_users_controller -->|"invoca"| node_users_service
node_artisans_controller -->|"invoca"| node_artisans_service
node_applications_controller -->|"invoca"| node_applications_service
node_catalog_controllers -->|"invoca"| node_catalog_services
node_users_controller -->|"genera token"| node_tokens
node_authn -->|"verifica token"| node_tokens
node_authn -->|"consulta revocación"| node_revocations
node_authz -->|"carga usuario"| node_users_service
node_users_service -->|"consulta y modifica"| node_prisma
node_artisans_service -->|"consulta y modifica"| node_prisma
node_applications_service -->|"consulta y modifica"| node_prisma
node_catalog_services -->|"accede a datos"| node_prisma
node_prisma -.->|"persiste datos"| node_postgres
node_app -->|"inicia tarea"| node_cleanup
node_cleanup -->|"limpia expirados"| node_revocations
node_app -->|"expone documentación"| node_swagger
node_schemas -->|"documenta operaciones"| node_swagger

click node_app "https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/app.js"
click node_user_routes "https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/routes/usuariosRoutes.js"
click node_artisan_routes "https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/routes/artesanosRoutes.js"
click node_application_routes "https://github.com/emanuel-ramayo/poncho-digital-api/tree/main/src/routes"
click node_validation "https://github.com/emanuel-ramayo/poncho-digital-api/tree/main/src/middlewares"
click node_artisans_validation "https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/validators/artesanosValidator.js"
click node_applications_validation "https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/validators/postulacionesValidator.js"
click node_products_validation "https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/validators/productosValidator.js"
click node_users_validation "https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/validators/usuariosValidator.js"
click node_users_controller "https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/controllers/usuariosController.js"
click node_artisans_controller "https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/controllers/artesanosController.js"
click node_applications_controller "https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/controllers/postulacionesController.js"
click node_catalog_controllers "https://github.com/emanuel-ramayo/poncho-digital-api/tree/main/src/controllers"
click node_users_service "https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/services/usuariosService.js"
click node_artisans_service "https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/services/artesanosService.js"
click node_applications_service "https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/services/postulacionesService.js"
click node_catalog_services "https://github.com/emanuel-ramayo/poncho-digital-api/tree/main/src/services"
click node_authn "https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/middlewares/autenticacionMiddleware.js"
click node_authz "https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/middlewares/autorizacionMiddleware.js"
click node_tokens "https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/services/tokensService.js"
click node_revocations "https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/services/revocacionesService.js"
click node_cleanup "https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/tareas/limpiezaRevocaciones.js"
click node_prisma "https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/config/prisma.js"
click node_schemas "https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/documentacion/esquemas.js"
click node_swagger "https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/app.js"

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_user_routes,node_artisan_routes,node_application_routes,node_validation,node_artisans_validation,node_applications_validation,node_products_validation,node_users_validation,node_client toneBlue
class node_users_controller,node_artisans_controller,node_applications_controller,node_catalog_controllers,node_users_service,node_artisans_service,node_applications_service,node_catalog_services toneAmber
class node_authn,node_authz,node_tokens,node_revocations,node_cleanup toneMint
class node_prisma,node_postgres toneRose
class node_schemas,node_swagger toneIndigo
```

## Components

### API HTTP

- [Aplicación Express](https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/app.js): `src/app.js`
- [Rutas usuarios](https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/routes/usuariosRoutes.js): `src/routes/usuariosRoutes.js`
- [Rutas artesanos](https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/routes/artesanosRoutes.js): `src/routes/artesanosRoutes.js`
- [Rutas catálogo y solicitudes](https://github.com/emanuel-ramayo/poncho-digital-api/tree/main/src/routes): `src/routes`
- [Validación de entrada](https://github.com/emanuel-ramayo/poncho-digital-api/tree/main/src/middlewares): `src/middlewares`
- [Esquemas artesanos](https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/validators/artesanosValidator.js): `src/validators/artesanosValidator.js`
- [Esquemas postulaciones](https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/validators/postulacionesValidator.js): `src/validators/postulacionesValidator.js`
- [Esquemas productos](https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/validators/productosValidator.js): `src/validators/productosValidator.js`
- [Esquemas usuarios](https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/validators/usuariosValidator.js): `src/validators/usuariosValidator.js`

### Gestión de dominio

- [Controlador usuarios](https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/controllers/usuariosController.js): `src/controllers/usuariosController.js`
- [Controlador artesanos](https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/controllers/artesanosController.js): `src/controllers/artesanosController.js`
- [Controlador postulaciones](https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/controllers/postulacionesController.js): `src/controllers/postulacionesController.js`
- [Controladores catálogo](https://github.com/emanuel-ramayo/poncho-digital-api/tree/main/src/controllers): `src/controllers`
- [Servicio usuarios](https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/services/usuariosService.js): `src/services/usuariosService.js`
- [Servicio artesanos](https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/services/artesanosService.js): `src/services/artesanosService.js`
- [Servicio postulaciones](https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/services/postulacionesService.js): `src/services/postulacionesService.js`
- [Servicios catálogo](https://github.com/emanuel-ramayo/poncho-digital-api/tree/main/src/services): `src/services`

### Identidad y acceso

- [Autenticación JWT](https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/middlewares/autenticacionMiddleware.js): `src/middlewares/autenticacionMiddleware.js`
- [Autorización por rol](https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/middlewares/autorizacionMiddleware.js): `src/middlewares/autorizacionMiddleware.js`
- [Tokens JWT](https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/services/tokensService.js): `src/services/tokensService.js`
- [Revocaciones](https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/services/revocacionesService.js): `src/services/revocacionesService.js`
- [Limpieza periódica](https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/tareas/limpiezaRevocaciones.js): `src/tareas/limpiezaRevocaciones.js`

### Persistencia

- [Cliente Prisma](https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/config/prisma.js): `src/config/prisma.js`
- **PostgreSQL**

### Documentación API

- [Esquemas OpenAPI](https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/documentacion/esquemas.js): `src/documentacion/esquemas.js`
- [Swagger UI](https://github.com/emanuel-ramayo/poncho-digital-api/blob/main/src/app.js): `src/app.js`

### Other components

- **Cliente HTTP**

## Connections

- Cliente HTTP → Aplicación Express: envía solicitudes
- Aplicación Express → Rutas usuarios: monta rutas (evidence: `src/app.js`)
- Aplicación Express → Rutas artesanos: monta rutas (evidence: `src/app.js`)
- Aplicación Express → Rutas catálogo y solicitudes: monta rutas (evidence: `src/app.js`)
- Rutas usuarios → Validación de entrada: aplica validación (evidence: `src/routes/usuariosRoutes.js`)
- Rutas artesanos → Validación de entrada: aplica validación (evidence: `src/routes/artesanosRoutes.js`)
- Rutas catálogo y solicitudes → Validación de entrada: aplica validación (evidence: `src/routes/postulacionesRoutes.js`)
- Validación de entrada → Esquemas artesanos: valida datos (evidence: `src/middlewares/validarArtesanos.js`)
- Validación de entrada → Esquemas postulaciones: valida datos (evidence: `src/middlewares/validarPostulaciones.js`)
- Validación de entrada → Esquemas productos: valida datos (evidence: `src/middlewares/validarProductos.js`)
- Validación de entrada → Esquemas usuarios: valida datos (evidence: `src/middlewares/validarUsuarios.js`)
- Rutas usuarios → Controlador usuarios: despacha a (evidence: `src/routes/usuariosRoutes.js`)
- Rutas usuarios → Autenticación JWT: ejecuta autenticación (evidence: `src/routes/usuariosRoutes.js`)
- Rutas artesanos → Controlador artesanos: despacha a (evidence: `src/routes/artesanosRoutes.js`)
- Rutas catálogo y solicitudes → Controlador postulaciones: despacha a (evidence: `src/routes/postulacionesRoutes.js`)
- Rutas catálogo y solicitudes → Controladores catálogo: despacha a (evidence: `src/routes/productosRoutes.js`)
- Controlador usuarios → Servicio usuarios: invoca (evidence: `src/controllers/usuariosController.js`)
- Controlador artesanos → Servicio artesanos: invoca (evidence: `src/controllers/artesanosController.js`)
- Controlador postulaciones → Servicio postulaciones: invoca (evidence: `src/controllers/postulacionesController.js`)
- Controladores catálogo → Servicios catálogo: invoca (evidence: `src/controllers/productosController.js`)
- Controlador usuarios → Tokens JWT: genera token (evidence: `src/controllers/usuariosController.js`)
- Autenticación JWT → Tokens JWT: verifica token (evidence: `src/middlewares/autenticacionMiddleware.js`)
- Autenticación JWT → Revocaciones: consulta revocación (evidence: `src/middlewares/autenticacionMiddleware.js`)
- Autorización por rol → Servicio usuarios: carga usuario (evidence: `src/middlewares/autorizacionMiddleware.js`)
- Servicio usuarios → Cliente Prisma: consulta y modifica (evidence: `src/services/usuariosService.js`)
- Servicio artesanos → Cliente Prisma: consulta y modifica (evidence: `src/services/artesanosService.js`)
- Servicio postulaciones → Cliente Prisma: consulta y modifica (evidence: `src/services/postulacionesService.js`)
- Servicios catálogo → Cliente Prisma: accede a datos (evidence: `src/services/productosService.js`)
- Cliente Prisma → PostgreSQL: persiste datos
- Aplicación Express → Limpieza periódica: inicia tarea (evidence: `src/app.js`)
- Limpieza periódica → Revocaciones: limpia expirados (evidence: `src/tareas/limpiezaRevocaciones.js`)
- Aplicación Express → Swagger UI: expone documentación (evidence: `src/app.js`)
- Esquemas OpenAPI → Swagger UI: documenta operaciones
