caso de proyecto / operaciones
OpsFlow
Plataforma full-stack para gestionar incidencias operativas con roles, trazabilidad, evidencias privadas y métricas de estado.
Producto
Gestión de incidencias
Roles
Operator / Supervisor
Evidencias
S3 privado
Backend
NestJS + Prisma
contexto
Qué resuelve
OpsFlow es una demo funcional de una plataforma web full-stack para gestionar incidencias operativas. Permite registrar problemas, asignar responsables, seguir cambios de estado, comentar avances, adjuntar evidencias y revisar métricas generales desde un dashboard.
El desafío fue ordenar una experiencia para equipos operativos con distintos permisos, manteniendo trazabilidad, control de acceso, adjuntos privados y una arquitectura preparada para crecer sin mezclar responsabilidades.
solución
Decisiones principales
Se construyó una aplicación separada por features en React/Vite y un backend modular en NestJS. La autenticación usa JWT, las reglas se ordenan por roles, Prisma centraliza el modelo de datos y los archivos se suben a S3 mediante URLs firmadas para mantener el bucket privado.
Registro de incidencias con prioridad, categoría, creador y responsable.
Asignación de responsables y cambios de estado para supervisores.
Comentarios, historial y trazabilidad dentro de cada incidencia.
Adjuntos privados con URLs firmadas para escritura y lectura.
producto
Pantallas principales
Capturas reales de la demo para mostrar la experiencia operativa: estado general, tablero de trabajo y reportes.
arquitectura
Estructura técnica
- ▹ Frontend por features: auth, dashboard, incidents, profile, reports, users y shared.
- ▹ Backend por módulos: auth, incidents, comments, attachments, history, dashboard, users, storage y health.
- ▹ Base de datos PostgreSQL con Prisma, migraciones, seed y enums de dominio.
- ▹ Evidencias con AWS S3 privado usando URLs firmadas de escritura y lectura.
stack
Tecnologías usadas
OpsFlow