1. Introducción

1.1 Propósito

Este documento detalla los requerimientos funcionales y no funcionales de FlashAR (FAR), una plataforma de logística que conectará vendedores de Mercado Libre (ML) con repartidores independientes para ofrecer un servicio de envíos Turbo en la Ciudad Autónoma de Buenos Aires (CABA).

1.2 Alcance

FAR permitirá la gestión automatizada de envíos a través de la integración con la API de Mercado Libre, optimizando la asignación de repartidores y brindando seguimiento en tiempo real a vendedores y clientes.

2. Requerimientos Funcionales

2.1 Usuarios y Roles

FAR contará con los siguientes roles y niveles de acceso:

• FlashAR:
  • Administrador: Gestión completa del sistema, usuarios y operaciones.
  • Agente: Supervisión de operaciones, asignación de zonas y repartidores y administración de batches de tiempos de espera para repartidores.
  • Soporte: Resolución de incidentes y asistencia a usuarios.
• Vendedores:
  • Vendedor: Puede realizar envíos y visualizar reportes.
• Repartidores:
  • Repartidor: Responsable de realizar entregas.

2.2 Registro y Validación

• Los vendedores serán registrador en FAR por un administrador manualmente.
• Los repartidores deberán registrarse en FAR de manera independiente y pasarán por un proceso de registro y aprobación antes de comenzar a operar.

2.3 Integración con Mercado Libre

FAR utilizará APIs de Mercado Libre para:

• Obtener datos del vendedor.
• Extraer detalles de compra, dirección de entrega y contacto del cliente.
• Gestionar entregas.
• Enviar información de tracking a ML y al vendedor.

2.4 Logística y Asignación de Pedidos

• Los repartidores serán asignados automáticamente a zonas (cluster) específicas dentro de CABA, según demanda/áreas con grupos de vendedores, esto podrá ser editado por usuarios adminitradores de FAR.
• Se definirán clusters de cobertura de 8 km de radio, agrupando vendedores dentro de estas áreas, esto podrá ser editado por usuarios adminitradores de FAR.
• Los pedidos se agruparán en batches de un rango de tiempo, manualmente variable, para optimizar la entrega.
• El máximo de entregas por batche será definido por FAR, manualmente variable.
• Las entregas comenzarán luego del cumplimiento de la primera de las anteriores variables, finalización del batche de tiempo o el máximo de entregas asignadas al repartidor, si existe al menos una entrega asignada al batche correspondiente.
• La ruta de entrega será automáticamente definida por el sistema de FAR optimizando distancias y tiempos.
• En caso de falta de repartidores disponibles, se enviará una alerta a los administradores de FAR.
• En caso de contar con un envío ingresado al sistema de FAR, el cual lleve más de 5 minutos de no ser asignado a un Cluster, el sistema debe notificar a los administradores.
• En caso de no contar con al menos dos repartidores en un Cluster, el sistema debe notificar a los administradores.
• Los Repartidores podrán registrarse utilizando Moto y Bici eléctrica/motor.
• Cuando el sistema detecta un paquete Oversize (Alto + Largo + Ancho > 120 cm) que asigne un batch unico a un repartidor, el más cercano disponible.
• Las reasignaciones manuales deben mostar la lista de repartidores ordenados por cercanía y disponibilidad, es decir menos cantidades de envíos asignados.

2.5 Plataforma y Aplicaciones

• Administradores FAR: Aplicación web.
• Vendedores: Aplicación web.
• Repartidores: Aplicación móvil.

2.5.1 Funcionalidades para Administradores FAR

• Usuarios:
  • Sección de administración de usuarios:
    • FAR
    • Vendedores
    • Repartidores
• Administración:
  • Gestión de:
    • Delimitación de zonas,
    • Asignación de repartidores,
    • Administración de:
      • Batches de tiempos de espera para repartidores,
      • Máximo de entregas por batche.
    • Montos:
      • Envío 1
      • Envío 2
      • Bono lluvia
      • Bono Incentivo
• Envíos:
  • Sección de envíos con:
    • Seguimiento en tiempo real del estado de los envíos.
    • Filtros por fecha y estado.
• Reportes:
  • Sección de reportes:
    • Top 10 vendedores con más envíos.
    • Horarios de mayor flujo por vendedor.
    • Tiempo promedio de entrega.
    • Índice de entregas exitosas vs. fallidas.
    • Zonas con mayor volumen de pedidos.
    • Cantidad de incidentes reportados.
  • Reporte diario por mail incluyendo:
    • Estado de cada envío por vendedor y repartidor.
    • Balance diario de vendedores y repartidores.
• Balances:
  • Sección balances:
    • Vendedores con filtros por fecha y vendedor.
      • Ingresos por mes mensuales por Q y por año completo.
      • Porcentaje Ingreso Top 20
      • Historial de pagos con pruebas.
    • Repartidores con filtros por fecha y repartidor.
    • Historial de pagos con pruebas.
• Soporte:

2.5.2 Funcionalidades para Repartidores

• Ver rutas y detalles de entrega.
• Marcar entregas como completa/Incompleta.
• Indicar inicio y fin de entregas.
• Aportar pruebas de entrega (fotos, capturas de pantalla).
• Reportar incidentes.

Posibles casos