Platovi
Plataforma multi-restaurante de cartas digitales con QR. Cada restaurante tiene su carta pública en /<slug> y un panel en /panel donde el dueño edita categorías, platos, precios, fotos, marca y descarga los QR.
Stack: Next.js 15 (App Router) + Supabase (Postgres, Auth, Storage, RLS) + Vercel.
Qué incluye (fase 1 · MVP)
- Carta pública
/<slug>?mesa=7: rápida, pensada para el móvil, cacheada y regenerada al guardar en el panel. Muestra la mesa y un botón de WhatsApp.
- Panel del dueño
/panel: categorías y platos con foto, precio, descripción y etiquetas; precio editable en línea; interruptor de agotado; reordenar arrastrando; ocultar categorías.
- Marca
/panel/marca: logo, colores con vista previa, moneda, WhatsApp. El país (moneda, zona horaria y código de WhatsApp sugeridos) se elige al crear el restaurante y se cambia en Personalizar; por defecto, Chile (CLP, America/Santiago).
- Códigos QR
/panel/qr: QR general (PNG y SVG), QR por mesa (PNG) y hoja PDF A4 con 6 tarjetas para imprimir.
- Cuentas: registro, login, recuperar contraseña. Las fotos se comprimen en el navegador a WebP de 1200 px antes de subirlas.
- Diseños de carta: Clásico, Noche, Esmeralda, Comida rápida y Retro, elegibles en Marca con vista previa.
- Idiomas: la carta se escribe en español y se puede ofrecer en inglés, portugués, francés, italiano y alemán. Se abre sola en el idioma del teléfono y tiene un botón para cambiarlo. Las traducciones de platos y categorías se cargan en el panel.
- Pedidos por WhatsApp: el cliente arma su pedido en la carta y lo envía al WhatsApp del local (o de la sucursal) con mesa, total y notas.
- Sucursales
/panel/sucursales: misma carta, con dirección, horario, WhatsApp y QR de mesa propios (/<slug>?s=centro&mesa=4).
- Estadísticas
/panel/estadisticas: visitas por día, hora, mesa e idioma, pedidos y lo más pedido.
- QR con logo: logo al centro y color de la marca en PNG, SVG y PDF.
- Administración
/admin: todos los restaurantes, plan, pausar/reactivar, entrar a editar la carta de un cliente y crear restaurantes para clientes.
- Seguridad: RLS en todas las tablas. Cada dueño solo ve y edita su restaurante; la carta pública solo lee restaurantes activos, categorías visibles y platos disponibles. El dueño no puede cambiar su plan ni su dirección.
Puesta en marcha
- Crea un proyecto en Supabase.
- En SQL Editor, ejecuta en orden todos los archivos de
supabase/migrations/ (de 0001 a 0015). Opcional: supabase/seed.sql crea la carta de ejemplo /la-esquina y supabase/seed_cafe.sql la cafetería /aroma-cafe con 36 bebidas, fotos y traducciones. supabase/seed_disenos.sql (después de 0006) crea una carta demo por cada diseño nuevo: /la-esquina-verde (Bistró), /jardin-veggie (Dorado), /forno-pizzeria (Forno), /warung-oriente (Oriente) y /neon-tokio (Neón). supabase/seed_disenos_2.sql (después de 0007) suma 11 cartas demo más, una por diseño nuevo (Tropical, Natural, Soleado, Gala, Vitrina, Cinta, Trattoria, Kraft, Madera, Cóctel y Revista), y marca algunos platos como destacados.
- Para entrar a
/admin, date permiso de superadmin con tu correo:
insert into public.superadmins (user_id) select id from auth.users where email = '[email protected]';
- En Authentication → URL Configuration:
- Site URL: la URL pública de la app (por ejemplo
https://tumenu.com).
- Redirect URLs: añade
https://tumenu.com/auth/confirm (y http://localhost:3000/auth/confirm para desarrollo).
- Copia
.env.example a .env.local y rellena las variables (Supabase → Project Settings → API).
npm install y npm run dev. Abre http://localhost:3000.
Publicar en Vercel
- Importa el repositorio en Vercel.
- Añade las tres variables de
.env.example en Settings → Environment Variables. Los QR y los correos usan la dirección desde la que se abre el panel; NEXT_PUBLIC_SITE_URL solo se usa en el servidor. Antes de imprimir QR, entra al panel desde el dominio final.
- Deploy. Recuerda que el plan gratis de Vercel no permite uso comercial: pasa a Pro al empezar a cobrar.
Dar de alta un restaurante
- El dueño solo: entra a
/registro, pone el nombre del local y su correo.
- Tú por él: en
/admin → "Restaurante para un cliente". Quedas como dueño y lo eliges arriba en el panel para armarle la carta.
- Editar la carta de un cliente: en
/admin → "Editar carta" te suma como staff de ese restaurante.
- Para darle el restaurante a su dueño, añade una fila en
public.usuarios con su user_id, el restaurante_id y rol = 'dueno'.
- Plan y pausa (
plan, activo) se cambian en /admin. Pausar un restaurante oculta su carta al momento.
Prueba de 14 días y planes (migración 0016)
- Cada restaurante nuevo empieza con 14 días de prueba, el diseño Vitrina, imágenes por defecto y 12 platos de ejemplo (se borran con "Borrar ejemplos" en Carta; los que el dueño edita quedan).
- Durante la prueba se usa todo lo del plan Pro. Cada plan muestra solo lo suyo (
src/lib/planes.ts): Carta = carta, diseños, idiomas, QR y promos; Pro suma salón, cocina, caja, pedidos, reservas, clientes, estadísticas y equipo; Grupo suma sucursales. Lo bloqueado aparece con candado y lleva a /panel/plan.
- El envío diario (
/api/recordatorios, Vercel Cron) avisa cuando quedan 4 días y 1 día y, al vencer, pausa la carta (el cliente ve "estamos actualizando la carta"). En /admin puedes extenderla, quitarle el vencimiento o ponerle un plan (eso la reactiva y anota el inicio del plan).
- Variables en Vercel:
CRON_SECRET y SUPABASE_SERVICE_ROLE_KEY (obligatorias para el envío diario). Opcionales: NEXT_PUBLIC_WHATSAPP_VENTAS (cambia el WhatsApp del botón "Quiero contratar"; por defecto +56 9 4149 7083), RESEND_API_KEY + AVISOS_CORREO_DE (correo con dominio verificado en resend.com) + AVISOS_CORREO_ADMIN (dónde te llegan a ti) para mandar los avisos por correo.
Platovi Loyalty: tarjetas de sellos (migraciones 0024, 0025 y 0026)
Tarjeta digital de sellos que se contrata aparte del plan ($12.990/mes por local, $19.990 Grupo). Reemplaza al antiguo "premio cada N visitas".
- Se activa por restaurante en
/admin (interruptor "Loyalty"). El local arma su tarjeta en /panel/sellos (sellos, premio, regla por visita o por monto, colores) y descarga el QR para unirse.
- El cliente se une en
/s/unirse/<slug> y su tarjeta queda en /s/<código>. La precuenta trae un QR de un solo uso (24 h) que suma el sello de esa visita; si la mesa se anula, el sello se quita.
- El mesero suma o canjea desde
/panel/sellos, desde la ficha de la mesa ("Ver tarjeta") o escaneando la tarjeta con la cámara del celular con su sesión iniciada. Con "Pedir PIN de encargado" activo, un mesero necesita el PIN.
- Avisos al celular de la tarjeta web: usan las mismas claves VAPID y
SUPABASE_SERVICE_ROLE_KEY.
- Google Wallet (opcional):
GOOGLE_WALLET_ISSUER_ID, GOOGLE_WALLET_CLIENT_EMAIL y GOOGLE_WALLET_PRIVATE_KEY (cuenta de emisor en Google Pay & Wallet Console y una cuenta de servicio de Google Cloud con acceso). Sin ellas el botón no aparece.
- "Para que vuelvan" (0026): días de sello doble, invitación a reseña de Google tras el sello, y el cron diario
/api/sellos/campanas (vercel.json) que manda el saludo de cumpleaños y el "te extrañamos" con sus sellos de regalo. Usa CRON_SECRET y SUPABASE_SERVICE_ROLE_KEY.
- Todo vive en
src/lib/sellos, src/app/s, src/app/panel/sellos, src/app/api/sellos y las tablas sellos_*, para poder separarlo después como producto independiente.
Las fotos de public/demo/cafe salen de una infografía de terceros y son solo para la demo: para clientes reales usa fotos propias o libres de derechos.
Estructura
src/app/[slug]/ carta pública
src/app/panel/ panel del dueño (carta, marca, qr, sucursales, estadísticas)
src/app/admin/ administración del servicio (superadmin)
src/app/s/ tarjeta de sellos del cliente (Platovi Loyalty)
src/components/carta/ diseños de la carta, idiomas, pedidos y barra inferior
src/app/login|registro|recuperar|nueva-clave/
src/app/auth/confirm/ enlaces de correo (confirmar cuenta, recuperar contraseña)
src/lib/ clientes de Supabase, tipos, QR/PDF, fotos
supabase/ migración SQL y datos de ejemplo
Imágenes por defecto
Si el restaurante activa Marca → Imágenes por defecto, los platos sin foto muestran una ilustración según su nombre o descripción (pizza, café, cerveza, etc.). Se guarda en restaurantes.ajustes.imagenes_defecto, así que no necesita SQL. Las imágenes de public/defecto son Fluent Emoji de Microsoft, con licencia MIT (ver public/defecto/LICENSE.txt), que permite el uso comercial.
