Saltar al contenido principal

PWA Delivery (delivery.farme.pro)

La aplicación FARME Delivery es una PWA (Progressive Web Application) autónoma diseñada exclusivamente para el personal de reparto y motorizados (role: delivery).

📱 Acceso y Autenticación​

  • URL Producción: https://delivery.farme.pro
  • URL Staging: https://delivery-staging.farme.pro
  • Puerto Local: http://localhost:3200

Regla de Aislamiento​

  1. Acceso exclusivo: Solo los usuarios con rol delivery pueden iniciar sesión en delivery.farme.pro. Si un usuario administrativo intenta ingresar, el sistema le denegará el acceso.
  2. Bloqueo en Panel Administrativo: Si un repartidor intenta ingresar a farme.pro o staging.farme.pro, el sistema le indicará que debe utilizar la app dedicada en delivery.farme.pro.

🗺️ Gestión de Rutas y Paradas​

Al ingresar a la app, el repartidor visualiza sus rutas activas y planificadas:

  • Progreso en tiempo real: Porcentaje de avance de la ruta en base a paradas completadas o canceladas.
  • Identificación de paradas (A - Z): Cada parada muestra su identificador, nombre del beneficiario, dirección y distancia acumulada.
  • Mapa interactivo: Integración con Google Maps con marcadores dinámicos según el estado de la parada (verde para completadas, rojo para canceladas, naranja para pendientes).
  • Navegación GPS directa: Botón para abrir la navegación en vivo en Google Maps (dir_action=navigate) hacia el próximo destino.

📸 Completar y Cancelar Paradas​

Completar Entrega​

  • Permite capturar o subir una fotografía del comprobante de entrega o firma.
  • Campo de observaciones opcional.

Cancelar Parada / Ruta​

  • Selector estandarizado de motivos de cancelación (cliente ausente, dirección incorrecta, acceso bloqueado, etc.).
  • Registro de observaciones adicionales para el coordinador.

📶 Funcionamiento Offline​

La aplicación cuenta con soporte offline completo mediante IndexedDB (idb-keyval):

  1. Si el motorizado pierde conexión en una zona sin cobertura celular, puede seguir completando entregas.
  2. Las entregas se guardan de forma segura en la memoria local del dispositivo.
  3. Un banner visual notifica cuántas entregas están pendientes de sincronizar.
  4. Tan pronto se recupera la conexión a internet, la aplicación sincroniza automáticamente las entregas con el servidor.