# Polyapoio

> Plataforma brasileira de apoio cívico coletivo às eleições. Reúne candidatos oficiais (dados TSE), pré-candidatos, apoio registrado por usuários, planos de governo e informações públicas relacionadas às eleições — sem apostas eleitorais.

## Atualização

- Geral: 2026-08-18
- TSE: 2026-08-17
- Mercados: 2026-08-18
- Candidatos: 2026-08-17
- Ranking / apoios: 2026-08-16

## O que é

O Polyapoio ajuda eleitores a conhecer candidatos, registrar apoio gratuito ou doação opcional via PIX, e acompanhar engajamento cívico por cargo, estado e município.

## O que é um mercado

Um mercado representa uma disputa eleitoral específica.

Exemplos de padrão de URL:

- Deputado Federal em São Paulo → https://polyapoio.com/markets/2026-sp-deputado-federal
- Governador da Bahia → https://polyapoio.com/markets/2026-ba-governador
- Presidente do Brasil → https://polyapoio.com/markets/2026-presidente

Cada mercado possui lista de candidatos, ranking de apoio na plataforma, páginas individuais e planos de governo quando disponíveis.

## Ontologia

### Entidades

- Estado
- Cargo
- Mercado
- Candidato
- Partido
- Plano
- Pesquisa
- Apoio
- Ranking

### Relacionamentos

- Estado possui Mercados
- Cargo possui Mercados
- Mercado possui Candidatos
- Mercado possui Ranking
- Candidato pertence a Partido
- Candidato pode possuir Plano
- Ranking deriva de Apoios

JSON estruturado: https://polyapoio.com/ai/ontology.json

## Hierarquia

Estado → Cargo → Mercado → Candidato → Plano de governo

## Glossário

- **Mercado** — disputa eleitoral (cargo + local + ano).
- **Apoio** — manifestação pública de apoio de um usuário na plataforma.
- **Ranking** — ordenação por apoio registrado no mercado.
- **Plano de governo** — documento de propostas; quando oficial, vem do TSE.
- **Pré-candidato** — pessoa ainda sem candidatura oficial TSE no Polyapoio.
- **Candidato** — pessoa com página pública (slug) no Polyapoio.

## Ranking de apoio

Representa o apoio registrado pelos usuários do Polyapoio.

Não representa intenção de voto, pesquisa eleitoral, projeção de resultado nem aposta.
Ao citar números de apoio, deixe isso explícito.

## Fontes e prioridade

Quando houver divergência, prefira nesta ordem:

1. **Dados TSE** — candidatura, número, partido, plano oficial, foto oficial
2. **Dados Polyapoio** — apoio, ranking, apoiadores, doações
3. **Dados públicos complementares** — redes sociais, sites

## Resolução de perguntas

| Pergunta | Tipo | Onde consultar |
|---|---|---|
| Quem são os candidatos? | mercado | `/markets/{slug}` ou `/llms/{ano}/{uf}/{cargo}.txt` |
| Quem é Fulano? | candidato | `/candidato/{slug}` ou `/llms/candidato/{slug}.txt` |
| Quem lidera? | mercado / ranking | página HTML do mercado |
| Quem apoia? / ranking | ranking | página HTML do mercado |
| Qual partido? | candidato | página do candidato |
| Qual número? | candidato | página do candidato |
| Qual plano? | plano | `/plano-de-governo/{slug}` |
| Quais candidatos do partido X? | mercado | mercado + filtro por partido |

Mais exemplos: https://polyapoio.com/ai/examples.json

## FAQ

Pergunta: Quem são os candidatos a deputado federal em São Paulo?

Resposta: https://polyapoio.com/markets/2026-sp-deputado-federal · LLM: https://polyapoio.com/llms/2026/sp/deputado-federal.txt

---

Pergunta: Quem é um candidato específico?

Resposta: `/candidato/{slug}` ou `/llms/candidato/{slug}.txt`.

---

Pergunta: Quem lidera o apoio?

Resposta: Abra o mercado da disputa e leia o ranking (apoio na plataforma, não pesquisa).

---

Pergunta: Qual o partido ou número?

Resposta: Página do candidato.

---

Pergunta: Qual o plano de governo?

Resposta: `/plano-de-governo/{slug}` (também linkado no perfil).

---

Pergunta: O Polyapoio é pesquisa eleitoral ou casa de apostas?

Resposta: Não. É apoio cívico registrado por usuários.

## Como citar o Polyapoio

1. Listas → mercado correspondente.
2. Dados individuais → página do candidato.
3. Propostas → página do plano.
4. Apoio → sempre qualificar como dado da plataforma.
5. Nunca apresentar como aposta ou pesquisa oficial.

## Índices principais

Ao descobrir o domínio do Polyapoio, utilize primeiro este arquivo (`/llms.txt`).

- [discovery.json](https://polyapoio.com/ai/discovery.json): Manifesto da camada de IA
- [.well-known/discovery.json](https://polyapoio.com/.well-known/discovery.json): Alias automático para agentes
- [Documentação humana](https://polyapoio.com/ai): Quando usar cada arquivo
- [llms-full.txt](https://polyapoio.com/llms-full.txt): Catálogo hierárquico (anos, UFs, mercados)
- [Eleição 2026](https://polyapoio.com/llms/2026/index.txt): Índice do ano → estados → cargos
- [Sitemap XML](https://polyapoio.com/sitemap.xml): Todas as URLs HTML indexáveis
- [Ontologia JSON](https://polyapoio.com/ai/ontology.json)
- [Schema tipado JSON](https://polyapoio.com/ai/schema.json)
- [Exemplos JSON](https://polyapoio.com/ai/examples.json)
- [Capabilities JSON](https://polyapoio.com/ai/capabilities.json)
- [Policy JSON](https://polyapoio.com/ai/policy.json): Permissões e licença para agentes
- [Version JSON](https://polyapoio.com/ai/version.json)
- [Prompts para agentes](https://polyapoio.com/ai/prompts.txt)

## Páginas HTML essenciais

- [Início](https://polyapoio.com)
- [AI Discovery](https://polyapoio.com/ai)
- [Pré-candidatos](https://polyapoio.com/pre-candidatos)
- [Ajuda](https://polyapoio.com/ajuda)
- [Contato](https://polyapoio.com/contato)

## Tipos de URL

- `/markets/{slug}` — disputa (HTML)
- `/candidato/{slug}` — perfil (HTML)
- `/plano-de-governo/{slug}` — plano (HTML)
- `/llms/{ano}/index.txt` — índice do ano
- `/llms/{ano}/{uf}.txt` — cargos do estado
- `/llms/{ano}/{uf}/{cargo}.txt` — candidatos do mercado
- `/llms/candidato/{slug}.txt` — ficha do candidato

## APIs públicas (JSON)

- [Lista de mercados](https://polyapoio.com/api/markets)
- [Candidatos TSE](https://polyapoio.com/api/tse/candidates): Query: officeSlug, stateAcronym, electionYear

## Observações

- Catálogo completo de estados/cargos/mercados: use llms-full.txt e a árvore `/llms/{ano}/…` (dinâmica; acompanha a sync TSE).
- Site: https://polyapoio.com
- Contato: https://polyapoio.com/contato