Observatori de l'Habitatge de Castelló

Web estática de datos sobre vivienda, salarios y coste de vida en Castelló, herramienta de la campaña de vivienda de CGT Castelló. Ver observatori-habitatge-brief.md para el brief completo.

Pipeline de datos

python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
.venv/bin/python scripts/fetch_serpavi.py   # alquiler real (MIVAU/SERPAVI)
.venv/bin/python scripts/fetch_ine.py       # IPC, compraventas, hipotecas, IPV, ADRH
.venv/bin/python scripts/fetch_cgpj.py      # desahucios (lanzamientos CGPJ)
.venv/bin/python scripts/fetch_vt.py        # vivienda turística (GVA + INE)
.venv/bin/python scripts/fetch_aeat.py      # salarios y renta IRPF municipal
.venv/bin/python scripts/fetch_mivau.py     # valor tasado €/m² (precio compra)
.venv/bin/python scripts/fetch_fianzas.py   # fianzas GVA (contratos de alquiler/año)
.venv/bin/python scripts/fetch_cartografia.py  # GeoJSON secciones censales (mapa)
.venv/bin/python scripts/build_all.py       # indicadores derivados + meta.json
.venv/bin/python scripts/fetch_censo.py     # Censo 2021: parque y tenencia municipal
.venv/bin/python scripts/gen_fichas.py      # fichas municipales (formacion/fichas/)

build_all.py --fetch ejecuta antes todos los fetchers. Cada indicador tiene un test de rango plausible (dict RANGOS): si un valor se sale, el build aborta sin publicar nada.

La imagen para compartir en redes (web/img/og-observatori.png, 1200x630) se diseña a mano: antes la generaba gen_og.py, que se ha retirado para que un build no la sobrescriba. Si cambian las cifras que muestra, hay que rehacerla.

scripts/manual_inputs.csv guarda los datos introducidos a mano (SMI, precios de oferta de portales) con fuente y URL por fila.

Los scripts descargan de fuentes oficiales, validan rangos de plausibilidad y escriben JSON en data/ de forma atómica: si una fuente cambia de formato, abortan sin tocar el JSON bueno anterior. Las descargas pesadas se cachean en scripts/cache/ (usar --force en fetch_serpavi para re-descargar).

La URL del XLSX de SERPAVI cambia con cada publicación anual: está en la constante XLSX_URL de scripts/fetch_serpavi.py, con instrucciones para actualizarla.

Formación

(Solo en local: no se incluye en el repositorio publicado.)

formacion/ contiene el material de la sesión formativa interna: guion de 90 minutos (guion-sessio.md) y argumentario de réplicas con fuente (argumentario.md). Las cifras marcadas con ⟵ se revisan tras cada build anual. El indicador esfuerzo_niveles de data/indicadores.json (tasa de esfuerzo por niveles salariales: 1/1,5/2 SMI y salario medio) se calcula en build_all.py con un neto estimado documentado (IRPF/SS 2024).

Estado

• Fase 1a: fetch_serpavi.py, fetch_ine.py
• Fase 1b: fetch_cgpj.py, fetch_vt.py, fetch_aeat.py, manual_inputs.csv
• Fase 2: indicadores derivados en build_all.py + data/meta.json
• Fase 3: web one-page en valenciano (Chart.js + calculadora) — textos pendientes de revisión
• Fase 4: mapa Leaflet, versión /es/, SEO (JSON-LD, hreflang, sitemap)