Módulo appointments — agenda de citas

Agenda de un negocio con cita previa (peluquería, clínica, taller): reserva una franja para un cliente, contra un servicio y un profesional, y lleva el ciclo de vida pending → confirmed → in_progress → completed / cancelled / no_show. Gestiona horarios de disponibilidad, tiempo bloqueado y plantillas de citas recurrentes.

Module id: appointments. Depende de: customers, services, staff — la cita se reserva contra un profesional, no contra un nombre tecleado (los tres ids son required en el schema, así que el alta de texto libre la rechaza el runtime). Módulo híbrido: SQL + handler WASM (create_appointment, bulk_create, bulk_delete, materialize_recurring).

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-appointments-list («Appointments»), con conmutador lista ↔ por profesional (reutiliza ok-scheduler de OutfitKit).

Layout

module.json                   # manifest (contrato técnico)
migrations/postgres/          # esquema §2.5 + contador atómico por (hub_id, day)
queries/*.sql                 # lecturas declarativas (el motor de disponibilidad es Tier 0)
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í. Documentado en docs/limits.md: el módulo no envía recordatorios (los ajustes solo guardan la política) y el vínculo con calendarios externos vive en un satélite (calendar_sync, ADR-0148), sin depends_on en ninguna dirección.

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