FleteChat v1.0 — Resumen Ejecutivo¶

Contexto del negocio¶

FleteChat es el nombre comercial del servicio de logística internacional operado por Zeverium Group, S.A. (razón social panameña), que contrató a Kaeus para construir una plataforma conversacional que atienda a sus clientes por WhatsApp. El objetivo es convertir la experiencia de cotización, aprobación y seguimiento de embarques —tradicionalmente hecha por correo y teléfono con alto costo operativo y fricción para el cliente— en un flujo conversacional atendido por un agente inteligente que consulta en tiempo real los catálogos, precios y estatus del sistema.

El proyecto se enmarca en el Statement of Work v1.2 firmado por ambas partes y desarrolla el producto como versión 1.0 del sistema. Esta versión cubre el ciclo completo del embarque —desde el primer contacto del cliente hasta la entrega— más la administración del negocio y el cumplimiento legal aplicable en la jurisdicción panameña.

Qué hace FleteChat v1.0¶

Para el cliente final, FleteChat ofrece por WhatsApp:

• Registro guiado por el agente con consentimiento informado al primer contacto.
• Cotización en lenguaje natural con precio desglosado, vigencia y tiempo de tránsito estimado.
• Aprobación formal en tres pasos sobre dos canales (WhatsApp + correo verificado).
• Recepción automática de instructivos operativos al aprobar.
• Seguimiento conversacional del estatus del embarque.
• Atención humana a demanda mediante handoff con consentimiento explícito.
• Reportes consultables por filtros en lenguaje natural o vista web tokenizada.
• Ejercicio de los derechos del titular según Ley 81 de Panamá (acceso, portabilidad, rectificación, eliminación, oposición).
• Control sobre las comunicaciones proactivas (opt-out granular) y respeto al horario razonable.

Para el equipo operativo de FleteChat, un backoffice web con:

• Gestión de clientes y usuarios del sistema con tres roles diferenciados (admin, operator, price_manager).
• Catálogos de niveles corporativos, servicios logísticos, modalidades, Incoterms y tipos de operación.
• Gestión manual e import masivo de listas de precios desde Excel con preview y transaccionalidad.
• Atención en tiempo real de handoffs con chat integrado al historial conversacional.
• Vista de seguimiento de embarques, alertas de vencimiento corporativo y audit log filtrable.
• Parámetros globales configurables y matriz de eventos auditables.

Componentes arquitecturales destacables (alcance técnico):

• Agente conversacional sobre Pydantic AI + Anthropic, integrado a WhatsApp Cloud API.
• Cotizador y ensamblador de embarques expuestos vía MCP para uso por el agente.
• Formularios públicos tokenizados para datos operativos, aprobación formal y descarga de paquete Ley 81.
• Generación branded de PDF para tres instructivos (proveedor, operador logístico, personal interno).
• Chat en tiempo real por WebSockets para handoff.
• Audit log inmutable con anonimización controlada ante eliminación de datos.

Alcance comprometido¶

El proyecto entrega:

Quedan fuera del alcance de v1.0 según lo acordado con el cliente: machine learning para sugerencias, UI de gestión para la carga inicial de datos, exportación a Excel en reportes, actualización automática de precios, actualización automática externa del estatus de embarques, transferencia automática al agente humano sin consentimiento.

Lo que quedó en discusión¶

Al cierre de Fase 1 del análisis, queda una decisión abierta del cliente que es condición previa para cerrar formalmente la fase:

1. Estructura operativa: cinco roles (admin, operator, price manager, moderador del agente, responsable de integración WhatsApp) con cantidad de personas, perfil requerido, horarios de cobertura y backups.

La razón social del operador (PC-01) ya fue confirmada como Zeverium Group, S.A. y queda incorporada a los materiales legales (política de privacidad, contratos, facturación, registro ANTAI, pie legal de correos).

El ítem abierto se detalla en docs/tracker/analysis/v1.0-preguntas-pendientes-cliente.md y en el Excel de seguimiento v1.0-pendientes-cliente-seguimiento.xlsx (54 ítems categorizados) que acompaña este FRD. Los pendientes cubren también obligaciones que no son decisiones de Kaeus: cuenta Meta Business verificada, cuenta Anthropic, cuenta Azure, proveedor de correo, dominio, certificado SSL, branding, configuración inicial del negocio (catálogos y listas de precios), aprobación de plantillas Meta, designación del Responsable de Protección de Datos y política de privacidad redactada.

Responsables¶

• Por Kaeus: Sebastián García (dirección del proyecto y entrega) más el equipo de desarrollo asignado.
• Por FleteChat: admin principal y backup (a definir), operadores logísticos (a definir), price manager y backup (a definir), moderador del agente (a definir), responsable de integración WhatsApp (a definir), Responsable de Protección de Datos (a designar).

Próximos pasos¶

1. Validación y firma del presente análisis funcional por FleteChat.
2. Resolución del pendiente abierto (estructura operativa).
3. Construcción del Documento de Requerimientos Funcionales (FRD) consolidado como entregable posterior a la firma.
4. Inicio de Ciclo 1 de desarrollo en paralelo con el trabajo del cliente sobre los ítems del Excel de pendientes.
5. Demos semanales con el cliente durante Ciclo 1 para validar el comportamiento del agente conversacional.

Documentos que acompañan a este resumen¶

Publicados en el portal:

• Las 63 historias de usuario refinadas, accesibles desde la sección "Historias por epic" del panel lateral.
• Reglas de negocio.
• Requerimientos funcionales.
• Requerimientos no funcionales.
• Glosario.
• Stakeholders y roles.
• Riesgos.
• Plan UAT.
• Preguntas pendientes al cliente.
• Excel de seguimiento de pendientes.
• Hoja de firma.

Documentos internos de Kaeus no incluidos en el portal (disponibles bajo pedido):

• Habilitadores técnicos (12 HTs + trazabilidad inversa + contrato mínimo del cotizador) — documento de arquitectura del equipo de desarrollo.
• Tracker de estado de las historias por epic.
• Pendientes de Fase 2 (purga automática, seguridad del tratamiento, transferencias internacionales).
• Registro de la revisión exhaustiva.

Control de versiones¶