Análisis funcional — ArcorTruck BackOffice Web (v2)
Fuente: Manual de usuario ArcorTruck BackOffice web, versión 2 (Emser Empresa de Servicios S.A.).
Objetivo: Especificar los casos de uso para una reimplementación del producto con stack moderno, rendimiento elevado y experiencia de usuario alineada a Material Design.
1. Contexto y actores
| Actor |
Descripción |
| Usuario del distribuidor |
Operador del backoffice de la distribuidora Arcor; gestiona reparto, reportes, tableros y mapas. |
| Personal técnico / EMSER |
Puede acceder a configuración sensible del sistema y base de datos externa. |
| Sistema externo (América / ERP) |
Origen de datos maestros; cambios pueden requerir “preparación de datos de proceso único diario”. |
| Repartidores (móvil) |
Consumen datos generados desde “Administración móvil”; no son usuarios directos de este backoffice pero son el destino operativo. |
Supuestos derivados del manual: cada distribuidora tiene URL dedicada (http://{identificador}.arcordis.com.ar:13550/... en el ejemplo). La aplicación depende de una base de datos externa y de integración con mapas (Google Maps API key).
2. Glosario breve
- Hoja de reparto: agrupación lógica de visitas/reparto (numerada).
- Repartidor: persona que ejecuta entregas/cobranzas en ruta.
- Actividad: tipo de operación en ruta (p. ej. entrega, cobranza; el manual menciona filtros “Todas las actividades”, “Entrega, Cobranzas”, etc.).
- Canal: dimensión de segmentación en reporte estadístico de entrega.
- Preparar datos: generación de paquetes de carga para equipos móviles de repartidores.
3. Casos de uso (detalle)
UC-01 — Iniciar sesión de trabajo
| Campo |
Detalle |
| Actores |
Usuario del distribuidor |
| Disparador |
Acceso a la URL del backoffice |
| Precondiciones |
Usuario dado de alta; credenciales válidas |
| Flujo principal |
1. El sistema muestra formulario de acceso. 2. El usuario ingresa Usuario. 3. Navega con TAB al campo Clave e ingresa la contraseña. 4. Confirma el ingreso (botón de login). 5. El sistema valida credenciales y muestra la pantalla principal. |
| Flujos alternos |
Credenciales inválidas: el sistema debe informar error sin revelar si falló usuario o clave (recomendación de seguridad para la nueva versión). |
| Postcondiciones |
Sesión autenticada; menú lateral y panel central disponibles según permisos. |
| Reglas de negocio |
URL por distribuidora; posible multi-tenant por subdominio o path. |
| Datos |
Usuario (texto), clave (secreto). |
UC-02 — Cerrar sesión de trabajo (Logout)
| Campo |
Detalle |
| Actores |
Usuario autenticado |
| Disparador |
Clic en control de cierre (manual: parte superior izquierda de la pantalla principal) |
| Precondiciones |
Sesión activa |
| Flujo principal |
1. Usuario activa cierre de sesión. 2. El sistema invalida la sesión y redirige al login. |
| Postcondiciones |
No queda acceso a datos protegidos sin reautenticación. |
UC-03 — Navegar pantalla principal (home / dashboard de accesos)
| Campo |
Detalle |
| Actores |
Usuario autenticado |
| Disparador |
Tras login exitoso o navegación al inicio |
| Precondiciones |
Sesión válida |
| Flujo principal |
1. El sistema muestra menú lateral con secciones: Reparto, Administración móvil, Reportes, Tableros, Mapas, Configuración general. 2. Muestra panel central con accesos directos a: Resumen de cobranza por hoja de reparto; Reporte de entrega; Reporte de cobranza; Reporte desempeño; Reporte estadístico de entrega; Reporte devolución. |
| Reglas de negocio |
Las entradas del panel deben reflejar las mismas capacidades que el menú (atajos). En la nueva versión se puede enriquecer con permisos por rol. |
UC-04 — Administración móvil: preparar datos (todos los repartidores)
| Campo |
Detalle |
| Actores |
Usuario operativo del distribuidor |
| Disparador |
Menú Administración móvil → Preparar datos → acción Generar todos |
| Precondiciones |
Datos maestros y operativos consistentes en servidor |
| Flujo principal |
1. Usuario selecciona “Generar todos”. 2. El sistema dispara job de generación de datos de carga para todos los repartidores. 3. El sistema informa resultado (éxito/parcial/error — a explicitar en UX). |
| Postcondiciones |
Paquetes de carga actualizados para móviles (según diseño actual de sincronización). |
| Reglas de negocio |
Operación potencialmente pesada: debe ser asíncrona, con progreso y trazabilidad en la reimplementación. |
UC-05 — Administración móvil: preparar datos (un repartidor)
| Campo |
Detalle |
| Actores |
Usuario operativo |
| Disparador |
Preparar datos → Generar un repartidor |
| Precondiciones |
Lista de repartidores disponible |
| Flujo principal |
1. Usuario selecciona repartidor en lista desplegable. 2. Ejecuta generación para ese repartidor. 3. Sistema procesa y confirma. |
| Postcondiciones |
Solo el repartidor seleccionado recibe actualización de carga. |
UC-06 — Administración móvil: preparación “proceso único diario”
| Campo |
Detalle |
| Actores |
Usuario operativo |
| Disparador |
Checkbox en la parte inferior de la pantalla de preparación de datos |
| Precondiciones |
Pantalla “Preparar datos” abierta |
| Flujo principal |
1. Usuario marca el check cuando hubo cambios en América que impactan datos móviles. 2. Ejecuta generación (todos o uno). 3. Sistema aplica lógica de “proceso único diario” para mantener equipos actualizados. |
| Reglas de negocio |
Debe documentarse en la nueva versión el significado exacto del flag (transacción única, invalidación de caché, versión de dataset, etc.) con el equipo funcional. |
UC-07 — Reporte de reparto por hoja
| Campo |
Detalle |
| Actores |
Usuario |
| Disparador |
Panel central o menú Reportes → Reporte de reparto por hoja |
| Precondiciones |
Sesión válida |
| Filtros |
Repartidor (defecto: TODOS); Hoja de reparto (defecto: indicación para seleccionar número); Tipo (defecto: TODAS LAS ACTIVIDADES); Desde / Hasta (defecto: fecha del día). |
| Flujo principal |
1. Usuario define filtros. 2. Genera reporte. 3. El sistema lista clientes/hojas con columnas incluyendo Código, Razón social, casilla de selección (box). 4. Ordenación por Código o Razón social (asc/desc) mediante control en encabezado. |
| Extensiones |
Exportar a Excel; obtener/vista de impresión según botones del manual (equivalente a imprimir/PDF en web moderna). |
| Postcondiciones |
Usuario dispone de vista tabular y exportación. |
UC-08 — Reporte de devoluciones por hoja
| Campo |
Detalle |
| Actores |
Usuario |
| Disparador |
Panel o Reportes → Reporte de devoluciones por hoja |
| Filtros |
Repartidor (TODOS); Hoja (seleccionar número); Tipo (defecto: POR COMPROBANTE); Desde/Hasta (día actual). |
| Flujo principal |
1. Aplicar filtros. 2. Generar. 3. Revisar resultados. 4. Imprimir y/o exportar a Excel. |
| Reglas |
Coherencia con comprobantes cuando el tipo es “por comprobante”. |
UC-09 — Reporte de cobranzas por hoja
| Campo |
Detalle |
| Actores |
Usuario |
| Disparador |
Panel o Reportes → De cobranzas por hoja |
| Filtros |
Repartidor (TODOS); Hoja; Tipo (defecto: POR COMPROBANTE); Desde/Hasta (día actual). |
| Flujo principal |
Igual patrón: filtros → generar → imprimir / Excel. |
UC-10 — Reporte de cobranza general
| Campo |
Detalle |
| Actores |
Usuario |
| Disparador |
Panel o Reportes → De cobranzas general |
| Filtros |
Repartidor (TODOS); Tipo (defecto: DETALLADO); Desde/Hasta (día actual). |
| Presentación |
Lista de clientes con selección, Código, Razón social; orden asc/desc por esos campos. |
| Extensiones |
Imprimir; exportar Excel. |
UC-11 — Reporte de desempeño
| Campo |
Detalle |
| Actores |
Usuario |
| Disparador |
Panel o Reportes → Reporte de desempeño |
| Filtros |
Repartidor (TODOS); Desde/Hasta (día actual). |
| Presentación |
Lista con selección, código, razón social; ordenación por código/razón social. |
| Extensiones |
Imprimir; Excel. |
| Reglas |
Métricas de desempeño deben definirse con negocio (KPIs: visitas, entregas, montos, tiempos, etc.). |
UC-12 — Reporte estadístico de entrega
| Campo |
Detalle |
| Actores |
Usuario |
| Disparador |
Panel o Reportes → Reporte estadístico de entrega |
| Filtros |
Repartidor (TODOS); Canal (Todos); Desde/Hasta (día actual). |
| Presentación |
Clientes de la distribuidora: selección, código, razón social; ordenación. |
| Extensiones |
Imprimir; Excel. |
| Reglas |
“Información de entrega durante la jornada” — agregar definición de agregaciones en backlog funcional. |
UC-13 — Tablero de avance de reparto
| Campo |
Detalle |
| Actores |
Usuario |
| Disparador |
Menú Tableros → Tablero de avance de reparto |
| Precondiciones |
Datos de jornada disponibles |
| Flujo principal |
1. Usuario utiliza opción de búsqueda (criterio no detallado en texto del PDF — asumir filtro por repartidor/texto). 2. El sistema muestra columnas: Transportista; % avance de visita; Cantidad de clientes visitados; Cantidad de clientes a visitar; Monto deuda de clientes; Monto cobrado en reparto; Monto entregado en cuenta corriente; Cantidad de repartos entregados; Cantidad de repartos rechazados. 3. Ordenación ascendente/descendente del tablero. |
| Postcondiciones |
Vista operativa para seguimiento intradía. |
UC-14 — Mapa de reparto (consulta y filtros)
| Campo |
Detalle |
| Actores |
Usuario |
| Disparador |
Menú Mapas → Mapa de reparto |
| Filtros |
1) Repartidor/es (defecto: TODOS). 2) Actividades (defecto: Entrega, Cobranzas). 3) Día (fecha actual). 4) Hoja (defecto: seleccionar número). 5) Incluir actividades sin GPS (checkbox, off por defecto). 6) Incluir clientes sin actividad (off). 7) Unir marcadores (off). 8) Incluir GPS maestro de clientes (off). 9) Mostrar nombres de clientes (off). |
| Flujo principal |
1. Usuario configura filtros. 2. Ejecuta generación/visualización del mapa. 3. El sistema pinta marcadores/rutas según reglas y leyenda. |
| Reglas de simbología (manual) |
Diferentes estados visuales para: entrega y cobranza; entrega sin cobrar; entrega o cobranza parcial (por repartidor). |
UC-15 — Mapa de reparto (detalle al seleccionar punto)
| Campo |
Detalle |
| Actores |
Usuario |
| Disparador |
Clic sobre marcador tipo Entrega |
| Flujo principal |
El sistema muestra panel/detalle con información asociada a esa entrega (el manual referencia capturas no reproducidas en texto). |
| Variantes |
Clic en Entrega sin cobrar → detalle específico. Clic en Entrega o cobranza parcial → detalle específico. |
| Postcondiciones |
Usuario audita caso puntual en mapa. |
UC-16 — Configuración del BackOffice (solo técnico / EMSER)
| Campo |
Detalle |
| Actores |
Personal técnico del distribuidor o EMSER |
| Disparador |
Configuración general → Configuración BackOffice |
| Precondiciones |
Permisos elevados |
| Datos — Configuración del sistema |
Título de la aplicación; dirección de la aplicación externa; logotipo de la empresa. |
| Datos — Base de datos externa |
Motor de BD; URL; nombre de BD; puerto; usuario; contraseña; coordenadas GPS de la distribuidora; API key de Google Maps. |
| Flujo principal |
1. Usuario autorizado edita parámetros. 2. Guarda. 3. Sistema valida conectividad (recomendado en nueva versión) y persiste de forma segura. |
| Reglas de seguridad |
Secretos (password BD, API keys) deben almacenarse cifrados, rotación, auditoría; nunca en cliente; configuración vía backend seguro. |
4. Matriz menú ↔ casos de uso
| Sección menú (manual v2) |
Casos de uso |
Ruta SPA |
| (Login) |
UC-01, UC-02 |
#/login |
| Pantalla principal |
UC-03 |
#/inicio |
| Reparto |
Resumen operativo |
#/reparto |
| ~~Administración móvil → Preparar datos~~ |
UC-04–06 (obsoleto: datos vía equipos móviles) |
— |
| Reportes → Reparto por hoja |
UC-07 |
#/reportes/reparto-por-hoja |
| Reportes → Devoluciones por hoja |
UC-08 |
#/reportes/devoluciones-por-hoja |
| Reportes → Cobranzas por hoja |
UC-09 |
#/reportes/cobranzas-por-hoja |
| Reportes → Cobranzas general |
UC-10 |
#/reportes/cobranzas-general |
| Reportes → Desempeño |
UC-11 |
#/reportes/desempeno |
| Reportes → Estadístico de entrega |
UC-12 |
#/reportes/estadistico-entrega |
| Tableros → Avance de reparto |
UC-13 |
#/tableros/avance-reparto |
| Mapas → Mapa de reparto |
UC-14, UC-15 |
#/mapas/reparto |
| Configuración general → BackOffice |
UC-16 |
#/configuracion/backoffice |
Atajos panel central (UC-03): resumen cobranza por hoja → cobranzas por hoja; reporte de entrega → reparto por hoja; reporte de cobranza → cobranzas general; desempeño; estadístico de entrega; devolución.
5. Requisitos no funcionales sugeridos (para la reimplementación)
- Rendimiento: generación de reportes y mapas con datasets grandes debe ser paginada en servidor y/o streaming; jobs de “preparar datos” asíncronos con cola.
- Usabilidad: Material Design 3, navegación coherente (navigation rail / drawer según breakpoint), tablas con ordenación y filtros persistentes en URL.
- Accesibilidad: WCAG 2.1 AA en componentes de tabla, formularios y mapas (alternativas a solo color en leyenda).
- Seguridad: OAuth2/OIDC o sesiones HTTP-only; RBAC; cifrado de secretos; auditoría de cambios de configuración.
- Observabilidad: trazas, métricas y logs estructurados en exportaciones y jobs críticos.
6. Estado de implementación (backoffice web actual)
| UC |
Estado |
Notas |
| UC-01 / UC-02 |
Implementado |
Login JWT, cierre de sesión |
| UC-03 |
Implementado |
Menú lateral y atajos del panel central según manual v2 |
| UC-04–06 |
No aplica |
Eliminado del backoffice: la carga la realizan los equipos móviles directamente |
| UC-07–12 |
Implementado |
Reportes con filtros, datos E_*, export CSV e impresión |
| UC-13 |
Implementado |
GET /api/boards/delivery-progress |
| UC-14–15 |
Implementado |
Mapa Leaflet + OpenStreetMap; detalle al clic en marcador |
| UC-16 |
Parcial |
Lectura I_CONFIGURACION / empresa; sin edición ni secretos en cliente |
| Sección Reparto (menú) |
Implementado |
Resumen operativo del día |
7. Brechas respecto al PDF (a validar con negocio)
- Texto del manual referencia botones e imágenes sin transcribir nombres exactos de acciones secundarias (“obtener reporte” vs “imprimir”).
- Detalle de popups del mapa (campos exactos) solo aparece en capturas: conviene workshop con usuarios clave para completar el modelo de datos de cada tooltip/panel.
- La sección “REPARTO” aparece en el menú lateral en la pantalla principal pero no está desarrollada en las páginas numeradas del índice del manual entregado: confirmar si hay módulos adicionales fuera de este PDF.
Documento generado a partir del manual funcional disponible en docs/manual/Manual_BackOffice Web_Truck_v2.pdf.