Módulo staff — personal, roles, horarios y ausencias

Módulo HR base del Hub (sin dependencias): ficha laboral del empleado, rol de catálogo (estilista, barbero…), horarios semanales, ausencias con flujo de aprobación y datos de compensación (tarifa/comisión).

⚠️ staff NO sustituye a la identidad del core (ADR-0192). El hub_user responde a quién entra y su rol concede permisos; staff_member responde a quién trabaja y su staff_role es solo una etiqueta de catálogo con color y orden. staff_member.user_id es la costura, y es opcional en los dos sentidos.

Module id: staff. Depende de: nada (depends_on: []). Es dependencia de appointments. Módulo híbrido: SQL + handler WASM (4 funciones).

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

Privacidad por query (staff#10)

employee tiene view_staff_member y view_time_off por defecto, así que la compensación y el motivo de una ausencia se sacaron de las listas y viven detrás de sus propios permisos:

No están tampoco en sort/filters: un filtro de rango sobre un valor invisible es un oráculo.

Self-service (staff#19): el empleado sí ve LO SUYO — staff.members.mine (su ficha con su tarifa y comisión) y staff.time_off.mine (sus ausencias con motivo y notas) — con los permisos de siempre: el alcance lo cierra WHERE user_id = :current_user_id (inyectado por el runtime, ADR-0192), no un permiso más ancho.

Qué expone hoy

Navegación: erp-staff-members, erp-staff-roles, erp-staff-time-off, erp-staff-schedules; 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í. Limitaciones documentadas en docs/limits.md: no hay control horario/fichajes (por eso no hay widget de fichajes — cero mocks) y no hay nómina. Las guardas de deactivate/time_off.create/schedules.create/ time_off.set_status son autoritativas (staff#1): el handler decide sobre context.reads y un rechazo es un error de dominio (staff.*) — ni fila ni evento; el SQL condicional queda solo como defensa en profundidad.

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