Módulo customers — CRM del POS

Ficha de cliente con datos de contacto y fiscales, segmentación por grupos y etiquetas, campos personalizados por tenant, timeline de actividad y notas, y métricas de compra (nº de compras, gasto, última compra, etapa de ciclo de vida). Recibe automáticamente las ventas completadas para actualizar el historial del cliente.

Module id: customers. Depende de: nada (depends_on: [] a propósito — declarar sales haría que instalar un CRM arrastre el POS entero, ADR-0141). Módulo híbrido: SQL + handler WASM (bulk_create, set_groups, set_tags).

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-customers-list, erp-customers-groups, erp-customers-tags, erp-customers-fields.

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í. Huecos conocidos y documentados en docs/limits.md: sin pantalla para los valores de campos personalizados y sin pantalla de import masivo (bulk_create es solo API).

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