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

1. Crea un proyecto en Supabase.
2. 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.
3. 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]';
   

4. 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).
5. Copia .env.example a .env.local y rellena las variables (Supabase → Project Settings → API).
6. npm install y npm run dev. Abre http://localhost:3000.

Publicar en Vercel

1. Importa el repositorio en Vercel.
2. 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.
3. 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.