Simulador profesional de operaciones de restaurante — editor 2D + motor de simulación determinista de eventos discretos. Gratuito, de código abierto (MIT), ejecutable 100 % en local.
LBA Restaurant Engine es un laboratorio virtual de operaciones: dibuja tu local en 2D (paredes, puertas, mesas, equipos, zonas), define roles, recetas, equipos e inventario, y ejecuta simulaciones reproducibles para identificar cuellos de botella antes de abrir o reorganizar un negocio. La vista 3D (fase 10) será una forma más de observar la misma simulación, no un segundo motor.
| Estado | 🚧 En desarrollo — FASE 01 (base técnica, CI y logs) |
| Stack | TypeScript 6 · React 19 · Vite 8 · Konva (editor 2D, fase 03) · motor propio de eventos discretos · Vitest 5 · Three.js (fase 10) |
| Licencia | MIT — Copyright (c) 2026 Leandro (@lean0311g) |
| Idioma | Español (documentación y UI) |
El desarrollo está gobernado por una guía maestra completa que se conserva en este repositorio para que las instrucciones nunca se pierdan y cualquier persona o agente pueda seguirlas siempre:
- README de la guía — índice completo y mapa de fases
- Prompt maestro del agente — reglas no negociables
- Arquitectura y estructura
- Recursos, licencias y parámetros
- GitHub Actions, logs y evidencias
- Contrato del motor y modelo de datos
- Flujo de revisión con auditoría externa
- Fases 00–11 · Matriz de aceptación global
Regla de oro: una fase no se considera terminada porque la IA afirme que lo está. Se cierra únicamente cuando el código, las pruebas, GitHub Actions, los logs y las evidencias verificables cumplen los criterios de esa fase.
| Documento | Contenido |
|---|---|
| Alcance y exclusiones | Qué se construye, qué queda fuera y por qué |
| Mapa de módulos | Estructura del repo y límites de responsabilidad |
| ADR-0001 — Stack inicial | Decisiones técnicas con versiones y licencias verificadas |
| ADR-0002 — Excepciones de licencia | Evaluación de licencias transitivas del toolchain |
| Backlog maestro | Fases 00–11 con criterios de salida |
| Riesgos y supuestos | Inventario de riesgos con mitigaciones |
| Evidencias de fase | Informes de cierre por fase (SHA, Actions, artefactos) |
Requisitos: Node.js 24 LTS (la versión exacta está fijada en .nvmrc).
npm ci # instala dependencias exactas del lockfile
npm run dev # app de desarrollo → http://localhost:5173
npm test # pruebas unitarias/integración con cobertura (Vitest)
npm run lint # ESLint
npm run typecheck # TypeScript sin emitir
npm run build # build de producción (apps/web/dist)
npm run audit:licenses # informe de licencias de dependencias
npm run audit:security # npm audit (nivel high)La pantalla base muestra el layout del producto (controles de simulación, herramientas, lienzo, inspector, eventos/estadísticas) con los paneles de fases futuras deshabilitados y su fase prevista, más el panel de diagnóstico: registro estructurado de la aplicación con niveles, códigos de evento, sanitización de secretos y exportación JSONL.
Ver CONTRIBUTING.md. Resumen: rama + PR por entrega, fases sin saltar, evidencia verificable, licencias permisivas, sin secretos. Para vulnerabilidades: SECURITY.md.
Proyecto bajo MIT. Las licencias de las dependencias se detallan en THIRD_PARTY_NOTICES.md y se auditan automáticamente en CI. Si construyes sobre este proyecto, se agradece el reconocimiento: “Basado en LBA_Restaurant_Engine, por @lean0311g”.