Caso de estudio · 2025
AVISA - Sistema de Quejas y Sugerencias
Plataforma de gestión de quejas y sugerencias para proyectos de infraestructura, con gateway multicanal y notificaciones en tiempo real
- Cliente
- Consultora Guayacán
- Proyecto
- Sistema Web Completo
- Entrega
- 2025
Contexto y respuesta
El proyecto, sin adornos.
Desarrollé AVISA, un sistema integral de gestión de quejas y sugerencias para Consultora Guayacán. El sistema permite a los ciudadanos reportar problemas y sugerencias sobre proyectos de infraestructura mediante códigos QR ubicados en los sitios de proyectos, gateway multicanal y formularios web.
La arquitectura del sistema está construida con Node.js y Express, implementando una API REST completa con más de 45 endpoints. El sistema incluye autenticación JWT con 4 niveles de acceso (admin, supervisor, auditor, público), rate limiting para protección contra DoS, y un audit log completo de todas las acciones del sistema.
Una de las características más innovadoras es el gateway multicanal via códigos QR. Los códigos QR colocados en los sitios de proyectos redirigen a los ciudadanos a una página donde pueden elegir su canal de contacto preferido: WhatsApp, formulario web, teléfono o email, facilitando la participación ciudadana independientemente de sus preferencias tecnológicas.
Arquitectura
Tecnología con una función clara.
Cada herramienta se eligió por su aporte al rendimiento, la operación o la capacidad de crecimiento del proyecto.
- 01
Node.js + Express
Backend robusto con 45+ endpoints REST
- 02
PostgreSQL
Base de datos con 11 tablas optimizadas
- 03
JWT Authentication
Sistema de autenticación seguro con 4 roles
- 04
WebSocket
Notificaciones en tiempo real
- 05
Chart.js
Visualización de estadísticas y tendencias
- 06
QRCode.js
Generación de códigos QR dinámicos
Capacidades
Lo que hace posible.
- 01
Gateway Multicanal
Acceso vía códigos QR ubicados en sitios de proyectos con redirección a WhatsApp, Web, Teléfono y Email
- 02
Seguridad Robusta
Autenticación JWT con 4 roles (admin, supervisor, auditor, público), rate limiting y audit log completo
- 03
Notificaciones en Tiempo Real
Sistema WebSocket con notificaciones de escritorio y audio para reportes nuevos
- 04
Panel Administrativo
Dashboard completo con estadísticas en tiempo real, gráficos interactivos y filtros avanzados
- 05
Gestión Social Integrada
Módulos de stakeholders, gestión de riesgos y evaluaciones sociales
- 06
Arquitectura Modular
22 módulos independientes con reducción de complejidad del 89% en archivo principal
Construcción
Decisiones detrás del resultado.
Una mirada a las piezas técnicas que sostienen la experiencia y facilitan su mantenimiento.
- 01
API REST Completa
45+ endpoints organizados en 10 archivos de rutas con middleware de autenticación, validación y rate limiting (máx 100 requests/15min)
- 02
Base de Datos Optimizada
11 tablas PostgreSQL con ~150 campos, índices optimizados y relaciones eficientes. Incluye tablas para proyectos, reportes, usuarios, stakeholders, riesgos y audit log
- 03
Sistema de Notificaciones
WebSocket implementado para notificaciones push en tiempo real con soporte para notificaciones de escritorio del navegador y alertas de audio personalizadas
- 04
Seguridad Multi-Capa
Protección SQL injection, validación de archivos, CORS configurado, rate limiting por IP, audit log de todas las acciones y tokens JWT con expiración
01
Módulos Principales
Sistema de Autenticación
JWT con tokens de 8 horas, password hashing con bcrypt y protección contra ataques de fuerza bruta
Gateway de Proyectos
Sistema de códigos QR que redirige a múltiples canales de contacto según preferencia del usuario
Gestión de Reportes
CRUD completo con subida de archivos (hasta 5), tracking con número de seguimiento y sistema de comentarios
Panel de Estadísticas
Gráficos dinámicos con Chart.js mostrando tendencias, distribución por estado y proyectos más reportados
02
Métricas del Sistema
Resultado
AVISA - Sistema de Quejas y Sugerencias
Impacto del proyecto
AVISA gestiona quejas y sugerencias en proyectos de infraestructura. La gente reporta por el canal que prefiera (QR, WhatsApp, web o correo) y los administradores dan seguimiento a cada caso desde un panel con estadísticas en tiempo real.
El siguiente paso