Resumen

Esta página es la referencia completa a nivel columna para las 12 tablas de la base de datos Popolo-Graph. Cada columna, su tipo, nulabilidad, restricciones y propósito están documentados aquí. Úsala como fuente autorizada al consultar la base de datos o construir análisis derivados.

Convenciones

:::note

• Todas las fechas se almacenan en formato ISO 8601 (YYYY-MM-DD o YYYY-MM-DDTHH:MM:SS).
• Todo el texto está codificado en UTF-8.
• Las llaves foráneas se aplican (PRAGMA foreign_keys = ON).
• NULL significa “no especificado” o “no aplica”. No se usan valores centinela.
• Los campos identifiers_json contienen arreglos u objetos JSON válidos.
• La columna "group" en la tabla vote usa comillas SQL porque group es una palabra reservada en SQLite.
• Las eliminaciones en cascada en membership (person_id, org_id) aseguran integridad referencial cuando se elimina una persona u organización. :::

Tablas Principales

area

Áreas geográficas utilizadas para mapear distritos electorales, estados y circunscripciones.

organization

Partidos políticos, bancadas parlamentarias, coaliciones, organismos de gobierno y otras organizaciones.

person

Legisladores y otras personas rastreadas en el sistema.

membership

Vincula a una persona con una organización mediante un rol específico y un período de tiempo.

post

Cargos formales dentro de una organización (cámara), opcionalmente vinculados a un área geográfica.

motion

Iniciativas legislativas: reformas constitucionales, leyes secundarias y proyectos de ley ordinarios.

vote_event

Un evento de votación específico (lista nominal) sobre una moción, realizado por una cámara.

vote

Voto individual emitido por un legislador en un evento de votación.

Nota: El nombre de columna group es una palabra reservada de SQLite y debe ir entre comillas en las consultas.

count

Conteos agregados de votos por opción y por partido dentro de un evento de votación.

Tablas de Extensión

Estas tres tablas extienden el esquema Popolo para soportar análisis de redes de poder. Modelan actores políticos externos, relaciones entre entidades y eventos políticos que influyen en el comportamiento legislativo.

actor_externo

Actores políticos fuera del legislativo: gobernadores, presidentes municipales, ex presidentes, dirigentes partidistas, jueces y otros que influyen en los resultados legislativos.

relacion_poder

Relaciones de poder entre dos entidades (personas, organizaciones o actores externos). Se usa para análisis de lealtad, mapeo de presión y seguimiento de coaliciones.

evento_politico

Eventos políticos (reformas, crisis, acuerdos) que pueden o no estar vinculados a una moción legislativa.

Referencia de Índices

-- Búsquedas por membresía
CREATE INDEX idx_membership_person ON membership(person_id);
CREATE INDEX idx_membership_org    ON membership(org_id);

-- Búsquedas por evento de votación
CREATE INDEX idx_vote_event_motion ON vote_event(motion_id);
CREATE INDEX idx_vote_event_source ON vote_event(source_id);

-- Filtros por evento de votación
CREATE INDEX idx_vote_event_legislatura ON vote_event(legislatura);
CREATE INDEX idx_vote_event_org ON vote_event(organization_id);
CREATE INDEX idx_vote_event_start_date ON vote_event(start_date);

-- Búsquedas por voto individual
CREATE INDEX idx_vote_voter ON vote(voter_id);
CREATE INDEX idx_vote_event ON vote(vote_event_id);

-- Agregaciones de conteo
CREATE INDEX idx_count_event ON count(vote_event_id);
CREATE INDEX idx_count_group ON count(group_id);

-- Deduplicación (UNIQUE)
CREATE UNIQUE INDEX idx_vote_unique ON vote(vote_event_id, voter_id);
CREATE UNIQUE INDEX idx_count_unique ON count(vote_event_id, option, group_id);

-- Recorridos de relaciones de poder
CREATE INDEX idx_relacion_source ON relacion_poder(source_type, source_id);
CREATE INDEX idx_relacion_target ON relacion_poder(target_type, target_id);
CREATE INDEX idx_relacion_tipo   ON relacion_poder(tipo);

-- Análisis de lealtad
CREATE INDEX idx_person_corriente ON person(corriente_interna);

-- Filtrado de actores externos
CREATE INDEX idx_actor_tipo ON actor_externo(tipo);

Referencia de Triggers

Cuatro triggers aplican la restricción end_date >= start_date en las tablas person y membership, tanto para INSERT como para UPDATE.

-- Person: validar fechas en INSERT
CREATE TRIGGER trg_person_dates
BEFORE INSERT ON person
WHEN NEW.end_date IS NOT NULL AND NEW.start_date IS NOT NULL
BEGIN
    SELECT CASE WHEN NEW.end_date < NEW.start_date
    THEN RAISE(ABORT, 'end_date debe ser >= start_date en person')
    END;
END;

-- Person: validar fechas en UPDATE
CREATE TRIGGER trg_person_dates_update
BEFORE UPDATE ON person
WHEN NEW.end_date IS NOT NULL AND NEW.start_date IS NOT NULL
BEGIN
    SELECT CASE WHEN NEW.end_date < NEW.start_date
    THEN RAISE(ABORT, 'end_date debe ser >= start_date en person')
    END;
END;

-- Membership: validar fechas en INSERT
CREATE TRIGGER trg_membership_dates
BEFORE INSERT ON membership
WHEN NEW.end_date IS NOT NULL AND NEW.start_date IS NOT NULL
BEGIN
    SELECT CASE WHEN NEW.end_date < NEW.start_date
    THEN RAISE(ABORT, 'end_date debe ser >= start_date en membership')
    END;
END;

-- Membership: validar fechas en UPDATE
CREATE TRIGGER trg_membership_dates_update
BEFORE UPDATE ON membership
WHEN NEW.end_date IS NOT NULL AND NEW.start_date IS NOT NULL
BEGIN
    SELECT CASE WHEN NEW.end_date < NEW.start_date
    THEN RAISE(ABORT, 'end_date debe ser >= start_date en membership')
    END;
END;