Barra Manager
PWA para gestionar venta, cobro, preparación, stock y cierre de caja de una
barra de bebidas en eventos y festivales. Pensada para usarse simultáneamente
desde varios celulares/tablets (Caja, Frío, Caliente, Admin) con sincronización
en tiempo real.
Primer evento cargado: Conciencia Solar — 13/09/2026 — UNLAM.
Stack
- Next.js 14 (App Router) + TypeScript + Tailwind CSS
- Supabase (Postgres + Realtime + RLS) como base de datos centralizada
- PWA instalable (
@ducanh2912/next-pwa)
- Autenticación liviana por PIN de 4 dígitos por sector/persona (sin
contraseñas), pensada para tablets compartidas durante el evento
1. Crear el proyecto de Supabase
- Entrá a supabase.com y creá un proyecto nuevo (plan
Free alcanza).
- Andá a SQL Editor y ejecutá, en este orden:
- Todo el contenido de
supabase/schema.sql
(tablas, seguridad por fila, funciones y realtime).
- Todo el contenido de
supabase/seed.sql
(evento Conciencia Solar + productos + usuarios de staff con PIN).
- Andá a Settings → API y copiá:
Project URL → NEXT_PUBLIC_SUPABASE_URLanon public key → NEXT_PUBLIC_SUPABASE_ANON_KEYservice_role key → SUPABASE_SERVICE_ROLE_KEY (¡secreta! nunca la
expongas en el frontend ni la subas a git)
2. Configurar variables de entorno
Copiá .env.example a .env.local y completá los valores:
cp .env.example .env.local
NEXT_PUBLIC_SUPABASE_URL=...
NEXT_PUBLIC_SUPABASE_ANON_KEY=...
SUPABASE_SERVICE_ROLE_KEY=...
SESSION_SECRET=... # generar con: openssl rand -base64 32
3. Correr en desarrollo
npm install
npm run dev
Abrí http://localhost:3000
4. Primeros pasos dentro de la app
- Entrá como ⚙️ ADMINISTRADOR con el PIN semilla
9999.
- Andá a Staff / PINs y cambiá TODOS los PIN semilla antes del evento:
- Administrador:
9999
- Caja:
1111
- Frío:
2222
- Caliente:
3333
- Andá a Eventos → Conciencia Solar, revisá/ajustá el stock inicial
desde Productos y precios (el seed carga cantidades de ejemplo para
jugos/agua/gaseosas — reemplazalas por las cantidades reales compradas).
- Tocá ▶ Iniciar evento. A partir de ahí:
- La numeración de pedidos arranca en
#001.
- Se habilita la pantalla de Caja para cobrar.
- Al terminar el evento, desde Eventos → 🔒 Cerrar evento (o desde
Cierre de caja) se bloquean nuevas ventas y queda todo el historial
disponible para siempre en Historial.
5. Roles / pantallas
| Rol | Pantalla | PIN semilla |
|---|
| 💰 Caja | /caja — vender y cobrar | 1111 |
| 🧊 Frío | /frio — preparar pedidos del sector frío | 2222 |
| 🔥 Caliente | /caliente — preparar pedidos del sector caliente | 3333 |
| ⚙️ Administrador | /admin — todo lo anterior + eventos, productos, staff, cierre | 9999 |
6. Reglas de negocio implementadas
- Separación económica vs. preparación: cada producto tiene
sector_economico y sector_preparacion independientes (una recarga de
agua caliente factura como FRÍO pero se prepara en CALIENTE).
- Reparto: 100% del sector frío es del organizador; del sector caliente,
70% para el socio y 30% para el organizador. `TOTAL ORGANIZADOR = 100% FRÍO
- 30% CALIENTE`. No hay ningún reparto posterior.
- Precios históricos: el precio de cada venta queda "congelado" en el
momento del cobro (
order_items.unit_price); cambiar el precio de un
producto en Admin nunca reescribe ventas pasadas.
- Pedidos mixtos: un pedido con productos de ambos sectores aparece en
Frío y en Caliente simultáneamente, cada uno viendo solo sus propios ítems,
bajo el mismo número de pedido.
- Anulaciones: piden motivo, quedan registradas para auditoría, revierten
el stock automáticamente y se excluyen de toda la facturación/cierre.
- Stock: se descuenta en cada cobro y se revierte en cada anulación, con
historial completo en
stock_movements. Las recargas y los productos del
sector caliente están configurados sin control de stock unitario por
defecto.
- Un solo evento activo a la vez, cada uno con su propia numeración de
pedidos, productos, precios y stock — sin tocar nunca el historial de
eventos anteriores.
7. Deploy en Vercel
- Importá este repo en vercel.com.
- Cargá las mismas 4 variables de entorno del paso 2 en Settings →
Environment Variables.
- Deploy. Al ser una PWA, cualquier celular/tablet puede "Agregar a
pantalla de inicio" desde el navegador para instalarla.
8. Estructura del proyecto
app/ Pantallas (App Router) y Route Handlers (app/api/**)
lib/ Lógica compartida: sesión, Supabase, cierre de caja, hooks
components/ Componentes de UI reutilizables
supabase/ schema.sql y seed.sql para crear la base de datos
public/ manifest.json, íconos de la PWA
9. Fuera de alcance de esta primera versión
Por decisión explícita del pedido original: sin facturación fiscal/AFIP, sin
factura electrónica, sin ningún reparto de dinero más allá del 70/30 del
sector caliente. La exportación a PDF se cubre con la vista imprimible
(Imprimir / PDF en Cierre de caja, usando "Guardar como PDF" del navegador)
en vez de un generador de PDF dedicado.
