Explorador atómico del Knowledge Graph — Región del Biobío
[ Pre-MVP más reciente · 2026 ]
Qué es
Un mapa interactivo (MapLibre GL) para explorar el Knowledge Graph atómico de la Región del Biobío de mi Tesina del Magíster en Ciencia de Datos para la Innovación (MACI), Universidad de Concepción: 23.266 unidades atómicas (manzanas censales y entidades rurales) más 719 unidades vecinales, instanciadas como 597.807 tripletas RDF.
Propósito
Dar acceso real a los datos que el KG atómico ya contiene por manzana o entidad rural — a una persona vía el mapa, y a un LLM vía el servidor MCP — sin depender de que el experimento predictivo paralelo tenga éxito.
Arquitectura: un solo módulo de consulta, tres puertas de entrada
Toda la lógica de consulta vive en un único módulo Python determinista. La API REST y el servidor MCP son adaptadores delgados sobre ese módulo — ninguno reimplementa lógica propia, así que un humano y un LLM consultan exactamente los mismos datos con exactamente la misma lógica. Es el mismo principio que ya validé en Pharos.
🗺️ Mapa
MapLibre GL, sin build step. Colorea por población, índice de precariedad (BVI), score estructural o nivel de riesgo experimental; clic en una unidad abre su panel de detalle.
🔌 API REST
FastAPI. Sirve el GeoJSON por comuna y el detalle de cada unidad (población, BVI, amenazas, scores) al mapa.
🤖 Servidor MCP
Transporte stdio (Claude Desktop/Code). 6 tools: consultar una unidad, sus vecinas, una unidad vecinal, listar por comuna, la cascada de afectación comuna→unidad vecinal→manzana, y un glosario.
Por qué importa el MCP aquí
Cada tool del servidor MCP declara en su propia descripción el estado de validación del dato que devuelve — para que un LLM que la consuma no presente como certeza una estimación de investigación. Es la misma regla de no-fusión de scores aplicada también a cómo un modelo de lenguaje puede (y no puede) hablar de estos datos.
Qué muestra el panel de detalle
- Población y jerarquía territorial (Censo 2024)
- Vulnerabilidad biocultural (BVI): las dimensiones biológica, cultural y socioeconómica
- Exposición a amenazas — cada una con su procedencia declarada: solo tsunami es una relación real del grafo; remoción en masa e incendio forestal son datos tabulares, no relacionales; la amenaza volcánica solo existe a nivel comunal
- Dos bloques de riesgo, nunca combinados en un solo número: el score estructural (Capa 3, validado parcialmente contra tsunami) y el nivel de riesgo del experimento paralelo KG-vs-tabular (experimental, veredicto H0)
Esa regla de no-fusión existe porque ya se detectó una vez el problema contrario: combinar amenaza × BVI por producto anulaba la vulnerabilidad cuando la amenaza era 0. El panel de detalle y las tools del MCP la aplican como invariante, no como corrección puntual.
Por qué es el pre-MVP más central
Es la primera implementación ejecutable de CQ-16 (cascada de afectación comuna → unidad vecinal → manzana), una Competency Question de la ontología que hasta ahora estaba diseñada pero sin código que la respondiera bajo demanda. También materializa el "endpoint del MVP" descrito en la arquitectura de tres capas de la tesina: dado un punto o una unidad atómica del Biobío, devolver su score de riesgo desagregado y su posición relativa dentro de la comuna.
Alcance y límites
Cubre solo la Región del Biobío (33 comunas) — es la única región con un KG RDF atómico realmente instanciado. Es una herramienta de investigación local, sin autenticación: decisión de diseño declarada explícitamente, no un descuido. No corre expuesta remotamente.
El otro pre-MVP de esta tesina
También existe un mockup interactivo del panel operativo de riesgo territorial.
Ver el mockup del panel de riesgo →