Operación de tablets
Esta guía sirve al equipo que instala o mantiene terminales de recepción. Las operaciones administrativas usan el bearer BC; la PWA utiliza exclusivamente su token de dispositivo.
Alta inicial
- Instala la PWA desde el navegador Android usando la URL HTTPS de tablet.
- Registra la tablet con
POST /v1/devices, indicando undeviceIdestable comotablet-recepcion-1y un nombre legible. - Emite un código con
POST /v1/devices/{deviceId}/activation-code. - Introduce identificador y código numérico de seis dígitos en la PWA. La vigencia inicial es 15 minutos.
- Comprueba la pantalla de espera y
GET /v1/devices: activa, nombre correcto ylastSeenAtactualizado cuando consulta.
La PWA guarda la sesión en localStorage. Recargar o reiniciar normalmente conserva la activación; borrar datos del sitio, cambiar origen o desinstalar puede perderla.
Ejemplos de las llamadas: Ejemplos REST.
Actualizar sin perder la activación
Redespliega la imagen tablet. En espera, usa Comprobar actualización o vuelve a abrir la PWA y confirma su versión.
La PWA detecta nuevas versiones mediante service worker y app-version.json. La recarga automática se aplaza mientras hay un documento activo. No borres almacenamiento para forzar una versión: el token se perdería.
Trabajar con un documento
El huésped lee y firma sobre el PDF. La PWA inicia firma al primer trazo, genera un PDF con tinta y lo sube. Ante fallo temporal de subida, deja la pantalla abierta y reintenta.
Tras recarga puede recuperar el PDF activo, pero no los trazos aún no enviados. Si se perdió la respuesta de subida, soporte debe consultar estado desde BC: el documento puede estar ya firmado.
Un documento abandonado en signing no expira automáticamente; cancélalo desde BC si debe liberarse. La referencia de estados detalla esos casos.
Desactivar, revocar o eliminar
| Necesidad | Acción | Condición / efecto |
|---|---|---|
| Salir desde la propia PWA | Desactivar tablet / POST /v1/devices/{deviceId}/deactivate |
409 si hay displayed/signing; borrar sesión local solo tras éxito |
| Cortar acceso remoto | POST /v1/devices/{deviceId}/revoke |
Invalida credenciales; conserva el registro y solicitudes |
| Reactivar/reemplazar equipo | Emitir código nuevo | Invalida el token anterior; activar en el equipo previsto |
| Retirar registro definitivamente | DELETE /v1/devices/{deviceId} |
409 si quedan solicitudes abiertas |
Revocar no cancela documentos. Antes de retirar un equipo, revisa sus solicitudes y resuelve las abiertas. Eliminar el registro no borra historial, PDFs ni auditoría.
Resolver una incidencia
| Síntoma | Comprobación |
|---|---|
| No llega documento | API saludable, tablet activa, deviceId destino correcto y solicitudes pendientes |
| Pide activación de nuevo | Datos locales borrados, token revocado o código nuevo emitido |
| No carga PDF | Conectividad, URL API, CORS y archivo original en storage |
| No se puede desactivar/eliminar | Resolver documento activo/solicitudes abiertas |
| No sube resultado | Mantener PWA abierta; revisar estado BC, tamaño y logs usando trace |
| Versión antigua | Recurso tablet correcto, redeploy y actualización en espera |
Para un dispositivo perdido, revoca inmediatamente, revisa lastSeenAt y auditoría, y emite un código nuevo cuando el equipo sea confiable.
Instalación física
Usa fijación de pantalla o kiosk gestionado según la política del hotel. Mantén encendida la pantalla con brillo adecuado: la PWA no puede despertar de forma fiable una pantalla Android apagada. El salvapantallas de espera reduce contenido estático, pero no sustituye la gestión de energía del dispositivo.