RewardFlow Enterprise — Documentación técnica
Versión 1.0 · 2026-06-13 · Stack: React + Vite + Node + Express + MySQL 8
Arquitectura
Backend en capas: routes → controllers → services → models (MySQL). Frontend SPA React 18 en /admin/. Landing comercial en /.
- API:
/api/v1/*— JWT Bearer - Webhooks:
/api/v1/webhooks/*— públicos - Health:
/health,/api/health - OpenAPI:
/api-docs
Módulos MVP
| # | Módulo | Endpoints clave |
|---|---|---|
| 1 | Usuarios / Auth | POST /auth/login, GET /auth/me |
| 2 | Portal social | GET/POST /posts |
| 3 | Concursos | GET /contests, POST /contests/:id/entries |
| 4 | Prode | GET /tournaments, POST /matches/:id/predictions |
| 5 | Puntos | GET /points |
| 6 | Beneficios | GET /benefits/products, POST redeem |
| 7 | Referidos | GET/POST /referrals |
| 8 | Reconocimientos | POST /recognitions |
| 9 | Comunicación | GET /announcements, /notifications |
| 10 | Gamificación | GET /badges, /challenges |
| 11 | Workflows | GET/POST /workflows/:id/transition |
| 12 | Dashboard | GET /dashboard |
Roles y permisos
| Rol | Código | Acceso |
|---|---|---|
| Empleado | employee | Social, concursos, prode, puntos, beneficios, referidos |
| Supervisor | supervisor | + reconocimientos de equipo |
| RRHH | hr | Referidos, usuarios, validaciones |
| Marketing | marketing | Concursos, prode, campañas |
| Comunicación | communication | Publicaciones, anuncios |
| Administrador | admin | Acceso total |
| Auditor | auditor | Logs de auditoría, lectura |
Workflows configurables
- publication: draft → review → approved → published
- contest: 7 estados hasta entrega
- redemption: solicitud → validación → aprobación → stock → entrega → confirmación
- referral: registro → RRHH → entrevista → contratación → beneficio
- recognition: registro → validación → publicación → acreditación
Enlaces
Stack plan · Evolutivos · API Swagger · Landing · App