Módulo cash_register — caja y arqueos

Capa de control de efectivo del TPV: sesiones (turnos), movimientos de efectivo y arqueos del cajón. Reconcilia el efectivo esperado (fondo + Σ movimientos) contra el contado al cierre y registra la diferencia. Captura sola las ventas en efectivo escuchando sale.completed.

Module id: cash_register. Depende de: nada (depends_on: []). Módulo híbrido: SQL + handler WASM (add_count, record_sale).

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-cashregister-dashboard; ajustes declarativos (ADR-0082).

Layout

module.json                   # manifest (contrato técnico)
migrations/postgres/          # esquema §2.5 (hub_id + soft-delete + auditoría)
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í. Los límites conocidos están en docs/limits.md. (El que decía que current_session.expected_total invertía el signo de refund/out ya no aplica: lo arregló cash_register#48, y desde cash_register#65 la rejilla calcula el esperado con esa misma fórmula — las tres lecturas se comprueban entre sí en tests/open_session_expected.postgres.test.py.)

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