Módulo schedules — horario de apertura del NEGOCIO

Fuente de verdad de «¿estamos abiertos?»: horario semanal, días especiales (festivos, cierres, días con horas distintas) y overrides por rango de fechas (horario de verano, obras). Incluye el motor que resuelve las tres capas para un momento dado.

⚠️ Es el horario del NEGOCIO, no turnos de empleados (eso es staff) ni huecos reservables (eso es appointments). Tres calendarios para tres preguntas distintas.

Module id: schedules. Depende de: nada — y nada depende de él. Módulo híbrido: SQL + handler WASM (5 funciones: is_open, set_business_hours, create_special_day, create_override, bulk_create_special_days).

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).

Precedencia del motor

SpecialDay (fecha exacta > recurring MM-DD)  →  Override (rango)  →  BusinessHours (con descanso)  →  no_hours

Todo se evalúa en la zona horaria del negocio (context.timezone, del core) y sobre las filas que el runtime pre-carga (reads): el caller solo dice cuándo.

Qué expone hoy

Navegación: las tres entradas (hours, special_days, settings) montan el mismo erp-schedules-hours, que resuelve las pestañas internamente — este módulo no usa el bloque settings declarativo de ADR-0082.

Layout

module.json                   # manifest (contrato técnico)
migrations/postgres/          # esquema §2.5; horas TEXT 'HH:MM', fechas TEXT ISO (ADR-0007)
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í. schedules.is_open es autoritativo de punta a punta (schedules#1): el runtime pre-carga las cuatro listas (reads, ADR-0069), evalúa en la zona horaria del negocio (context.timezone, hub#731/hub#1022) y devuelve el veredicto por el canal result (hub#70). El caller solo dice cuándo. Limitaciones vigentes en docs/limits.md. Pendientes sin command propio: is_open_at puntual y generación de slots.

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