Estado del documento
Versión 0.1 · 12 de mayo de 2026
Manual vivo para auditoría inicial del producto público. Debe actualizarse cuando cambien fuentes, módulos, lógica de cálculo o condiciones de despliegue.
Manual técnico · auditoría
HydroRisk: manual técnico para revisión institucional
Documento de apoyo para hidrólogos, ingenieros informáticos, revisores técnicos y autoridades que necesiten evaluar el alcance funcional, las fuentes, los límites y el comportamiento esperado de HydroRisk.
Producto revisado
HydroRisk en https://terranava.org/hydrorisk/. Herramienta web de lectura hidrológica y territorial preliminar, con datos precargados y fuentes públicas declaradas.
1 · Alcance de auditoría
Qué debe evaluar este manual
La auditoría debe comprobar que HydroRisk comunica correctamente su alcance, que las interfaces son legibles, que las funciones principales responden y que las salidas no presentan como oficial aquello que es derivado, preliminar o referencial.
Funcional
Módulos y flujos
Verificar carga, búsqueda, selección, filtros, cambio de país, lectura de series, cálculos preliminares y salida PDF.
Hidrológico
Lectura prudente
Revisar que riesgo, IDF, SCS, caudal y cuencas estén explicados como apoyo preliminar y no como dictamen técnico final.
Datos
Fuente y trazabilidad
Comprobar que el usuario distingue dato oficial, dato observado, referencia climática, capa abierta y derivado TerraNava.
UX
Legibilidad institucional
Detectar contrastes débiles, mapas ilegibles, textos redundantes, estados vacíos confusos y controles que no reflejen estado real.
2 · Arquitectura pública
Cómo está presentado HydroRisk en esta fase
HydroRisk se publica como herramienta web institucional. La capa pública prioriza flujos local-first, datasets precargados cuando es posible y estados neutros cuando una fuente externa no está integrada o no declara información suficiente.
Frontend
Aplicación web estática
La interfaz se entrega como página web pública con HTML, CSS y JavaScript. Los módulos principales deben funcionar sin requerir credenciales privadas del usuario final.
Datos
Precarga y fuentes públicas
Los flujos críticos se apoyan en catálogos o capas precargadas. Las integraciones externas se documentan cuando aportan contexto o descarga de referencia.
Estado neutro
Ausencia de dato sin error crudo
Si falta un dataset, la UI debe explicar el estado de forma sobria, sin mostrar errores técnicos como contenido principal ni inventar valores.
Sin promesa operativa
No SLA, no alerta oficial
La publicación pública no declara servicio 24/7, alerta oficial, pronóstico certificado ni sistema nacional de vigilancia.
3 · Módulos bajo revisión
Funciones principales y resultado esperado
| Módulo | Función esperada | Criterio de revisión |
|---|---|---|
| Mapa de riesgo | Lectura municipal o territorial con mapa, selección, modo de amenaza, exposición o prioridad y síntesis inferior. | El mapa debe ser protagonista, legible y coherente con la leyenda. No debe mostrar estaciones si existe módulo observacional separado. |
| Estaciones | Catálogo observacional con tipo de red, estado operativo, variables, acceso declarado y fuente. | No debe presentar 0/0/0 si existen estaciones disponibles. Si faltan datos, debe indicar estado neutro y no inventar acceso o actividad. |
| Series históricas | Búsqueda y visualización de series observadas o referencias climáticas por estación o ubicación. | Debe distinguir serie observada de referencia climática. Los gráficos deben ser legibles y no superponer texto. |
| IDF | Intensidades de diseño por duración y periodo de retorno para cribado técnico. | Debe comunicar que no reemplaza curvas oficiales calibradas ni diseño definitivo. |
| Evento SCS | Escenario preliminar lluvia-escorrentía con CN, Tc y resultado orientativo. | Debe mantenerse sincronizado con cuenca activa o declarar escenario manual cuando no exista selección. |
| Caudal | Cálculo preliminar de caudal con entradas manuales o transferencia desde IDF. | El resultado debe ser claro y el método racional debe presentarse como cribado, no como validación hidráulica. |
| Delimitación de cuencas | Mapa de cuencas, niveles HydroBASINS, ríos y ficha resumida de unidad activa. | Debe evitar capas auxiliares redundantes y mantener selección, ríos y contexto con contraste suficiente. |
| Metodología y reporte | Explicación de fuentes, cobertura, nivel de servicio y salida PDF. | Debe incluir límites de uso, fuente declarada y diferencia entre oficial, observado, derivado y referencial. |
4 · Checklist funcional
Pruebas mínimas antes de una revisión institucional
5 · Checklist visual
Legibilidad y presentación
6 · Gobernanza de datos
Reglas para no alucinar ni sobreinterpretar datos
HydroRisk debe conservar una política estricta: no inventar estados operativos, acceso, periodos, variables ni autoridad. Cuando la fuente no declara un campo, se comunica como no declarado o se omite.
Fuente primero
Citar origen y fecha
Cada dataset usado en salida institucional debe indicar organismo, nombre, cobertura y fecha visible o fecha de verificación.
No inventar
Acceso y operación declarados
Solo se usa público o no público cuando la fuente lo declara. Si no, se muestra acceso no declarado.
Separar origen
Oficial, abierto y derivado
Un cruce TerraNava no se presenta como dato oficial. Una capa abierta no se convierte en autoridad por aparecer en el visor.
Estado neutro
Faltantes sin ruido
La ausencia de datos debe producir una ficha neutra, no una alerta falsa ni un error técnico visible como contenido principal.
7 · Riesgos conocidos
Aspectos que requieren seguimiento
| Riesgo | Impacto | Control recomendado |
|---|---|---|
| Catálogos incompletos | El usuario puede interpretar ausencia de datos como ausencia de estaciones o riesgo. | Mostrar estado neutro, fecha de verificación y cobertura activa. |
| Dependencia de fuentes externas | Una API o servicio puede cambiar formato, disponibilidad o acceso. | Mantener fallback local, cache de datasets críticos y mensajes no técnicos. |
| Contraste cartográfico | Un mapa ilegible reduce confianza aunque el dato sea correcto. | Auditar paletas, leyendas, popups y visibilidad en escritorio y móvil. |
| Interpretación excesiva | Una lectura preliminar puede usarse indebidamente como conclusión oficial. | Repetir límites de uso en módulo, reporte y documentación pública. |
8 · Mantenimiento
Rutina recomendada antes de auditorías
Conclusión operativa
HydroRisk debe sentirse sobrio, no infalible
La herramienta gana credibilidad cuando declara límites, muestra fuentes y conserva una interfaz legible. La auditoría debe premiar prudencia, trazabilidad y estabilidad funcional.
Contacto de revisión
Para revisión técnica externa: contacto@terranava.org. Indicar módulo, territorio, fecha, navegador y evidencia de la incidencia.