P-14
Plantão Gaúcho
Portal de notícias com painel de redação, capa curada e preview certo no WhatsApp.
clientePortal de notícias regional do Rio Grande do Sul
Portal de notícias regional com painel administrativo para uma redação não técnica: editor de texto rico, imagens comprimidas no navegador, curadoria da capa por arrastar e soltar e newsletter. SPA em React sobre Supabase, com toda regra de acesso em Row Level Security, e um Cloudflare Worker no domínio que entrega Open Graph aos robôs de preview para os links compartilhados no WhatsApp mostrarem foto e título.
- react
- supabase
- postgres
- rls
- cloudflare
01Visão geral
O Plantão Gaúcho é um portal de notícias do Rio Grande do Sul: home com manchete e destaques escolhidos pela redação, ticker de últimas notícias, editorias (Política, Economia, Brasil, Mundo, Interior, Cultura, Saúde, Segurança, Opinião e outras), busca, página de matéria com compartilhamento e um cadastro de newsletter.
Por trás do site público existe um painel administrativo completo para a redação: editor de texto rico, upload de imagens que se comprimem sozinhas no navegador, controle de rascunho/publicado/oculto, curadoria da capa por arrastar e soltar, configurações do site (SEO, rodapé, redes sociais) e a lista de inscritos da newsletter com exportação em CSV.
O projeto saiu do primeiro layout ao portal conectado ao banco, com painel e preview de link no WhatsApp, em cerca de cinco semanas (abril a maio de 2026).
02O problema
Um veículo regional precisava de um portal próprio, rápido de operar por uma redação pequena e sem depender de um CMS genérico. Três exigências moldaram o projeto:
- Quem publica não é técnico. A redação precisa escrever, subir foto, escolher a manchete e publicar sem ajuda, inclusive pelo celular.
- A distribuição acontece no WhatsApp e nas redes. Se o link da matéria não mostrar foto e título no preview, ninguém clica. Uma SPA em React, sozinha, não resolve isso: os robôs de preview não executam JavaScript.
- As fotos chegam direto da câmera, com 10 a 20 MB, acima do limite de cerca de 5 MB que o WhatsApp aceita no preview.
03A solução
Portal público
- Capa com uma manchete principal e dois destaques secundários escolhidos pela redação, com cadeia de fallback (slot definido → matéria marcada como destaque → a mais recente) para a capa nunca ficar vazia.
- Ticker horizontal de últimas notícias, com pausa ao passar o mouse.
- 11 editorias navegáveis (10 reais e uma visão virtual "Últimas"), página por editoria e busca por título, subtítulo e editoria.
- Página de matéria com tempo de leitura, matérias relacionadas da mesma editoria (ou as mais recentes, se não houver) e botões de compartilhamento para WhatsApp, Facebook e X usando a URL limpa do domínio.
- Popup de newsletter após 10 segundos na primeira visita, com validação e máscara de telefone; aviso de cookies.
Painel da redação (/admin)
- Dashboard com contagem de publicados, rascunhos e ocultos.
- Lista de matérias com filtros, alternância de status e destaque, e exclusão.
- Formulário de matéria com editor TipTap (negrito, itálico, listas, citação, links, imagens inline), slug editável, autor, tags, legenda da imagem e escolha de posição na capa.
- Painel de capa com arrastar e soltar (dnd-kit) para ordenar os destaques secundários.
- Contagem de matérias por editoria, configurações do site e gestão da newsletter com busca e exportação CSV (com BOM, para abrir certo no Excel).
- Barra de "você está vendo o site como administrador" ao navegar pelo portal logado.
Preview de link nas redes
- Um Cloudflare Worker na rota
/artigo/*do domínio entrega HTML com Open Graph da matéria para os robôs de preview e repassa a requisição intacta para leitores humanos.
- Nenhum backend próprio entre o navegador e o banco: 15 policies de RLS em 4 tabelas decidem quem lê e quem escreve.
- Papéis em tabela sem policy de escrita: ninguém se promove a admin pela API pública.
- Rascunhos não vazam: saber o slug de uma matéria não publicada devolve vazio para quem não é admin.
- Cloudflare Worker no domínio entrega Open Graph aos robôs de preview e repassa leitores humanos intactos.
- Fotos de câmera de 10 a 20 MB redimensionadas no navegador (1600 px, JPEG 0,82) antes do upload.
- Slug único gerado por trigger no Postgres, com unaccent e respeito à edição manual.
04Arquitetura
Ler o diagrama como lista (14 componentes, 12 conexões)
Componentes
- Clientes: Leitor<br>portal público (SPA), Redação<br>painel /admin, Crawlers de preview<br>WhatsApp · Facebook · X
- Cloudflare (domínio do portal): Worker og-meta<br>rota /artigo/*<br>detecta crawler pelo User-Agent
- PostgreSQL · RLS em 4 tabelas · 15 policies: articles<br>slug · status · hero_slot, user_roles<br>has_role() SECURITY DEFINER, site_settings, newsletter_subscribers
- Supabase: Auth<br>e-mail + senha, PostgREST<br>chave anon + JWT, Edge Function og-meta<br>(Deno), PG, Storage<br>bucket article-images
Conexões
- Leitor<br>portal público (SPA) → Worker og-meta<br>rota /artigo/*<br>detecta crawler pelo User-Agent
- Crawlers de preview<br>WhatsApp · Facebook · X → Worker og-meta<br>rota /artigo/*<br>detecta crawler pelo User-Agent
- Worker og-meta<br>rota /artigo/*<br>detecta crawler pelo User-Agent → SPA estática<br>React 18 + Vite<br>React Query · TipTap (humano: repassa)
- Worker og-meta<br>rota /artigo/*<br>detecta crawler pelo User-Agent → PostgREST<br>chave anon + JWT (crawler: HTML com OG)
- Worker og-meta<br>rota /artigo/*<br>detecta crawler pelo User-Agent → Proxy de imagem<br>1200×630 JPEG q80 (og:image)
- Redação<br>painel /admin → SPA estática<br>React 18 + Vite<br>React Query · TipTap
- SPA estática<br>React 18 + Vite<br>React Query · TipTap → Auth<br>e-mail + senha
- SPA estática<br>React 18 + Vite<br>React Query · TipTap → PostgREST<br>chave anon + JWT
- SPA estática<br>React 18 + Vite<br>React Query · TipTap → Storage<br>bucket article-images (upload comprimido no navegador)
- PostgREST<br>chave anon + JWT → PG
- Edge Function og-meta<br>(Deno) → PostgREST<br>chave anon + JWT
- articles<br>slug · status · hero_slot → user_roles<br>has_role() SECURITY DEFINER (policies chamam)
A aplicação é uma SPA estática que fala direto com o Supabase pela chave pública (anon). Não existe backend próprio entre o navegador e o banco: toda regra de acesso mora no Postgres, em Row Level Security. A única peça de servidor escrita à mão fica na borda: o Worker do Cloudflare que resolve o preview de links.
05Por dentro
- 4 tabelas em 7 migrations:
articles,user_roles,site_settingsenewsletter_subscribers, mais o bucketarticle-imagesno Storage. - Enums para papel (
app_role) e status da matéria (published,draft,hidden), em vez de texto livre. - Slug gerado no banco. A função
generate_slugusaunaccent, normaliza para[a-z0-9-]e acrescenta sufixo numérico até achar um valor livre. Um triggerBEFORE INSERT OR UPDATEgera o slug na criação e o regenera quando o título muda, mas só se o slug não foi editado à mão. A coluna temNOT NULLeUNIQUE; a migration que a criou fez backfill das matérias existentes antes de aplicar as restrições. - Curadoria da capa no schema.
hero_slotaceita sómainousecondary(CHECK) ehero_orderdefine a ordem; dois índices parciais (WHERE hero_slot IS NOT NULL) atendem as consultas da capa sem indexar o resto da tabela. Uma migration de seed idempotente preencheu a capa a partir das matérias em destaque, sem sobrescrever nada se a redação já tivesse escolhido. updated_atpor trigger emarticlesesite_settings.- Configurações como chave/valor (
site_settings): título e descrição de SEO, ID do Analytics, textos de rodapé e redes sociais, editáveis pelo painel sem deploy. - Edge Function
og-meta(Deno): primeira versão do preview de links, que responde HTML com Open Graph para crawlers e redireciona humanos para a URL do portal.
- React 18 + Vite + TypeScript, Tailwind CSS e componentes shadcn/ui (Radix), ícones Lucide.
- TanStack React Query para todo acesso a dados, com
staleTimede 5 minutos: navegar entre capa, editoria e matéria reaproveita o cache em vez de refazer consultas. - Rotas: 4 públicas (
/,/artigo/:slug,/categoria/:slug,/busca), login e 7 rotas de painel protegidas porProtectedRoute. - Editor TipTap com upload de imagens inline direto para o Storage, nomes de arquivo aleatórios (
inline/<timestamp>-<aleatório>; capa comcrypto.randomUUID()). - Compressão de imagem no navegador antes do upload: largura máxima de 1600 px, JPEG com qualidade 0,82, ignorando arquivos já pequenos (até 400 KB e dentro da largura) e mantendo o original se a versão comprimida não ficar menor. SVG e GIF passam sem conversão.
- Formulário de newsletter validado com Zod (tamanho de nome, e-mail, cidade; telefone de 10 a 20 caracteres só com dígitos e
()+-) e máscara de telefone brasileiro. - Ordenação da capa com dnd-kit, persistindo
hero_orderde cada item.
- Front: build estático do Vite servido por uma plataforma de hospedagem de SPA; o domínio do portal fica atrás do Cloudflare.
- Cloudflare Worker
og-metaem duas rotas (dominio/artigo/*ewww.dominio/artigo/*). Para crawlers, busca a matéria no PostgREST comcf.cacheTtlde 300 s e responde comCache-Control: public, max-age=300e o cabeçalhoX-OG-Worker: hit(oufallback, em caso de erro). Para humanos, repassa a requisição para a origem do SPA sem alterar o corpo. - Supabase para Postgres, Auth, Storage e a Edge Function (
verify_jwt = falsesó nela, porque crawlers não mandam token). - Deploy do Worker documentado passo a passo no repositório (rotas, teste com
curl -A "WhatsApp/2.0", rollback removendo as rotas), pensado para a equipe do cliente operar sem o desenvolvedor.
06Segurança
6 ataques considerados, 6 defesas em produção.
Pular a interface e falar direto com o banco ou a API, com a chave pública na mão.
Ler rascunhos ou matérias ocultas adivinhando o slug ou consultando a API
Policy pública libera só status = 'published'; leitura do resto exige has_role(auth.uid(), 'admin')
Quem tem algum acesso tentando ganhar mais: virar admin, ler o que não deve, manter acesso revogado.
Chamar a API com a chave pública e se inserir como admin em user_roles
user_roles só tem policy de SELECT do próprio registro; INSERT/UPDATE/DELETE são negados pelo RLS
Publicar, editar ou apagar matérias e imagens com uma conta comum
Toda escrita em articles, site_settings e no bucket checa has_role() SECURITY DEFINER com search_path fixo
CSRF, webhooks falsos, tokens reaproveitados, links assinados e redirecionamento aberto.
Usar o redirecionamento da Edge Function como open redirect
O destino é sempre a URL fixa do portal + /artigo/<slug>; não há parâmetro de destino
XSS, iframe, fórmula em CSV, upload disfarçado e manipulação do prompt da IA.
Injetar HTML/script no preview servido aos robôs via título ou subtítulo
Worker e Edge Function escapam & < > " ' e removem tags do corpo antes de montar o HTML
Enumerar quem está na base, raspar dados pessoais, ligar perguntas a pessoas, extrair segredos.
Baixar a lista de inscritos da newsletter (nome, e-mail, telefone, cidade)
Tabela somente-escrita para o público: SELECT e DELETE só para admin
O desenho parte de uma premissa: a chave anon está no bundle do navegador e qualquer pessoa pode chamar a API do Supabase diretamente. Por isso nenhuma regra depende do frontend; o que vale é o banco.
Autenticação
- Login da redação por e-mail e senha no Supabase Auth. Mensagem de erro única ("Email ou senha incorretos.") que não revela se o e-mail existe.
- Não há tela de cadastro: contas são criadas pela administração, e ter conta não basta para entrar no painel.
Autorização e RLS
- RLS habilitado nas 4 tabelas, com 15 policies no total (incluindo as do Storage).
- Papéis em tabela própria (
user_roles), não numa coluna de perfil editável pelo usuário. A tabela só tem policy deSELECTpara o próprio usuário; não existe policy deINSERT,UPDATEouDELETE, então ninguém se promove a admin pela API. has_role()comoSECURITY DEFINERcomsearch_pathfixo, usada por todas as policies de escrita. Isso evita recursão de RLS e impede sequestro de função por um schema malicioso no caminho de busca.- Rascunhos e matérias ocultas não vazam. O público só lê
status = 'published'. Saber o slug de um rascunho não adianta: a consulta volta vazia para quem não é admin. O preview de matéria não publicada funciona para a redação porque a policy de admin libera a leitura, não porque o front esconde algo. - Escrita só por admin em
articles,site_settingse no bucket de imagens (INSERT,UPDATEeDELETEchecamhas_role(auth.uid(), 'admin')). - Newsletter somente-escrita para o público. Qualquer visitante pode se inscrever (
INSERT), mas listar e apagar inscritos exige papel de admin. A chave anon não lê nenhum dado pessoal. - Checagem de papel falha fechada no cliente. Se a consulta de papel der erro, o painel trata o usuário como não admin.
Superfície pública na borda
- O Worker e a Edge Function usam só a chave anon, sujeita às mesmas policies: só leem matérias publicadas e não carregam credencial de serviço.
- Todo valor vindo do banco é escapado (
& < > " ') antes de entrar no HTML de Open Graph; o conteúdo da matéria vira texto puro (tags removidas) antes de virar descrição. - O redirecionamento de humanos na Edge Function aponta sempre para a URL fixa do portal, montada a partir do slug: não há parâmetro de destino que permita open redirect.
Validação e dados pessoais
- Formulário de newsletter validado com Zod e limites de tamanho; e-mail normalizado em minúsculas e
UNIQUEno banco, com o erro23505tratado como "você já está inscrito" em vez de falha. - Integridade garantida no schema: enums,
NOT NULL,UNIQUEno slug e no e-mail, CHECK emhero_slot.
07Desafios técnicos
Preview de link numa SPA
Robôs do WhatsApp e do Facebook não executam JavaScript, então todas as matérias apareciam com o título e a imagem genéricos do index.html. A primeira solução foi uma Edge Function que servia HTML com Open Graph, mas ela obrigava a compartilhar um link com o domínio do Supabase. A versão final é um Worker no próprio domínio, restrito à rota /artigo/*: identifica o robô por User-Agent (21 padrões), busca a matéria publicada no PostgREST com cache de 5 minutos na borda, escapa tudo e responde em HTML mínimo. Leitores humanos recebem a SPA intacta, e qualquer erro devolve um preview genérico em vez de quebrar o compartilhamento. A URL compartilhada continua sendo a do portal.
Fotos de câmera acima do limite do WhatsApp
Fotos de 10 a 20 MB faziam o preview sair sem imagem. A correção ficou em duas camadas: no upload, o navegador redimensiona para no máximo 1600 px e recomprime em JPEG 0,82 (fotos novas já chegam leves ao Storage); no Worker, a og:image passa por um proxy de imagem que entrega 1200×630 em JPEG q80, o que cobre também as matérias antigas sem reprocessar nada.
Capa curada com fallback
A redação queria escolher manchete e destaques, mas a capa não podia ficar quebrada quando ninguém escolhesse. A solução combina schema (hero_slot com CHECK, hero_order, índices parciais), uma migration de seed que só age se nenhum slot estiver definido e uma consulta com cadeia de fallback que completa os destaques secundários com as matérias mais recentes com imagem, sem repetir a manchete.
Sessão e tela branca no login
O painel tinha uma corrida entre restaurar a sessão salva e o evento inicial do Auth, e em rede instável o carregamento podia ficar preso. O provedor de autenticação passou a restaurar a sessão primeiro, ignorar o evento INITIAL_SESSION já tratado, descartar respostas após desmontar o componente, tratar erro na checagem de papel como "não admin" e liberar o carregamento depois de 8 segundos no pior caso.
08Resultados
- Portal e painel entregues em cerca de 5 semanas: o primeiro commit de código é de 10/04/2026, o último de 14/05/2026.
- 220 commits (145 sem contar merges), 202 deles em abril de 2026.
- 7 migrations, 4 tabelas, 15 policies de RLS, 1 Edge Function e 1 Cloudflare Worker.
- Cerca de 4.770 linhas de código próprio (sem linhas em branco, sem os componentes gerados do shadcn/ui nem os tipos gerados do banco): 3.429 em TSX, 712 em TS, 296 em SQL, 187 em JS e 145 em CSS.
- 220
- Commits
- 10/04 → 14/05/2026
- Período
- 7
- Migrations
- 4
- Tabelas
- 15
- Policies RLS
- 1 + 1
- Edge Functions + Workers
- 4 públicas · 7 admin
- Rotas
- ~4,8 mil
- Linhas de código
como medimos
git log --oneline | wc -l (145 sem merges)
como medimos
datas do primeiro e do último commit de código no git log (excluídos o commit de template e o de README)
como medimos
ls supabase/migrations
como medimos
CREATE TABLE nas migrations
como medimos
grep -c 'CREATE POLICY' nas migrations (inclui 4 do Storage)
como medimos
supabase/functions/og-meta e cloudflare-worker/og-meta-worker.js
como medimos
src/App.tsx
como medimos
linhas não vazias em src, supabase e cloudflare-worker, sem shadcn/ui gerado nem types.ts (TSX 3.429, TS 712, SQL 296, JS 187, CSS 145)
09Linha do tempo
- 10 abr 2026
Layout base com header fixo, capa, feed, ticker, rodapé e página de matéria com dados mock
- 13 abr 2026
Banco no Supabase com RLS, painel administrativo, editor TipTap e slugs gerados no Postgres
- 16 abr 2026
Sugestões de leitura, contagem por editoria e aviso de cookies
- 17 abr 2026
Curadoria da capa com manchete, destaques e ordenação por arrastar e soltar
- abr 2026
20–24/04: Open Graph dinâmico, primeiro via Edge Function e depois via Cloudflare Worker no domínio
- 04 mai 2026
Compressão e redimensionamento de imagens no navegador e proxy de imagem para o preview
- 06 mai 2026
Newsletter com painel de inscritos e exportação CSV
- 14 mai 2026
Correção de corrida na sessão que deixava o login em branco
10Stack
- React 18
- TypeScript
- Vite 5
- Tailwind CSS 3
- shadcn/ui
- TanStack React Query
- TipTap 3
- dnd-kit
- Zod
- Supabase Auth
- PostgREST
- Supabase Edge Functions (Deno)
- Supabase Storage
- PostgreSQL
- Row Level Security
- PL/pgSQL
- Triggers
- unaccent
- Cloudflare Workers
- Cloudflare Worker Routes
- Hospedagem estática de SPA
- RLS em todas as tabelas
- Papéis em tabela própria
- SECURITY DEFINER com search_path fixo
- Escape de HTML na borda
- Validação com Zod
11Ficha técnica
- type
- portal de notícias + painel de redação
- stack
- React 18 · Vite · Supabase
- db
- Postgres · 4 tabelas · 15 policies
- auth
- Supabase Auth + user_roles
- edge
- Cloudflare Worker (Open Graph)
- deploy
- SPA estática + Cloudflare
- modules
- capa · editorias · busca · editor · newsletter
- status
- em produção
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.
Mobilização de voluntários com prazo legal e público hostil: toda regra vale no banco.
Operação de relacionamento por WhatsApp com envio humano, histórico imutável e o banco como última palavra.
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.