Check-in digital

Esta es la guía operativa del check-in digital. Para el modelo, conviene leer antes
Huéspedes y check-in digital.

Tiene dos caras, y esta guía las recorre en orden:

• La del huésped — una app pública aparte, hecha para un teléfono. Es la única
  parte del producto que usa alguien que no trabaja en el hotel.
• La de recepción — dentro de una reserva: la pestaña Huéspedes, el panel
  de verificación, el resumen en el encabezado de la reserva, y las fichas de
  registro.

Las tres reglas que explican el resto

1. El enlace es la credencial

No hay inicio de sesión. El huésped no tiene cuenta, ni contraseña, ni un
código que escribir. Llega por un enlace, y ese enlace es el permiso.

De ahí se siguen cuatro cosas que si no se verían arbitrarias:

• Hay dos clases de enlace y no son intercambiables. El del huésped principal
  abre la reserva entera; el de un acompañante abre a una sola persona. Un enlace
  de la clase equivocada no se adapta — no abre.
• Un enlace que no corresponde da exactamente el mismo error que uno que nunca
  existió. Deliberadamente: si el error los distinguiera, cualquiera podría
  descubrir si una reserva existe probando enlaces.
• El sistema no le manda su enlace a nadie más que al huésped principal. El
  huésped principal reparte los enlaces de los acompañantes como quiera. El hotel
  no le escribe a cada acompañante.
• Un enlace perdido se vuelve a entregar en el mostrador. Recepción tiene el
  de todos en la pestaña Huéspedes, con un botón de copiar.

Que es por lo que alguien que llega sin enlace no ve un formulario de inicio de
sesión sino un aviso que le dice dónde buscar: buscá "check-in" en tu correo, y
revisá spam.

2. El huésped principal no espera a nadie

Hay dos cifras de avance separadas y nunca suman:

• La del huésped principal — sus datos, sus acompañantes ingresados, su propia
  verificación y los términos. Es lo único que condiciona el botón de terminar.
• La de los acompañantes — cuántos tienen que verificar y cuántos lo hicieron.
  Es un conteo, no una compuerta.

Un huésped principal puede terminar con dos acompañantes sin verificar. La pantalla
se lo dice — 2 acompañantes todavía tienen que verificar. Tu check-in está listo.
Pasales su enlace — y lo deja pasar.

La razón es de producto, no técnica: un acompañante muchas veces es un colega, no
familia. El huésped principal no tiene su documento, no está con él, y no puede
hacer nada en su nombre. Condicionarlo lo condicionaría para siempre.

En recepción, por eso la etiqueta de Check-in digital y el contador de
X de N verificados están uno al lado del otro y nunca se reemplazan. Son
dos hechos distintos.

3. Axis Pro no guarda las fotos

La identidad la resuelve un proveedor externo de verificación. El huésped sale
de la app, hace su revisión ahí, y vuelve. Lo que se conserva de este lado es el
veredicto y los campos leídos del documento — nunca una imagen.

Consecuencias visibles:

• No hay pantalla para subir un archivo, en ninguno de los dos lados. Si
  alguna vez aparece una, algo salió mal.
• Las fotos que recepción ve en el panel de verificación se traen del proveedor
  en ese momento, por enlaces que expiran solos. Por eso el panel se pide a mano
  en vez de cargarse con la reserva, y por eso cerrarlo descarta las fotos.
• Una foto puede volver como el enlace de esta imagen expiró. Eso no es un error
  del hotel: es el enlace firmado haciendo su trabajo.
• El lote de fichas de registro del día va sin fotos. Traerlas para una reserva
  son unas cuantas idas y vueltas al proveedor; para una mañana de llegadas son
  cientos, y el PDF no terminaría nunca.

Antes de empezar

Todo esto se configura una vez por propiedad.

La feature de check-in digital es la llave del módulo. Sin ella, recepción no
ve etiquetas de verificación, ni contador, ni panel de verificación, ni enlace de
check-in en una fila. No es "0 de 0" ni "no iniciado": la pregunta no aplica a esa
propiedad. Las fichas de registro siguen funcionando de todos modos — eso es
deliberado.

El umbral de edad decide quién tiene que verificar. Se mide a la fecha de
llegada, no a hoy, así que un huésped que cumple años durante la estadía no
cambia de categoría a mitad de camino. Es también por lo que la fecha de
nacimiento es obligatoria en todo formulario: sin ella el sistema no puede decidir
quién verifica, y se niega a guardar.

Términos y política de privacidad — si la propiedad los publicó, el último paso
del huésped muestra una casilla obligatoria con los dos enlaces. Si no publicó
ninguno, el paso no pregunta.

Idiomas y logo — la app del huésped abre en el idioma del navegador y ofrece los
que la propiedad habilitó, cayendo al suyo por defecto. El logo de la propiedad es
lo primero de la portada, y es lo que le dice al huésped dónde está.

El lado del huésped

Los pasos son Tus datos → Huéspedes → Verificación → Listo, y el paso de
verificación existe solo si esa persona tiene que verificar. Un paso que dice
"no tenés que hacer nada" es peor que no tener paso.

En un teléfono es una columna centrada con la barra de avance arriba y el botón
principal fijo abajo. En una computadora el mismo flujo agrega un riel a la
izquierda con la propiedad, la estadía y el avance vertical — después de la
portada, el huésped si no nunca volvería a ver de qué reserva se trata.

La portada

El logo y el nombre de la propiedad, las fechas, el alojamiento, y un botón de
Empezar, con el selector de idioma arriba.

Las fechas se muestran, nunca se editan. Cambiarlas movería disponibilidad y
precio. Para el huésped son de solo lectura, y si están mal eso se arregla en
recepción.

1. Tus datos

Once campos en dos bloques: sobre vos (nombre, apellido, fecha de nacimiento,
correo, teléfono) y dónde vivís (dirección, ciudad, estado, código postal, país).

• Se guarda un borrador local mientras se escribe. Es un formulario largo, en
  un teléfono, muchas veces en movimiento: una llamada entrante o una pestaña
  cerrada si no borrarían todo. El borrador vive en el navegador del huésped,
  expira a la semana, y se limpia en el momento en que el guardado tiene éxito.
• Pide más de lo que exige la API. El teléfono y la dirección se podrían
  guardar vacíos, pero después aparecerían como faltantes en el último paso.
  Pedirlos acá es más honesto que dejar que el huésped choque con un "falta algo"
  cuando creía haber terminado.
• La fecha de nacimiento tiene su propio texto de ayuda: hace falta para
  decidir si esa persona tiene que verificar. No es un campo de relleno.

2. Huéspedes

El encabezado dice a cuántas personas espera la reserva, y sigue la lista con el
huésped principal marcado como Vos. Desde acá se agregan, editan y quitan
personas, hasta la capacidad de la reserva.

Cada fila de acompañante tiene Copiar enlace — el que hay que pasarle a esa
persona. Si el navegador no permite acceso al portapapeles, el enlace se muestra
para copiarlo a mano; fallar en silencio dejaría al huésped sin nada.

3. Verificación

El botón lleva al huésped al proveedor; hace su revisión ahí y vuelve por su
cuenta.

Dos cosas que vale decir aparte:

• El veredicto no llega con el huésped. Que vuelva del proveedor prueba que
  terminó el flujo, no que haya una decisión. Por eso la espera es una pantalla de
  primera clase — con su spinner y su esta pantalla se actualiza sola — y no un
  aviso de paso: la app vuelve a preguntar cada pocos segundos y cada vez que el
  huésped regresa a la pestaña.
• Puede continuar sin el veredicto. El botón dice continuar y verificar
  después. Esperar acá dejaría varado al huésped por una decisión que no controla;
  lo que sí condiciona de verdad se resuelve en el último paso.

4. Listo

Si falta algo las razones se listan en lenguaje claro — tus datos están
incompletos, faltan acompañantes adultos por agregar, todavía tenés que verificar,
hay que aceptar los términos — cada una con un botón de Completar que va al
paso donde se arregla. Los ocho campos del huésped principal se colapsan en un
solo aviso: el nombre técnico de la columna no le ayuda a nadie, saber a dónde ir
sí.

Si está todo, la casilla de términos (donde la propiedad publicó legales) y
Terminar check-in.

Terminar muestra el QR, con el código de reserva debajo y un botón de descarga.
Es lo que recepción escanea al llegar. Va sobre un fondo blanco fijo a propósito:
un QR sobre fondo con tinte deja de escanearse en varios lectores, y todo el valor
de la pantalla es que lea a la primera.

Si quedan acompañantes sin verificar, lo dice ahí mismo, sin deshacer nada.

El acompañante: una sola pantalla

Ve el nombre de la propiedad, las fechas, sus propios datos y su propia
verificación. Y nada más: ni el código de reserva, ni el alojamiento, ni quién
más viaja, ni una sola cifra de dinero.

La misma razón que la regla 2: un acompañante muchas veces es un colega, no
familia. Mostrarle la reserva entera le filtraría a un tercero lo que contrató
otra persona.

No hay pasos ni pantalla de cierre — su verificación es su tarea. Cuando la
termina, terminó.

El texto de arriba le pide expresamente que revise los datos que ingresó el huésped
principal: un nombre mal escrito es la razón más común de que una verificación no
coincida con el documento. Es literalmente la causa número uno de rechazos
evitables.

Recepción

La pestaña Huéspedes

Una tarjeta por persona, el huésped principal primero. Con la feature encendida,
cada tarjeta agrega:

• La etiqueta de veredicto, con los seis estados de arriba y sus colores. Un
  estado que este frontend todavía no conoce se muestra como en progreso, nunca
  como error.
• Resuelto el …, y solo en estados que pueden llevar fecha. En revisión nunca
  lleva una: todavía no hay decisión, y fecharla diría que sí.
• El bloque de identidad con lo que se leyó del documento — tipo y número,
  nombre, fechas de emisión y vencimiento, nacionalidad, país emisor — en el orden
  en que uno lee un pasaporte, no en el orden del payload. Solo llega en una
  verificación aprobada y puede venir incompleto. Al pie: esto lo lee el proveedor,
  y las imágenes no se guardan en Axis Pro.
• Copiar enlace — el enlace de check-in de esa persona, para quien llegó sin el
  huésped principal, perdió el correo o no tiene teléfono. Copia y nada más: no
  hay forma de verificar en nombre de otro, y el botón no insinúa que la haya.

El enlace solo aparece si la propiedad tiene la feature y la puerta sigue
abierta. Con la puerta cerrada no hay nada que copiar — entregar ese enlace sería
mandarle un error al huésped.

Un menor no muestra etiqueta, ni panel, ni enlace.

El panel de verificación

El botón por fila que abre qué produjo el veredicto. Existe porque el hotel no
tiene acceso a la consola del proveedor: sin él, un rechazo es un veredicto sin
una razón al lado, que es exactamente lo que recepción necesita con la persona
parada enfrente.

Cuatro bloques, y no todos llegan siempre:

1. Imágenes — retrato, anverso del documento, reverso. En ese orden porque es
   el orden en que uno mira: primero comparar la cara que tiene enfrente con el
   retrato, después abrir el documento.
2. Revisiones automáticas — coincidencia facial y prueba de vida, como
   porcentajes redondeados.
3. Datos del documento — los mismos campos de la tarjeta.
4. Advertencias del proveedor — y acá está el detalle que importa: en un
   rechazo las advertencias van hasta arriba, bajo por qué se rechazó. Es lo
   único accionable de la pantalla, y ponerlo debajo de tres fotos lo escondería. En
   un veredicto aprobado con una advertencia menor, la foto sigue primero y la
   advertencia es contexto.

Es una llamada en vivo cada vez que se abre. Por eso es un botón y no un bloque
que se carga solo: abrir una reserva de cinco personas no puede costar cinco
llamadas al proveedor. Hay un botón de refrescar, y cerrar el panel descarta las
fotos con él.

Los dos modos de falla se ven distintos, y esa distinción es el punto:

Para un recepcionista los dos se parecen y significan cosas opuestas, que es por lo
que son dos pantallas y no un error genérico.

El resumen en la reserva

Arriba a la derecha, junto al estado:

• Check-in digital (verde) o Check-in digital pendiente (ámbar) — si el
  huésped principal cerró su check-in.
• X de N verificados — el conteo de quienes tenían que verificar, con N
  rechazados al lado si los hay.

Las dos etiquetas conviven porque son cosas distintas (regla 2). El tooltip lo dice:
el check-in digital del huésped principal no espera a los acompañantes, así que una
reserva puede leerse como completada con verificaciones pendientes.

Una vez cerrada la puerta, el contador se pinta neutro y el tooltip cambia:
estos números son el registro de lo que pasó, ya nadie puede verificar. Pintar una
estadía terminada como advertencia le pediría a recepción una tarea que ya no puede
hacer.

Fichas de registro

El papel que el hotel archiva por estadía. Hay dos, y difieren a propósito.

Para una reserva — una ficha por huésped de esa reserva, con las fotos de
verificación. Tarda unos segundos: el sistema las trae del proveedor en ese
momento.

El lote del día — desde la lista de reservas. Un popover con:

• El día de llegada, editable. Arranca del filtro de la lista y, a falta de
  eso, hoy en la propiedad — no en el navegador: a las 19:00 en Guatemala el
  hotel sigue en un día que en Madrid ya terminó. Cambiarlo es lo que permite
  imprimir las fichas de mañana la noche anterior.
• Los filtros que hereda de la lista — unidad y estado, y solo cuando hay uno
  de cada. Con varios seleccionados el popover lo dice en vez de aplicar el
  primero calladamente.
• Dos advertencias fijas: el lote va sin fotos de verificación, y se detiene
  en 100 reservas (el PDF señala el corte en su primera página).

Las cancelaciones quedan fuera salvo que se pidan expresamente por el filtro de
estado.