Sistema de Gestión de Restaurantes

Descripción

Plataforma multi-restaurante que centraliza facturación y punto de venta, gastos con análisis por IA (OpenAI), control horario de empleados, autorización de dispositivos y el flujo completo de órdenes entre mesero o cliente, caja, cocina y entrega. El punto de venta sigue cobrando sin conexión: las operaciones se encolan de forma cifrada y se sincronizan al recuperar la red. Proyecto privado desarrollado en SITI WORLD, empresa de desarrollo de software.

Problemas que resuelve

Operación de restaurante fragmentada entre herramientas separadas para órdenes, cobro, gastos, asistencia del personal y coordinación con cocina, con pérdida de trazabilidad y control de costos en horas pico. Cortes de conexión que detenían el cobro.

Funcionalidades destacadas

1. Punto de venta offline-first: outbox cifrado con AES-GCM en IndexedDB, reintentos con backoff exponencial e idempotencia por operación
2. Flujo de órdenes mesero/cliente → caja → cocina → entrega, con tablero de cocina de tres carriles y historial de estados
3. Gastos con análisis por IA (OpenAI): extracción de datos de facturas a partir de hasta 8 fotos, con bandeja de revisión y aprobación
4. Control horario de empleados con kiosco por PIN, ocho tipos de marcaje y períodos de pago
5. Autorización de dispositivos por restaurante: emparejamiento con código de un solo uso y geocerca
6. RBAC con revalidación de sesión en cada petición, MFA con TOTP y auditoría con exportación CSV

Arquitectura

MVC propio en PHP 8.1+ sin framework: front controller con router de expresiones regulares y cadena de middlewares (dispositivo, autenticación, permisos, CSRF). Acceso a datos con mysqli y statements preparados sobre MariaDB 11.4 con claves UUID. Frontend con módulos ES nativos, Bootstrap 5 y PWA con service worker que solo cachea shells anónimos. Interfaz bilingüe ES/EN. CI/CD con GitHub Actions (lint, pruebas de contrato y migraciones contra MariaDB real).