Vista General

El Observatorio del Congreso usa un esquema unificado Popolo-Graph almacenado en SQLite. Contiene 12 tablas organizadas en cuatro grupos funcionales:

Todas las tablas usan claves primarias de texto con una convención de prefijos (ej. P00001, VE_D00001). Las claves foráneas imponen integridad referencial — 14 claves foráneas en total: 4 con ON DELETE CASCADE (tablas hijas) y 10 con ON DELETE RESTRICT (tablas de lookup/padre). Las restricciones CHECK validan enumeraciones y rangos a nivel de base de datos, usando el patrón correcto IS NULL OR campo IN(...) para enumeraciones que admiten NULL.

Diagrama Entidad-Relación

                        +-------------+
                        |    area     |
                        +-------------+
                        | id (PK)     |
                        | nombre      |
                        | parent_id FK|----+
                        +-------------+    |
                               ^          |
                               |          |
+---------------+    +------------------+  |  +------------------+
| organization  |    |      post        |  |  | actor_externo    |
+---------------+    +------------------+  |  +------------------+
| id (PK)       |<---| org_id (FK)      |  |  | id (PK)          |
| nombre        |    | area_id (FK)     |--+  | nombre           |
| abbr          |    +------------------+     | tipo             |
| clasificacion |                             | area_id (FK)     |--+
+------+--------+                             +------------------+  |
       |            +----------------+                              |
       |            |   membership   |                              |
       |            +----------------+                              |
       |            | id (PK)        |                              |
       +---org_id-->| person_id (FK) |-----+                        |
       |            | rol            |     |                        |
       |            | on_behalf_of FK|-----+                        |
       |            +----------------+     |                        |
       |                                   v                        |
       |                            +-------------+                 |
       |                            |    person   |                 |
       |                            +-------------+                 |
       |                            | id (PK)     |                 |
       |                            | nombre      |                 |
       |                            | genero      |                 |
       |                            +-------------+                 |
       |                                   |                        |
       |                                   v                        |
       |       +----------------+   +-------------+                 |
       |       |    vote_event  |   |    vote     |                 |
       |       +----------------+   +-------------+                 |
       +--org_id| id (PK)       |<--| vote_event  |                 |
               | motion_id (FK)|   | voter_id FK |                 |
               +-------+--------+   +-------------+                 |
                       |                                            |
                       v                                            |
                +-------------+       +------------------+          |
                |   motion    |       |   count          |          |
                +-------------+       +------------------+          |
                | id (PK)     |       | id (PK)          |          |
                | texto       |       | vote_event_id FK |----------+
                | clasificacion       | option           |          |
                +-------------+       | group_id (FK) ---+----------+
                                      +------------------+

        +-------------------+     +-------------------+
        | relacion_poder    |     | evento_politico   |
        +-------------------+     +-------------------+
        | id (PK)           |     | id (PK)           |
        | source_type       |     | fecha             |
        | source_id         |     | tipo              |
        | target_type       |     | descripcion       |
        | target_id         |     | motion_id (FK) ---+--> motion
        | tipo              |     +-------------------+
        | peso (1-5)        |
        +-------------------+
  source/target: person | organization | actor_externo

Convención de IDs

Todas las claves primarias usan un prefijo de texto para identificar el tipo de entidad y, donde aplica, la cámara de origen. La porción numérica se rellena con ceros a 5 dígitos.

:::note Los prefijos por cámara (_D para Diputados, _S para Senado) se usan en entidades que difieren entre cámaras. Las entidades compartidas como person y count usan un único prefijo. :::

Organizaciones Clave

Estas son las organizaciones políticas principales almacenadas en la tabla organization:

:::note O08 (Diputados) y O09 (Senado) están clasificados como institucion, no gobierno. O10 (SHH) es la coalición gobernante. Los partidos históricos (O12–O15) pueden tener fecha de disolución registrada. :::

Referencia por Tabla

area — Divisiones Geográficas

Almacena las divisiones geográficas usadas para distritos electorales y estados. Las áreas se pueden anidar mediante parent_id para modelar la jerarquía: distrito dentro de estado.

clasificacion IN ('estado', 'distrito', 'circunscripcion')

organization — Organizaciones Políticas

Almacena partidos políticos, cámaras legislativas, coaliciones e instituciones de gobierno. Esta tabla no tiene claves foráneas.

clasificacion IN ('partido', 'bancada', 'coalicion', 'gobierno', 'institucion', 'otro')

person — Legisladores

Tabla central de legisladores (diputados y senadores). Incluye datos demográficos, tipo de curul, corrientes internas y evaluaciones de vulnerabilidad.

genero IN ('M', 'F', 'NB')
curul_tipo IN ('mayoria_relativa', 'plurinominal', 'suplente')
circunscripcion BETWEEN 1 AND 5
corriente_interna IS NULL OR corriente_interna IN ('Monreal', 'AMLO', 'Sheinbaum', 'institucionalista')
vulnerabilidad IS NULL OR vulnerabilidad IN ('alta', 'media', 'baja')

:::caution Los campos de enumeración que admiten NULL (corriente_interna, vulnerabilidad) usan el patrón campo IS NULL OR campo IN(...). El patrón anterior campo IN('val1', 'val2', NULL) es ineficaz porque NULL IN (...) evalúa a NULL (no FALSE), saltando la restricción por completo. :::

:::tip El campo corriente_interna rastrea las facciones políticas dentro de los partidos. Esto es particularmente relevante para MORENA, donde las divisiones internas (monrealistas, sheinbaumistas, etc.) afectan significativamente el comportamiento de voto. :::

membership — Relaciones Persona-Organización

Vincula personas con organizaciones incluyendo rol, rango de fechas y representación opcional de coalición.

:::note La columna on_behalf_of maneja la representación de coaliciones. Cuando un diputado del Partido A fue electo bajo una coalición con el Partido B, este campo registra la entidad de coalición. :::

post — Cargos Legislativos

Representa cargos formales dentro de organizaciones (ej. presidente de comisión, secretario de mesa directiva).

motion — Iniciativas Legislativas

Almacena propuestas legislativas incluyendo reformas constitucionales, leyes secundarias y legislación ordinaria.

clasificacion IN ('reforma_constitucional', 'ley_secundaria', 'ordinaria', 'otra')
requirement IN ('mayoria_simple', 'mayoria_calificada', 'unanime')
result IS NULL OR result IN ('aprobada', 'rechazada', 'pendiente', 'retirada')

vote_event — Eventos de Votación

Registra sesiones de votación. Cada evento de votación está vinculado a una motion y una organización (cámara).

result IS NULL OR result IN ('aprobada', 'rechazada', 'empate')
requirement IS NULL OR requirement IN ('mayoria_simple', 'mayoria_calificada', 'unanime')

vote — Votos Individuales

Registra el voto individual de cada legislador dentro de un evento de votación.

option IN ('a_favor', 'en_contra', 'abstencion', 'ausente')

:::tip La columna group captura la afiliación partidista al momento de la votación, que puede diferir de la membresía actual de la persona. Esto es esencial para rastrear legisladores que cambian de partido. :::

count — Recuentos de Votos por Grupo

Tallies agregadas de votos por opción y por grupo (partido). Usadas para consultas estadísticas rápidas sin escanear filas individuales de vote.

option IN ('a_favor', 'en_contra', 'abstencion', 'ausente')
value >= 0

actor_externo — Actores Externos

Almacena actores políticos fuera del legislativo que influyen en los resultados legislativos: gobernadores, alcaldes, ex presidentes, jueces, dirigentes partidistas.

tipo IN ('gobernador', 'alcalde', 'ex_presidente', 'dirigente', 'juez', 'otro')

relacion_poder — Redes de Poder

Tabla de relaciones polimórficas que modela conexiones políticas entre cualquier combinación de personas, organizaciones y actores externos. Esta es una extensión Popolo específica de este proyecto.

source_type IN ('person', 'organization', 'actor_externo')
target_type IN ('person', 'organization', 'actor_externo')
tipo IN ('lealtad', 'presion', 'influencia', 'familiar', 'clientelismo', 'conflicto', 'alianza')
peso BETWEEN 1 AND 5

:::note relacion_poder usa un diseño polimórfico: source_type/source_id y target_type/target_id pueden apuntar a cualquiera de tres tablas. Esto sacrifica la aplicación de claves foráneas a nivel SQL a cambio de flexibilidad para modelar redes políticas complejas. :::

evento_politico — Eventos Políticos

Registra eventos políticos significativos que pueden afectar el comportamiento o los resultados legislativos.

Índices

Los siguientes 18 índices están definidos para optimizar los patrones de consulta más comunes, incluyendo 2 índices compuestos únicos para deduplicación:

:::tip Los índices compuestos únicos (idx_vote_unique e idx_count_unique) previenen registros duplicados a nivel de base de datos. idx_vote_unique asegura que un legislador no pueda votar dos veces en el mismo evento, e idx_count_unique asegura un solo conteo por opción por grupo por evento. :::

Triggers

Cuatro triggers imponen consistencia de fechas entre los campos start_date y end_date. Usan el patrón SELECT CASE WHEN ... THEN RAISE(ABORT, ...) END con una cláusula WHEN a nivel de trigger:

trg_person_dates

Se ejecuta BEFORE INSERT en person. Garantiza que end_date no sea anterior a start_date cuando ambos están presentes.

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;

trg_person_dates_update

Misma validación en UPDATE de person.

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;

trg_membership_dates

Se ejecuta BEFORE INSERT en membership. Previene membresías con rangos de fechas invertidos.

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;

trg_membership_dates_update

Misma validación en UPDATE de membership.

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;

Estadísticas

Volúmenes actuales de datos en la base de datos de producción: