How elpocho304/api_rest-poncho_digital works
Poncho Digital is a REST API for public catalog browsing and administrator-managed artisan registration and fair layout, plus artisan-owned product management. Requests enter through Express route modules, which dispatch to controllers and services; Prisma provides persistence. Authentication checks current account state and role on protected routes. The README documents the registration-approval and stand-assignment workflows; some service implementations were not sampled, so those internal links are omitted where call evidence is unavailable.
Main entry points: app.js Express app · prisma.js PostgreSQL via Prisma · autenticacion.js Token and role checks · productos.routes.js Product routes
Components 27
API entry and routing
- Express app
src/app.js - Artisan routes
src/routes/artesanos.routes.js - Product routes
src/routes/productos.routes.js - Venue routes
src/routes/pabellones.routes.js - Sector routes
src/routes/sectores.routes.js - Stand routes
src/routes/stands.routes.js - Authentication routes
src/routes/autenticacion.routes.js - Registration request routes
src/routes/solicitudRegistro.routes.js - Assignment routes
src/routes/asignacionesStand.routes.js - User administration routes
src/routes/usuarios.routes.js - Request validation
src/validators - API schemas
src/documentacion/esquemas.js
Identity and registration
- Token and role checks
src/middlewares/autenticacion.js - Login and registration
src/services/autenticacion.services.js - JWT tokens
src/services/tokens.service.js - Registration decisions
src/services/solicitudRegistro.services.js
Catalog and venue
- Artisan profiles
src/services/artesanos.services.js - Product catalog
src/services/productos.services.js - Pavilions
src/services/pabellones.services.js - Sectors
src/services/sectores.services.js - Stands
src/services/stands.services.js
Administration and assignment
- Stand assignments
src/services/asignacionesStand.services.js - Account administration
src/services/usuarios.services.js - PostgreSQL via Prisma
src/config/prisma.js
Other components
- API clients
- Administrator
- Artisan
Connections 37
- API clients → Express app: sends requests
src/app.js - Express app → Artisan routes: mounts routes
src/app.js - Express app → Product routes: mounts routes
src/app.js - Express app → Venue routes: mounts routes
src/app.js - Express app → Sector routes: mounts routes
src/app.js - Express app → Stand routes: mounts routes
src/app.js - Express app → Authentication routes: mounts routes
src/app.js - Express app → Registration request routes: mounts routes
src/app.js - Express app → Assignment routes: mounts routes
src/app.js - Express app → User administration routes: mounts routes
src/app.js - Artisan routes → Artisan profiles: dispatches profile actions
- Product routes → Product catalog: dispatches product actions
- Venue routes → Pavilions: dispatches pavilion actions
- Sector routes → Sectors: dispatches sector actions
src/routes/sectores.routes.js - Stand routes → Stands: dispatches stand actions
- Authentication routes → Login and registration: dispatches authentication
src/routes/autenticacion.routes.js - Registration request routes → Registration decisions: dispatches decisions
- Assignment routes → Stand assignments: dispatches assignments
- User administration routes → Account administration: dispatches account actions
- Authentication routes → Token and role checks: validates login
src/routes/autenticacion.routes.js - Product routes → Token and role checks: checks artisan role
src/routes/productos.routes.js - Registration request routes → Token and role checks: requires admin
src/routes/solicitudRegistro.routes.js - Assignment routes → Token and role checks: requires admin
src/routes/asignacionesStand.routes.js - Token and role checks → JWT tokens: verifies token
src/middlewares/autenticacion.js - Token and role checks → PostgreSQL via Prisma: rechecks account
src/middlewares/autenticacion.js - Product catalog → PostgreSQL via Prisma: reads and writes
src/services/productos.services.js - Artisan profiles → PostgreSQL via Prisma: reads and writes
src/services/artesanos.services.js - Pavilions → PostgreSQL via Prisma: reads and writes
src/services/pabellones.services.js - Stands → PostgreSQL via Prisma: reads and writes
src/services/stands.services.js - Stand assignments → PostgreSQL via Prisma: updates assignments
src/services/asignacionesStand.services.js - Registration decisions → PostgreSQL via Prisma: persists decisions
src/services/solicitudRegistro.services.js - API clients → API schemas: documents API
- Administrator → Registration request routes: resolves applications
- Administrator → Assignment routes: assigns stands
- Artisan → Authentication routes: registers and logs in
- Artisan → Product routes: manages own products
- Administrator → User administration routes: manages accounts