Todos os cases
~/cases/plantao-ga
Plataformas & CRMsOutros setoresabr 2026 → mai 2026Em produção

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.

15
Policies RLS
1 + 1
Edge Functions + Workers
4 públicas · 7 admin
Rotas
10/04 → 14/05/2026
Período
  • react
  • supabase
  • postgres
  • rls
  • cloudflare
architecture.pt.svgampliar ↓

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

arquitetura real · passe o cursor nos nós
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

Backend e dados
  • 4 tabelas em 7 migrations: articles, user_roles, site_settings e newsletter_subscribers, mais o bucket article-images no 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_slug usa unaccent, normaliza para [a-z0-9-] e acrescenta sufixo numérico até achar um valor livre. Um trigger BEFORE INSERT OR UPDATE gera 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 tem NOT NULL e UNIQUE; a migration que a criou fez backfill das matérias existentes antes de aplicar as restrições.
  • Curadoria da capa no schema. hero_slot aceita só main ou secondary (CHECK) e hero_order define 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_at por trigger em articles e site_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.
Frontend
  • React 18 + Vite + TypeScript, Tailwind CSS e componentes shadcn/ui (Radix), ícones Lucide.
  • TanStack React Query para todo acesso a dados, com staleTime de 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 por ProtectedRoute.
  • Editor TipTap com upload de imagens inline direto para o Storage, nomes de arquivo aleatórios (inline/<timestamp>-<aleatório>; capa com crypto.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_order de cada item.
Infraestrutura e deploy
  • 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-meta em duas rotas (dominio/artigo/* e www.dominio/artigo/*). Para crawlers, busca a matéria no PostgREST com cf.cacheTtl de 300 s e responde com Cache-Control: public, max-age=300 e o cabeçalho X-OG-Worker: hit (ou fallback, 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 = false só 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.

ataquedefesa
Atalho pela API

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')

Escalada de privilégio

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

Origem e requisições forjadas

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

Injeção e conteúdo hostil

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

Vazamento e rastreio de dados

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 de SELECT para o próprio usuário; não existe policy de INSERT, UPDATE ou DELETE, então ninguém se promove a admin pela API.
  • has_role() como SECURITY DEFINER com search_path fixo, 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_settings e no bucket de imagens (INSERT, UPDATE e DELETE checam has_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 UNIQUE no banco, com o erro 23505 tratado como "você já está inscrito" em vez de falha.
  • Integridade garantida no schema: enums, NOT NULL, UNIQUE no slug e no e-mail, CHECK em hero_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
como medimos

git log --oneline | wc -l (145 sem merges)

10/04 → 14/05/2026
Período
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)

7
Migrations
como medimos

ls supabase/migrations

4
Tabelas
como medimos

CREATE TABLE nas migrations

15
Policies RLS
como medimos

grep -c 'CREATE POLICY' nas migrations (inclui 4 do Storage)

1 + 1
Edge Functions + Workers
como medimos

supabase/functions/og-meta e cloudflare-worker/og-meta-worker.js

4 públicas · 7 admin
Rotas
como medimos

src/App.tsx

~4,8 mil
Linhas de código
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

  1. 10 abr 2026

    Layout base com header fixo, capa, feed, ticker, rodapé e página de matéria com dados mock

  2. 13 abr 2026

    Banco no Supabase com RLS, painel administrativo, editor TipTap e slugs gerados no Postgres

  3. 16 abr 2026

    Sugestões de leitura, contagem por editoria e aviso de cookies

  4. 17 abr 2026

    Curadoria da capa com manchete, destaques e ordenação por arrastar e soltar

  5. abr 2026

    20–24/04: Open Graph dinâmico, primeiro via Edge Function e depois via Cloudflare Worker no domínio

  6. 04 mai 2026

    Compressão e redimensionamento de imagens no navegador e proxy de imagem para o preview

  7. 06 mai 2026

    Newsletter com painel de inscritos e exportação CSV

  8. 14 mai 2026

    Correção de corrida na sessão que deixava o login em branco

10Stack

Frontend
  • React 18
  • TypeScript
  • Vite 5
  • Tailwind CSS 3
  • shadcn/ui
  • TanStack React Query
  • TipTap 3
  • dnd-kit
  • Zod
Backend
  • Supabase Auth
  • PostgREST
  • Supabase Edge Functions (Deno)
  • Supabase Storage
Dados
  • PostgreSQL
  • Row Level Security
  • PL/pgSQL
  • Triggers
  • unaccent
Infra
  • Cloudflare Workers
  • Cloudflare Worker Routes
  • Hospedagem estática de SPA
Segurança
  • 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

node@plantao-ga: ~/cases/plantao-ga
node@plantao-ga ─────────────
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
$ ls supabase/migrations | wc -l && cat supabase/migrations/*.sql | grep -c 'CREATE POLICY'
7
15
$ curl -s "$SUPABASE_URL/rest/v1/newsletter_subscribers?select=email" -H "apikey: $ANON_KEY"
[]
# anon pode se inscrever, mas não lê ninguém
$ curl -s -X POST "$SUPABASE_URL/rest/v1/user_roles" -H "apikey: $ANON_KEY" -H "Authorization: Bearer $USER_JWT" -d '{"user_id":"<meu-id>","role":"admin"}'
{"code":"42501","message":"new row violates row-level security policy for table \"user_roles\""}
$ curl -sI -A "WhatsApp/2.0" https://portal.example/artigo/<slug> | grep -i -E 'x-og-worker|cache-control'
cache-control: public, max-age=300, s-maxage=300
x-og-worker: hit
NODE

TECNOLOGIA E INTELIGÊNCIA POLÍTICA

© 2026 NODE. Todos os direitos reservados.