GastroOS — Restaurant POS System

Contexto

GastroOS es un sistema POS (Point of Sale) completo para restaurantes, diseñado para centralizar la operación diaria en una sola plataforma web progresiva. El proyecto nació de la necesidad de reemplazar sistemas legacy costosos y poco flexibles con una solución moderna, accesible desde cualquier dispositivo y con capacidades offline.

El sistema cubre todo el ciclo operativo de un restaurante: desde la apertura de mesas y toma de comandas hasta el cierre de caja, pasando por cocina, inventario, promociones y reportes.

Reto

Construir un SaaS multiinquilino que funcionara de forma confiable en entornos con conectividad intermitente (cocinas, bodegas, zonas de servicio). El sistema debía soportar 7 roles operativos distintos con permisos granulares, y ser lo suficientemente rápido para usarse en horarios pico sin fricción.

Además, el frontend necesitaba ser 100% responsivo para tablets y celulares usados por meseros, cocineros y cajeros, con actualizaciones en tiempo real entre módulos (una comanda nueva debía aparecer al instante en la pantalla de cocina).

Mi aporte

• Arquitectura y desarrollo full-stack: diseñé la estructura completa del frontend con Next.js, el sistema de 7 roles, los servicios de backend sobre Supabase y la lógica de caché que permite seguir operando sin conexión.
• Módulo de mesas: mapa visual del restaurante con estados (libre, ocupada, reservada, cerrada), creación y edición de mesas con zonas, y apertura de sesiones por mesa con temporizador.
• Módulo de comandas: panel de toma de pedidos con búsqueda de productos por categoría, carrito persistente, selección de variantes y extras, y envío instantáneo a cocina con actualización en tiempo real.
• Panel de cocina: tablero kanban por áreas de preparación (cocina, barra, parrilla) con tickets agrupados, filtros por estado y confirmación de entregado con hora exacta.
• Módulo de caja: apertura y cierre de caja registradora con conteo de fondo, cobros mixtos (efectivo, tarjeta, transferencia), resumen de ventas diarias y corte de cajero.
• Módulo de inventario: control de existencias con entradas, salidas, ajustes y mermas, alertas de stock mínimo, y movimientos trazables por producto.
• Módulo de productos: catálogo de productos con variantes (tamaños, sabores), precios, categorías, áreas de preparación y extras configurables.
• Módulo de promociones: descuentos por monto, combo, porcentaje o producto específico con validación de fechas y condiciones.
• Autenticación y roles: 7 roles con acceso protegido en servidor y en cliente, menú lateral que cambia según los permisos y selección de rol para usuarios con varios perfiles.
• PWA y offline: instalable como app, con caché propia, notificaciones push y sincronización automática al recuperar la conexión.
• Despliegue en Cloudflare: renderizado en servidor, headers de seguridad, caché y entrega optimizada de imágenes y assets.
• Base de datos: PostgreSQL con seguridad a nivel de fila para que cada restaurante solo vea sus propios datos, y cambios de esquema versionados para mantener todo trazable.

Stack

Next.js 16 (App Router), React 19, TypeScript, Tailwind CSS 4, shadcn/ui, Zustand, Supabase (PostgreSQL, Auth, Realtime), PWA, Recharts y Cloudflare Workers.

Resultado

SaaS de gestión restaurantera completo y funcional, desplegado en Cloudflare Workers con SSR. El sistema maneja 7 roles operativos, 15+ módulos funcionales y notificaciones en tiempo real entre todos los puntos del restaurante. La arquitectura offline-first permite operar sin interrupciones incluso en zonas sin cobertura, con sincronización automática al recuperar la conexión.