Ir ao conteúdo

Guia de uso do Politapp

Mapa das funções principais, fluxos sugeridos e onde encontrar cada ferramenta. No telemóvel, o menu no topo pode ser deslizado horizontalmente. Use Ir ao conteúdo (primeiro elemento ao navegar com teclado) para saltar o menu.

Mapa rápido — o que é cada página

Clique no nome para abrir. A ordem reproduz o menu principal quando disponível.

Lista de candidatos index.html Deputados federais (API Câmara), filtros UF, ligação a perfil e votação.
Eleição 2022 · DF eleicao-2022… Recorte histórico / referência de deputado federal.
Visão executiva executivo.html Resumo para leitura de gestão e prioridades.
Insights RJ insights-rj.html Mapas IBGE, comércio/feiras, simulador de viagem entre municípios.
Prefeituras RJ prefeituras-rj.html Dados e referências municipais do estado.
Vereadores RJ vereadores-rj.html Listas, Caxias, mapa de votos — use o sub-menu em cada vista.
Transparência transparencia.html Rotas de accountability e leitura de dados públicos.
Mídia social midia-social.html · whatsapp.html · instagram.html No menu global, WhatsApp e Instagram aparecem no submenu «Mídia social». Escuta e conteúdo no painel principal; setup de bot e tokens nas páginas dedicadas.
Tarefas tarefas.html Checklist e notas por dia; sincronização por unidade (Supabase).
Conta conta.html Dados do utilizador autenticado.
Entrar login.html Google + Supabase; novas contas podem precisar aprovação.

Fluxo de acesso (manual)

O diagrama resume o caminho típico após abrir o site. Texto alternativo: ver lista numerada abaixo.

flowchart TD A[Abrir Politapp] --> B{Autenticado?} B -->|Não| C["login.html — Google"] C --> D{Conta aprovada?} D -->|Pendente| E[aguarde-aprovacao.html] D -->|Recusada| F[conta-recusada.html] D -->|OK / admin| G["Demais páginas"] B -->|Sim| G G --> H["Tarefas, Insights, Mídia…"]
  1. Sem sessão, o auth-guard envia para o login (exceto páginas públicas como landing-publico.html, landing-app.html, landing.html, privacidade.html e termos-uso.html).
  2. Primeiro acesso cria perfil; administradores podem aprovar ou recusar.
  3. Com sessão válida, o menu leva a todas as áreas; dados sensíveis de WhatsApp e Instagram ficam no browser até exportar.

Dados da Câmara e perfil de candidato

  • Lista (index): paginação, filtro por UF, ligação ao detalhe do deputado.
  • Perfil (candidato.html): abre a partir da lista; traz biografia, comissões e contexto da API.
  • API oficial: link «Documentação da API» no menu — útil para cruzar campos avançados.

Território RJ — vereadores e insights

  • Vereadores RJ: na mesma família de páginas, use o sub-menu (lista, Caxias, mapa) para não se perder.
  • Insights RJ: três blocos principais — mapa de necessidades por município, comércio/feiras com horários de referência, viagem OSRM + POIs.
  • Prefeituras: visão municipal complementar ao mapa estadual.

Transparência e mídia social

  • Transparência: painéis e referências para acompanhamento de informação pública.
  • Mídia social: escuta curada + integrações; para APIs com token use o servidor de desenvolvimento e proxy conforme README do projeto.

WhatsApp, Instagram e integrações

  • whatsapp.html: preencha por blocos (provedor, credenciais, webhook, comportamento do bot), depois Salvar.
  • instagram.html: credenciais Graph API, webhook, modelo de posts programados (worker/cron no servidor) e notas para bot/DMs.
  • Use Exportar JSON para partilhar configuração com o backend sem copiar tokens à mão em chats inseguros.
  • Em produção, migre credenciais para variáveis de ambiente no servidor.

Conta, tarefas e administração

  • Conta: estado do utilizador e mensagens de configuração (Supabase).
  • Tarefas: escolha data, unidade (se aplicável), marque itens; notas longas no mesmo ecrã.
  • Admin (admin.html): apenas perfil admin — unidades e aprovações de novos utilizadores.

Se algo não carregar, confirme ligação à rede, ficheiro js/auth-config.js e consola do navegador (F12).