How emanuel-ramayo/poncho-digital-api works
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: middlewares Validación de entrada · app.js Aplicación Express · prisma.js Cliente Prisma · usuariosRoutes.js Rutas usuarios
Components 27
API HTTP
- Aplicación Express
src/app.js - Rutas usuarios
src/routes/usuariosRoutes.js - Rutas artesanos
src/routes/artesanosRoutes.js - Rutas catálogo y solicitudes
src/routes - Validación de entrada
src/middlewares - Esquemas artesanos
src/validators/artesanosValidator.js - Esquemas postulaciones
src/validators/postulacionesValidator.js - Esquemas productos
src/validators/productosValidator.js - Esquemas usuarios
src/validators/usuariosValidator.js
Gestión de dominio
- Controlador usuarios
src/controllers/usuariosController.js - Controlador artesanos
src/controllers/artesanosController.js - Controlador postulaciones
src/controllers/postulacionesController.js - Controladores catálogo
src/controllers - Servicio usuarios
src/services/usuariosService.js - Servicio artesanos
src/services/artesanosService.js - Servicio postulaciones
src/services/postulacionesService.js - Servicios catálogo
src/services
Identidad y acceso
- Autenticación JWT
src/middlewares/autenticacionMiddleware.js - Autorización por rol
src/middlewares/autorizacionMiddleware.js - Tokens JWT
src/services/tokensService.js - Revocaciones
src/services/revocacionesService.js - Limpieza periódica
src/tareas/limpiezaRevocaciones.js
Persistencia
- Cliente Prisma
src/config/prisma.js - PostgreSQL
Documentación API
- Esquemas OpenAPI
src/documentacion/esquemas.js - Swagger UI
src/app.js
Other components
- Cliente HTTP
Connections 33
- Cliente HTTP → Aplicación Express: envía solicitudes
- Aplicación Express → Rutas usuarios: monta rutas
src/app.js - Aplicación Express → Rutas artesanos: monta rutas
src/app.js - Aplicación Express → Rutas catálogo y solicitudes: monta rutas
src/app.js - Rutas usuarios → Validación de entrada: aplica validación
src/routes/usuariosRoutes.js - Rutas artesanos → Validación de entrada: aplica validación
src/routes/artesanosRoutes.js - Rutas catálogo y solicitudes → Validación de entrada: aplica validación
src/routes/postulacionesRoutes.js - Validación de entrada → Esquemas artesanos: valida datos
src/middlewares/validarArtesanos.js - Validación de entrada → Esquemas postulaciones: valida datos
src/middlewares/validarPostulaciones.js - Validación de entrada → Esquemas productos: valida datos
src/middlewares/validarProductos.js - Validación de entrada → Esquemas usuarios: valida datos
src/middlewares/validarUsuarios.js - Rutas usuarios → Controlador usuarios: despacha a
src/routes/usuariosRoutes.js - Rutas usuarios → Autenticación JWT: ejecuta autenticación
src/routes/usuariosRoutes.js - Rutas artesanos → Controlador artesanos: despacha a
src/routes/artesanosRoutes.js - Rutas catálogo y solicitudes → Controlador postulaciones: despacha a
src/routes/postulacionesRoutes.js - Rutas catálogo y solicitudes → Controladores catálogo: despacha a
src/routes/productosRoutes.js - Controlador usuarios → Servicio usuarios: invoca
src/controllers/usuariosController.js - Controlador artesanos → Servicio artesanos: invoca
src/controllers/artesanosController.js - Controlador postulaciones → Servicio postulaciones: invoca
src/controllers/postulacionesController.js - Controladores catálogo → Servicios catálogo: invoca
src/controllers/productosController.js - Controlador usuarios → Tokens JWT: genera token
src/controllers/usuariosController.js - Autenticación JWT → Tokens JWT: verifica token
src/middlewares/autenticacionMiddleware.js - Autenticación JWT → Revocaciones: consulta revocación
src/middlewares/autenticacionMiddleware.js - Autorización por rol → Servicio usuarios: carga usuario
src/middlewares/autorizacionMiddleware.js - Servicio usuarios → Cliente Prisma: consulta y modifica
src/services/usuariosService.js - Servicio artesanos → Cliente Prisma: consulta y modifica
src/services/artesanosService.js - Servicio postulaciones → Cliente Prisma: consulta y modifica
src/services/postulacionesService.js - Servicios catálogo → Cliente Prisma: accede a datos
src/services/productosService.js - Cliente Prisma → PostgreSQL: persiste datos
- Aplicación Express → Limpieza periódica: inicia tarea
src/app.js - Limpieza periódica → Revocaciones: limpia expirados
src/tareas/limpiezaRevocaciones.js - Aplicación Express → Swagger UI: expone documentación
src/app.js - Esquemas OpenAPI → Swagger UI: documenta operaciones