US-032 — Reportes estructurados de embarques

Detalle de la historia¶

Historia¶

Como operador de FleteChat que analiza la operación, quiero ver reportes de embarques agrupados por cliente, por origen, por destino o por modalidad, para entender la operación desde distintas perspectivas y tomar decisiones comerciales informadas.

Persona de usuario¶

Aplica a los operadores de FleteChat con rol admin u operator. El rol price_manager no tiene acceso a estos reportes.

Contexto de negocio¶

Los operadores necesitan ver la operación agregada, no embarque por embarque. Preguntas típicas: "¿qué clientes concentran más embarques?", "¿qué rutas crecieron mes a mes?", "¿qué modalidad domina por tipo de cliente?". Cada pregunta tiene una dimensión de agrupación distinta y un conjunto de filtros propio.

En v1.0 FleteChat ofrece cuatro vistas estructuradas —una por cada dimensión de agrupación natural (cliente, origen, destino, modalidad)—, con filtros combinables para acotar el universo analizado. Las vistas son consultables en el backoffice y exportables a CSV para análisis externo.

Criterios de aceptación¶

Vistas disponibles¶

1. El backoffice ofrece cuatro vistas separadas, accesibles desde el menú de reportes: a. Por cliente: agrupa embarques por cliente (titular de la cuenta). b. Por origen: agrupa por ciudad / puerto de origen. c. Por destino: agrupa por ciudad / puerto de destino. d. Por modalidad: agrupa por modalidad (aéreo, LCL, FCL-20', FCL-40', etc.).
2. Cada vista muestra, por cada grupo: identificador del grupo, cantidad de embarques, total facturado, embarque más reciente y estatus más frecuente entre los embarques del grupo.

Filtros y comportamiento¶

1. Cada vista acepta filtros combinables: rango de fechas, modalidad (cuando no es la dimensión de agrupación), estatus, cliente (cuando no es la dimensión), origen y destino (idem).
2. Los filtros son AND por defecto, editables en línea. Cambiar un filtro re-consulta la vista.
3. La tabla es paginada y ordenable por cualquiera de las columnas numéricas y por identificador del grupo.
4. Desde cada fila del grupo, el operador puede hacer drill-down a una vista de embarques individuales que cumplen el filtro de la fila.

Acceso y export¶

1. Los reportes son accesibles únicamente a admin y operator. El rol price_manager recibe 403.
2. Cada vista exporta a CSV con los filtros aplicados; la exportación respeta el agrupamiento. El drill-down también exporta a CSV.
3. Cada generación y export queda registrado en el audit log.

Coherencia con otras vistas¶

1. Los mismos datos consultados en las cuatro vistas estructuradas y en la consulta conversacional de reportes (ver historia correspondiente) son coherentes entre sí: el conteo total para un mismo filtro es idéntico en todas las vistas.

Edge cases¶

• Volumen alto en una vista específica (por ejemplo, cientos de clientes con operaciones). La tabla pagina; el drill-down y el export funcionan sobre el conjunto filtrado completo.
• Cliente eliminado que aparece en la vista "por cliente". Se muestra como "cliente eliminado" con el identificador interno para trazabilidad, sin exponer datos personales.
• Nueva modalidad agregada al catálogo. Aparece automáticamente en la vista "por modalidad" una vez hay al menos un embarque con esa modalidad.
• Operador aplica filtros que dejan la vista vacía. La vista muestra estado vacío con mensaje y sugiere relajar filtros.

Tamaño, prioridad y tipo¶

• Tamaño: M
• Prioridad: P1 — herramienta analítica base del backoffice.
• Tipo: feature

Premisas¶

La historia está redactada bajo las siguientes premisas. Si alguna cambia, la historia debe revisarse y ajustarse en consecuencia. Todas deben ser confirmadas por el cliente antes de cerrar la historia.

• PR-133 — Cuatro dimensiones de agrupación en v1.0. Las dimensiones soportadas en v1.0 son cliente, origen, destino y modalidad. Otras dimensiones (nivel corporativo, Incoterm, servicio) quedan para versiones posteriores.
• PR-134 — Drill-down al detalle del embarque. Cada fila de una vista agregada permite hacer drill-down a una tabla de embarques individuales que cumplen el filtro de la fila.
• PR-135 — Sin export a Excel en MVP. Igual que el resto de los reportes, la exportación es a CSV; otras opciones de export están fuera del alcance de v1.0.

Refinamiento y Definition of Ready¶

Notas¶

Checklist¶

• ✅ Historia escrita en formato Como / Quiero / Para
• ✅ Persona de usuario identificada
• ✅ Contexto de negocio documentado
• ✅ Criterios de aceptación observables y pass/fail
• ✅ Edge cases relevantes listados
• ✅ Tamaño y prioridad asignados
• ⬜ Premisas PR-133 a PR-135 confirmadas por el cliente
• ⬜ Reglas de negocio aplicables aprobadas
• ⬜ Requerimientos funcionales aplicables aprobados
• ⬜ Historia aprobada formalmente por el cliente