AVISA - Sistema de Quejas y Sugerencias
Plataforma completa de gestión de quejas y sugerencias para proyectos de infraestructura con gateway multicanal y notificaciones en tiempo real
Desafío & Solución
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.
Detalles del Proyecto
Consultora Guayacán
Sistema Web Completo
2025
Stack Tecnológico
Node.js + Express
Backend robusto con 45+ endpoints REST
PostgreSQL
Base de datos con 11 tablas optimizadas
JWT Authentication
Sistema de autenticación seguro con 4 roles
WebSocket
Notificaciones en tiempo real
Chart.js
Visualización de estadísticas y tendencias
QRCode.js
Generación de códigos QR dinámicos
Características Destacadas
Gateway Multicanal
Acceso vía códigos QR ubicados en sitios de proyectos con redirección a WhatsApp, Web, Teléfono y Email
Seguridad Robusta
Autenticación JWT con 4 roles (admin, supervisor, auditor, público), rate limiting y audit log completo
Notificaciones en Tiempo Real
Sistema WebSocket con notificaciones de escritorio y audio para reportes nuevos
Panel Administrativo
Dashboard completo con estadísticas en tiempo real, gráficos interactivos y filtros avanzados
Gestión Social Integrada
Módulos de stakeholders, gestión de riesgos y evaluaciones sociales
Arquitectura Modular
22 módulos independientes con reducción de complejidad del 89% en archivo principal
Implementación Técnica
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)
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
Sistema de Notificaciones
WebSocket implementado para notificaciones push en tiempo real con soporte para notificaciones de escritorio del navegador y alertas de audio personalizadas
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
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
Métricas del Sistema
Impacto del Proyecto
AVISA representa una solución completa y escalable para la gestión de quejas y sugerencias en proyectos de infraestructura. El sistema facilita la participación ciudadana mediante múltiples canales de acceso, mientras proporciona a los administradores herramientas poderosas para gestionar, analizar y dar seguimiento a todos los reportes de manera eficiente y transparente.
AVISA - Sistema de Quejas y Sugerencias¿Necesitas un Sistema de Gestión Personalizado?
Transformemos tu visión en una realidad digital excepcional.