P-15
Cadência
Um app de consultoria fitness gerado por IA, levado a padrão de produção: RLS sem avaliação por linha, treino que não se perde offline e CI que testa o banco de verdade
cliente████Consultoria fitness de pequeno porte (personal trainers e nutricionistas) com alunos pagantes
Engenheiro responsável por levar o app a padrão de produção: migração de hospedagem, segurança, CI, plano de correções e auditoria de performance
PWA de consultoria fitness com três áreas (aluno, professor e admin): prescrição de treinos e dietas, registro de séries e cargas, check-ins com foto, métricas, questionários, arena social com ranking, financeiro, avisos em massa e exportação de relatórios. O app nasceu numa plataforma de geração por IA e foi assumido como projeto de engenharia em setembro de 2026: migração para Cloudflare Workers, auditoria em cinco frentes, correções em nove fases e auditoria de performance com base sintética de 100 professores e 10 mil alunos. Supabase com 41 tabelas sob RLS, 44 funções SQL, 7 edge functions em Deno, 4 jobs de pg_cron e um CI de seis jobs que sobe o banco do zero, roda 36 verificações de RLS e falha se uma consulta passar de 500 ms na escala alvo.
- pwa
- react
- supabase
- postgres
- rls
- edge
- pg-cron
- cloudflare
- ci
- csp
- lgpd
01Visão geral
Cadência é a plataforma que uma consultoria fitness usa para atender os alunos: o professor monta treinos e dietas, o aluno registra o que fez no celular e a administração acompanha adesão, cobranças e questionários. É um PWA (aplicativo web instalável) com três áreas, cada uma com o seu papel: aluno, professor e admin. O aluno vê o treino do dia, marca séries e cargas, segue a dieta, faz check-in diário, registra peso e fotos e participa de uma arena social com ranking mensal. O professor prescreve a partir de uma biblioteca de exercícios, alimentos e modelos, e enxerga só os alunos vinculados a ele. O admin cuida de planos, assinaturas, cobranças, avisos em massa, exportação de relatórios e da equipe.
O aplicativo nasceu em fevereiro de 2026 numa plataforma de geração de apps por IA (Lovable), que produziu em dois meses a base de telas e de banco. Em setembro de 2026 ele foi assumido como projeto de engenharia: migrado para Cloudflare Workers, auditado em cinco frentes (segurança, fluxos de produto, arquitetura, prontidão para a App Store e bugs), corrigido em nove fases e, por fim, submetido a uma auditoria de performance com uma base sintética de 100 professores e 10 mil alunos, que é a escala que o negócio quer alcançar com o app nas lojas.
Este case é sobre essa segunda etapa: o que significa pegar um app gerado por IA, com dados de gente real em produção, e deixá-lo pronto para crescer 700 vezes sem perder treino, vazar dado de aluno ou cobrar duas vezes.
02O problema
Um app gerado por IA tem uma qualidade enganosa: as telas existem, os botões respondem e o banco tem as tabelas certas. A auditoria de setembro encontrou o que isso esconde:
- Perda de trabalho do aluno. Um treino de cinquenta minutos vivia só em memória e sumia quando a tela bloqueava. Os exercícios marcados como concluídos nunca eram gravados, então o professor não enxergava adesão, que é o que a consultoria vende.
- Escritas de várias etapas sem transação. Editar um modelo de treino apagava os exercícios e podia não reinseri-los. Atribuir uma dieta ignorava o erro de uma refeição e mostrava "sucesso" com o plano incompleto.
- Autorização só na tela. Um professor sem vínculo conseguia prescrever dieta para qualquer aluno com um POST direto. Um aluno podia reativar o próprio plano e desligar a troca de senha obrigatória editando o próprio perfil.
- Números errados apresentados com confiança. Nenhuma das 28 telas tratava erro de consulta. O dashboard financeiro mostrava receita zero por causa de um erro 400 que ninguém via.
- Escala. Com a base sintética, listas eram cortadas em 1.000 linhas sem aviso, a receita do admin mostrava 14% do valor real, abrir um treino levava 9 segundos e uma consulta de cargas anteriores passava de 42 segundos e caía por timeout.
- Operação. Um único ambiente (produção), deploy manual pelo gerador, migrations que não rodavam do zero e nenhum teste de política de acesso.
03A solução
O app foi mantido na mesma stack (React + Supabase), sem reescrita. O trabalho foi de engenharia sobre o que existia: fronteira de dados, transações no banco, políticas corretas, CI que exercita o banco, e uma auditoria de performance com método antes/depois.
Para o aluno
- Treino do dia com registro de séries e cargas, cargas anteriores de cada exercício e rascunho que sobrevive ao bloqueio da tela.
- Registro de treino idempotente e com fila offline: sem rede, o treino fica guardado no aparelho e é enviado na próxima abertura, mesmo que o app tenha sido fechado ou atualizado.
- Dieta em vigor com macros, check-in de refeições com foto (reduzida no aparelho antes do upload: de 5,7 MB para 454 kB).
- Check-in diário, métricas (peso, altura, percentual de gordura, fotos), questionários agendados e notificações in-app e por Web Push.
- Arena: feed mensal com posts de treino, curtidas, comentários, ranking de pontos, denúncia e bloqueio.
- Onboarding inicial, troca de senha obrigatória no primeiro acesso e exclusão da própria conta.
Para o professor
- Lista dos alunos vinculados com busca no banco, prontuário completo, atribuição de modelos de treino e dieta, e avisos só para os próprios alunos.
Para o admin
- Gestão de alunos, professores e administradores, planos e assinaturas, cobranças paginadas, dashboard financeiro agregado no banco.
- Avisos em massa resolvidos no servidor ("notificar todos" chega a 10 mil alunos em 312 ms), notificações automáticas por gatilho (cobrança vencendo, aluno inativo, treino novo, dieta nova, lembrete de check-in).
- Exportação de 10 relatórios em CSV e PDF, com o volume calculado antes do clique e teto por arquivo (200 mil linhas no CSV, 5 mil no PDF).
- Configuração por plataforma: versão mínima do app e interruptores de funcionalidade sem publicar binário novo.
- App gerado por IA (Lovable, fev–mar/2026) assumido como projeto de engenharia e levado a padrão de produção sem reescrita
- RLS em 41 tabelas avaliada uma vez por consulta: banco de uma passada pelas telas de 11.918 para 392 ms na escala de 10 mil alunos
- Registro de treino idempotente, transacional e com fila offline que sobrevive a deploy: sem rede, de 0 para 1 treino gravado
- Idempotência por chave nas RPCs financeiras e de cópia, com lock por aluno: clique duplo de 2 cobranças para 1
- CI que sobe o Supabase do zero, confere os tipos gerados, roda 36 verificações de RLS e 47 testes de integração contra a API real
- Guardrail semanal com 100 professores e 10.007 alunos: consulta acima de 500 ms ou resposta cortada em 1.000 linhas falha o CI
- Nenhuma função SQL executável sem login, com checagens que falham fechado; correção aplicada em produção com logs sem uso do furo
- CSP sem unsafe-inline em script-src, com o único script inline por hash SHA-256 verificado por teste
- Prontidão para App Store: exclusão de conta, denúncia e bloqueio, versão mínima por plataforma, interruptores e teste que impede venda na área do aluno
- Exportação completa por cursor: check-ins do mês de 1.000 linhas sem nome para 146.529 com nome em 2 s
04Arquitetura
Ler o diagrama como lista (19 componentes, 20 conexões)
Componentes
- Clientes: App do aluno (PWA)<br>treino · dieta · check-in · arena, Painel do professor<br>alunos vinculados · prescrição, Painel do admin<br>financeiro · exportação · avisos
- Cloudflare Workers: SPA React 18 + Vite<br>37 rotas lazy · CSP por hash<br>service worker (precache + push), _headers<br>CSP · nosniff · frame-ancestors
- Aparelho: IndexedDB<br>cache de consultas · fila offline
- Supabase Edge Functions · Deno (7): create-student / create-staff<br>requireRole(admin), delete-account<br>confirmação + registro, send-notification<br>Web Push RFC 8291 · ≤500 por lote, promote-to-admin<br>reset-student-password
- Postgres (Supabase): 41 tabelas · RLS em todas<br>44 funções SQL · 26 triggers, user_roles + has_role()<br>ids_dos_meus_alunos()<br>(select …) uma vez por consulta, RPCs transacionais<br>log_workout · assinaturas<br>idempotência por chave, pg_cron (4 jobs)<br>questionários · avisos · expurgos, Storage (4 buckets)<br>2 privados · URL assinada 1 h, Realtime<br>só feed_posts
- GitHub Actions: 6 jobs: typecheck · lint · 281 testes<br>migrations do zero · 36 checagens RLS<br>47 testes de integração · CSP/PWA no Chrome, Volume semanal<br>100 professores · 10 mil alunos<br>> 500 ms ou 1.000 linhas = falha
Conexões
- App do aluno (PWA)<br>treino · dieta · check-in · arena → SPA React 18 + Vite<br>37 rotas lazy · CSP por hash<br>service worker (precache + push)
- Painel do professor<br>alunos vinculados · prescrição → SPA React 18 + Vite<br>37 rotas lazy · CSP por hash<br>service worker (precache + push)
- Painel do admin<br>financeiro · exportação · avisos → SPA React 18 + Vite<br>37 rotas lazy · CSP por hash<br>service worker (precache + push)
- _headers<br>CSP · nosniff · frame-ancestors → SPA React 18 + Vite<br>37 rotas lazy · CSP por hash<br>service worker (precache + push)
- SPA React 18 + Vite<br>37 rotas lazy · CSP por hash<br>service worker (precache + push) → IndexedDB<br>cache de consultas · fila offline
- SPA React 18 + Vite<br>37 rotas lazy · CSP por hash<br>service worker (precache + push) → 41 tabelas · RLS em todas<br>44 funções SQL · 26 triggers (anon key + JWT · RLS)
- SPA React 18 + Vite<br>37 rotas lazy · CSP por hash<br>service worker (precache + push) → create-student / create-staff<br>requireRole(admin) (JWT)
- SPA React 18 + Vite<br>37 rotas lazy · CSP por hash<br>service worker (precache + push) → delete-account<br>confirmação + registro
- SPA React 18 + Vite<br>37 rotas lazy · CSP por hash<br>service worker (precache + push) → send-notification<br>Web Push RFC 8291 · ≤500 por lote
- SPA React 18 + Vite<br>37 rotas lazy · CSP por hash<br>service worker (precache + push) → promote-to-admin<br>reset-student-password
- SPA React 18 + Vite<br>37 rotas lazy · CSP por hash<br>service worker (precache + push) → Realtime<br>só feed_posts (WebSocket)
- SPA React 18 + Vite<br>37 rotas lazy · CSP por hash<br>service worker (precache + push) → Storage (4 buckets)<br>2 privados · URL assinada 1 h (URL assinada)
- create-student / create-staff<br>requireRole(admin) → 41 tabelas · RLS em todas<br>44 funções SQL · 26 triggers (service_role)
- send-notification<br>Web Push RFC 8291 · ≤500 por lote → 41 tabelas · RLS em todas<br>44 funções SQL · 26 triggers
- send-notification<br>Web Push RFC 8291 · ≤500 por lote → Serviços de push<br>dos navegadores (VAPID)
- 41 tabelas · RLS em todas<br>44 funções SQL · 26 triggers → user_roles + has_role()<br>ids_dos_meus_alunos()<br>(select …) uma vez por consulta
- 41 tabelas · RLS em todas<br>44 funções SQL · 26 triggers → RPCs transacionais<br>log_workout · assinaturas<br>idempotência por chave
- pg_cron (4 jobs)<br>questionários · avisos · expurgos → 41 tabelas · RLS em todas<br>44 funções SQL · 26 triggers
- 6 jobs: typecheck · lint · 281 testes<br>migrations do zero · 36 checagens RLS<br>47 testes de integração · CSP/PWA no Chrome → CF (wrangler deploy)
- Volume semanal<br>100 professores · 10 mil alunos<br>> 500 ms ou 1.000 linhas = falha → DB
Não existe servidor próprio. O front é uma SPA estática servida por um Cloudflare Worker, que fala direto com o Supabase: PostgREST com RLS para leitura e escrita, RPCs em PL/pgSQL para tudo que precisa de transação ou de agregação, sete edge functions em Deno para o que exige a chave de serviço (criar contas, promover admin, enviar push, excluir conta) e quatro jobs no pg_cron.
A decisão de arquitetura mais importante é a camada de dados em 16 domínios (src/api/*): toda leitura e escrita passa por hooks de um domínio, e uma regra de ESLint proíbe página ou componente de importar o cliente do Supabase ou o TanStack Query diretamente. É isso que permitiu trocar consultas por RPCs, paginar listas e mudar políticas sem tocar nas telas, e é o que torna um app nativo (Capacitor) viável sem duplicar lógica.
05Por dentro
- Postgres 17 no Supabase, com 41 tabelas, 90 migrations (45 delas na fase de endurecimento, de setembro de 2026), 44 funções SQL, 26 triggers e 79 índices. Extensões:
pg_cron,pg_net,pg_trgm. - Regra de escrita: o que tem mais de uma etapa vira RPC transacional. Salvar modelo de treino, atribuir treino ou dieta, criar assinatura com a primeira cobrança, trocar plano, cancelar aluno e registrar treino rodam em PL/pgSQL, numa transação só.
- Idempotência no banco. As RPCs financeiras e de cópia recebem
p_idempotency_key uuid default null; a primeira chamada registra a operação na tabelaidempotenciae a segunda devolve o resultado da primeira sem gravar. As de assinatura ainda tomam um lock por aluno, para duas trocas de plano simultâneas não deixarem duas assinaturas ativas. O registro de treino usa o id gerado ao iniciar o treino, então reenviar nunca duplica. Um job semanal expurga chaves com mais de 30 dias. - Agregação no banco, não no cliente. Dashboard do admin, contagem de alunos por professor, situação de questionários, cargas anteriores, lista de alunos paginada por cursor e aniversariantes da semana são RPCs. O limite de 1.000 linhas do PostgREST deixou de ser uma armadilha silenciosa.
- Compatibilidade com versões antigas do app. Com o app na loja, versões antigas convivem com o backend novo por semanas. A regra documentada é expandir, migrar e só então contrair: parâmetro novo sempre com
default, retorno novo vira função nova, e a coluna antiga só sai depois de subir a versão mínima emapp_config. - Jobs no pg_cron, todos como função SQL
SECURITY DEFINERcom trava contra execução concorrente: questionários agendados (diário), notificações automáticas (diário), expurgo de notificações antigas e de chaves de idempotência (semanais). - Datas no fuso de São Paulo. A classe de erro mais espalhada da auditoria era ler coluna
DATEcomo UTC e voltar um dia; os padrões das colunas de data foram trocados para o fuso local e os testes rodam comTZ=America/Sao_Paulode propósito, para o CI não esconder o caso. - Storage: quatro buckets. Avatares e imagens da arena são públicos; fotos de refeição e arquivos de questionário são privados, com URL assinada de uma hora e política que só libera para o dono, o admin ou o professor vinculado.
- Realtime só na tabela de posts do feed, com contadores denormalizados: curtir ou comentar gera um UPDATE no post com os números novos, e nada mais invalida o feed inteiro.
- React 18 + Vite 5 + TypeScript 5 em modo strict, Tailwind 3, shadcn/ui sobre Radix, TanStack Query 5, react-hook-form com zod, Recharts.
- Uma página por chunk: 37 rotas carregadas sob demanda; o esqueleto comum fica em 185 kB comprimidos e o CI falha se passar de 190 kB, ou se qualquer rota passar de 320 kB. Os gráficos (Recharts) saem do caminho crítico das telas que não os usam: a ficha do aluno caiu de 414 kB para 309 kB.
- PWA com
injectManifest: service worker próprio com precache, atualização por aviso (não automática, para não quebrar abas abertas no meio de um deploy com code splitting), cache de miniaturas e do Storage, e Web Push com clique que só abre caminho interno do app. - Cache de consultas no aparelho (IndexedDB) com dono por usuário: o app abre na hora com o que tinha da última vez e atualiza em segundo plano. O cache de outra conta é descartado; sair da conta apaga tudo. Listas inteiras do admin ficam de fora, de propósito.
- Fila de mutations offline para o registro de treino. Um deploy novo descarta o cache de consultas mas preserva a fila, porque a RPC é idempotente.
- Portão de versão: na abertura, o app compara a própria versão com a mínima da plataforma em
app_confige mostra "atualize o app" em vez de quebrar com erro de API. A consulta sai depois da primeira pintura, para não disputar conexão com os dados da tela. - Erro nunca passa em silêncio:
QueryCache.onError,MutationCache.onErrore um error boundary externo passam por um ponto único de observabilidade, com aviso ao usuário deduplicado por 8 segundos. - Identidade visual própria (set/2026), com sistema de tokens documentado em
DESIGN.md: ambiente azul elétrico, superfícies arredondadas, tipografia Inter Tight para display, modo escuro. - Acessibilidade: zoom nunca bloqueado no viewport (WCAG 1.4.4), manifest em
pt-BR, testes de acessibilidade emsrc/lib. - Um teste que protege uma decisão de negócio: a área do aluno não pode mostrar preço, "assinar", "comprar" nem nome de gateway. O teste varre os arquivos das telas do aluno e falha se alguém acrescentar um "seu plano custa R$ X", porque isso obrigaria a compra no app da Apple (15 a 30% da receita).
- Cloudflare Workers com static assets (
wrangler.jsonc), fallback de SPA, observabilidade do Worker ligada. Os cabeçalhos de segurança vêm depublic/_headers. Assets com hash no nome recebemCache-Control: immutablepor um ano: a revisita sem service worker passou de 6 idas ao servidor para 0. - GitHub Actions com seis jobs a cada push e PR: typecheck, lint, 281 testes unitários e build com orçamento de bundle; Supabase local do zero com as 90 migrations, diff dos tipos gerados contra o schema, 36 verificações de RLS em SQL puro e 47 testes de integração contra PostgREST e Auth reais; validação das 196 strings de
selectcontra o schema; PWA e CSP verificados num Chrome headless servido pelo Worker, não pelovite preview;deno check,deno linte 18 testes das edge functions. O deploy em produção só roda depois de todos. - Job semanal de volume: sobe o Supabase local, popula 100 professores, 10.007 alunos e dois anos de histórico (3,7 GB, cerca de 13 minutos) e falha se uma consulta das rotas principais passar de 500 ms ou voltar cortada em 1.000 linhas. Na primeira execução ele achou uma RPC cortando a lista de alunos.
- CLI do Supabase com versão fixa no CI: uma atualização mudou o formato dos tipos gerados e teria quebrado a comparação sem nenhuma mudança no banco.
- Variáveis de build (URL, chave publicável, chave pública VAPID) vêm das variáveis do repositório. Nenhuma chave de serviço está no código: os secrets das funções ficam no painel do Supabase.
- Região: o banco está em
us-west-2; a migração parasa-east-1(São Paulo) está planejada passo a passo, com o plano Pro já aprovado. Medido a partir da máquina de desenvolvimento, a conexão cai de 211 ms para 38 ms.
06Segurança
8 ataques considerados, 8 defesas em produção.
Pular a interface e falar direto com o banco ou a API, com a chave pública na mão.
Chamar uma RPC de listagem só com a chave pública, sem login
execute revogado de public e anon em toda função; checagens SECURITY DEFINER com 'is not true' (falham fechado); teste no CI falha se qualquer função do public ficar executável por anon
Quem tem algum acesso tentando ganhar mais: virar admin, ler o que não deve, manter acesso revogado.
Professor sem vínculo prescreve dieta ou lê o prontuário do aluno de outro professor
RLS em todas as tabelas com vínculo em staff_students lido por ids_dos_meus_alunos(); WITH CHECK nas escritas; 36 verificações no CI, incluindo 'professor A não lê os treinos do aluno de B'
Aluno reativa o próprio plano ou desliga a troca de senha obrigatória com um PATCH no próprio perfil
Trigger em profiles rejeita alteração de status, fim do plano e must_change_password por quem não é admin nem service role
Usuário comum se promove a admin ou cria contas pela edge function
verify_jwt nas 7 funções, requireRole(admin) antes de usar a chave de serviço, papéis em user_roles separados do perfil; o último admin não pode se rebaixar nem se excluir
CSRF, webhooks falsos, tokens reaproveitados, links assinados e redirecionamento aberto.
Notificação com link externo usada como phishing a partir de dentro do app
O link só pode ser caminho interno (/app/...), validado na edge function e de novo no clique do push no service worker
XSS, iframe, fórmula em CSV, upload disfarçado e manipulação do prompt da IA.
XSS lê o token de sessão guardado no navegador
CSP sem unsafe-inline em script-src (único inline por hash SHA-256 testado), object-src none, base-uri self, frame-ancestors none, nosniff; zero dangerouslySetInnerHTML e zero eval
Estourar a fatura, esgotar limites, inundar logs e derrubar funções com carga.
Consultas lentas prendem o pool de 10 conexões e derrubam a API para todos
statement_timeout de 4 s para authenticated e 3 s para anon, RLS sem avaliação por linha, listas paginadas no banco e guardrail semanal que falha acima de 500 ms
Mexer em contagens, apagar a base, editar o histórico ou negar o que foi autorizado.
Toque duplo ou reenvio após timeout gera duas cobranças ou dois treinos
Chave de idempotência nas RPCs financeiras e de cópia com lock por aluno; registro de treino usa o id gerado ao iniciar e ignora a repetição
Autenticação. Supabase Auth com e-mail e senha. Não existe cadastro público no app: alunos e professores são criados por edge function, com senha temporária forte gerada com crypto.getRandomValues, e a flag must_change_password obriga a troca no primeiro acesso. Esse portão falha fechado: se a leitura do perfil falhar, o app assume que a troca é obrigatória, em vez de liberar a navegação com a senha provisória ainda válida. Os papéis da última sessão ficam no aparelho só para decidir qual tela abrir; quem protege os dados é a RLS.
Autorização em três camadas, todas no banco.
- Papéis em tabela separada (
user_roles), nunca no perfil, consultados porhas_role()SECURITY DEFINERcomsearch_pathfixo. O vínculo professor-aluno vive emstaff_studentse é lido porids_dos_meus_alunos(). - RLS ligada nas 41 tabelas, com políticas
TO authenticated(exceto a leitura do logo na tela de login). O professor só lê e escreve nos alunos vinculados; o aluno só nos próprios dados; a biblioteca de modelos é compartilhada para uso e privada para edição. - Um trigger em
profilesrejeita qualquer tentativa do próprio usuário de alterar colunas administrativas (status, fim do plano,must_change_password), porqueGRANT UPDATEpor coluna não sobreviveria à evolução da tabela. - As políticas são avaliadas uma vez por consulta, não por linha:
has_roleentra em(select …)(InitPlan) e o vínculo vira semi-join. Uma checagem estrutural no CI falha se alguma política voltar ao padrão antigo. Isso é segurança e performance ao mesmo tempo: na base sintética, as leituras no índice deuser_rolesnuma passada pelas telas caíram de 4,5 milhões para 113.
Funções SQL fora do alcance anônimo. Toda função nova revoga execute de public e anon na mesma migration, e um teste no CI falha se qualquer função do schema public ficar executável sem login. As checagens dentro de SECURITY DEFINER usam if (...) is not true, porque com auth.uid() nulo a condição é nula e if not null deixaria passar.
Edge functions. As sete exigem JWT (verify_jwt = true), passam por requireRole antes de usar a chave de serviço, validam cada campo do corpo (e-mail, UUID, tamanho, caracteres proibidos em nomes) e devolvem 500 genérico sem vazar detalhe. send-notification aceita no máximo 500 destinatários por chamada, resolve "todos" no banco, e o professor só alcança os próprios alunos. O link de uma notificação só pode ser caminho interno do app, no servidor e no clique do push, para uma notificação não virar phishing a partir de dentro do produto. O Web Push é implementado com WebCrypto puro (RFC 8030, 8291 e 8292), sem dependência externa. CORS com lista fechada de origens e Vary: Origin.
Exclusão de conta (LGPD e App Store). O próprio usuário apaga a conta com confirmação explícita; o pedido é registrado numa tabela que não entra na cascata antes de apagar auth.users, que leva junto perfil, treinos, dietas, check-ins, métricas e posts por on delete cascade. O único admin não consegue se excluir nem se rebaixar.
Conteúdo gerado por usuário. Denúncia de post ou comentário (uma por pessoa por conteúdo) e bloqueio de usuário, que some com o conteúdo dele nas RPCs do feed e dos comentários.
Front e entrega. CSP sem unsafe-inline em script-src: o único script inline (tema antes da primeira pintura) entra por hash SHA-256, e um teste recalcula o hash a partir do index.html e falha se ele divergir. object-src 'none', base-uri 'self', frame-ancestors 'none', X-Frame-Options: DENY, nosniff, Referrer-Policy e Permissions-Policy fechada. Zero dangerouslySetInnerHTML e zero eval no código.
Limites de dano. statement_timeout de 4 s para authenticated e 3 s para anon: o PostgREST tem 10 conexões para todo mundo e uma consulta presa segura a conexão até o timeout. Uma RPC de reconciliação pesada é só da chave de serviço. Fotos de refeição e arquivos de questionário (dados de saúde) são privados com URL assinada.
Teste de política como parte do CI. O arquivo supabase/tests/rls.sql assume a identidade de cada papel e tenta o que ele não pode: professor A lendo perfil, treinos, dietas e cargas do aluno de B; aluno alterando o próprio status ou estendendo o próprio plano; aluno se cadastrando como profissional; função chamada sem sessão. Roda com psql puro, dentro de uma transação desfeita no fim, e bloqueia o merge.
Correção aplicada em produção (set/2026). A própria auditoria encontrou que uma migration anterior tinha dado execute em todas as funções a anon, e que a checagem de acesso de uma RPC de listagem de alunos falhava aberta sem sessão. A correção fechou 25 funções para o papel anônimo e reescreveu a checagem para falhar fechada; a chamada sem login passou de 200 com a lista para 401. Os logs de API disponíveis no período não registraram uso do furo.
07Desafios técnicos
RLS que custava 4,5 milhões de leituras por passada
As políticas já envolviam auth.uid() em (select …), mas não as funções de papel e vínculo. Como elas são SECURITY DEFINER, o planner não as inlineia, e políticas permissivas se combinam com OR: a de admin era testada em toda linha, para todo papel. Com 127 mil cobranças, um count do admin levava 1.370 ms. A reescrita foi mecânica e sem mudar o que cada papel vê: has_role dentro de (select …) e o vínculo como coluna in (select ids_dos_meus_alunos()). O banco de uma passada pelas 16 rotas caiu de 11.918 ms para 392 ms, e um script de reversão foi gerado a partir de pg_policies antes da migration.
Treino que se perdia sem rede
O fluxo central do produto gravava em dois inserts soltos com id novo a cada tentativa: reenviar depois de um timeout duplicava o treino, e se o segundo insert falhasse ficava um treino sem exercícios. A solução tem três partes: o app gera o id ao iniciar o treino e guarda no rascunho; a RPC log_workout grava log e itens numa transação e ignora a chamada se o id já existe; e a mutation entra numa fila persistida no IndexedDB, retomada na próxima abertura mesmo que o componente que a disparou não exista mais. O caso mais traiçoeiro foi o deploy: o buster de cache do TanStack descartava a fila junto com as consultas, e um treino registrado antes de uma build nova sumia. O restoreClient foi reescrito para descartar as consultas e preservar a fila.
Exportação completa sem derrubar o banco
Os relatórios carregavam tabelas inteiras e paravam em 1.000 linhas, 90% delas sem nome por causa de um embed inválido. A primeira ideia (embed de workouts(nome) por página) custava 1.708 ms contra 213 ms; a paginação por offset levava 1,6 s na página 199 mil. O resultado: cursor por coluna de data e id, mapa de nomes carregado uma vez, e o volume calculado antes do clique com o que será recusado em destaque. Os check-ins de um mês passaram de 1.000 linhas sem nome para 146.529 com nome, em 2 segundos. E o statement_timeout de authenticated pôde cair de 8 s para 4 s depois que as consultas longas saíram do caminho.
Um cron parado por três semanas
O cron de questionários recorrentes calculava a próxima data como data + 7 mesmo quando ela já tinha passado: parado três semanas, um agendamento semanal virava um aviso por dia até alcançar hoje, e, para "todos os alunos", 10 mil avisos por dia perdido. Agora a próxima data é a primeira depois de hoje, cópias do mesmo agendamento são marcadas juntas, e o envio para "todos" ignora inativos. Medido: cron parado três semanas, de 3 avisos para 1.
08Resultados
Tudo medido localmente, A/B na mesma máquina, com a base sintética de 100 professores e 10.007 alunos e o mesmo método nos dois lados (docs/audit/07-relatorio-final.md).
| O que | Antes | Depois |
|---|---|---|
| Banco somado numa passada pelas 16 rotas | 11.918 ms | 392 ms |
Leituras no índice de user_roles na mesma passada |
4.539.385 | 113 |
| Cargas anteriores do treino (EXPLAIN) | 42.682 ms, timeout | 2,98 ms |
| Execução de treino até ficar ociosa | 9.158 ms | 753 ms |
/admin/students: Lighthouse · TBT · alunos alcançáveis |
65 · 1.807 ms · 1.000 de 10.007 | 99 · 95 ms · 10.007 |
| Receita do mês no cartão do admin | 14% do valor real | igual ao SQL |
| Tela de login | 579 kB | 333 kB |
| "Notificar todos" | HTTP 400 | 10.007 alunos em 312 ms |
| Testes unitários · integração · Deno · RLS | 193 · 0 · 0 · 20 | 281 · 47 · 18 · 36 |
Nenhum comportamento regrediu: a visibilidade de dados por papel foi comparada antes e depois (10.007 de 10.007 alunos com a mesma situação), e package-lock.json e deno.lock ficaram idênticos ao baseline.
Os números de produção real (usuários, receita, uso) não entram no case.
- 41
- Tabelas sob RLS
- 90
- Migrations
- 44
- Funções SQL
- ≈99
- Policies RLS
- 26 · 79
- Triggers · índices
- 7
- Edge functions
- 4
- Jobs pg_cron
- 43 · 37
- Rotas · chunks lazy
- 16
- Domínios da camada de dados
- 281
- Testes unitários
- 47 · 18 · 36
- Testes de integração · Deno · RLS
- 855
- Commits
- ≈50 mil
- Linhas TS/TSX
- ≈8 mil
- Linhas SQL
- 11.918 → 392 ms
- Banco por passada nas telas (escala alvo)
como medimos
Tables em src/integrations/supabase/types.ts; todas aparecem em ALTER TABLE ... ENABLE ROW LEVEL SECURITY nas migrations
como medimos
ls supabase/migrations | wc -l (45 com timestamp de set/2026)
como medimos
CREATE [OR REPLACE] FUNCTION distintos nas migrations (39 expostas em types.ts)
como medimos
CREATE POLICY distintos por nome e tabela nas migrations (205 statements no histórico, 31 DROP); contagem viva exige pg_policies
como medimos
CREATE TRIGGER e CREATE INDEX distintos nas migrations
como medimos
ls supabase/functions (pastas), todas com verify_jwt = true em config.toml
como medimos
cron.schedule nas migrations menos cron.unschedule posteriores
como medimos
<Route> e lazy() em src/App.tsx
como medimos
ls src/api (fronteira travada por no-restricted-imports no eslint.config.js)
como medimos
npx vitest run: 40 arquivos, 281 testes passando (executado em 2026-10-29)
como medimos
it()/test() em src/test/integracao (13 arquivos); deno test (18 passed); chamadas a verificar() em supabase/tests/rls.sql
como medimos
git rev-list --count HEAD (fev–out/2026; 719 do bot do gerador, 128 do Bernardo a partir de set/2026)
como medimos
wc -l em .ts/.tsx versionados (18.164 + 31.730, incluindo 2.272 de tipos gerados)
como medimos
wc -l em .sql versionados (7.007 nas migrations)
como medimos
docs/audit/07-relatorio-final.md, pg_stat_statements, 16 rotas, base sintética de 10.007 alunos
09Linha do tempo
- fev 2026
Início numa plataforma de geração por IA: Supabase, áreas de admin, professor e aluno, treinos, dietas e financeiro
- mar 2026
Questionários dinâmicos com agendamento, check-in de refeições com foto e envio de acesso ao aluno
- set 2026
Migração da hospedagem para Cloudflare Workers, CI com deploy, autenticação centralizada nas edge functions e endurecimento de RLS
- set 2026
Auditoria em cinco frentes e plano de correções F0–F9: transações, autorização no banco, datas, erros, App Store, testes de RLS no CI
- set 2026
Nova identidade visual e onboarding inicial do aluno
- set 2026
Auditoria de performance com base sintética de 10 mil alunos: RLS sem avaliação por linha, paginação, idempotência, fila offline, portão de versão e guardrails semanais
- set 2026
Correção de segurança aplicada em produção: nenhuma função SQL executável sem login
- out 2026
Plano Pro aprovado e roteiro de migração do banco para São Paulo (conexão de 211 para 38 ms)
10Stack
- React 18
- Vite 5 (SWC)
- TypeScript 5 strict
- Tailwind CSS 3
- shadcn/ui (Radix)
- TanStack Query 5 + IndexedDB
- react-router 6
- react-hook-form + zod
- Recharts
- Workbox 7 (service worker próprio)
- PostgREST
- PL/pgSQL (RPCs transacionais e idempotentes)
- Supabase Edge Functions (Deno 2)
- Web Push em WebCrypto puro
- PostgreSQL 17 (Supabase)
- Row Level Security
- pg_cron
- pg_net
- pg_trgm
- Supabase Storage
- Supabase Realtime
- Cloudflare Workers (static assets)
- wrangler 4
- GitHub Actions (6 jobs + volume semanal)
- Supabase CLI fixa no CI
- Node 22
- Supabase Auth
- user_roles + has_role() SECURITY DEFINER
- RLS sem avaliação por linha
- trigger de colunas administrativas
- revoke execute from anon
- verify_jwt + requireRole
- validação de entrada
- CSP por hash
- statement_timeout por papel
- URLs assinadas
- testes de RLS no CI
11Ficha técnica
- type
- PWA de consultoria fitness · 3 papéis
- stack
- React 18 · Vite · Deno edge · PL/pgSQL
- db
- Postgres 17 · 41 tabelas · RLS em todas
- auth
- Supabase Auth · user_roles · falha fechado
- offline
- cache em IndexedDB · fila idempotente
- jobs
- pg_cron ×4 · guardrail semanal com 10 mil alunos
- deploy
- Cloudflare Workers · CI de 6 jobs
- status
- concluído · pronto para as lojas
A plataforma da campanha pelo fim da escala 6x1: adesão nacional, rede de voluntários e defesa anti-bot em 7 camadas
A plataforma que pôs milhares de criadores de conteúdo na campanha pelo fim das bets: cadastro nacional, contador público à prova de inflação e painel blindado contra força bruta.
Captação, militância e CRM de mobilização numa só base, com o Postgres decidindo quem é quem.
Quer um sistema assim para a sua operação?
A Node projeta, constrói e protege plataformas sob medida para campanhas, mandatos e movimentos.

TECNOLOGIA E INTELIGÊNCIA POLÍTICA
© 2026 NODE. Todos os direitos reservados.