Housekeeping

Housekeeping lleva el control de quién limpia qué, en qué estado está cada
espacio, qué está descompuesto y qué habitación no se puede vender por eso.

Informa, no bloquea

Housekeeping nunca detiene una operación comercial. Es dato, no permiso:

• Una habitación sucia se sigue vendiendo y al huésped se le sigue haciendo
  check-in. La reserva dice que la habitación no está lista y recepción decide
  — apurar la limpieza, mover al huésped, o seguir adelante.
• Una tarea con pasos del checklist sin marcar se puede completar igual.

Un candado no ayudaría. Un candado a las 11 de la noche se falsifica: el
recepcionista marca la habitación como limpia a mano para poder trabajar, y
corrompe justo el dato que el módulo existe para mantener honesto.

Lo único que sí saca una habitación de la venta es un bloqueo de
mantenimiento — y ese es un eje completamente distinto. Una habitación
bloqueada sigue estando limpia y sigue estando lista. Lo que no está es a la
venta, y eso sí llega a los canales.

Vocabulario

La inspección es una decisión a nivel de propiedad

Que la limpieza sea un paso o dos se configura por propiedad, por un admin de
plataforma, porque describe cómo opera el hotel y no lo que está haciendo hoy.

• Apagada — quien limpia marca la habitación como clean y queda lista.
• Encendida — quien limpia la deja en clean, y solo queda lista cuando un
  supervisor la marca inspected.

Se puede cambiar en cualquier momento y tiene efecto inmediato, porque cada
superficie lee el "lista" que calcula la API en vez de deducirlo.

Los esquemas generan el trabajo

Un esquema se dispara en la salida (se genera cuando al huésped se le hace
check-out) o durante la estadía (un servicio cada N noches, contado desde la
noche de llegada).

El disparador de estadía cubre las noches estrictamente entre la llegada y la
salida. El día de llegada no lleva servicio — la habitación se acababa de limpiar
como salida del huésped anterior — y el día de salida es una limpieza de salida,
no un servicio.

Una lista de unidades vacía en un esquema significa todas las unidades de la
propiedad, no ninguna.

No tener esquemas en absoluto es una configuración válida ("creamos las tareas a
mano"), no un estado roto.

Las ediciones no reescriben la historia

• Renombrar o reordenar un paso no lo convierte en otro paso. El esquema
  conserva la identidad de cada paso, así que "cada cuánto nos saltamos las
  toallas" sobrevive a las ediciones. Quitar un paso sí lo borra.
• Editar el checklist de un esquema no toca las tareas ya generadas. La tarea
  de ayer sigue diciendo lo que decía ayer. Una tarea completada es el registro
  de un trabajo que ocurrió, y reescribirla desde la plantilla la falsificaría.
• Borrar un esquema detiene la generación y deja en paz las tareas
  existentes, con sus pasos y con lo que se marcó en ellas.

Excepción por reserva

Una reserva se puede marcar como que no quiere servicio diario. La limpieza de
salida se hace igual.

En la API

• Merchant: /api/merchant/housekeeping para el tablero, las tareas y los
  cambios de estado; los esquemas de limpieza viven bajo los endpoints de
  configuración de la propiedad.
• Un bloqueo de mantenimiento escribe un bloqueo de venta corriente sobre la
  unidad — ver Unidades.
• Externa: GET /units/{unit}/housekeeping (alcance housekeeping:read)
  devuelve el estado de cada habitación, y los webhooks unit.ready y
  unit.dirty avisan cuando cambia — ver
  Recibir eventos por webhook.

Relacionado

• Unidades — los espacios, y qué bloquea realmente una venta.
• Reservas — donde el "no está lista" le llega a recepción.