Modo offline — escanear sin conexión

Introducción

Muchos venues (salones en el interior, espacios sin cobertura, estadios abarrotados) tienen wifi inestable o directamente sin conexión. Para que eso no te frene el ingreso, Ticketera tiene un modo offline: el scanner descarga la lista de QRs válidos antes del evento, y valida contra una base local en el celular.

Cuando vuelve la conexión, los escaneos pendientes se sincronizan automáticamente con el servidor.

Cuándo usarlo

• Venues con wifi dudoso o saturado (festivales grandes suelen colapsar la conexión).
• Lugares sin cobertura móvil (venues rurales, subterráneos, zonas con poca señal).
• Contingencia: incluso si tenés wifi del venue, activar offline te da un seguro si se cae.

Recomendación: usalo siempre para eventos de +500 asistentes. El costo es cero y el beneficio enorme si hay un incidente de red.

Cómo funciona

Antes del evento: descargar tickets

1. 1

   El scanner entra al validador (/dashboard/scanner del evento).

2. 2

   Hace clic en Descargar tickets. El sistema descarga toda la lista de QRs válidos del evento (cada ticket con su QR code, tipo de entrada, nombre del comprador, estado).

3. 3

   Los datos se guardan localmente en el dispositivo — en el almacenamiento interno del navegador. Sobrevive al cierre del navegador y reinicios del celular.

4. 4

   Confirmá descarga completa. El scanner ve "X tickets descargados".

Durante el evento: validación offline

Cuando la conexión se cae (o se vuelve inestable), el validador detecta que no puede llegar al server y pasa automáticamente a modo offline. Vas a ver un banner arriba: "Sin conexión a internet. Las validaciones se harán de forma local y se sincronizarán después."

En modo offline:

• Cada escaneo se valida contra la base local del dispositivo.
• Si el QR está en la base y no fue usado, se marca como usado localmente (optimista) y se pone en cola de "escaneos pendientes de sincronizar".
• Si el QR no está en la base (ej: el comprador compró después de la descarga), el sistema lo rechaza como "QR no encontrado". Esto es una limitación conocida del modo offline — ver FAQ.
• Si el QR ya fue usado (localmente o en la descarga), se rechaza con "Ya fue utilizado".

El scanner no percibe diferencia operativa — la UX es la misma. Solo cambia el banner arriba y un contador de "escaneos sin sincronizar".

Al volver conexión: sincronización

Cuando el navegador detecta que volvió la conexión:

• Sincronización automática: intenta subir todos los escaneos pendientes al servidor.
• Botón manual Sincronizar: si querés forzarla por cualquier razón (ej: estás de vuelta en la oficina revisando).
• Resolución de conflictos: si el mismo QR fue escaneado en paralelo por otro scanner online, el servidor acepta solo uno. El scanner offline ve el suyo marcado como "ya usado online" y lo descarta del pending.

Al finalizar la sincronización, el scanner ve el resumen: cuántos escaneos se subieron correctamente, cuántos fallaron y cuántos ya estaban marcados como usados online.

Indicadores en la pantalla

Mientras escanean, los scanners ven en la parte superior:

• 🟢 Conectado — operación normal, validación online.
• 🟠 Sincronizando... — envío de pending al server.
• 🔴 Sin conexión — modo offline activo, validaciones locales.
• Contador de pendientes: "N escaneos sin sincronizar" si hay backlog.

El indicador de estado refresca cada 5 segundos — eso es lo que te muestra el pending.

Qué pasa con compradores que compraron después de la descarga

Limitación conocida: si alguien compra una entrada después de que el scanner descargó la base, ese QR no está en la base local. Si el scanner está offline al momento del escaneo, lo va a rechazar como "QR no encontrado".

Soluciones

1. Re-descargar la base periódicamente: si sabés que hay ventas de último momento (ej: venta online abierta hasta la puerta), el scanner re-descarga cada 30 min mientras tenga conexión.
2. Dejar la venta online cerrada con X horas de antelación: desde el dashboard del evento cambiá el estado a Cerrado para frenar ventas nuevas N horas antes. Después de eso, la base local del scanner queda siempre completa.
3. Coordinar con el scanner: cuando llegue alguien con QR reciente, que el scanner vaya a un lugar con señal (cerca de la puerta, si hay), valide ese QR puntual online, y vuelva.

Preguntas frecuentes

¿Cuánta plata ocupa la base local?

Muy poco. Cada ticket ocupa alrededor de 500 bytes. Para 10.000 tickets son ~5 MB. Para 100.000 tickets son ~50 MB. Ningún celular moderno tiene problema con eso.

¿Cuánto dura la base local?

Hasta que borres el caché del navegador o reinstales el navegador. El sistema operativo no la elimina por inactividad.

Si el scanner se va y vuelve el celular prestado, ¿se pierden los pending?

No. La base local queda en el navegador del celular. Al volver a abrir el validador y loguearse, los pending siguen ahí y se sincronizan cuando haya red.

¿Qué pasa si dos scanners escanean el mismo QR en modo offline?

Al sincronizar, el servidor acepta solo uno (el primero que llega). El segundo recibe como respuesta "ya usado online" y el scanner lo ve retroactivamente. En la práctica esto casi no pasa porque un QR se usa una vez; pero si alguien intenta usar la misma entrada en dos puertas distintas, el sistema lo detecta.

¿Y si alguien manipula la base local del navegador?

El modo offline confía en el dispositivo por diseño. Si hay sospecha de manipulación, los datos del servidor son la fuente de verdad al sincronizar — cualquier QR que ya fue marcado como usado no se puede revertir desde el cliente.

¿Se puede usar modo offline sin haber estado online nunca?

No. Para que exista la base local, alguna vez el scanner tuvo que descargar con conexión. No hay una forma de cargar manualmente tickets al celular sin pasar por la descarga.

¿El modo offline funciona con eventos recurrentes?

Sí. La descarga trae todos los tickets del evento incluyendo la información de función/fecha. El validador local verifica la ocurrencia correcta — si el QR corresponde a otra función, lo rechaza igual que online.

Siguientes pasos

• Web scanner — la herramienta base de validación.
• Monitorear accesos en vivo — dashboard de ingresos.
• Invitar scanners — dar de alta a tu equipo.