Reclamos Urbanos
Plataforma fullstack para la gestión de reclamos urbanos. Los ciudadanos pueden reportar problemas, los agentes municipales gestionan el flujo de estados y los administradores tienen visibilidad completa del sistema. Incluye autenticación, control de acceso por roles, historial de auditoría y CI/CD automatizado.
Stack Tecnológico
¿Qué resuelve?
Digitaliza el proceso de reporte y seguimiento de reclamos urbanos. Los ciudadanos reportan problemas geolocalizados, los agentes gestionan la resolución con flujo de estados controlado y los administradores tienen métricas y trazabilidad completa de cada reclamo.
Decisiones Técnicas
- 1
Arquitectura en capas (routers → dependencies → services → models) con separación estricta de responsabilidades — cambiar la lógica de negocio no requiere tocar los endpoints
- 2
RBAC granular por endpoint mediante dependency injection en FastAPI: cada ruta declara explícitamente el rol requerido sin lógica de autorización duplicada
- 3
Historial de estados inmutable (append-only) para auditoría completa — nunca se modifica un registro, solo se insertan nuevos, permitiendo reconstruir el ciclo de vida de cualquier reclamo
- 4
CI/CD con GitHub Actions: tests automáticos con cobertura mínima del 70% en cada PR, deploy automático a Render al publicar un release
- 5
Multi-stage Dockerfile (builder/runtime) para imagen de producción liviana sin compiladores ni dependencias de desarrollo
- 6
NullPool para conexión con Neon (PostgreSQL serverless) — evita conexiones idle que impiden la suspensión de la instancia
Capturas
Aún no se han añadido capturas.