# Panel ciudadano del incendio de Las Peñas de Riglos

Web pública estática para reunir información oficial sobre el incendio forestal de Las Peñas de Riglos (Huesca). El panel prioriza claridad, trazabilidad, privacidad y seguridad informativa.

Web publicada: <https://www.custoscivis.org/>

> **No es una herramienta oficial de emergencias.** No sustituye los avisos de 112 Aragón, Protección Civil, CECOPI ni de ninguna autoridad. En caso de discrepancia, prevalecen siempre las instrucciones oficiales. Ante una emergencia, llama al 112.

Los datos incorporados enlazan su fuente y conservan su fecha de publicación. Los campos que el último parte no cuantifica —como el porcentaje de perímetro consolidado— permanecen vacíos aunque otras fuentes utilicen expresiones cualitativas.

## Características

- HTML5, CSS3 y JavaScript vanilla, sin compilación ni backend.
- Datos editables en JSON local.
- Mapa Leaflet con capas activables, estaciones AEMET, perímetro oficial, área quemada aproximada EFFIS y focos térmicos VIIRS opcionales.
- Resumen, evacuaciones, carreteras contrastadas con DGT, meteorología, lluvia útil, evolución y cronología.
- Tres estados de fiabilidad: `oficial`, `provisional` y `sin_actualizacion`.
- Gráfica SVG propia, accesible y sin dependencias adicionales.
- Diseño responsive, navegación por teclado y marcado semántico.
- Actualización automática cada 30 minutos de Aragón Hoy, DGT, AEMET, ICEARAGON y del área quemada satelital EFFIS.
- Sin cookies, formularios, autenticación, analítica, publicidad ni trackers propios.

## Ejecutar localmente

Los navegadores suelen impedir que una página abierta con `file://` lea archivos JSON por seguridad. Sirve la carpeta mediante HTTP local:

```bash
python -m http.server 8000
```

Después abre <http://localhost:8000/>. En Windows también puede usarse `py -m http.server 8000`. Otra opción es la extensión **Live Server** de Visual Studio Code.

No hacen falta `npm install`, Node.js, base de datos ni variables de entorno.

## Estructura

```text
.
├── index.html
├── README.md
├── LICENSE
├── css/
│   └── style.css
├── js/
│   ├── app.js
│   ├── map.js
│   └── charts.js
├── data/
│   ├── estado.json
│   ├── evacuaciones.json
│   ├── carreteras.json
│   ├── meteo.json
│   ├── cronologia.json
│   ├── fuentes.json
│   ├── perimetro.geojson
│   └── espacios-protegidos.geojson
├── scripts/
│   └── update_public_data.py
├── .github/workflows/
│   └── actualizar-datos.yml
└── assets/
    └── icons/
```

## Editar los JSON

### Reglas generales

1. Comprueba la publicación original y conserva su enlace directo.
2. Confirma que el emisor es una Administración u organismo oficial.
3. Copia el dato sin redondear, completar ni extrapolar.
4. Registra el enlace directo y la fecha/hora de la publicación.
5. Usa `null` si el valor es desconocido.
6. Valida los JSON antes de publicar.
7. Actualiza `ultima_comprobacion_panel` aunque no haya novedades; cambia `ultima_actualizacion_oficial` solo cuando se incorpore un parte nuevo.

Las fechas deben estar en ISO 8601 con zona horaria, por ejemplo `2026-08-16T10:01:00+02:00`.

### Estado general

Cada dato de `data/estado.json` contiene un valor y metadatos independientes. Así se evita atribuir a una fuente cifras que no publicó:

```json
{
  "superficie_ha": {
    "value": 16600,
    "meta": {
      "fecha_hora": "2026-08-16T10:01:00+02:00",
      "fiabilidad": "oficial",
      "fuente": {
        "nombre": "Gobierno de Aragón",
        "url": "https://enlace-directo-al-parte.example"
      }
    }
  }
}
```

El valor anterior es solo una demostración de esquema: **no debe copiarse al archivo real sin una publicación oficial verificable**. `perimetro_consolidado_pct` debe permanecer en `null` si la fuente no facilita el porcentaje explícitamente.

### Evacuaciones

Añade objetos en `data/evacuaciones.json`:

```json
{
  "poblacion": "Nombre del núcleo",
  "estado": "Evacuada",
  "fecha_hora": "2026-08-16T10:01:00+02:00",
  "coordenadas": [42.0, -0.7],
  "fuente": {
    "nombre": "112 Aragón",
    "url": "https://enlace-directo.example"
  }
}
```

Estados admitidos: `Evacuada`, `Confinada`, `Retorno autorizado` y `Sin actualización`. Las coordenadas son opcionales. En este panel se conservan en `scripts/update_public_data.py`, contrastadas con OpenStreetMap/Nominatim, para que la actualización automática no borre los marcadores. Identifican el núcleo o establecimiento, nunca domicilios o posiciones operativas. No incluyas nombres ni datos personales.

### Carreteras

En `data/carreteras.json`, cada registro admite `carretera`, `pk_inicio`, `pk_fin`, `tramo`, `sentido`, `localizacion`, `estado`, `fecha_hora`, `fuente` y, opcionalmente, `coordenadas` y `trazado`. La automatización contrasta las vías enumeradas por el último parte con el cuadro vigente de carreteras cortadas por incendio de DGT. Para cada intervalo enlaza el eje viario oficial de ICEARAGON con hitos kilométricos de ICEARAGON o del geocodificador oficial CartoCiudad/IGN. Si el intervalo de DGT abarca una vía completa, puede utilizar el eje oficial completo después de comprobar su longitud. Cuando no existe correspondencia suficiente conserva el marcador y publica el motivo. Ninguna representación sustituye al mapa de tráfico: verifica siempre el estado en DGT, 011 o la autoridad vial competente antes de desplazarte.

### Meteorología y precipitación diaria

`data/meteo.json` separa `prevision` de `observacion`. La previsión horaria corresponde al municipio y la observación procede de la estación AEMET de Bailo-Puyalto, identificada por su código IDEMA, altitud y hora. La actualización automática no presenta esa medición como si se hubiera tomado dentro del incendio ni muestra una distancia ambigua a la capital municipal.

La automatización consulta también los resúmenes diarios públicos de AEMET para Bailo-Puyalto (9211F) y Jaca (9201X). Los almacena en `precipitacion_diaria` con este formato:

```json
{
  "fecha": "2026-08-16",
  "idema": "9201X",
  "estacion": "Jaca",
  "precipitacion_mm": 4.0,
  "estado": "Día completo",
  "completo": true,
  "fuente": {
    "nombre": "AEMET — resúmenes diarios de Jaca",
    "url": "https://www.aemet.es/es/eltiempo/observacion/ultimosdatos?l=9201X&datos=det&w=2"
  }
}
```

El día en curso se identifica como incompleto y se sustituye en cada ejecución. Los días anteriores se conservan para formar la serie histórica. Un valor ausente de AEMET permanece como `null`; la aplicación no lo convierte en cero ni interpreta automáticamente el efecto operativo de la lluvia.

### Cronología y gráfica

`data/cronologia.json` contiene:

- `eventos`: partes ordenados de más reciente a más antiguo;
- `series`: puntos cronológicos con `fecha`, `superficie_ha` y `perimetro_consolidado_pct`. La precipitación se representa desde `data/meteo.json` para mantener separadas las dos estaciones.

Usa `null` cuando falte un valor. En superficie y porcentaje consolidado, la línea une únicamente los puntos oficiales fechados disponibles sin crear valores intermedios. La precipitación mantiene separadas las series de cada estación.

## Capas de perímetro y área quemada

1. Obtén una geometría publicada por una fuente oficial y comprueba sus condiciones de reutilización.
2. Confirma que el sistema de coordenadas sea WGS84 (`EPSG:4326`) y el orden GeoJSON sea longitud, latitud.
3. Sustituye el contenido de `data/perimetro.geojson` por un `FeatureCollection` válido.
4. Añade a `metadata` la fuente, el enlace, la fecha/hora y un aviso sobre su vigencia.
5. Comprueba visualmente que la geometría cae en la zona correcta.
6. No dibujes a mano un perímetro aproximado ni publiques una geometría operativa filtrada.

La geometría oficial se guarda exclusivamente en `data/perimetro.geojson`. La estimación satelital se guarda por separado en `data/perimetro-aproximado.geojson`, se representa en naranja discontinuo y contiene una advertencia expresa de que no es un perímetro operativo. La capa del Paisaje Protegido de San Juan de la Peña y Monte Oroel se mantiene en `data/espacios-protegidos.geojson`.

El flujo automático consulta cada media hora ICEARAGON y solo incorpora una geometría oficial de 2026 cuyo nombre contenga “Riglos”. También consulta por WFS las áreas quemadas EFFIS, exige que el municipio coincida con Las Peñas de Riglos, comprueba fecha, extensión territorial y coherencia con la superficie publicada, y conserva la versión anterior si la fuente falla. Los focos térmicos VIIRS se solicitan directamente al WMS de EFFIS con la fecha actual y se dejan desactivados inicialmente porque ese servicio puede devolver teselas opacas que oculten el mapa base.

## Actualización automática

GitHub Actions ejecuta `scripts/update_public_data.py` cada media hora y también puede lanzarse manualmente desde **Actions → Actualizar datos y publicar el panel → Run workflow**. El proceso:

1. localiza y lee el último parte oficial de Aragón Hoy sobre Las Peñas de Riglos;
2. actualiza estado, superficie, último informe CECOPI, perímetro aproximado publicado, totales de evacuación, carreteras contrastadas con DGT y sus trazados con cartografía oficial de ICEARAGON y CartoCiudad/IGN, cronología y fuentes cuando las fuentes publican datos explícitos;
3. descarga la predicción horaria oficial de AEMET, la observación más reciente de Bailo-Puyalto y la precipitación diaria de Bailo-Puyalto y Jaca;
4. consulta si ICEARAGON ya ha publicado el perímetro de 2026;
5. descarga el área quemada EFFIS atribuida a Las Peñas de Riglos y aplica controles automáticos de coherencia;
6. valida todos los JSON y GeoJSON, conserva los datos anteriores si una fuente falla y vuelve a publicar GitHub Pages.

Antes de cada publicación, `scripts/validate_public_data.py` comprueba además que las fechas no sean futuras, que todas las fuentes del panel sean oficiales y usen HTTPS, que no haya vías duplicadas, que los PK sean numéricos y que cada marcador o trazado permanezca dentro del ámbito territorial del incendio. Un trazado se rechaza si sus PK cartográficos se separan más de 1,5 km de los PK comunicados por DGT. Después, `scripts/verify_official_sources.py` realiza una segunda consulta independiente al PDF vigente de DGT y al último informe de CECOPI para impedir la publicación si los PK, el número de cortes, el enlace o la fecha ya no coinciden.

No requiere claves ni secretos. La extracción es deliberadamente conservadora: no interpreta expresiones ambiguas, no inventa retornos o evacuaciones y mantiene vacío el porcentaje consolidado vigente si el último parte no lo publica expresamente.

## Publicar en GitHub Pages

### Desde la interfaz de GitHub

1. Crea un repositorio público o privado compatible con Pages.
2. Sube el contenido de esta carpeta a la rama principal, dejando `index.html` en la raíz.
3. Abre **Settings → Pages** en el repositorio.
4. En **Build and deployment**, selecciona **Deploy from a branch**.
5. Elige la rama `main` y la carpeta `/(root)`.
6. Pulsa **Save** y espera a que GitHub muestre la URL publicada.
7. Abre la URL, confirma que el mapa carga y revisa la consola del navegador.

### Desde Git

```bash
git add .
git commit -m "Añadir panel ciudadano de Riglos"
git branch -M main
git remote add origin https://github.com/USUARIO/REPOSITORIO.git
git push -u origin main
```

Después activa Pages con los pasos 3–6 anteriores. No hace falta una acción de compilación: el sitio se sirve tal cual.

### Dominio público de este proyecto

El dominio canónico es `www.custoscivis.org`, declarado en el archivo `CNAME`. El dominio raíz apunta a las direcciones oficiales de GitHub Pages y `www.custoscivis.org` apunta a `custos-civis.github.io`; GitHub redirige automáticamente el dominio raíz al canónico. HTTPS permanece forzado en la configuración de Pages.

## Lista de comprobación antes de publicar

- [ ] Todos los datos proceden de enlaces oficiales accesibles.
- [ ] Las fechas distinguen comprobación del panel y publicación oficial.
- [ ] Los campos desconocidos siguen en `null`.
- [ ] No hay información táctica ni datos personales.
- [ ] No hay publicaciones particulares usadas como confirmación.
- [ ] Los JSON son válidos y la consola no muestra errores.
- [ ] Se ha probado escritorio, móvil y navegación por teclado.
- [ ] El perímetro, si existe, tiene fuente, fecha y licencia documentadas.
- [ ] Una segunda persona ha revisado los cambios sensibles.

## Seguridad informativa

Reglas obligatorias para cualquier actualización:

- No publicar información táctica.
- No publicar ubicaciones de bomberos, maquinaria, UME, voluntariado ni otros equipos.
- No publicar rutas de ataque, maniobras o movimientos de extinción.
- No usar información de redes sociales particulares como confirmación.
- Priorizar siempre fuentes oficiales y enlazar la publicación original.
- Revisar manualmente cualquier cambio sensible que no pueda extraerse de forma inequívoca de una fuente oficial.
- No inferir perímetros operativos, porcentajes consolidados, evacuaciones ni efectos meteorológicos. Las estimaciones satelitales deben permanecer identificadas como tales.

## Privacidad

El código no solicita nombre, correo, teléfono, dirección, geolocalización ni identificadores; tampoco crea cookies, formularios, perfiles o analítica. GitHub Pages y los proveedores externos pueden procesar datos técnicos de conexión conforme a sus propias políticas:

- La hoja de estilos de Leaflet se sirve desde este repositorio; su biblioteca JavaScript se descarga desde `unpkg.com`.
- Las teselas del mapa se solicitan a `tile.openstreetmap.org` y, como en cualquier petición web, el servidor puede recibir la dirección IP.
- El área satelital se obtiene por WFS y los focos térmicos se solicitan al WMS de EFFIS/Copernicus; el enlace complementario abre Google Maps en otra pestaña.
- GitHub procesa las visitas cuando aloja el sitio.

Para reducir todavía más las conexiones externas, puede descargarse Leaflet al repositorio y sustituirse el mapa base por teselas de un proveedor con condiciones adecuadas. No almacenes teselas masivamente: respeta la [política de uso de teselas de OpenStreetMap](https://operations.osmfoundation.org/policies/tiles/).

## Limitaciones

- Todos los conjuntos de datos se comprueban automáticamente cada media hora. Los valores solo cambian cuando una fuente identificada publica información inequívoca, por lo que algunos campos pueden conservar su dato anterior entre partes.
- La observación AEMET más cercana está fuera del perímetro y puede no representar las condiciones del frente.
- EFFIS es una estimación satelital de actualización diaria y puede tardar en mostrar un incendio o diferir de la cartografía oficial.
- El panel no envía alertas.
- El mapa es informativo y depende de servicios externos para el fondo cartográfico.
- Una ausencia en el panel significa “no incorporado”, no “inexistente”.
- La disponibilidad de fuentes, enlaces y formatos oficiales puede cambiar.
- No es una herramienta de coordinación, predicción ni toma de decisiones operativas.

## Licencia y contenidos de terceros

El código original de este repositorio se distribuye bajo licencia MIT; consulta `LICENSE`.

La licencia MIT **no** se extiende automáticamente a datos, mapas, geometrías, teselas, logotipos, marcas, publicaciones oficiales ni otros contenidos de terceros. Esos materiales mantienen sus propias licencias y condiciones de reutilización. Leaflet se distribuye bajo licencia BSD-2-Clause y los datos de OpenStreetMap bajo ODbL; revisa siempre las condiciones vigentes de cada proveedor.