Vertces — Gerador de Memorial INCRA + Planilha SIGEF
Sistema para empresa de topografia/georreferenciamento: recebe o TXT da máquina
de topografia, apresenta formulário de conferência (dados do serviço,
confrontantes, vértices) e gera o Memorial Descritivo GEO (DOCX) e a
Planilha Eletrônica de Dados Georreferenciados (ODS oficial SIGEF).
Arquitetura
- Frontend: React + Vite + TypeScript (deploy Vercel). Não contém segredos;
o preview do rodapé reutiliza o mesmo motor puro apenas para exibição.
- Backend: Supabase — Postgres + RLS, Storage (
uploads-txt, templates,
gerados, todos privados) e Edge Functions (Deno):
parse-txt — valida o TXT, detecta fuso, converte coordenadas (proj4),
sugere trechos/tipos e cria o serviço em rascunho. Quando o serviço
confronta com área certificada, recebe também os CSVs de exportação do
SIGEF dos vizinhos com os vértices escolhidos e os une ao levantamento
(_shared/certificados.ts: igualar a ≤ tolerância, inserir no lado mais
próximo; o vértice sai com código/GMS/método/σ/Z do vizinho).gerar-documentos — monta o serviço a partir do banco (fonte da verdade),
aloca códigos de vértice (contadores transacionais via RPC
alocar_contadores), gera DOCX + ODS e grava no bucket gerados
(regeração ilimitada, arquivos sobrescritos).admin-setup — ferramenta de deploy p/ subir os templates oficiais ao
bucket templates (protegida por segredo na tabela config_setup).
- Motor geodésico (
supabase/functions/_shared/geo.ts): pipeline
auto-consistente — UTM → geográficas (SIRGAS2000), arredondamento canônico
dos segundos a 3 casas (half-up), re-projeção e TODOS os cálculos (azimutes,
distâncias, área shoelace, perímetro) no plano re-projetado.
Comandos
npm install
npm test # todos os testes do motor e dos geradores (node --test)
npm run test:engine # só os testes de aceitação do motor (LARISSA.txt)
npm run test:rls # isolamento entre escritórios num Postgres descartável
npm run dev # frontend local (precisa de .env)
npm run build # build de produção
npm run make:docx-template # regenera reference/memorial-template.docx
npm run upload:templates # envia templates ao Storage (env: SETUP_SECRET)
npm run deploy:functions # publica as 9 edge functions a partir do repositório
npm run e2e # teste end-to-end contra o backend implantado
O GitHub Actions roda testes, RLS e build em todo push (.github/workflows/ci.yml)
e publica as edge functions sob demanda (Actions → "Deploy das edge functions";
precisa do secret SUPABASE_ACCESS_TOKEN).
Variáveis de ambiente
Ver .env.example. Frontend: VITE_SUPABASE_URL, VITE_SUPABASE_ANON_KEY
e as opcionais VITE_SUPORTE_*, VITE_SENTRY_DSN (o autocadastro, #/assinar,
abre e fecha no painel do superadmin, não por variável).
Scripts: SUPABASE_URL, SUPABASE_ANON_KEY, SETUP_SECRET, E2E_EMAIL,
E2E_PASSWORD, SUPABASE_DB_URL (backup).
Deploy
- Banco: aplicar
supabase/migrations/*.sql (via MCP/CLI/painel).
- Segredo de setup:
insert into config_setup values ('setup_secret', '<aleatório>').
- Edge Functions:
npm run deploy:functions (todas; verify_jwt vem de
supabase/config.toml — só a admin-setup fica sem JWT). Segredo extra:
MAPBOX_TOKEN.
- Templates:
npm run make:docx-template && npm run upload:templates.
- Usuários: criar operadores via painel do Supabase (Auth → e-mail/senha).
Com a migração de escritórios aplicada, o cadastro é pela tela
("Criar conta") e a equipe em Configurações → Equipe.
- Frontend (Vercel): passo a passo em
docs/operacao/publicar-na-vercel.md.
Documentação de operação e produto:
docs/multiescritorio/ — migração de vários escritórios (proposta, com teste) e ordem de aplicaçãodocs/operacao/ — Vercel, backup/restauração e monitoramento de errosdocs/legal/ — minutas de termos de uso e política de privacidade (revisão jurídica pendente)docs/guia-primeiros-passos.md — onboarding do cliente (também na tela Ajuda)docs/comercial/ — cliente ideal, roteiro de abordagem/demo, proposta e conteúdo
Fixtures de referência (reference/)
LARISSA.txt — TXT real usado nos testes de aceitação (fuso 24S).PLANTA.ODS — planilha oficial SIGEF usada como template-base.5MEMORIAL-INCRA.DOC — memorial legado de referência do fraseado.
