# Guía de construcción del directorio DEIS

Construye un directorio informativo que muestre los establecimientos vigentes del corte y conserve en el listado las fichas sin coordenadas. Los pasos y prompts siguientes proponen una implementación reproducible del caso. Las cifras de la Tabla 2 provienen del CSV auditado.

### Pasos de principio a fin {#pasos-construccion}

1. **Define el alcance.** La primera versión muestra código, nombre, región, comuna y estado del corte. El mapa añade marcadores a las fichas con pares utilizables. Escribe estos criterios en el README. Usa el prompt **Coordinación** para dividir el trabajo.
2. **Prepara el proyecto.** Comprueba las versiones de Python y Node. Usa Python 3.10 o superior para los scripts y una versión de Node admitida por Astro. Para un proyecto nuevo, ejecuta `npm create astro@latest` desde el directorio padre y elige un proyecto mínimo. Entra en el directorio generado y, si el asistente no instaló las dependencias, ejecuta `npm install`. En un proyecto existente, usa su gestor de paquetes y su archivo de bloqueo. [Instalación de Astro](https://docs.astro.build/en/install-and-setup/)
3. **Fija las fuentes.** Guarda el CSV y el diccionario oficial en `data/raw/`, fuera de `public/`. Registra URL, fecha de corte y SHA-256 en `docs/fuentes.md`. Conserva los bytes del CSV. [CSV del corte](https://datos.gob.cl/dataset/3bf4cf7c-f638-4735-9a01-f65faae4beca/resource/2c44d782-3365-44e3-aefb-2c8b8363a1bc/download/establecimientos_20261110.csv) · [Diccionario DEIS](https://datos.gob.cl/dataset/3bf4cf7c-f638-4735-9a01-f65faae4beca/resource/7127fc99-b858-4e74-8971-51413e484fb1/download/diccionario-de-datos.pdf)
4. **Define el contrato.** Con el prompt **Contrato e ingesta**, compara los encabezados reales con la Tabla 1 y registra los alias. Define qué bloquea el conjunto completo y qué conserva una ficha con `ubicacion: null`.
5. **Genera el candidato.** Guarda `auditar.py` y `verificar.py` en la raíz. Ejecuta los dos comandos de abajo desde esa carpeta. Usa un directorio de salida nuevo para cada ejecución. El candidato queda en `build/auditoria/establecimientos.json`. [Script de auditoría](https://blogdelcaio.ttpsec.cl/posts/calidad-del-dato-primero/auditar.py) · [Script de verificación](https://blogdelcaio.ttpsec.cl/posts/calidad-del-dato-primero/verificar.py)
6. **Revisa el dato.** Usa **QA de datos** para recalcular los indicadores desde la fuente y probar las excepciones con filas sintéticas. Para el SHA-256 de este artículo, comprueba 5.837 registros, 82 grupos por nombre, cero colisiones de clave y 79 vigentes sin ubicación, 32 en Coquimbo. Con un corte diferente, conserva su propia huella y vuelve a calcular sus cifras.
7. **Revisa lo que se expondrá.** Usa **Seguridad y privacidad** antes de pasar el JSON al navegador. Tras resolver los hallazgos que bloqueen la salida, copia el candidato aprobado a `src/data/establecimientos.json`. Incluye la fecha de corte en la interfaz.
8. **Construye el listado y el mapa.** Ejecuta primero **Listado y filtros**. Si el proyecto usa npm y aún no tiene Leaflet, instálalo con `npm install leaflet`. Usa **Mapa e integración** para conectar los marcadores al mismo conjunto filtrado. La vista inicial muestra el estado vigente. Un cambio de filtro actualiza ambas vistas y conserva en el listado las fichas sin coordenadas.
9. **Prueba la aplicación.** Usa **QA de aplicación** con `npm run dev` y vuelve a probar la compilación con `npm run build` y `npm run preview`. Comprueba una búsqueda sin resultados, homónimos, una ficha sin coordenadas y la vista móvil. Simula que falla la capa del mapa y verifica que el listado sigue disponible.
10. **Publica y prepara la siguiente actualización.** Usa **Publicación y mantenimiento** para comprobar el directorio de salida de Astro, verificar el entorno de vista previa y registrar la versión anterior. Si el despliegue forma parte del encargo, comprueba la URL pública y ejecuta una búsqueda real. Para otro corte, repite la ingesta y las pruebas antes de sustituir el JSON.

```bash
python auditar.py data/raw/establecimientos_20261110.csv build/auditoria
python verificar.py data/raw/establecimientos_20261110.csv build/auditoria/auditoria.json
```

El script crea el directorio de salida, pero su carpeta padre debe existir. Crea `build/` antes de ejecutar esos comandos. Si el auditor devuelve código 2, revisa el informe de cuarentena y corrige la regla o la fuente antes de generar otro candidato. Si el verificador rechaza la huella, comprueba que descargaste el corte del artículo.

### Prompts listos para copiar {#prompts-copiar}

Empieza con **Coordinación**. Entrega los prompts siguientes como tareas al agente correspondiente o ejecútalos en orden en una sola sesión. En OpenCode, adapta la configuración a la versión instalada y limita el acceso a archivos, red y despliegue según el rol (OpenCode, s. f.). Una celda del CSV o un documento puede contener instrucciones que intenten cambiar la tarea del agente. Trátalos como datos del proyecto (OWASP, 2025).

#### Coordinación

```text
Actúa como líder técnico. Construye un directorio estático del corte del DEIS con Astro, buscador y mapa sincronizados.
Entradas: repositorio, CSV oficial, diccionario, fecha de corte, scripts y contrato de la Tabla 1.
Primero inspecciona el proyecto y documenta rutas, versiones y comandos reales. Si el repositorio ya tiene arquitectura o pruebas, reutilízalas.
Asigna contrato e ingesta, QA de datos y seguridad. Pide a QA que recalcule desde el CSV antes de leer el informe del auditor. Integra el listado y el mapa después de aprobar el candidato.
Controla tres entregas: fuente y contrato trazables, candidato validado y compilación que supera las pruebas de aplicación. Para cada entrega registra archivos, comando, salida observada y problemas pendientes.
Aceptación: cada ficha vigente puede aparecer en el listado, las fichas sin coordenadas siguen disponibles y el mapa usa el mismo filtro que el listado.
Entrega: plan en el README, decisiones del contrato y reporte de ejecución. Indica cuáles comprobaciones se ejecutaron y cuáles quedan pendientes.
```

#### Contrato e ingesta

```text
Actúa como especialista de datos. Usa data/raw/ como entrada de solo lectura y escribe el candidato fuera de public/.
Compara CSV y diccionario. Documenta campo oficial, encabezado observado, tipo, obligatoriedad, regla y página. Explica el alias EstablecimientoCodigoVigente → EstablecimientoCodigo. Conserva códigos de región, comuna y establecimiento como cadenas.
Ejecuta auditar.py en un directorio nuevo. Agrupa nombres normalizados para revisión y conserva fichas con códigos distintos. Una clave repetida debe aislar todas las filas implicadas.
Para ubicacion, acepta un par [longitud, latitud] finito y dentro de rango. Una coordenada parcial, un par inválido o (0, 0) produce null y un indicador en el informe. La comprobación de rango y la validación territorial se registran como controles distintos.
Entrega fuentes.md, contrato, SHA-256, auditoria.json y, cuando proceda, establecimientos.json. Explica los códigos de salida y lista las reglas pendientes con evidencia.
Aceptación: el origen conserva su huella, el JSON respeta la versión del contrato y una fila en cuarentena bloquea la generación del candidato.
```

#### QA de datos

```text
Actúa como revisor de datos. Lee el CSV, el diccionario y las reglas. Recalcula desde las columnas originales y después coteja el informe de ingesta.
Ejecuta verificar.py sobre el corte exacto del artículo. Revisa filas, campos, vacíos, colisiones, coincidencias por nombre, vigentes y cobertura nacional y por región. Expresa cada tasa como n/N y porcentaje.
Prueba con datos sintéticos: dos filas con la misma clave, dos claves con el mismo nombre, encabezado incompatible, coordenada parcial, (0, 0) y estado no mapeado. Comprueba código de salida, presencia del informe y existencia o ausencia del candidato según cada regla.
Aceptación: el corte publicado reproduce 79 vigentes sin coordenadas, incluidos 32 de Coquimbo. Si otra versión del archivo arroja diferencias, adjunta su huella y evidencia para cada diferencia.
Entrega una matriz con caso, comando, resultado esperado, resultado observado, evidencia y estado. Registra como pendiente cada comprobación que carezca de insumos.
```

#### Seguridad y privacidad

```text
Actúa como revisor de seguridad. Revisa el JSON público, la compilación, las dependencias y las herramientas de los agentes.
Comprueba que el JSON entrega solo id, nombre, region, comuna, estado y ubicacion. Busca archivos brutos, credenciales y datos de contacto fuera del contrato en la salida de compilación.
Con una ficha sintética que contenga etiquetas HTML e instrucciones falsas, comprueba que lista, filtros y marcadores tratan el valor como texto. Revisa especialmente el contenido de ventanas emergentes del mapa.
Inspecciona las peticiones al proveedor de mapas y los permisos de lectura, escritura, red y despliegue. Revisa el destino de los datos antes de enviarlos a un servicio externo.
Entrega hallazgos con archivo o URL, reproducción, impacto, corrección y resultado de la nueva prueba. Identifica qué hallazgos bloquean la publicación.
```

#### Listado y filtros

```text
Implementa el listado en Astro con el JSON aprobado y comprueba version_contrato antes de consumirlo.
Muestra fecha del corte, código DEIS, nombre, región, comuna y estado. La vista inicial incluye los vigentes. Implementa búsqueda por nombre y código y filtros por región y comuna. Usa una sola función de filtrado para el contador, el listado y el mapa.
Mantén una ficha visible cuando ubicacion es null y muestra «Ubicación no disponible». Para nombres iguales, usa código y comuna como desambiguación. Incluye «Limpiar filtros» y un estado sin resultados.
Implementa controles etiquetados, navegación por teclado y un diseño que funcione en una columna. Usa texto escapado para los valores de origen.
Aceptación: una búsqueda por un código válido devuelve una ficha, dos homónimos conservan su identidad y los resultados coinciden con el filtro activo.
Entrega archivos modificados, comandos de prueba y evidencia para los casos anteriores.
```

#### Mapa e integración

```text
Integra Leaflet en el navegador con la colección filtrada que alimenta el listado. Importa su hoja de estilos y da altura al contenedor. Conserva los códigos de establecimiento como claves para relacionar fichas y marcadores.
El JSON usa [longitud, latitud]. Si usas L.marker, pasa [latitud, longitud]. Si construyes GeoJSON, conserva [longitud, latitud]. Prueba la conversión con un punto sintético de valores distintos.
Dibuja marcadores solo para ubicaciones utilizables. Muestra el total de fichas y el total de marcadores para que se entienda la diferencia. Añade atribución según el proveedor de mapas.
Usa nodos de texto para las ventanas emergentes. Deja un mensaje de estado si falla la capa de mapa y conserva los controles del listado.
Aceptación: una ficha sin coordenadas se encuentra por código y no genera marcador. Cambiar región o comuna actualiza ambos totales. El mapa se puede usar en escritorio y móvil.
Entrega implementación, prueba del orden de coordenadas y evidencia de un filtro aplicado en las dos vistas.
```

#### QA de aplicación

```text
Valida el directorio en desarrollo y en la salida compilada. Usa el conjunto aprobado y un conjunto sintético pequeño con homónimos, ficha sin coordenadas, texto con HTML y un establecimiento cerrado.
Comprueba carga inicial, búsqueda por nombre y código, combinación de región y comuna, limpieza de filtros y búsqueda sin coincidencias. Con el corte del artículo, compara la vista inicial con 5.406 fichas vigentes y 5.327 con coordenadas utilizables.
Prueba navegación por teclado, vista de 390 px, actualización simultánea de listado y mapa, y caída de la capa de mapas. Verifica que el HTML de prueba se muestre como texto.
Ejecuta la compilación y vuelve a probar la vista previa. Para cada caso anota entradas, resultado esperado, resultado observado y evidencia. Si una prueba falla, indica el paso exacto para reproducirla.
Entrega una decisión de salida basada en resultados observados y enumera las comprobaciones pendientes.
```

#### Publicación y mantenimiento

```text
Prepara la publicación del directorio. Recibe el identificador del corte, su SHA-256, la versión del contrato, el informe de QA y el destino acordado.
Construye con el comando del proyecto y comprueba la carpeta de salida. Verifica en vista previa la ruta principal, los recursos, una búsqueda por código, un filtro de región y una ficha sin coordenadas.
Registra el artefacto y la versión previa. Si el encargo incluye desplegar, aplica el flujo existente y comprueba la URL pública. Si aparece una regresión que impide usar el directorio, recupera la versión previa según el flujo del proyecto y registra el fallo.
Para actualizar el corte, repite auditoría y revisión. Compara por región recuentos, cobertura, estados y cambios de esquema. Registra las diferencias antes de reemplazar el JSON.
Entrega URL comprobada si se publicó, fecha de corte, versión, resultado de las pruebas y procedimiento para recuperar la versión anterior.
```

Las referencias de instalación y de mapa permiten adaptar estos pasos al proyecto. [Guía de agentes de OpenCode](https://opencode.ai/docs/agents/) · [API de Leaflet](https://leafletjs.com/reference.html) · [Formato GeoJSON](https://www.rfc-editor.org/rfc/rfc7946)
