Módulo tables — plano de sala, mesas y sesiones

Plano de sala de un restaurante: zonas, mesas físicas (con su posición en el lienzo) y sesiones de servicio — una sesión es una CUENTA. Cubre todo lo que le pasa a una cuenta en sala: abrir, aparcar, transferir, fusionar, dividir y cerrar, más la retención de mesa para una reserva. Es la autoridad de ocupación del hub.

Module id: tables. Depende de: nada (depends_on: []) — todo lo que sale del módulo es referencia opaca o evento. Módulo híbrido: SQL + handler WASM (9 funciones) con guardas de estado en SQL vía tabla guardia tables__gate (patrón ADR-0020).

Documentación de usuario — docs/

Viaja dentro del módulo y se versiona con él: el asistente del hub (ADR-0282) la indexa por versión instalada y cita la de TU versión, no la de la última publicada. En inglés (idioma fuente).

Qué expone hoy

Navegación: erp-tables-canvas («Floor Plan») y erp-tables-floor-plan (Zones / Tables / Sessions / Settings).

Layout

module.json                   # manifest (contrato técnico)
migrations/postgres/          # esquema §2.5 + tabla guardia tables__gate
queries/*.sql                 # lecturas declarativas (:hub_id inyectado)
commands/*.sql                # escrituras declarativas (las `_` son intenciones del WASM)
schemas/*.json                # JSON Schemas de input (draft 2020-12)
handler/                      # WASM Tier 2 → dist/handler.wasm
ui/                           # Web Components (Lit/Ionic/OutfitKit)
docs/                         # documentación de usuario + corpus del asistente

Estado y trabajo abierto

El estado vive en las Issues de este repo, no aquí. El flujo dividir/juntar está cerrado de punta a punta (tables#12 + sales#61 + tables#26). Pendiente conocido: is_active=false sobre una mesa no available no está gateado (requeriría enrutar tables.tables.update a WASM).

Doc de arquitectura: architecture/modules/tables.md (cargarlo antes de tocar el módulo).