Arquitectura

Componentes

• BC: registra tablets, emite codigos, crea solicitudes y descarga resultados.
• Backend API: autentica, orquesta estados, gestiona colas y persiste documentos.
• Tablet PWA: se activa por codigo, recupera documentos y sube el PDF firmado.

Reglas clave

• una tablet solo puede tener un documento activo a la vez
• la cola se aísla por deviceId
• GET /next usa lock temporal para evitar doble reserva
• la tablet consulta primero active y despues next
• el frontend publico no incluye secretos embebidos
• la activacion de tablet persiste en almacenamiento local hasta revocacion, reactivacion o borrado local
• eliminar una tablet no elimina el historico de solicitudes ni auditoria

Despliegue objetivo

• VPS Linux
• Coolify
• API publica HTTPS
• tablet publica HTTPS
• PostgreSQL interno

Operacion de tablet

• La pantalla de espera esta pensada para recepcion y solo muestra Esperando documento.
• Para uso continuo se recomienda PWA instalada y Android en fijacion de pantalla o kiosk gestionado.
• La PWA no puede despertar de forma fiable una pantalla Android apagada; para eso haria falta una app Android/wrapper con permisos nativos.