data/dataset_catalog_config.json; esta tabla

es solo orientativa. Detalle completo en AGENTS.md §2.

1. regiones — Capa derivada de regiones para filtros, joins y referencias administrativas de alto nivel. (PK: codigo_region) | Columna | Tipo | Ejemplo | |:---|:---|:---| | codigo_region | VARCHAR(2) | "01" | | nombre_region | VARCHAR | "Tarapacá" |

2. provincias — Capa derivada de provincias para cruces intermedios entre region y comuna. (PK: codigo_provincia) | Columna | Tipo | Ejemplo | |:---|:---|:---| | codigo_region | VARCHAR(2) | "01" | | nombre_region | VARCHAR | "Tarapacá" | | codigo_provincia | VARCHAR(3) | "011" | | nombre_provincia | VARCHAR | "Iquique" |

3. comunas — Base territorial normalizada para cruces por region, provincia y comuna. (PK: codigo_comuna) | Columna | Tipo | Ejemplo | |:---|:---|:---| | codigo_comuna | VARCHAR(5) | "01101" | | nombre_comuna | VARCHAR | "Iquique" | | nombre_comuna_clean | VARCHAR | "iquique" | | codigo_provincia | VARCHAR(3) | "011" | | codigo_region | VARCHAR(2) | "01" | | nombre_region | VARCHAR | "Tarapacá" | | latitud_cabecera | DOUBLE | -20.2138 | | longitud_cabecera | DOUBLE | -70.1508 | | poblacion_estimada | INTEGER | 223400 |

4. comunas_enriquecidas — Comunas con coordenadas de cabecera y poblacion estimada INE, listas para analisis territorial sin joins adicionales. (PK: codigo_comuna) | Columna | Tipo | Ejemplo | |:---|:---|:---| | codigo_comuna | VARCHAR(5) | "01101" | | nombre_comuna | VARCHAR | "Iquique" | | nombre_comuna_clean | VARCHAR | "iquique" | | codigo_provincia | VARCHAR(3) | "011" | | codigo_region | VARCHAR(2) | "01" | | latitud_cabecera | DOUBLE | -20.2138 | | longitud_cabecera | DOUBLE | -70.1508 | | poblacion_estimada | INTEGER | 223400 |

5. indicadores — Serie de indicadores economicos diarios de referencia para analisis y software. (PK: fecha, codigo_indicador) | Columna | Tipo | Ejemplo | |:---|:---|:---| | fecha | DATE | "2026-05-30" | | codigo_indicador | VARCHAR | "uf" | | valor | DOUBLE | 39420.5 |

6. censo_comunal — Perfil demografico comunal del Censo 2024 con sexo y grandes grupos de edad. (PK: codigo_comuna) | Columna | Tipo | Ejemplo | |:---|:---|:---| | codigo_region | VARCHAR(2) | "01" | | codigo_provincia | VARCHAR(3) | "011" | | codigo_comuna | VARCHAR(5) | "01101" | | nombre_comuna | VARCHAR | "Iquique" | | poblacion_censada | INTEGER | 223400 | | hombres / mujeres | INTEGER | "111200 / 112200" | | razon_hombre_mujer | DOUBLE | 99.11 | | poblacion_0_14 … poblacion_65_mas | INTEGER | "5 tramos etarios" |

7. censo_hogares_viviendas — Viviendas y hogares censados por comuna, ocupacion y tamano medio del hogar. (PK: codigo_comuna) | Columna | Tipo | Ejemplo | |:---|:---|:---| | codigo_comuna | VARCHAR(5) | "01101" | | viviendas_censadas | INTEGER | 85000 | | viviendas_particulares_ocupadas | INTEGER | 75000 | | viviendas_colectivas | INTEGER | 200 | | hogares_censados | INTEGER | 73000 | | promedio_personas_hogar | DOUBLE | 3.06 |

8. establecimientos_salud — Directorio vigente de establecimientos de salud con tipo, dependencia, urgencia y ubicacion. (PK: codigo_establecimiento) | Columna | Tipo | Ejemplo | |:---|:---|:---| | codigo_establecimiento | VARCHAR | "101101" | | nombre_establecimiento | VARCHAR | "Hospital Dr. Ernesto Torres Galdames" | | tipo_establecimiento | VARCHAR | "Hospital" | | nivel_atencion | VARCHAR | "Alta Complejidad" | | codigo_comuna | VARCHAR(5) | "01101" | | tiene_servicio_urgencia | VARCHAR | "SI" / "NO" | | latitud / longitud | DOUBLE | "Coordenadas geográficas" | | estado_funcionamiento | VARCHAR | "Vigente" |

9. distritos_electorales — Asociación de comunas a distritos electorales (diputados) y circunscripciones senatoriales. (PK: codigo_comuna) | Columna | Tipo | Ejemplo | |:---|:---|:---| | codigo_comuna | VARCHAR(5) | "01101" | | nombre_comuna | VARCHAR | "Las Condes" | | distrito_electoral | VARCHAR | "10" | | circunscripcion_senatorial | VARCHAR | "3" |

10. establecimientos_educacionales — Directorio oficial del Ministerio de Educación (MINEDUC) con Rol Base de Datos (RBD), ubicación y dependencia administrativa. (PK: rbd) | Columna | Tipo | Ejemplo | |:---|:---|:---| | rbd | VARCHAR | "1234-5" | | dv_rbd | VARCHAR | "4" | | nombre_establecimiento | VARCHAR | "Liceo Abate Molina" | | codigo_comuna | VARCHAR(5) | "01101" | | dependencia_administrativa | VARCHAR | "Municipal" | | latitud / longitud | DOUBLE | "Coordenadas geográficas" | | estado_funcionamiento | VARCHAR | "Vigente" |

11. finanzas_municipales — Indicadores financieros municipales anuales desde SINIM/SUBDERE. CAPA PARCIAL/CANDIDATO: 3 de 346 comunas (0.9%). Usar con precaución; no representa cobertura nacional. (PK: anio, codigo_comuna) | Columna | Tipo | Ejemplo | |:---|:---|:---| | anio | INTEGER | 2024 | | codigo_comuna | VARCHAR(5) | "01101" | | ingresos_totales / gastos_totales | DOUBLE | 245000000000.0 | | ingresos_propios_permanentes | DOUBLE | 162000000000.0 | | fondo_comun_municipal | DOUBLE | 39000000000.0 |

12. resultados_educacionales — Resultados educacionales agregados por comuna y año, sin registros personales. (PK: anio, codigo_comuna) | Columna | Tipo | Ejemplo | |:---|:---|:---| | anio | INTEGER | 2024 | | codigo_comuna | VARCHAR(5) | "01101" | | matricula_total | INTEGER | 122000 | | asistencia_promedio | DOUBLE | 86.2 | | tasa_aprobacion / tasa_retiro | DOUBLE | "91.4 / 4.5" |

13. indicadores_urbanos_siedu — Indicadores urbanos SIEDU en formato largo con cobertura comunal parcial esperada. (PK: anio, codigo_comuna, codigo_indicador) | Columna | Tipo | Ejemplo | |:---|:---|:---| | anio | INTEGER | 2024 | | codigo_comuna | VARCHAR(5) | "01101" | | codigo_indicador | VARCHAR | "siedu_acceso_areas_verdes" | | categoria | VARCHAR | "Espacio publico" | | valor / unidad | DOUBLE | "71.4 / "porcentaje" |

14. perfil_territorial_comunal — Perfil comunal curado que consolida DPA, censo, salud, educación, finanzas, SIEDU y distritos. (PK: codigo_comuna) | Columna | Tipo | Ejemplo | |:---|:---|:---| | codigo_comuna | VARCHAR(5) | "01101" | | poblacion_censada | INTEGER | 223400 | | establecimientos_salud_total | INTEGER | 140 | | establecimientos_educacionales_total | INTEGER | 410 | | distrito_electoral | VARCHAR | "10" | | crecimiento_natural_ultimo_anio | INTEGER | 12 | | anio_estadisticas_vitales | INTEGER | 2023 | | viviendas_autorizadas_ultimo_anio | INTEGER | 2451 | | superficie_autorizada_m2_ultimo_anio | INTEGER | 187320 | | anio_permisos_edificacion | INTEGER | 2023 | | mp25_promedio_ultimo_anio | DOUBLE | 18.4 | | anio_calidad_aire | INTEGER | 2026 |

15. empresas — Registro de Empresas y Sociedades (RES) con RUT, razon social, tipo societario, capital, fecha de constitucion y comuna de domicilio. (PK: rut) | Columna | Tipo | Ejemplo | |:---|:---|:---| | rut | VARCHAR | "76286049-K" | | razon_social | VARCHAR | "COMERCIALIZADORA EJEMPLO SPA" | | codigo_sociedad | VARCHAR | "SPA" | | capital | INTEGER | 5000000 | | fecha_actuacion | DATE | "2020-06-15" | | anio | INTEGER | 2020 | | comuna_tributaria | VARCHAR | "SANTIAGO" | | region_tributaria | VARCHAR | "13" |

16. pobreza_comunal — Estimaciones de pobreza comunal por ingresos y multidimensional derivadas de la encuesta CASEN mediante metodología SAE (Estimación de Áreas Pequeñas). Incluye tasa, límite inferior y superior del intervalo de confianza por comuna, año y dimensión. (PK: codigo_comuna, anio, dimension) | Columna | Tipo | Ejemplo | |:---|:---|:---| | codigo_region | VARCHAR(2) | "01" | | codigo_comuna | VARCHAR(5) | "01101" | | nombre_comuna | VARCHAR | "Santiago" | | anio | INTEGER | 2022 | | dimension | VARCHAR | "ingresos" / "multidimensional" | | tasa | DOUBLE | 15.3 | | limite_inferior | DOUBLE | 12.1 | | limite_superior | DOUBLE | 18.9 | | metodologia | VARCHAR | "SAE" | | fuente | VARCHAR | "Observatorio Social — MDS" |

17. consumo_electrico_comunal — Consumo eléctrico anual por comuna y tipo de cliente (Residencial, Comercial, Industrial, Agrícola, Alumbrado Público, Otros), publicado por la Comisión Nacional de Energía (CNE) en el portal Energía Abierta. DEPRECATED: la fuente Junar de energiaabierta.cl fue decomisionada (investigado 2026-07-07); el dataset solo publica datos de muestra (FALLBACK_ROWS), no está en el bundle público. Ver data/source_registry.json. (PK: codigo_comuna, anio, tipo_cliente) | Columna | Tipo | Ejemplo | |:---|:---|:---| | codigo_region | VARCHAR(2) | "01" | | codigo_comuna | VARCHAR(5) | "01101" | | nombre_comuna | VARCHAR | "Santiago" | | anio | INTEGER | 2023 | | tipo_cliente | VARCHAR | "Residencial" | | consumo_kwh | DOUBLE | 1523400.5 | | numero_clientes | INTEGER | 45800 | | fuente | VARCHAR | "CNE — Energía Abierta" |

18. partidos_politicos — Roster de partidos políticos de Chile (Cámara de Diputadas y Diputados), con estado_legal y fecha_constitucion completados por join de nombre contra el registro público de SERVEL. (PK: id_partido) | Columna | Tipo | Ejemplo | |:---|:---|:---| | id_partido | VARCHAR | "DC" | | nombre | VARCHAR | "Partido Demócrata Cristiano" | | sigla | VARCHAR | "DC" | | estado_legal | VARCHAR | "constituido" (nulo si no matchea con SERVEL)" | | fecha_constitucion | DATE | "1988-05-02" | | ambito | VARCHAR | "null (sin fuente que lo provea)" | | fuente | VARCHAR | "Cámara de Diputadas y Diputados" |

19. autoridades_electas — Autoridades electas en ejercicio de Chile (diputados y senadores): partido, distrito electoral/circunscripción senatorial, región y período de mandato. (PK: id_autoridad) | Columna | Tipo | Ejemplo | |:---|:---|:---| | id_autoridad | VARCHAR | "diputado_1009" | | nombre | VARCHAR | "Jorge Alessandri Vergara" | | cargo | VARCHAR | "diputado" / "senador" | | institucion | VARCHAR | "Cámara de Diputadas y Diputados" / "Senado" | | partido | VARCHAR | "Unión Demócrata Independiente" | | distrito_electoral | VARCHAR | "10" (solo diputados)" | | circunscripcion_senatorial | VARCHAR | "3" (solo senadores)" | | codigo_region | VARCHAR(2) | "02" (solo senadores)" | | periodo_inicio / periodo_fin | DATE | "2026-03-11 / 2030-03-10" | | estado_mandato | VARCHAR | "vigente" |

20. estadisticas_vitales — Nacimientos y defunciones por comuna de residencia y sexo, desde los Anuarios de Estadísticas Vitales del INE (definitivos, 2010 en adelante). (PK: anio, codigo_comuna, evento, sexo) | Columna | Tipo | Ejemplo | |:---|:---|:---| | anio | INTEGER | 2023 | | codigo_region | VARCHAR(2) | "13" | | codigo_comuna | VARCHAR(5) | "13101" | | nombre_comuna | VARCHAR | "Santiago" | | evento | VARCHAR | "nacimiento" | | sexo | VARCHAR | "hombre" | | cantidad | INTEGER | 4521 | | estado_dato | VARCHAR | "definitivo" | | fuente | VARCHAR | "Instituto Nacional de Estadísticas (INE) — Estadísticas Vitales" | | url_fuente | VARCHAR | "https://www.ine.gob.cl/docs/default-source/.../2023/....xlsx" | | fecha_fuente | VARCHAR | "2026-09-14" |

21. permisos_edificacion — Viviendas en unidades y superficie (m2) por comuna y año —casas y departamentos— desde las estadísticas de permisos de edificación del CEDOC (MINVU), serie desde 2002. (PK: anio, codigo_comuna) | Columna | Tipo | Ejemplo | |:---|:---|:---| | anio | INTEGER | 2023 | | codigo_region | VARCHAR(2) | "13" | | codigo_comuna | VARCHAR(5) | "13101" | | nombre_comuna | VARCHAR | "Santiago" | | unidades_total | INTEGER | 2451 | | superficie_m2_total | INTEGER | 187320 | | unidades_casas | INTEGER | 312 | | superficie_m2_casas | INTEGER | 24810 | | unidades_departamentos | INTEGER | 2139 | | superficie_m2_departamentos | INTEGER | 162510 | | estado_dato | VARCHAR | "definitivo" | | fuente | VARCHAR | "MINVU — Centro de Estudios de Ciudad y Territorio (CEDOC)" | | url_fuente | VARCHAR | "https://catalogo.minvu.cl/cgi-bin/koha/opac-retrieve-file.pl?id=..." | | fecha_fuente | VARCHAR | "2026-09-15" |

22. calidad_aire — Promedios diarios de contaminantes atmosféricos (MP2.5, MP10, SO2, NO2, CO, O3) por estación de monitoreo, desde el SINCA (MMA). Cobertura parcial: ~65 comunas con estación. (PK: fecha, id_estacion, codigo_contaminante) | Columna | Tipo | Ejemplo | |:---|:---|:---| | fecha | VARCHAR | "2026-09-14" | | id_estacion | VARCHAR | "271" | | nombre_estacion | VARCHAR | "Quilicura" | | codigo_region | VARCHAR(2) | "13" | | codigo_comuna | VARCHAR(5) | "13144" | | nombre_comuna | VARCHAR | "Quilicura" | | latitud | DOUBLE | -33.36 | | longitud | DOUBLE | -70.73 | | codigo_contaminante | VARCHAR | "mp25" | | nombre_contaminante | VARCHAR | "MP 2,5" | | unidad | VARCHAR | "ug/m3" | | valor_promedio_diario | DOUBLE | 18.4 | | valor_max_horario | DOUBLE | 42.0 | | horas_validas | INTEGER | 24 | | estado_dato | VARCHAR | "definitivo" | | fuente | VARCHAR | "SINCA — Ministerio del Medio Ambiente" | | url_fuente | VARCHAR | "https://sinca.mma.gob.cl/index.php/json/listadomapa2k19/" | | fecha_fuente | VARCHAR | "2026-09-15" |

23. geometria_comunal — Límites poligonales de las 346 comunas de Chile (GeoParquet, geometría 'generalizada' — simplificada para cartografía a escala nacional, no apta para trabajo de precisión geodésica ni catastral). Fuente: BCN ArcGIS (tematico/Comunas_Generalizadas). Artefacto separado de comunas, unido por codigo_comuna. (en carril candidate — datos no incluidos en el bundle público) (PK: codigo_comuna) | Columna | Tipo | Ejemplo | |:---|:---|:---| | codigo_region | VARCHAR(2) | "01" | | codigo_comuna | VARCHAR(5) | "01101" | | nombre_comuna | VARCHAR | "Iquique" | | nombre_comuna_clean | VARCHAR | "iquique" | | nombre_region | VARCHAR | "Región de Tarapacá" | | geometry | BINARY | "WKB — Polygon o MultiPolygon en EPSG:4326 (WGS84), geoparquet 1.0" |

24. delincuencia_comunal — DEPRECATED 2026-09-15: Casos policiales de Delitos de Mayor Connotación Social (DMCS) y otras categorías por comuna y mes. Sin fuente estructurada oficial (solo scraping frágil) y no redistribuible; extractor neutralizado y fuera del scrape mensual. Ver docs/datasets/delincuencia_comunal.md. (en carril candidate — datos no incluidos en el bundle público) (PK: anio, mes, codigo_comuna, familia_delito) | Columna | Tipo | Ejemplo | |:---|:---|:---| | codigo_comuna | VARCHAR(5) | "01101" | | nombre_comuna | VARCHAR | "Santiago" | | anio | INTEGER | 2024 | | mes | INTEGER | 1 | | familia_delito | VARCHAR | "robos_violentos" | | casos | INTEGER | 245 |

25. autoridades_locales — Autoridades locales/subnacionales de Chile: gobernadores regionales (Wikipedia, CC-BY-SA) y alcaldes (BCN SIIT, dato público gubernamental). Wikipedia se mantiene como fuente de gobernadores y enriquecimiento opcional de periodo_inicio para alcaldes. Dataset segregado de autoridades_electas por licencia mixta. (en carril candidate — datos no incluidos en el bundle público) (PK: id_autoridad) | Columna | Tipo | Ejemplo | |:---|:---|:---| | id_autoridad | VARCHAR | "gobernador_01" | | nombre | VARCHAR | "null si no hay evidencia clara del titular" | | cargo | VARCHAR | "gobernador_regional" / "alcalde" | | codigo_region | VARCHAR(2) | "01" | | codigo_comuna | VARCHAR(5) | "01101" (solo alcaldes)" | | partido | VARCHAR | "nulo si no identificado" | | estado_mandato | VARCHAR | "vigente" / "sin_identificar" |

``mermaid erDiagram REGIONES { VARCHAR codigo_region PK "Ej: '01' (Tarapacá)" VARCHAR nombre_region } PROVINCIAS { VARCHAR codigo_provincia PK "Ej: '011' (Iquique)" VARCHAR codigo_region FK VARCHAR nombre_provincia } COMUNAS { VARCHAR codigo_comuna PK "Ej: '01101' (Iquique)" VARCHAR codigo_provincia FK VARCHAR codigo_region FK VARCHAR nombre_comuna VARCHAR nombre_comuna_clean "Ej: 'iquique' (sin tildes)" } COMUNAS_ENRIQUECIDAS { VARCHAR codigo_comuna PK VARCHAR nombre_comuna DOUBLE latitud_cabecera DOUBLE longitud_cabecera INTEGER poblacion_estimada } CENSO_COMUNAL { VARCHAR codigo_comuna PK INTEGER poblacion_censada INTEGER hombres INTEGER mujeres INTEGER poblacion_0_14 } CENSO_HOGARES_VIVIENDAS { VARCHAR codigo_comuna PK INTEGER viviendas_censadas INTEGER hogares_censados DOUBLE promedio_personas_hogar } ESTABLECIMIENTOS_SALUD { VARCHAR codigo_establecimiento PK VARCHAR codigo_comuna FK VARCHAR nombre_establecimiento VARCHAR tipo_establecimiento } DISTRITOS_ELECTORALES { VARCHAR codigo_comuna PK VARCHAR distrito_electoral VARCHAR circunscripcion_senatorial } ESTABLECIMIENTOS_EDUCACIONALES { VARCHAR rbd PK "Rol Base de Datos" VARCHAR codigo_comuna FK VARCHAR nombre_establecimiento

... (README truncated for length)