SIGRAN-LabCapa Estratégica de Datos e IA
Ingresar a la Plataforma
DOCUMENTACIÓN FUNCIONAL Y OPERATIVA

Manual de Usuario y Guía de Operación — SIGRAN-Lab

Directrices operativas para que los funcionarios del DAGRAN y coordinadores autorizados interactúen de manera eficaz con el ecosistema SIGRAN-Lab, en cumplimiento de los criterios de usabilidad y seguridad digital (Resolución MinTIC 1519 de 2020, Ley 1581 de 2012 y MIPG).

← Volver a la Landing del ProyectoIngresar (/login)
SECCIÓN 1

1. Acceso a la Plataforma, Invitaciones y Roles

El acceso a SIGRAN-Lab está controlado mediante un esquema de autenticación institucional por invitación, diseñado para proteger la integridad y trazabilidad de la información gestionada por el DAGRAN.

1.1 Inicio de sesión

  • Ingrese a la ruta /login de la plataforma e introduzca su correo electrónico institucional y su contraseña.
  • En su primer ingreso, si aún no ha definido su nombre de usuario y nombre completo, la plataforma le dirigirá automáticamente a /completar-perfil.

1.2 Flujo de invitación para nuevos usuarios

  • Emisión: Un usuario con rol de Administrador genera la invitación desde el panel interno (/admin/usuarios) asignando el rol correspondiente.
  • Recepción de enlace cifrado: El nuevo usuario recibe un correo oficial (enviado vía Azure Communication Services) con un enlace de activación temporal cifrado.
  • Activación: Al abrir el enlace (/activar-cuenta), el funcionario define su contraseña personal, nombre completo y usuario. Si el enlace vence, puede solicitar su reenvío desde la misma pantalla o al administrador.

1.3 Recuperación de contraseña y gestión de cuenta

En caso de olvido de contraseña, utilice el enlace 'Olvidé mi contraseña' en /login (/recuperar-contrasena) para recibir un enlace temporal de restablecimiento. Una vez dentro de la plataforma, puede actualizar sus datos o contraseña desde el menú de su avatar en la esquina superior derecha seleccionando 'Mi cuenta' (/mi-cuenta).

1.4 Perfiles y Roles de Usuario

Rol en la Plataforma Temáticas Habilitadas Funciones Administrativas
Administrador (platform_admin) AOAT, TR, MD, CRM WhatsApp y SIGRAN-Bot Invitación de usuarios, cambio de roles, eliminación, auditoría y sincronización de datos.
Usuario restringido (platform_restricted) AOAT y SIGRAN-Bot (según configuración de gobernanza vigente) Gestión de su propio perfil en /mi-cuenta.
SECCIÓN 3

3. Herramienta de Estadísticas, Filtros Dinámicos y Exportación CSV

La vista de Estadísticas constituye el punto de entrada al análisis cuantitativo y tabular de cada temática (AOAT, TR y MD).

  • Indicadores Clave (KPIs) y Gráficos: En la parte superior se calculan dinámicamente los totales de registros, municipios cubiertos, subregiones y distribuciones temáticas/temporales mediante Chart.js.
  • Filtros Multicriterio sin Recarga (HTMX): Seleccione rango de fechas, municipio, subregión, fenómeno amenazante, nivel de riesgo (AOAT), fondos de origen/destino (TR) o responsable (MD) y pulse 'Aplicar filtros'. Puede restablecer la vista en cualquier momento con el botón 'Limpiar'.
  • Tabla Interactiva y Panel de Detalle: Explore los registros paginados a la izquierda y haga clic sobre cualquier fila para inspeccionar su ficha detallada completa en el panel lateral derecho.
  • Exportación a CSV: Utilice el botón 'Descargar CSV' para exportar los registros y realizar análisis complementarios en hojas de cálculo.
SECCIÓN 4

4. Tablero Avanzado Geo-Relacional (Piloto AOAT)

Disponible en la pestaña 'Tablero Avanzado' del tópico AOAT, esta herramienta integra dos tecnologías avanzadas sincronizadas entre sí:

  • Mapa Hexagonal Uber H3 (Resolución 8): Agrupa espacialmente los reportes con coordenadas válidas en celdas hexagonales, calculando un puntaje ponderado de severidad (reportes, viviendas afectadas/evacuadas y población expuesta) categorizado en Crítico, Alto, Moderado o Bajo.
  • Grafo Relacional (vis-network): Representa municipios y fenómenos amenazantes como nodos y sus co-ocurrencias como enlaces, facilitando la identificación de clústeres territoriales de amenaza.
  • Interacción Sincronizada: Al filtrar por municipio o hacer clic sobre un hexágono o nodo del grafo, se despliega el panel lateral con el detalle de ubicación, amenaza e información técnica adicional.
SECCIÓN 5

5. SIGRAN-Bot: Chat Interactivo vs. Generador de Informes IA

SIGRAN-Bot opera en dos modalidades complementarias diseñadas según la profundidad analítica requerida por el funcionario:

Regla de Oro de Uso en SIGRAN-Bot

El Chat Interactivo es estrictamente para consultas rápidas y directas de datos. Las preguntas analíticas complejas o que requieran cruzar múltiples bases de datos (AOAT, TR y MD) y redactar documentos extensos deben ejecutarse en el Generador de Informes IA.

5.1 Modalidad 1: Chat Interactivo (Panel Izquierdo / Pestaña Asistente IA)

  • Escriba su pregunta en lenguaje natural o haga clic en una de las tarjetas de sugerencias rápidas (ej. '¿Cuáles son los 5 municipios con más reportes?').
  • El agente traduce la pregunta en consultas parametrizadas seguras (Function Calling) sobre la base de datos y responde con conteos, tendencias o resúmenes de hasta 5 registros.

5.2 Modalidad 2: Generador de Informes IA (Panel Derecho en SIGRAN-Bot)

  • Parámetros de entrada: Defina la Pregunta Central de Investigación (o título del informe), seleccione opcionalmente un municipio y rango de fechas, y marque las fuentes a cruzar (AOAT, TR, MD).
  • Generación estructurada: El sistema recopila la evidencia SQL de las tablas seleccionadas y redacta un documento técnico estructurado en Contexto, Contenido y Conclusión.
  • Formatos de descarga oficial: Descargue el resultado en formato Documento Word (.docx) listo para presentación institucional o en Markdown AI-Ready (.md) con metadatos YAML.
SECCIÓN 6

6. Módulo CRM Campañas WhatsApp ('DAGRAN a un Click')

Exclusivo para Administradores, este módulo permite auditar y analizar las campañas de comunicación bidireccional desplegadas vía WhatsApp hacia los CMGRD de Antioquia.

  • Alcance Único y Embudo de Conversión: Monitoree campañas totales, destinatarios únicos, tasa de respuesta general ponderada, tasa de inicio y retención entre la primera y la última pregunta.
  • Análisis por Tipo de Pregunta: Alterne entre las pestañas de Resumen, Preguntas Numéricas, Preguntas Abiertas y gráficos interactivos de Respuestas Categóricas.
  • Directorio de Usuarios Consolidados e Historial Individual: Muestra a los líderes territoriales que han validado tanto su municipio como su cargo actual. Haga clic sobre cualquier fila para consultar a la derecha el hilo completo de preguntas y respuestas de esa persona, o exporte el directorio a CSV.
SECCIÓN 7

7. Administración de Usuarios, Auditoría y Sincronización

Los usuarios con rol de Administrador disponen en el menú superior derecho (icono de iniciales) de las herramientas de gobierno de la plataforma:

  • Gestión de Usuarios (/admin/usuarios): Visualice el directorio de cuentas activas e invitaciones pendientes, envíe nuevas invitaciones por correo institucional, reenvíe enlaces, actualice el rol asignado (Administrador / Usuario restringido) o elimine accesos.
  • Registro de Auditoría (/admin/auditoria): Consulte la trazabilidad inmutable de eventos críticos (inicios de sesión, invitaciones, cambios de rol, consultas al asistente y generación de reportes).
  • Sincronización desde el Dashboard: En las vistas de estadísticas, los administradores cuentan con el control para sincronizar nuevos registros desde el FeatureServer institucional con barra de progreso y consola de logs en tiempo real.
SECCIÓN 8

8. Guía Rápida de Despliegue y Mantenimiento (sigran_pipeline)

Para los equipos de TI y Ciencia de Datos del DAGRAN, el repositorio incluye la aplicación web FastHTML y el servicio CLI de ingesta sigran_pipeline, gestionados con Python 3.13 y uv.

8.1 Comandos principales de operación local y CLI

# 1. Instalar dependencias y ejecutar el dashboard
uv sync
uv run app.py

# 2. Verificar configuración del pipeline por fuente
uv run sigran-pipeline --source-type INFORMES_TECNICOS check-config
uv run sigran-pipeline --source-type TRANSFERENCIA_RECURSOS check-config
uv run sigran-pipeline --source-type MANEJO_DESASTRES check-config

# 3. Ejecutar sincronización diaria desde ArcGIS FeatureServer
uv run sigran-pipeline daily
uv run sigran-pipeline --source-type TRANSFERENCIA_RECURSOS daily
uv run sigran-pipeline --source-type MANEJO_DESASTRES daily

8.2 Rutina recomendada de monitoreo institucional

Tarea Operativa Herramienta / Servicio Frecuencia Sugerida
Revisión de logs de la aplicación web Railway Logs / Panel de despliegue Continua
Monitoreo de almacenamiento y conexiones PostgreSQL Neon Tech Console Semanal
Control de consumo de tokens de modelos LLM Azure AI Foundry → Cost Analysis Mensual
Rotación de claves y secretos (.env) Variables de entorno en Railway / Servidor Trimestral