[EPIC] Extracao de contatos de mandatos: por plataforma + TSE backbone (ADR-0017) #72

New issue

Open

opened 2026-07-27 15:41:44 -03:00 by navigator · 1 comment

navigator commented

2026-07-27 15:41:44 -03:00

Owner

Enriquecer os ~70k mandatos com contatos institucionais sem scraper-por-municipio. Ref docs/decisions/ADR-0017.

Pipeline (4 camadas)

1. Roster TSE (dadosabertos.tse.jus.br / DivulgaCandContas) — quem tem mandato onde; baixar + normalizar
2. Federal/estadual: Camara + Senado APIs (ja em uso) + 27 Assembleias Legislativas
3. Municipal POR PLATAFORMA: fingerprint camara -> agrupar -> 1 extrator por plataforma
- Interlegis Portal Modelo / SAPL (1.200+ camaras, SAPL tem API)
- Vendors: camaraonline.org (confirmado no exemplo), IPM, Camara Sem Papel...
4. Casar (nome+partido+municipio) com roster TSE -> dedupe -> seed (scripts/seed-*.py, politico_contacts)

Prioridade por populacao

SP, PR, SC, RS, RJ, ES, MG, GO, MT, MS, BA, Nordeste.

Conformidade

So contato INSTITUCIONAL (gabinete/camara) — transparencia. Nunca pessoal. robots.txt/ToS. Accountability, nao marketing.

Nao confundir

Isto enriquece os MANDATOS da plataforma (politico_contacts). NAO e o F4 (#61, base propria de campanha).

Candidato a workflow multi-agente

Fan-out por municipio/UF priorizado por populacao. Estimar custo antes de rodar.

Enriquecer os ~70k mandatos com contatos institucionais sem scraper-por-municipio. Ref docs/decisions/ADR-0017. ## Pipeline (4 camadas) - [ ] 1. Roster TSE (dadosabertos.tse.jus.br / DivulgaCandContas) — quem tem mandato onde; baixar + normalizar - [ ] 2. Federal/estadual: Camara + Senado APIs (ja em uso) + 27 Assembleias Legislativas - [ ] 3. Municipal POR PLATAFORMA: fingerprint camara -> agrupar -> 1 extrator por plataforma - [ ] Interlegis Portal Modelo / SAPL (1.200+ camaras, SAPL tem API) - [ ] Vendors: camaraonline.org (confirmado no exemplo), IPM, Camara Sem Papel... - [ ] 4. Casar (nome+partido+municipio) com roster TSE -> dedupe -> seed (scripts/seed-*.py, politico_contacts) ## Prioridade por populacao SP, PR, SC, RS, RJ, ES, MG, GO, MT, MS, BA, Nordeste. ## Conformidade So contato INSTITUCIONAL (gabinete/camara) — transparencia. Nunca pessoal. robots.txt/ToS. Accountability, nao marketing. ## Nao confundir Isto enriquece os MANDATOS da plataforma (politico_contacts). NAO e o F4 (#61, base propria de campanha). ## Candidato a workflow multi-agente Fan-out por municipio/UF priorizado por populacao. Estimar custo antes de rodar.

navigator added the

epic

data-extraction

labels

2026-07-27 15:41:44 -03:00

navigator commented

2026-07-27 15:47:40 -03:00

Author

Owner

Ampliação de escopo (Marcos, 2026-07-27):

Fotos dos políticos (avatar) — muitos portais (camaraonline.org, Portal Modelo) expõem.
Telefone institucional (gabinete/ramal) — presente no exemplo camaraonline.
Atas das sessões — ex.: camaraonline.org/cm_santana/atas/resultado.php — OURO para destilação futura (ver issue-visão de meta-análise cidadã).

Cada extrator por plataforma deve puxar: identidade + contatos (foto/telefone/e-mail) e a atividade (atas, votações, presença, proposições) quando disponível.

Ampliação de escopo (Marcos, 2026-07-27): - [ ] **Fotos** dos políticos (avatar) — muitos portais (camaraonline.org, Portal Modelo) expõem. - [ ] **Telefone** institucional (gabinete/ramal) — presente no exemplo camaraonline. - [ ] **Atas das sessões** — ex.: `camaraonline.org/cm_santana/atas/resultado.php` — OURO para destilação futura (ver issue-visão de meta-análise cidadã). Cada extrator por plataforma deve puxar: identidade + contatos (foto/telefone/e-mail) **e** a atividade (atas, votações, presença, proposições) quando disponível.

navigator referenced this issue

2026-07-27 15:47:40 -03:00

[VISÃO] Cobertura máxima da atividade legislativa (todas as esferas) + destilação p/ meta-análise cidadã #73

navigator referenced this issue from a commit

2026-07-27 19:04:47 -03:00

feat(civic): #72 pipeline de extracao de contatos SAPL por plataforma (ADR-0017)

navigator referenced this issue from a commit

2026-07-27 19:06:44 -03:00

docs(adr): #72 status entregue (SAPL provado) + ADR-0018 atividade legislativa/destilacao (#73)

navigator referenced this issue from a commit

2026-07-27 19:42:46 -03:00

fix(civic): #72 nao sobrescrever mandate.source no enriquecimento (preserva origem TSE; 'self' mentiria auto-cadastro)