Saltar a contenido

Runbook de tablets

Alta inicial

  1. Registrar la tablet.
  2. Emitir codigo de activacion numerico de 6 digitos.
  3. Activar la tablet desde la PWA.
  4. Verificar que aparece activa y con lastSeenAt.

La activacion queda guardada en la PWA. Recargar la pagina o reiniciar la tablet no requiere un nuevo codigo mientras no se borre el almacenamiento local ni se revoque el dispositivo.

Actualizacion de la PWA

  • No uses "borrar datos del sitio", "limpiar almacenamiento" ni desinstalar la PWA para actualizar, porque puede borrar localStorage y perder la activacion.
  • Despues de desplegar una nueva version, cerrar y abrir la PWA o recargarla debe cargar la version nueva sin reactivar la tablet.
  • Si el service worker detecta una nueva version en pantalla de espera, la PWA se recarga automaticamente.
  • La tablet tambien consulta /app-version.json periodicamente en espera y permite usar Comprobar actualizacion.
  • Si hay un documento activo o una firma en curso, la recarga automatica se aplaza hasta volver a espera.
  • Comprueba la version visible en la esquina inferior para confirmar la actualizacion.

Revocacion

  1. Revocar la tablet desde backend.
  2. Confirmar que deja de acceder a active y next.
  3. Emitir nuevo codigo si procede.

Eliminacion

  1. Eliminar la tablet solo cuando ya no tenga solicitudes abiertas.
  2. Si la API devuelve 409, cancelar o finalizar primero las solicitudes pending, displayed o signing asociadas.
  3. Confirmar que deja de aparecer en GET /v1/devices.

Eliminar una tablet no borra solicitudes, PDFs ni auditoria historica. Usa revoke si solo quieres cortar el acceso pero mantener el registro.

Uso en recepcion

  • Instalar la PWA desde Chrome antes de activar la tablet.
  • En Android, usar fijacion de pantalla o Fully Kiosk Browser si la tablet queda expuesta al publico.
  • Mantener la pantalla encendida con brillo bajo; una PWA no puede encender de forma fiable una pantalla Android apagada cuando llega un documento.
  • La pantalla de espera esta pensada para recepcion y solo muestra Esperando documento hasta que llegue una solicitud.

Comprobaciones rapidas

  • revisar GET /health
  • revisar lastSeenAt
  • revisar errores de activacion o firmado