Módulo sales — TPV y ventas

Núcleo transaccional del punto de venta. Es dueño de dos cosas: las cuentas abiertas (order, mutables, con sus líneas) y las ventas (sale, inmutables) que nacen al cobrar. Decide el dinero —totales de línea, descuentos, IVA, cambio, numeración— y emite sale.completed, el evento canónico de cierre de venta del producto.

Module id: sales. Depende de: inventory, taxes (instalar sales los auto-instala). Módulo híbrido: SQL + handler WASM (complete_sale, open_order, fire_order).

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-pos (pantalla completa) y erp-sales-list; 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í.

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