Registro de actividad

El registro de actividad anota quién hizo qué sobre un registro, y cuándo. Es
de donde lee la pestaña Historial de una reserva.

Tres propiedades que lo hacen confiable

Es inmutable. Las entradas nunca se actualizan y nunca se borran. No existe
un camino de edición, lo que significa que la historia no se puede reescribir en
silencio para que cuadre con la versión que alguien prefiera.

Es atómico con el cambio que describe. La entrada se escribe dentro de la
misma transacción de base de datos que el cambio de negocio. Si el cambio se
revierte, la línea del registro también — así que no existe tal cosa como un
evento registrado que no ocurrió, ni un cambio que no dejó rastro.

El actor es una foto del momento. El nombre y el correo de quien lo hizo se
capturan en el instante del evento y nunca se refrescan. Si se renombra a un
usuario, o se le borra, el historial de marzo pasado sigue diciendo quién lo hizo
y cómo se llamaba entonces.

Esa última es la diferencia entre una pista de auditoría y un join. Un registro
que consultara al usuario en vivo empezaría a decir "Usuario eliminado" para todo
lo que hizo un colega que se fue.

Qué lleva una entrada

Una foto completa del contexto relevante, en vez de ids que uno tenga que
resolver por su cuenta. Donde un campo cambió, la entrada lleva ambos lados, y
las referencias vienen expandidas — un cambio de unidad muestra el nombre de
la unidad, no un identificador que un año después no significa nada.

Quién aparece como actor

No todo cambio lo hace una persona en un escritorio:

• Un usuario del hotel — el caso corriente.
• Un admin de plataforma — cuando actuó soporte.
• Un huésped — datos que escribió él mismo por
  check-in digital. Recepción puede
  distinguir qué campos escribió el huésped y cuáles escribió recepción.
• El sistema — un canal conectado que aplica una reserva, una modificación o
  una cancelación aparece bajo su propio actor, y no bajo quien estuviera con la
  sesión abierta.

Ese último importa al leer una reserva que alguien jura no haber tocado.

Dónde se ve

Hoy el módulo instrumentado es el de reservas, y se lee desde la pestaña
Historial de una reserva.

Algunas cosas se registran deliberadamente contra el registro al que conciernen y
no contra el grupo que está encima: en un
grupo de reservas, quién fijó el pagador de una
habitación y quién movió un cargo suelto viven en el historial de esa reserva,
mientras que el historial del grupo lleva el cambio de la regla de facturación y
los pagos a la cuenta. Las decisiones sobre una habitación pertenecen a la
habitación.

En la API

• Merchant: GET /api/merchant/bookings/{booking}/activities.

Relacionado

• Reservas — donde vive la pestaña Historial.
• Reservas de grupo — qué se registra dónde.