El Escáner QR
PWA, validación criptográfica, regla de las 4 AM y contingencias offline.
El Escáner QR y Control de Puerta
El motor de control de accesos de eTICKETar está diseñado como una PWA (Progressive Web App) ejecutada en el Edge. Esto significa que ni tú ni tu equipo de Staff necesitan descargar nada desde la App Store o Google Play. El sistema compila y funciona directamente desde el navegador del celular a máxima velocidad.
El Candado Temporal (La Regla de las 04:00 AM)
Por seguridad arquitectónica, los eventos no están abiertos para escaneo infinitamente. El escáner para un evento específico solo se habilita el día de la fecha de inicio. Para cubrir la naturaleza de la industria nocturna (fiestas cruzadas de madrugada), la ventana de validación se cierra de forma estricta a las 04:00 AM del día siguiente a la fecha de finalización del evento. Pasada esa hora, el escáner se bloquea automáticamente para esa producción.
El Sistema de Semáforo (Validación HMAC)
Al escanear un Código QR, el sistema realiza una verificación criptográfica instantánea. La pantalla se iluminará sin dejar margen de error en la oscuridad del club:
- 🟢 PANTALLA VERDE (Acceso Válido): La firma criptográfica es correcta, pertenece a este evento, y es la primera vez que se lee. ¡El cliente ingresa!
- 🔴 PANTALLA ROJA (Acceso Denegado): El sistema emitirá una alerta sonora y mostrará el diagnóstico exacto del rechazo:
- Ya Escaneado: Alguien más entró con este mismo QR anteriormente (Posible captura de pantalla o reventa fraudulenta).
- Ticket Falsificado: La firma HMAC del código no coincide con la de nuestro servidor. Es un QR inventado.
- Evento Incorrecto: El cliente muestra una entrada de una fiesta pasada o futura.
- Ticket Cancelado: La entrada fue reembolsada por la administración.
Superpoder: Modo Offline (Sin Internet)
Los clubes nocturnos o sótanos suelen tener conectividad nula. Nuestra PWA está diseñada con tolerancia a fallos de red.
Si el celular pierde la conexión a internet en medio de la fila:
- El escáner seguirá validando entradas a máxima velocidad leyendo la caché.
- Guardará todos los ingresos en la memoria local (IndexedDB) del teléfono.
- Al recuperar la señal (así sea horas después), ejecutará una sincronización silenciosa (Background Sync) con nuestra base de datos en la nube.
Requisito de Precarga Offline: Para que el escáner conozca las firmas válidas sin internet, es obligatorio que el portero inicie sesión y abra el evento al menos una vez mientras tenga buena conexión (ej. en su casa o en la calle antes de entrar al local). Esto descarga el "Snapshot" del inventario a su teléfono.
Búsqueda Manual (El Plan B)
Si el cliente se queda sin batería, la pantalla de su celular está rota, o no encuentra el correo, el escáner posee un sistema de Búsqueda Manual. El portero puede validar el acceso digitando en el buscador:
- El Código Corto de 12 caracteres alfanuméricos que aparece debajo del QR del cliente.
- El Nombre y Apellido.
- El Documento de Identidad (DNI, RUT, Cédula).
El motor indexará la base de datos en milisegundos y permitirá ejecutar el ingreso deslizando un botón, sin necesidad del QR físico.