Todos los casos
~/cases/plantao-ga
Plataformas y CRMOtros sectoresabr 2026 → may 2026En producción

P-14

Plantão Gaúcho

Portal de noticias con gestión editorial, portada seleccionada por el equipo y vistas previas para WhatsApp.

clientePortal regional de noticias en Rio Grande do Sul, sur de Brasil

Portal regional de noticias con un panel para una redacción no técnica: editor de texto enriquecido, compresión de imágenes en el navegador, organización de portada por arrastre y boletín. La SPA en React usa Supabase y reglas de acceso mediante RLS. Un Cloudflare Worker sirve Open Graph a los bots de previsualización para que los enlaces compartidos en WhatsApp incluyan foto y título.

15
Políticas de RLS
1 + 1
funciones de borde + trabajadores
4 público 7 admin
rutas
Abril 10 Mayo 14, 2026
marco de tiempo
  • react
  • supabase
  • postgres
  • rls
  • cloudflare
architecture.es.svgampliar ↓

01Sinopsis

Planto Gaúcho es un portal de noticias que cubre el estado de Rio Grande do Sul, en el sur de Brasil: una primera página con una historia principal y destacados elegidos por los editores, un ticker breaking-news, secciones (Política, Economía, Brasil, Mundo, Campo, Cultura, Salud, Seguridad Pública, Opinión y más), búsqueda, una página de artículo con botones para compartir y un boletín registro.

Detrás del sitio público se encuentra un panel de administración completo para la sala de redacción: un editor texto enriquecido, cargas de imágenes que se comprimen en el navegador, estados draft/published/hidden, curación arrastrar y soltar portada, configuración del sitio (SEO, pie de página, enlaces sociales) y la lista de suscriptores del boletín con exportación CSV.

Pasó del primer diseño a un portal respaldada por la base de datos con un panel de administración y vistas previas de enlaces WhatsApp adecuadas en aproximadamente cinco semanas (abril a mayo 2026).

02El problema

Un punto de venta regional necesitaba su propio portal, fácil de ejecutar para una pequeña redacción, sin depender de un CMS genérico. Tres restricciones dieron forma a la construcción:

  • La gente que publica no es técnica. Los editores deben escribir, subir una foto, elegir la historia principal y publicar por su cuenta, a menudo desde un teléfono.
  • La distribución ocurre en WhatsApp y en las redes sociales. Si un enlace compartido no muestra una foto y un título, nadie lo toca. Un React SPA por sí solo no puede solucionar eso: los robots de vista previa no ejecutan JavaScript.
  • Las fotos salen directamente de la cámara en 1020 MB, por encima de los aproximadamente 5 MB WhatsApp acepta una vista previa.

03La solución

Portal público

  • Una página principal con una historia principal y dos aspectos destacados secundarios elegidos por los editores, respaldados por una cadena de reserva (ranura explícita historia marcada como destacada más reciente) para que la página nunca esté vacía.
  • Un ticker latest-news horizontal que se detiene en el cursor.
  • Secciones navegables 11 (10 reales más una vista virtual "ltima"), páginas por sección y búsqueda sobre título, subtítulo y sección.
  • Páginas de artículos con tiempo de lectura, historias relacionadas de la misma sección (o las últimas como reserva) y botones de compartir WhatsApp, Facebook y X que usan la URL limpia del portal.
  • Una ventana emergente de boletín después de 10 segundos en la primera visita, con validación y una máscara de teléfono brasileña; un aviso de cookie.

Panel de redacción (/admin)

  • Panel de control con recuentos publicados, borradores y ocultos.
  • Lista de artículos con filtros, estado y cambios destacados y eliminación.
  • Formulario de artículo con un editor de TipTap (negrita, cursiva, listas, citas, enlaces, imágenes en línea), babosa editable, autor, etiquetas, título de imagen y ranura portada.
  • Drag-and-drop (dnd-kit) ordenando los aspectos destacados secundarios.
  • Conteo de artículos de Per-section, configuración de sitios y administración de boletines con búsqueda y exportación de CSV (BOM-prefixed para que se abra de forma limpia en Excel).
  • Una barra de "estás viendo el sitio como administrador" cuando navegas por el portal mientras inicias sesión.

Vista previa de enlaces sociales

  • A Cloudflare Worker en el dominio /artigo/* La ruta sirve Open Graph HTML para obtener una vista previa de los bots y pasa las solicitudes humanas sin tocar.
  • No hay backend personalizado entre el navegador y la base de datos: las directivas 15 RLS en las tablas 4 deciden quién lee y quién escribe.
  • Los roles viven en una tabla sin política de escritura: nadie puede promocionarse como administrador a través del público API.
  • Los borradores no se filtran: conocer la babosa de una historia inédita no devuelve nada a usuarios sin rol de administrador.
  • Un Cloudflare Worker en el dominio sirve Open Graph para obtener una vista previa de los bots y pasa a los lectores humanos sin tocar.
  • Las fotos de la cámara 1020 MB se redimensionan en el navegador (1600 px, JPEG 0.82) antes de cargarlas.
  • Tiras únicas generadas por un disparador Postgres, con poco acento y respeto por las ediciones manuales.

04Arquitectura

arquitectura real · pasa el cursor por los nodos
Leer el diagrama como lista (14 componentes, 12 conexiones)

Componentes

  • Clientes: Lector<br>portal público (SPA), Redacción<br>panel /admin, Rastreadores de vistas previas<br>WhatsApp Facebook X
  • Cloudflare (dominio de portal): og-meta Worker<br>ruta /artigo/*<br>detecta rastreadores por User-Agent
  • PostgreSQL RLS en las tablas 4 Políticas 15: artículos<br>slug estado hero_slot, user_roles<br>has_role() SECURITY DEFINER, site_settings, newsletter_subscribers
  • Supabase: Auth<br>correo + contraseña, PostgREST<br>clave anon + JWT, Función de borde og-meta<br>(Deno), PG, Almacenamiento<br>bucket article-images

Conexiones

  • Lector<br>portal público (SPA) → og-meta Worker<br>ruta /artigo/*<br>detecta rastreadores por User-Agent
  • Rastreadores de vistas previas<br>WhatsApp Facebook X → og-meta Worker<br>ruta /artigo/*<br>detecta rastreadores por User-Agent
  • og-meta Worker<br>ruta /artigo/*<br>detecta rastreadores por User-Agent → SPA estática<br>React 18 + Vite<br>React Consulta TipTap (persona: paso directo)
  • og-meta Worker<br>ruta /artigo/*<br>detecta rastreadores por User-Agent → PostgREST<br>clave anon + JWT (rastreador: HTML con OG)
  • og-meta Worker<br>ruta /artigo/*<br>detecta rastreadores por User-Agent → Proxy de imágenes<br>1200630 JPEG q80 (og:imagen)
  • Redacción<br>panel /admin → SPA estática<br>React 18 + Vite<br>React Consulta TipTap
  • SPA estática<br>React 18 + Vite<br>React Consulta TipTap → Auth<br>correo + contraseña
  • SPA estática<br>React 18 + Vite<br>React Consulta TipTap → PostgREST<br>clave anon + JWT
  • SPA estática<br>React 18 + Vite<br>React Consulta TipTap → Almacenamiento<br>bucket article-images (carga comprimida en el navegador)
  • PostgREST<br>clave anon + JWT → PG
  • Función de borde og-meta<br>(Deno) → PostgREST<br>clave anon + JWT
  • artículos<br>slug estado hero_slot → user_roles<br>has_role() SECURITY DEFINER (las políticas invocan)

La aplicación es un SPA estático que habla con Supabase directamente con la clave pública (anón). No hay un backend personalizado entre el navegador y la base de datos: cada regla de acceso vive en Postgres como Row Level Security. El único código de servidor escrito a mano se ejecuta en el borde: el Cloudflare Worker que maneja vistas previas de enlaces.

05Por dentro

Backend y datos
  • Tablas 4 entre las migraciones de 7: articles, user_roles, site_settings y newsletter_subscribers, más el article-images Cubo de almacenamiento.
  • Enums para el rol (app_role) y el estado del artículo (published, draft, hidden) en lugar de texto libre.
  • Slugs generados en la base de datos. generate_slug se ejecuta unaccent, normaliza a [a-z0-9-] y añade un sufijo numérico hasta que el valor esté libre. A BEFORE INSERT OR UPDATE trigger establece la babosa en la creación y la regenera cuando el título cambia, a menos que un editor la establezca a mano. La columna es NOT NULL y UNIQUE; la migración que lo agregó llenó los artículos existentes antes de aplicar las restricciones.
  • Portada Curación en el esquema. hero_slot Sólo acepta main or secondary (Check) y hero_order establece el orden; dos índices parciales (WHERE hero_slot IS NOT NULL) sirve las consultas portada sin indexar el resto de la tabla. Una migración de semillas idempotente llenó la primera página de las historias destacadas, sin tocar nada si los editores ya habían hecho selecciones.
  • Trigger-maintained updated_at on articles y site_settings.
  • Configuración de Key/value (site_settings): Título y descripción de SEO, ID de Analytics, copia de pie de página y enlaces sociales, editables desde el panel sin un despliegue.
  • og-meta Función de borde (Deno): la primera versión de vistas previas de enlaces, que sirve Open Graph HTML a bots y redirecciona a los humanos a la URL del portal.
Frontend
  • React 18 + Vite + TypeScript, Tailwind CSS y shadcn/ui (Radix) componentes, iconos Lucide.
  • TanStack React Consulta para todo el acceso a los datos con un 5-minuto staleTime, por lo que moverse entre la página principal, la sección y el artículo reutiliza la caché en lugar de volver a recuperarla.
  • Rutas: 4 público (/, /artigo/:slug, /categoria/:slug, /busca), una página de inicio de sesión y rutas de panel 7 detrás ProtectedRoute.
  • Editor de TipTap con imágenes en línea subidas directamente a Almacenamiento bajo nombres de archivo aleatorios (inline/<timestamp>-<random>; uso de imágenes de portada crypto.randomUUID()).
  • Compresión de imagen En el navegador antes de cargar: ancho máximo 1600 px, JPEG de calidad 0.82, omitiendo archivos que ya son pequeños ( 400 KB y dentro del ancho) y manteniendo el original siempre que la versión comprimida no sea más pequeña. SVG y GIF pasan intactos.
  • Formulario de boletín Zod-validated (nombre, correo electrónico y longitud de la ciudad; caracteres telefónicos 1020 de dígitos y ()+-) con una máscara de teléfono brasileña.
  • Portada pedidos con dnd-kit, la persistencia de cada elemento hero_order.
Infraestructura y despliegue
  • Frontend: una compilación estática Vite servida por una plataforma de alojamiento SPA, con el dominio del portal detrás de Cloudflare.
  • og-meta Cloudflare Worker en dos rutas (domain/artigo/* y www.domain/artigo/*). Para los bots, obtiene el artículo de PostgREST con un 300 s cf.cacheTtl y responde con Cache-Control: public, max-age=300 y un X-OG-Worker: hit encabezado (o fallback en caso de error). Para los seres humanos, reenvía la solicitud al origen SPA sin cambios.
  • Supabase para Postgres, Auth, almacenamiento y la función Edge (verify_jwt = false en ese solo, ya que los bots no envían tokens).
  • Step-by-step Libro de instrucciones Worker en la repo (rutas, pruebas con curl -A "WhatsApp/2.0", revertir eliminando las rutas) para que el equipo del cliente pueda operarlo sin el desarrollador.

06Seguridad

6 ataques considerados, 6 defensas en producción.

ataquedefensa
Atajo por la API

Saltarse la interfaz y hablar directo con la base o la API, con la clave pública en mano.

  • Leer borradores o historias ocultas adivinando la babosa o consultando el API

    La política pública solo permite status 'publicado'; cualquier otra cosa requiere has_role(auth.uid(), 'admin')

Escalada de privilegios

Quien ya tiene algún acceso intentando ganar más: volverse admin, leer lo que no debe, conservar un acceso revocado.

  • Llame a la API con la clave pública e insértese como administrador en user_roles

    user_roles solo tiene una política SELECT-own-row; INSERT/UPDATE/DELETE es denegada por RLS

  • Publicar, editar o eliminar historias e imágenes con una cuenta regular

    Cada escritura en artículos, site_settings y el cubo comprueba un SECURITY DEFINER has_role() con un search_path anclado

Origen y solicitudes falsificadas

CSRF, webhooks falsos, tokens reutilizados, enlaces firmados y redirección abierta.

  • Abusar de la función Edge como una redirección abierta

    El destino siempre es la URL fija del portal + /artigo/slug; no hay ningún parámetro de destino

Inyección y contenido hostil

XSS, iframe, fórmulas en CSV, subidas disfrazadas y manipulación del prompt de la IA.

  • Inyectar HTML/script en la vista previa de bot-facing a través de un título o subtítulo

    El Worker y la función Edge escapan y quitan las etiquetas del cuerpo antes de construir el HTML

Fuga y rastreo de datos

Enumerar quién está en la base, raspar datos personales, vincular preguntas a personas, extraer secretos.

  • Deshacerse de la lista de boletines (nombre, correo electrónico, teléfono, ciudad)

    Mesa Solo escritura para el público: SELECT y DELETE son solo para administradores

El diseño parte de una suposición: la clave anon se envía en el paquete del navegador, y cualquiera puede llamar al Supabase API directamente. Así que ninguna regla depende del frontend; la base de datos es lo que cuenta.

Autenticación

  • Inicio de sesión en la sala de prensa con correo electrónico y contraseña en Supabase Auth, con un solo mensaje de error ("correo electrónico o contraseña incorrectos") que no revela si existe la cuenta.
  • No hay pantalla registro: las cuentas son creadas por los administradores, y tener una cuenta no es suficiente para llegar al panel.

Autorización y RLS

  • RLS habilitado en todas las tablas 4, políticas 15 en total (almacenamiento incluido).
  • Roles en una tabla dedicada (user_roles), no una columna de perfil que el usuario puede editar. Solo tiene un SELECT para las propias filas del usuario; no hay INSERT, UPDATE or DELETE políticas, por lo que nadie puede promocionarse a admin a través de la API.
  • has_role() as SECURITY DEFINER con un anclado search_path, utilizado por cada política de escritura. Esto evita la recursión de RLS y evita el secuestro de funciones a través de un esquema malicioso en la ruta de búsqueda.
  • Los borradores y los artículos ocultos no se filtran. El público sólo puede leer status = 'published'. Conocer la tirada de un borrador no ayuda: la consulta vuelve vacía para usuarios sin rol de administrador. Los editores pueden previsualizar historias inéditas porque la política de administración permite la lectura, no porque el frontend oculte algo.
  • Admin-only escribe on articles, site_settings y el cubo de la imagen (INSERT, UPDATE y DELETE todo check has_role(auth.uid(), 'admin')).
  • Solo escritura boletín de noticias para el público. Cualquier visitante puede suscribirse (INSERT), pero listar y eliminar suscriptores requiere el rol de administrador. La clave anon no puede leer ningún dato personal.
  • La comprobación de roles Del lado del cliente no se cierra. Si se produce un error en la consulta del rol, el panel trata al usuario como un non-admin.

Superficie de borde público

  • La Worker y la función Edge solo utilizan la clave anon, vinculada por las mismas políticas: solo pueden leer artículos publicados y no tienen credenciales de servicio.
  • Se ha escapado todo valor de la base de datos (& < > " ') antes de entrar en el HTML de Open Graph; los cuerpos de los artículos se reducen a texto sin formato antes de convertirse en una descripción.
  • La función Edge siempre redirige a los humanos a la URL fija del portal creada a partir de la babosa: no hay ningún parámetro de destino para abusar como una redirección abierta.

Validación y datos personales

  • Validación de Zod con límites de longitud en el formulario de boletín; envíe un correo electrónico a lower-cased y UNIQUE en la base de datos, con error 23505 manejado como "ya estás suscrito" en lugar de un fracaso.
  • Integridad impuesta en el esquema: enums, NOT NULL, UNIQUE en slug y correo electrónico, CHECK en hero_slot.

07Desafíos técnicos

Vista previa de enlaces para un SPA

Los bots WhatsApp y Facebook no ejecutan JavaScript, por lo que cada artículo mostró el título genérico y la imagen de JavaScript. index.html. La primera solución era una función Edge que servía Open Graph HTML, pero significaba compartir enlaces en el dominio Supabase. La versión final es una Worker en el dominio propio del portal, con el alcance de /artigo/*: detecta bots por User-Agent (patrones 21), obtiene el artículo publicado de PostgREST con una caché de borde de 5 minutos, se escapa de todo y devuelve un mínimo de HTML. Los lectores humanos obtienen el SPA intacto, y cualquier error produce una vista previa genérica en lugar de una parte rota. La URL compartida sigue siendo la del portal.

Fotos de la cámara por encima del límite de WhatsApp

Las fotos 1020 MB produjeron vistas previas sin imagen. La solución tiene dos capas: en la carga, el navegador cambia de tamaño a como máximo 1600 px y re-encodes como JPEG 0.82, por lo que las nuevas fotos aterrizan en Storage ya son ligeras; en el Worker, og:image pasa por un proxy de imagen que sirve 1200630 JPEG q80, que también cubre artículos más antiguos sin reprocesar nada.

Primera página con fallbacks

Los editores querían elegir el líder y los aspectos más destacados, pero la página no podía romperse cuando nadie elegía. La respuesta combina esquema (hero_slot con chequeo, hero_order, índices parciales), una migración inicial que solo actúa cuando no se establece ninguna ranura, y una consulta con una cadena de reserva que completa los aspectos destacados secundarios con las últimas historias que tienen una imagen, sin repetir el lead.

Carrera de sesión y una pantalla de inicio de sesión en blanco

El panel tuvo una carrera entre la restauración de la sesión guardada y el evento inicial de Auth, y en una red escamosa la carga podría colgar. El proveedor de autenticación ahora restaura la sesión primero, ignora el already-handled INITIAL_SESSION evento, elimina las respuestas después de desmontar, trata una comprobación de rol fallida como "no admin", y libera el estado de carga después de 8 segundos en el peor de los casos.

08Resultados

  • Portal y panel entregados en aproximadamente 5 semanas: el primer código de confirmación es de abril 10, 2026, el último de mayo 14, 2026.
  • 220 confirma (145 excluyendo fusiones), 202 de ellos en abril 2026.
  • Migraciones 7, tablas 4, directivas 15 RLS, función de borde 1 y 1 Cloudflare Worker.
  • Acerca de las líneas 4,770 de código escrito a mano (non-blank, excluyendo los componentes shadcn/ui generados y los tipos de base de datos generados): 3,429 TSX, 712 TS, 296 SQL, 187 JS y 145 CSS.
220
compromisos
cómo lo medimos

git log --oneline wc -l (145 excluyendo fusiones)

Abril 10 Mayo 14, 2026
marco de tiempo
cómo lo medimos

fechas del primer y último código confirma en git log (excluyendo la plantilla y confirma README)

7
Migraciones
cómo lo medimos

ls supabase/migrations

4
cuadros
cómo lo medimos

CREAR MESA en las migraciones

15
Políticas de RLS
cómo lo medimos

grep -c 'CREAR POLTICA' en las migraciones (incluye 4 para Almacenamiento)

1 + 1
funciones de borde + trabajadores
cómo lo medimos

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

4 público 7 admin
rutas
cómo lo medimos

src/App.tsx

~4.8k
Líneas de código
cómo lo medimos

Líneas no vacío en src, supabase y cloudflare-worker, excluyendo shadcn/ui y types.ts generadas (TSX 3,429, TS 712, SQL 296, JS 187, CSS 145)

09Línea de tiempo

  1. 10 abr 2026

    Diseño de base con encabezado adhesivo, portada, feed, ticker, pie de página y página de artículo en datos simulados

  2. 13 abr 2026

    Base de datos Supabase con RLS, panel de administración, editor TipTap y babosas generadas por Postgres

  3. 16 abr 2026

    Sugerencias de lectura, por sección cuenta y aviso de cookies

  4. 17 abr 2026

    Curación de Portada con historia principal, aspectos destacados y pedidos de arrastrar y soltar

  5. abr 2026

    Apr 2024: Gráfico abierto dinámico, primero a través de una función de borde, luego un Cloudflare Worker en el dominio

  6. 04 may 2026

    Compresión y cambio de tamaño de imagen En el navegador, además de un proxy de imagen para vistas previas

  7. 06 may 2026

    Newsletter con panel de suscriptores y exportación CSV

  8. 14 may 2026

    Corrección para una carrera de sesión que dejó la pantalla de inicio de sesión en blanco

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
Datos
  • PostgreSQL
  • Row Level Security
  • PL/pgSQL
  • Triggers
  • unaccent
Infra
  • Cloudflare Workers
  • Cloudflare Worker Routes
  • Hospedagem estática de SPA
Seguridad
  • 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 noticias + panel de redacción
stack
React 18 · Vite · Supabase
db
Postgres Tablas 4 Políticas 15
auth
Supabase Auth + user_roles
edge
Cloudflare Worker (Gráfico abierto)
deploy
SPA estático + Cloudflare
modules
portada secciones búsqueda editor newsletter
status
en producción
$ 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

© 2026 NODE. Todos los derechos reservados.