Descripción
Ecosistema integral fullstack para restaurantes que transforma la experiencia comensal y la operación interna mediante menús digitales interactivos con visualización 3D y Realidad Aumentada (AR), gemelo digital tridimensional del salón, visualización KDS (Kitchen Display System) para cocina en tiempo real, gestión de comandas por mesa, sistema de delivery con control estricto de despacho, y conciliación de pagos multimoneda (USD / Bolívares a tasa oficial BCV).
// Narrativa: problema · decisión · impacto
El problema
Los restaurantes tradicionales enfrentan altos costos de reimpresión de cartas físicas, fricción en el comensal al no visualizar las porciones o presentación real de los platos, desorganización en horas pico de comandas entre saloneros y cocina, y pérdidas por descuadres cambiarios o comprobantes de pago duplicados.
La decisión
Se diseñó una arquitectura modular (Next.js 15 + PostgreSQL + Drizzle ORM) separando la capa API de las interfaces de salón y cocina, complementada con un pipeline de modelos 3D optimizados para web móvil (glTF/Draco), un bus de eventos Server-Sent Events (SSE) para sincronización mesa-cocina en tiempo real sin sobrecarga de polling, y validación criptográfica SHA-256 en comprobantes de Pago Móvil.
El impacto
- Sincronización en tiempo real mesa-cocina con latencia sub-segundo mediante Server-Sent Events (SSE) y visualización KDS.
- Pipeline de modelos 3D y Realidad Aumentada (AR) optimizado para web móvil (glTF/Draco) para pre-visualización inmersiva.
- Conciliación bancaria automatizada con prevención de fraude mediante hash criptográfico SHA-256 sobre transferencias.
- Eliminación de descuadres cambiarios mediante sincronización automatizada de la tasa oficial del Banco Central de Venezuela (BCV).
// Características
- Catálogo interactivo con modelos 3D inspeccionables a 360° y proyección en Realidad Aumentada (AR) sobre la mesa física.
- Gemelo digital 3D del salón con visualización del estado de mesas en vivo (libre, ocupada, pago pendiente) y mapa de calor de interacción AR.
- Acceso de comensal por código QR con autenticación independiente, auto-rellenado de datos y Modo Acompañante de solo lectura.
- KDS (Kitchen Display System) para que el personal de cocina avance estados de platos (pendiente, cocina, listo, servido) en tiempo real.
- Módulo de delivery y despacho con regla estricta de asignación únicamente cuando el pedido se encuentra en estado 'listo'.
- Arqueo y conciliación de caja multimoneda en USD y Bs. con detección automática de transferencias duplicadas y alertas de salón.
- Restitución automática de inventario diario (stockDiario) en anulaciones o cancelaciones de pedidos.
// Arquitectura
Frontend Comensal & Admin (Next.js 15)
frontend
Renderizado híbrido SSR/cliente en puerto 3100 con soporte para plantillas personalizables, visor 3D Google ModelViewer y navegación optimizada para móviles.
Core API Backend (Next.js Serverless Routes)
api
Servidor REST en puerto 3101 con validaciones Zod estrictas, autenticación JWT stateless con Web Crypto (jose) y control granular de permisos.
Capa de Persistencia (PostgreSQL + Drizzle)
db
Base de datos relacional con claves foráneas seguras (onDelete restrict/set null), índices optimizados y transacciones atómicas para inventario.
Bus de Eventos en Tiempo Real (SSE)
infra
Sistema de Server-Sent Events que transmite alertas de salón, llamadas a mozo y actualizaciones de comandas sin sobrecarga de polling.
Pipeline de Reconstrucción 3D (Worker Background)
external
Servicio autónomo de procesamiento fotogramétrico con COLMAP, Blender y compresión glTF Draco para empaquetado de assets 3D ultraligeros.
// Galería de capturas del sistema (6 pantallas)





