US-024 — Historial de cambios de estatus

Detalle de la historia¶

Historia¶

Como cliente de FleteChat con un embarque en curso o cerrado, quiero poder ver el historial completo de cambios de estatus, para entender la trazabilidad de mi carga y tener evidencia de cada paso.

Persona de usuario¶

Aplica a todo cliente verificado (consulta desde WhatsApp) y a los operadores de FleteChat con rol admin u operator (consulta desde el backoffice). El cliente ve sólo el flujo público del estatus; el operador además ve comentarios internos y autor del cambio.

Contexto de negocio¶

El estatus actual resuelve la pregunta "¿cómo va hoy?", pero en una operación logística el cliente también necesita a menudo la foto completa: cuándo salió de origen, cuándo pasó aduana, cuándo cambió de medio, cuándo llegó. Sin historial, cada cambio vive sólo en la notificación que se envió en su momento —y que probablemente ya no se encuentra fácilmente en la conversación.

FleteChat guarda la cronología completa y la expone por dos canales: el cliente la consulta por WhatsApp en texto ("dame el historial de E42"); el operador la consulta desde la ficha del embarque en el backoffice con más información (comentarios, autor) para gestión y auditoría.

Diálogo de referencia¶

Cliente pide el historial por WhatsApp¶

Cliente: Dame el historial de E42.

Agente: Historial de E42 (Bogotá → Miami, LCL DDP):

1. Emitido — 10/04 11:20
2. Documentación en revisión — 11/04 08:05
3. Retiro de carga en origen — 13/04 15:40
4. En tránsito marítimo — 17/04 09:40 (actual)

Le aviso automáticamente cuando pase al siguiente estatus.

Criterios de aceptación¶

Respuesta por WhatsApp al cliente¶

1. FleteChat entrega al cliente, en respuesta a una petición explícita o implícita de historial, una lista cronológica de los cambios de estatus del embarque, con estatus y fecha/hora de cada cambio.
2. La lista se muestra ordenada del más antiguo al más reciente, con el estatus actual destacado.
3. El historial entregado al cliente no incluye comentarios internos ni identidad del operador que hizo cada cambio; expone sólo el flujo operativo.
4. El historial se puede pedir antes o después del cierre del embarque (entregado o cancelado); en embarques cerrados, la entrada final incluye la fecha de cierre.

Vista de backoffice al operador¶

1. El backoffice muestra, en la ficha de cada embarque, una tabla de historial con las mismas entradas que ve el cliente más: comentarios internos asociados al cambio (cuando el operador los agregó al actualizar, ver historia de actualización manual de estatus) y autor de cada cambio (agente automático o usuario con identidad).
2. La tabla es ordenable por fecha y se puede exportar a CSV desde la ficha.

Aislamiento y coherencia¶

1. El historial se resuelve dentro del alcance de la cuenta del cliente que consulta y respeta la visibilidad del contacto (titular vs colaborador; ver historia de titular y colaboradores).
2. La lista es idéntica en contenido en ambos canales (WhatsApp y backoffice) salvo por los comentarios internos y el autor, que sólo aparecen en el backoffice.

Edge cases¶

• Embarque sin cambios adicionales después del estado inicial. El historial contiene sólo la entrada de emisión; FleteChat lo muestra sin añadir estimaciones.
• Cliente pide historial de un embarque cerrado hace meses. FleteChat lo entrega completo; el cierre es la última entrada.
• Cliente corporativo pide historiales de varios embarques a la vez ("mandame el historial de E28, E42 y E51"). FleteChat los responde en bloque por WhatsApp, con un separador entre cada embarque; si el volumen es grande, ofrece un enlace a la vista web (ver historia de reportes y enlace web detallado).

Tamaño, prioridad y tipo¶

• Tamaño: S
• Prioridad: P0 — completa la experiencia de seguimiento con trazabilidad que el cliente espera.
• 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-108 — Separación de vistas cliente y operador. El historial visto por el cliente expone sólo el flujo operativo (estatus + fecha). La vista del operador extiende esa información con comentarios internos y autor del cambio. Ambas vistas comparten las mismas entradas y fechas.
• PR-109 — Ordenamiento cronológico ascendente. El historial se presenta ordenado del más antiguo al más reciente, con el estatus actual destacado. Este orden es el mismo en WhatsApp y en backoffice.
• PR-110 — Histórico accesible tras el cierre. El historial queda disponible indefinidamente después del cierre del embarque (entregado o cancelado) para consulta y auditoría.

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-108 a PR-110 confirmadas por el cliente
• ⬜ Reglas de negocio aplicables aprobadas
• ⬜ Requerimientos funcionales aplicables aprobados
• ⬜ Historia aprobada formalmente por el cliente