Qué es esto
España Transparente reúne en un mismo sitio los datos que ya son públicos pero viven dispersos entre el Congreso, el INE, la Plataforma de Contratación, la BDNS y otros registros oficiales. Los normaliza, los enlaza por persona y los presenta como una cadena verificable: gasto → déficit → deuda → quién paga. Cada cifra apunta a su fuente original.
El producto tiene tesis explícita, pero las afirmaciones tienen que ser desmontables solo atacando la fuente oficial. Las reglas editoriales viven en AGENTS.md y la hoja de ruta activa en NEXT.md.
Qué incluye hoy
- XV Legislatura — 350 diputados activos con partido, circunscripción, biografía y foto oficial.
- Votaciones nominales — votos individuales enlazados a cada diputado, sesión a sesión.
- Cadenas de responsabilidad — cargos estatales, autonómicos y municipales conectados al gasto público.
- Contratos y subvenciones — PCSP (Plataforma de Contratación) y BDNS (
infosubvenciones.es).
- Indicadores macro — IPC, PIB, EPA y salarios desde el INE; deuda pública Maastricht desde Eurostat.
- Puertas giratorias — pipeline de tres fases con curación humana obligatoria antes de publicar.
- Divergencias — detección automática de votos contra el grupo parlamentario.
- Anotaciones — sistema propio para que la comunidad añada contexto verificable.
Arquitectura
Fuentes públicas → etl/src/<source>/ → Supabase (Postgres) → web/src/lib/data/ → Next.js (App Router)
| Capa | Tecnología | Carpeta |
|---|
| Frontend | Next.js 15 · App Router · Tailwind · shadcn/ui | web/ |
| ETL | Python 3.12 · psycopg2 · httpx | etl/ |
| Base de datos | Supabase (PostgreSQL) · 15+ tablas, vistas y RPCs | supabase/migrations/ |
| Datos curados | YAML revisado vía PR (liderazgos, responsables) | etl/data/ |
| CI/CD | GitHub Actions · cron diario y semanal · deploy SSH a VPS | .github/workflows/ |
Arranque rápido
Frontend
cd web
npm install
npm run dev # http://localhost:3000
npm run build # build de producción
npm run lint # eslint (flat config)
npm run ui:audit # primitives de layout y reglas responsive
npm run content:audit # reglas editoriales (ver AGENTS.md)
Variables requeridas: NEXT_PUBLIC_SUPABASE_URL, NEXT_PUBLIC_SUPABASE_ANON_KEY (producción sirve la clave publishable sb_publishable_…; la instancia self-hosted también acepta la anon JWT legacy, que es la que usa CI).
ETL
cd etl
pip install -r requirements.txt
# Todos los pipelines se ejecutan como módulos desde src/
PYTHONPATH=src python -m src.congreso.diputados
PYTHONPATH=src python -m src.ine.indicadores
PYTHONPATH=src python -m src.contratacion.contratos
PYTHONPATH=src python -m pytest tests/
Las escrituras requieren DATABASE_URL (URI directo de Postgres desde Supabase → Settings → Database). Todas las escrituras pasan por common.db.get_pg_conn() — el SDK de Supabase solo se usa para lecturas.
Puertas giratorias (3 fases)
# 1. Ingesta de candidatos (CSV o descubrimiento BORME)
PYTHONPATH=src python -m src.puertas_giratorias.ingest --csv puertas.csv --dry-run
# 2. Revisión humana
PYTHONPATH=src python -m src.puertas_giratorias.review list
PYTHONPATH=src python -m src.puertas_giratorias.review reject <id>
# 3. Publicación (exige ≥1 fuente "primary")
PYTHONPATH=src python -m src.puertas_giratorias.review publish <id> --reviewed-by <nombre>
Nada se publica automáticamente. El frontend público lee exclusivamente de revolving_door y v_revolving_door_public; los candidatos no son accesibles por anon.
Migraciones
cd etl
python apply_migration.py ../supabase/migrations/<archivo>.sql
# o, alternativamente:
npx supabase db push
Fuentes de datos
El portal del Congreso aplica rate-limit agresivo (403 tras pocos requests). Los scrapers usan curl vía subprocess con REQUEST_DELAY = 1.5s. No bajar el delay ni paralelizar peticiones al Congreso.
Reglas duras (auditadas en CI)
- Contenido (
npm run content:audit) — cobertura de explicaciones para cada indicador y bloqueo de términos de riesgo legal aplicados a personas sin condena firme.
- UI (
npm run ui:audit) — grid-cols-N requiere variante responsive; flex items-center justify-between requiere min-w-0; los colores de voto/partido se importan de lib/domain-style.ts; los tabs viven en components/domain/SectionTabs.tsx.
Detalles completos en CLAUDE.md, DESIGN.md y NEXT.md.
Contribuir
- Lee
AGENTS.md — es obligatorio antes de tocar código o copy.
- Revisa los issues abiertos.
- Haz fork, crea una rama, abre un PR. CI debe pasar (
lint + build + auditorías).
- Para añadir datos curados (responsables, liderazgos), edita el YAML correspondiente en
etl/data/ y deja el last_verified actualizado.
Licencia
MIT · El código es libre. Los datos provienen de fuentes públicas; cada vista enlaza a su origen.
