Sistema OPS — Reportes de Servicios Públicos
Versión 1.0.0

Sistema OPS

Dirección de Servicios Públicos — Municipio Diego Ibarra, Mariara, Estado Carabobo. Gestión integral de reportes ciudadanos para las divisiones de Sistema Eléctrico, Redes Cloacas y Acueducto, y Mantenimiento de Espacios Públicos.

¿Qué es el Sistema OPS?

Es un plugin para WordPress que permite a la Dirección de Servicios Públicos del municipio recibir, gestionar y dar seguimiento a los reportes ciudadanos sobre incidencias en los servicios públicos, todo de forma centralizada, digital y en tiempo real.

Reportes Ciudadanos

Los vecinos reportan incidencias con foto, ubicación exacta en mapa y detalles del problema.

Gestión por Divisiones

Cada división ve solo sus reportes y actualiza el estatus: En el sitio, En camino, Trabajando, Resuelto.

Dashboard y Estadísticas

Paneles con gráficos, mapa interactivo, alertas por tiempo y exportación a PDF.

¿Qué puedo hacer con el Sistema OPS?

Reportar Incidencias

Formulario ciudadano con validación de duplicados y datos completos:

  • Selección de sector en cascada: Parroquia → Circuito → Sector
  • Alerta de duplicados: si ya hay reportes activos en el sector se muestra un aviso antes de continuar
  • ¿Reportado por VenApp?: opción Sí/No con campo para número de reporte
  • División y tipo de trabajo con lista dinámica según la división elegida
  • Detalles del incidente (textarea, mín. 20 caracteres)
  • Foto del incidente (JPG/PNG/WEBP, máx. 5 MB)
  • Mapa Leaflet con geolocalización automática y marcador arrastrable
  • Fecha/hora generadas automáticamente por el servidor
  • Resumen previo antes de enviar y confirmación con número de reporte único (RPT-AAAA-XXXXX)
Panel de Divisiones

Cada división accede con su usuario y contraseña a un panel exclusivo con sus reportes:

  • Tabla de reportes con columnas: N°, Sector, Tipo de trabajo, Fecha/hora, Estatus y tiempo transcurrido
  • Códigos de color por antigüedad: menos de 24h (verde), 1-3 días (amarillo), 4-7 días (naranja), +7 días (rojo con alerta)
  • Botones de estatus: Pendiente → En el sitio → En camino → Trabajando → Resuelto, cada uno registra fecha/hora automática
  • Notificaciones por correo al ciudadano en cada cambio de estatus
  • Modal de detalle con toda la información, foto, mapa Leaflet e historial de cambios
  • Filtros por estatus, sector y fecha
Panel de Dirección

Vista general para el/la Director/a de Servicios Públicos:

  • Dashboard con tarjetas de resumen: total reportes activos, por división y alertas de tiempo excedido
  • Gráfico de evolución diaria (Chart.js) por división y tipo de trabajo
  • Top 5 sectores con mayor incidencia
  • Promedio de resolución por división
  • Tabla maestra con todos los reportes de las 3 divisiones y filtros avanzados
  • Alertas de gestión: reportes con +7 días sin resolver con nota interna
Reportes PDF

Generación de documentos oficiales con FPDF:

  • Reporte diario: reportes del día seleccionado
  • Reporte semanal: reportes de la semana seleccionada
  • Reporte mensual: reportes del mes seleccionado
  • Rango personalizado: desde fecha X hasta fecha Y
  • Encabezado con logo de la Alcaldía, resumen estadístico, tabla detallada y pie con fecha de generación
  • Botón de descarga directa del PDF
Mapa y Estadísticas

Dos shortcodes públicos para visualización en tiempo real:

  • ops_mapa_municipio — Mapa Leaflet del Municipio Diego Ibarra con puntos rojos de reportes activos. Popups con resumen y filtro por división.
  • ops_estadisticas_mes — Gráficos Chart.js del mes actual: barras por división (pendientes vs resueltos), evolución diaria y tabla de alertas
  • Actualización automática cada 5 minutos vía AJAX
  • Diseñados para pantallas de presentación ante la Alcaldesa
Notificaciones y Encuestas

Cierre del ciclo del reporte con participación ciudadana:

  • Correo de confirmación al registrar el reporte
  • Notificaciones HTML automáticas en cada cambio de estatus
  • Al resolver: correo al ciudadano con botones "Confirmar solución" o "El problema persiste" (reactiva el reporte)
  • Encuesta de satisfacción con emojis del 1 al 5 y campo de observaciones
  • Recordatorio automático si el ciudadano no confirma en 5 días
  • Datos de encuesta almacenados y visibles en el panel de Dirección

¿Quiénes pueden usar el sistema?

Ciudadano

Se registra con sus datos (nombre, cédula, teléfono, correo), crea reportes con foto y ubicación, recibe notificaciones por correo, confirma soluciones y llena encuestas de satisfacción.

Divisiones

Eléctrico, Cloacas/Acueducto y Espacios Públicos. Cada división ve únicamente sus reportes, cambia estatus con fecha/hora automática y mantiene el histórico de acciones.

Director/a de Servicios Públicos

Acceso total al sistema: dashboard con gráficos, todos los reportes de las 3 divisiones, exportación a PDF, notas internas y alertas de gestión.

Recorrido por el Menú Administrativo

El menú OPS Reportes en el panel de WordPress organiza el sistema en las siguientes secciones (visible según el rol):

Dashboard

Pantalla de inicio con tarjetas de resumen (reportes activos, por división, alertas), tabla de resumen por división y tipo de trabajo, top 5 sectores, promedios de resolución, gráficos Chart.js (distribución por estatus, comparativa por división, evolución diaria) y acceso al listado completo.

Listado de Reportes

Vista maestra de todos los reportes con filtros avanzados: por división, estatus, sector y rango de fechas. Incluye modal de detalle con foto, mapa Leaflet, historial de cambios y nota interna.

Estadísticas

Panel con gráficos avanzados Chart.js: distribución mensual por división y tipo de trabajo, evolución temporal y tabla de alertas con reportes de mayor antigüedad.

Generar Reportes PDF

Centro de exportación PDF con 4 modalidades: diario, semanal, mensual y rango personalizado. Cada PDF incluye logo municipal, resumen estadístico y tabla detallada.

Sectores del Municipio

Catálogo de sectores organizados por Parroquia → Circuito → Sector. Gestión CRUD completa con datos importados desde sectores.sql.

Tipos de Trabajo

Catálogo de tipos de trabajo asociados a cada división. Incluye nombre, descripción y estado activo/inactivo.

Configuración

5 pestañas de configuración:

  • General: días de alerta, recordatorio encuesta, tamaño máx. de foto, página del ciudadano
  • Mapa: coordenadas centro y zoom inicial del Leaflet
  • Correo: remitente y nombre para notificaciones
  • Shortcodes: lista de códigos disponibles para copiar
  • Sistema: versiones del plugin, BD, WordPress y PHP

Divisiones y Tipos de Trabajo

El sistema organiza los reportes en tres divisiones, cada una con sus tipos de trabajo específicos:

Sistema Eléctrico
  • Alumbrado público: luminarias en calles, plazas y parques
  • Red de baja tensión: cortes puntuales, baja tensión, cables sueltos
  • Conexiones comunitarias: nuevos puntos para centros comunitarios y escuelas
  • Emergencias: tormentas, caída de postes, riesgos eléctricos
  • Pica y poda: árboles que interfieren con líneas eléctricas
Redes Cloacas y Acueducto
  • Desobstrucciones: desagües tapados, cloacas llenas, malos olores
  • Reparación de roturas: averías de agua potable, pérdidas, hundimientos
  • Supervisión: sustitución de tramos caídos de colectores
  • Bocas de visita: limpieza y reparación de tapas de inspección
  • Atención a inundaciones: zonas bajas con acumulación de agua
Espacios Públicos
  • Parques y plazas: corte de césped, poda, juegos y bancos
  • Limpieza de calles: barrido manual/mecánico, residuos voluminosos
  • Caminos peatonales: rampas de accesibilidad, baldosas rotas, obstáculos

Flujo Completo del Sistema

1

Ciudadano
se registra

2

Crea reporte
con foto y ubicación

3

Correo
de confirmación

4

División
atiende y cambia estatus

5

Resuelto
notificación al ciudadano

6

Encuesta
de satisfacción

En cada cambio de estatus se registra automáticamente la fecha, hora y el usuario que realizó la acción. Todo el histórico queda almacenado y visible en el detalle del reporte.

Shortcodes Disponibles

Estos códigos se insertan en cualquier página de WordPress para mostrar los formularios y paneles del sistema:

Shortcode Descripción
ops_ciudadano Portal ciudadano unificado: inicio de sesión, registro, panel de reportes y nuevo reporte en una sola página.
ops_panel_division Panel interno para jefes de división: lista de reportes de su división con filtros y cambio de estatus.
ops_mapa_municipio Mapa interactivo Leaflet con puntos rojos de reportes activos en el Municipio Diego Ibarra.
ops_estadisticas_mes Estadísticas públicas del mes: totales por división, gráficos y tabla de alertas.

Preguntas Frecuentes

¿Cómo empiezo a usar el sistema?

Como ciudadano: ve a la página con el shortcode ops_ciudadano, regístrate con tus datos y comienza a reportar incidencias.

Como división o director: el administrador del sitio te creará un usuario con el rol correspondiente. Ingresa a la página del panel y empieza a gestionar.

¿Cómo se evitan los reportes duplicados?
Al seleccionar un sector, el sistema consulta automáticamente si hay reportes activos (pendientes o en proceso) en ese mismo sector. Si existen, muestra un aviso amarillo y la lista de reportes activos para que verifiques antes de crear uno nuevo.
¿Puedo adjuntar foto al reporte?
Sí. El formulario permite subir 1 foto en formato JPG, PNG o WEBP con un tamaño máximo de 5 MB. La foto se almacena en una carpeta segura dentro de wp-content/uploads/OPS/ con protección contra ejecución de scripts.
¿Cómo se usa la geolocalización?
Al cargar el formulario, el mapa Leaflet intenta obtener tu ubicación automática mediante el GPS del dispositivo. Puedes arrastrar el marcador para ajustar la posición exacta. Las coordenadas se guardan automáticamente.
¿Cómo recibo notificaciones?
Cada vez que tu reporte cambie de estatus (en el sitio, en camino, trabajando, resuelto), recibirás un correo electrónico automático con los detalles. También recibirás un correo cuando el reporte se marque como resuelto, con botones para confirmar o indicar que el problema persiste.
¿Cómo funciona la encuesta de satisfacción?
Cuando confirmas que tu reporte fue solucionado, se te presenta una encuesta con emojis del 1 al 5 (desde muy insatisfecho hasta muy satisfecho) y un campo opcional de observaciones. Tus respuestas ayudan a mejorar el servicio.
¿Qué pasa si un reporte no se resuelve a tiempo?
El sistema marca automáticamente los reportes que superan el límite de días configurado (por defecto 7 días) como alertas rojas. Estos aparecen destacados en el dashboard de la Dirección y se puede agregar una nota interna explicando el motivo de la demora.
¿En qué formatos puedo exportar los datos?
Actualmente se exporta en PDF con formato oficial, logo del municipio y datos institucionales, en 4 modalidades: diario, semanal, mensual o rango personalizado.

Soporte Técnico

Desarrollado por Julio González Bencomo (Jg)

¿Dudas, problemas o ayuda para configurar el sistema? Contacte al desarrollador:

Portafolio Web