SIME — Sistema de Monitoramento Eleitoral
Sistema auxiliar de observabilidade operacional para a 7ª Zona Eleitoral do Piauí
(Campo Maior, Jatobá do Piauí e Sigefredo Pacheco). Não substitui nenhum processo
oficial da Justiça Eleitoral.
- 174 seções · 63 locais de votação · 34.967 eleitores · 12 rotas de distribuição
- Eleição: 4 de outubro de 2026
- Custo de infraestrutura: R$ 0,00/mês (Supabase Free + Vercel Hobby + Oracle Always Free)
Estrutura
modules/ 16 módulos HTML (HTML+JS puro, sem build) — um por papel/fase
+ sime_dados.js (camada de dados zona-scoped) e sime_tv_auth.js
(bootstrap de sessão das TVs)
sql/ schema Supabase, notificações WhatsApp e triggers do Hermes
api/ função serverless (Vercel) que recebe eventos do Hermes
supabase/ Edge Function sime-login (troca token → sessão JWT)
docs/ documentação de apoio
CLAUDE.md documentação completa da arquitetura
O código e a documentação do agente de WhatsApp (Hermes) que consome os endpoints de api/
vivem num repositório separado: bernardobbs/hermes —
inclui HERMES_RUNTIME.md, HERMES_FUNCOES.md e o contrato de cada skill (SIME_hermes_skill_*.md).
Arquitetura multi-zona (em migração): o SIME está evoluindo de single-tenant
(7ª Zona fixa) para um modelo SaaS onde uma única instância (1 Vercel + 1 Supabase)
atende várias zonas eleitorais, isoladas por RLS. Progresso: RLS com super_admin
cross-zona (feito), camada de dados sime_dados.js + login real no Admin/TVs
(feito), JWT de campo pro QR+PIN dos demais módulos (pendente).
Início rápido (homologação local)
python3 -m http.server 8080
# Painel de entrada:
open http://localhost:8080/modules/SIME_principal.html
Na fase atual (homologação) os dados ficam em localStorage — sem backend. Cada módulo
grava/lê chaves compartilhadas (ver "CHAVES localStorage" no CLAUDE.md).
Papéis e acesso
- Cartório (admin):
SIME_admin.html/SIME_coordenador_preparacao.html — login real
(e-mail/senha via Supabase Auth), com saída "continuar offline" sempre disponível
(plano de contingência). Perfis com escopo (Coordenador, Monitor, Gestor de
Problemas/Distribuição, Observador, Coord. de Motoristas, Coord. de Acessibilidade,
Coletor de Mídias).
- Campo (QR Code + PIN): mesário, motorista, conferente, instalador, coordenador de
preparação e acessibilidade. Os tokens são gerados em
SIME_tokens.html
(por rota, ou por local no caso da acessibilidade). Ainda em localStorage — a
troca de token por sessão real (Edge Function sime-login) é a próxima fase.
- Telões (TV):
SIME_tv_dia, SIME_tv_vespera, SIME_tv_distribuicao,
SIME_tv_preparacao, SIME_paineis — autenticam via um token de longa duração
(?tv_token=, tipo 'tv' em sime_tokens), trocado uma vez por sessão persistida
em localStorage.
Banco de dados (produção — Supabase)
Executar os scripts nesta ordem no SQL Editor do Supabase:
1. sql/SIME_schema.sql -- tabelas, RPCs, RLS por zona, seed inicial
2. sql/SIME_whatsapp_schema.sql -- fila de notificações + triggers
3. sql/SIME_hermes_trigger.sql -- triggers para o Hermes
Requer as extensões uuid-ossp e pg_trgm (criadas pelo próprio schema). RLS está ativo
em todas as tabelas (isolamento por zona via sime_user_zona()/sime_zona_visivel(),
com bypass para o perfil super_admin); o acesso de campo por QR/PIN e das TVs por token
é feito pela Edge Function supabase/functions/sime-login (troca token → JWT), que
service_role também usa para provisionar o usuário na primeira troca. Sempre use
sime_now() para timestamps — nunca o relógio do dispositivo.
Depois de rodar o schema, faça o deploy da Edge Function e configure o segredo de
assinatura (o nome NÃO pode começar com SUPABASE_ — o Supabase reserva esse prefixo
para os secrets automáticos da plataforma):
supabase functions deploy sime-login
supabase secrets set SIME_JWT_SECRET=<valor de Settings → API → JWT Settings → JWT Secret>
Deploy (produção)
npm install -g vercel
vercel env add SUPABASE_URL
vercel env add SUPABASE_SERVICE_ROLE_KEY
vercel env add HERMES_URL
vercel env add HERMES_SECRET_ZONA_<numero> # uma por zona provisionada
vercel --prod
Além das env vars do Vercel (usadas só pela API serverless), os 7 módulos que ganharam
integração real com o Supabase (as 5 TVs + SIME_admin.html +
SIME_coordenador_preparacao.html) têm um SIME_CONFIG embutido no próprio HTML —
supabaseUrl/supabaseAnonKey públicos, não são env vars server-side. Substitua o
placeholder SEU_PROJETO.supabase.co/SUA_ANON_KEY pelos valores reais do projeto antes
de considerar o deploy completo.
Status
Pronto (produção, Supabase): RLS multi-zona com super_admin cross-zona; camada de
dados zona-scoped modules/sime_dados.js; Edge Function sime-login (token → JWT,
compartilhada entre TVs e, na próxima fase, campo); login real (e-mail/senha) no Admin e
Coordenador de Preparação, com saída offline explícita; as 5 TVs consumindo dado real via
token de longa duração.
Pronto (homologação, localStorage): os módulos de campo (mesário, motorista,
conferente, instalador, acessibilidade) e mídias — ainda sem sessão Supabase real.
Em andamento / pendente:
- Preencher
SIME_CONFIG real (URL/anon key) nos 7 arquivos migrados — hoje com placeholder.
- Seed de produção da 7ª Zona real (bloqueado numa revisão de CSV pendente).
- JWT de campo: plugar os módulos de campo na Edge Function
sime-login (mesmo mecanismo
já usado pelas TVs).
- Ver "MÓDULOS PENDENTES" no
CLAUDE.md para o restante (Realtime nos TVs, Edge Function
de WhatsApp, geração dos QR Codes).
Documentação completa
Arquitetura, papéis, chaves de dados, RPCs e cronograma: veja CLAUDE.md na raiz.
Licença
Distribuído sob a licença MIT — veja o arquivo LICENSE.
