Catálogo maestro

Mapa navegable de la documentación de illanes00-datos

Estado: Activo — actualizado 2025-10-07 12:21 CLT. Responsable: Equipo datos.

Catálogo maestro de documentación

Este documento jerarquiza los artefactos relevantes del repositorio y sirve como punto único de navegación para personas y agentes. Usa la tabla inicial para saltar a cada tomo temático.

Tabla de tomos

Sección Descripción Índice resumido
01. Overview Contexto estratégico, arquitectura y UX TECH_OVERVIEW.md, ARCHITECTURE.md, PRODUCT_GUIDE.md
02. Planificación Backlog, handoff y coordinación diaria BACKLOG.md, AGENTS.md, PROMPTS_START.md
03. Operaciones y QA Runbooks, CI/CD, estándares y reportes de calidad OPERATIONS.md, DEPLOY_CI.md, DB_QUALITY.md
04. Datos y pipelines Inventario de dominios, metodologías y pipelines DATA_INVENTORY.md, FUNNEL_SPEC.md, LEGISLATIVE_INGEST.md
05. Observatorio y elecciones Forecast electoral, dashboards y playbooks POLLS_AND_FORECAST.md, FORECAST_PLAYBOOK.md, ELECTIONS_MODEL.sql
06. Recursos y anexos Catálogos visuales, reportes, notas y fichas EXPLORER_CHARTS.md, SECURITY_REPORT_BLOG.md, notes/

01. Overview

  1. TECH_OVERVIEW.md — Stack técnico, dependencias externas y pipelines clave.
  2. ARCHITECTURE.md — Diagramas lógicos/físicos y decisiones de infraestructura.
  3. PRODUCT_GUIDE.md — Propuesta de valor, journeys y prioridades UX.
  4. ROADMAP.md — Hitos próximos y visión ejecutiva resumida.
  5. MVP_MASTER_PLAN.md — Hoja de ruta extendida con fases y criterios DoD.
  6. MVP_TODO.md — Tareas heredadas aún no migradas al backlog activo.
  7. UX_PLAN.md — Principios de diseño, componentes y lineamientos de UI.
  8. PROJECT_ORGANIZATION_PLAN.md — Roles, responsables y gobernanza interna.

02. Planificación

  1. BACKLOG.md — Estado textual del backlog priorizado (sincronizado con frontend/assets/meta/tasks.json).
  2. frontend/assets/meta/tasks.json — Registro estructurado para automatizaciones externas.
  3. AGENTS.md — Protocolo operativo para agentes/LLMs (turnos, flujos y guardias).
  4. PROMPTS_START.md — Plantilla diaria de handoff y prompts base.
  5. COMMITS_OVERVIEW.md — Convenciones de ramas, commits y etiquetado semántico.
  6. API_STATUS_ROADMAP.md — Roadmap de confiabilidad y observabilidad API.
  7. MAINTENANCE_PLAN.md — Calendario preventivo y rutinas periódicas.

03. Operaciones y QA

  1. OPERATIONS.md — Runbooks de despliegue, systemd y salud del servicio.
  2. DEPLOY_CI.md — Pipelines CI/CD, gating y verificaciones post deploy.
  3. HANDOVER.md — Checklist de traspaso on-call y contactos de emergencia.
  4. API_ENDPOINTS.md — Inventario generado de endpoints y parámetros.
  5. FRONTEND_QUALITY.md — Criterios de QA e2e para la UI.
  6. DB_QUALITY.md — Chequeos automatizados de datos y reportes.
  7. STANDARDS.md — Convenciones transversales de datos, código y documentación.
  8. BUGLOG.md — Incidentes y remediaciones históricas.
  9. quickstarts.md — Guías rápidas para consultas habituales del portal.
  10. qa_results.md — Resultados de QA más recientes (resúmenes).
  11. quality_report.md — Informe extendido de calidad y métricas.
  12. remediation_report.md — Planes de remediación activos.
  13. revision_portal.md — Checklist funcional del portal web.
  14. todo.md — Lista táctica de pendientes operativos.

04. Datos y pipelines

  1. DATA_INVENTORY.md — Inventario de dominios, coberturas y responsables.
  2. DATA_LOAD_STATUS.md — Snapshot RAW→marts y estados de ingestión.
  3. ONTOLOGIES.md — Catálogos maestros, claves y crosswalks.
  4. METODOLOGIA.md — Definiciones, supuestos estadísticos y notas metodológicas.
  5. FUNNEL_SPEC.md — Reglas funcionales del funnel de seguridad.
  6. FUNNEL_MATRIX.md — Tasas y etapas por territorio para QA.
  7. AUDIT_POLICIALES_FISCALIA_GENDARMERIA.md — Hallazgos críticos de QA.
  8. GENDARMERIA_LOAD.md — Procedimiento reproducible de Gendarmería.
  9. CASEN_PIPELINE.md — Pipeline CASEN interoperable.
  10. COFOG_PIPELINE.md — Pipeline COFOG y mapeos presupuestarios.
  11. BCCH.md — Ingesta Banco Central, deflactores y población alternativa.
  12. DATA_CATALOG.md — Conveniencias, vistas y codebook principal.
  13. BACKLOG_PIPELINES.md — Pendientes técnicos de ingestión/API.
  14. LEGISLATIVE_INGEST.md — Ingesta de datos legislativos (Cámara/Senado).
  15. MODEL_LEGISLATION.md — Modelo relacional legislativo y convenciones.
  16. LEYCHILE.md — Descarga y snapshots del corpus Ley Chile.
  17. LEYCHILE_LLM.md — Integración del corpus con LLM/MCP.
  18. schema.md — Esquemas de base de datos y validaciones.

05. Observatorio y elecciones

  1. POLLS_AND_FORECAST.md — Ingestiones de encuestas y APIs asociadas.
  2. FORECAST_PLAYBOOK.md — Metodología y supuestos del forecast electoral.
  3. ELECTIONS_FORECAST.md — Configuración del dashboard público.
  4. BPS_electoral_forecast.md — Sustento estadístico y escenarios alternativos.
  5. budget_dashboard_roadmap.md — Roadmap del dashboard presupuestario.
  6. ELECTIONS_MODEL.sql — SQL canónico del modelo electoral (dev-friendly).

06. Recursos y anexos

  1. EXPLORER_CHARTS.md — Catálogo de visualizaciones en /explore.
  2. SECURITY_REPORT_BLOG.md — Guía del blog de seguridad pública.
  3. presupuesto_backend.md — Backend del dashboard presupuestario.
  4. presupuesto_2026_respuestas.md — FAQ y respuestas de prensa.
  5. notes/ — Apuntes y contexto adicional (estado Borrador).
  6. diagrams/ — Diagramas Mermaid y assets gráficos.
  7. frontend/assets/ — Recursos UI y publicaciones externas.
  8. reports/security/ — Borradores y anexos históricos (estado Borrador).
  9. sii_biotech/PROJECT_OVERVIEW.md — Documentación del subproyecto biotech.
  10. sii_biotech/tesis.md / sii_biotech/references.bib — Manuscrito y bibliografía asociada.

Apéndices útiles

  • manifest.json — Inventario máquina-legible (status, owner, path).
  • sections/*.md — Índices temáticos utilizados por agentes y handoffs.
  • Genera catálogo y grafo de esquemas ejecutando python -m tasks.export.schema_catalog_markdown y python -m tasks.export.schema_graph_export cuando necesites artefactos actualizados.

Nota: Si creas un nuevo documento, agrégalo en la sección correspondiente y actualiza docs/manifest.json con tasks.docs.docsync.