Contexto del proyecto

Si solo lees un documento de este repo, lee este. Aquí está el "por qué" y dónde encajamos.

El problema

La unidad de negocio Venta a Bordo (VaB) de Rotoplas está en caída libre y representa un riesgo de supervivencia para el canal:

Indicador	Hoy	Meta 2026
Volumen de ventas VaB	-38% vs. base	Detener caída y revertir
EBITDA del canal	15%	30%
Adopción digital	<2%	20% (cierre 2026)
Ticket promedio	$6,000 MXN	$12,000 MXN

La causa raíz no es falta de demanda. El modelo operativo está obsoleto: el asesor comercial cumple la "Triple Función" (conducir + cobrar + entregar) y dedica solo el 30% de su tiempo a la actividad que genera valor real (venta estratégica). El cliente, mientras tanto, depende de la frecuencia incierta del camión y del inventario limitado que pueda cargar.

El cliente

El usuario final del agente Nilo es el dueño de un micronegocio informal (típicamente una ferretería pequeña):

• 53% son clientes no fiscales (sin RFC propio) — el cumplimiento mexicano es nativo, no caso borde.
• Smartphones de gama baja, sin computadora de escritorio.
• WhatsApp es su sistema operativo cotidiano (tasa de apertura ~98% vs. 18% del correo).
• Ruta piloto: Texcoco. Siguiente: Chalco.

La visión: ECHO

ECHO (Ecosystem for Commercial Hybrid Operations) separa la generación de la demanda del cumplimiento logístico:

• La demanda entra por canales de baja fricción: WhatsApp + agente IA conversacional (operado por Nilo) y opcionalmente una PWA B2B "light".
• El cumplimiento se delega a operadores logísticos 3PL (DispatchTrack) o flota interna.
• El asesor comercial deja de ser transportista/cobrador y pasa a ser Asesor-Desarrollador del cliente.
• Los datos viajan bajo el estándar ALCOA+ (atribuibles, exactos, contemporáneos, trazables).

Dónde encajamos nosotros como dev

Hipótesis principal del documento (a confirmar con el equipo — ver 06-pendientes.md #1): Nilo Commerce construye el agente conversacional y la capa WhatsApp/PWA. Nosotros construimos las APIs e integración que Nilo consume.

Sí construimos

• APIs HTTP que Nilo invoca: catálogo, precios por graduación, validación de crédito, creación de orden, estatus de pedido, recomendaciones, base de conocimiento de productos.
• Integración con SAP vía BTP Integration Suite (iPaaS): inyección de órdenes a SD, lectura de MDM, validación de crédito y stock.
• Gestión fiscal mexicana: creación automática de Business Partner con RFC genérico, facturas globales consolidadas.
• Orquestación 3PL: emisión de IDoc SHPORD a DispatchTrack, recepción del webhook POD, ejecución de PGI en SAP.
• Audit trail ALCOA+: timestamps server-side, GPS, evidencia inmutable.
• Infra GCP: Cloud Functions (webhooks), Cloud Run/containers (servicios de dominio), Buckets (POD, evidencias), Application Integration (orquestación interna).

NO construimos (responsabilidad de Nilo)

• Agente conversacional WhatsApp (NLP, voz, vision).
• Integración con WhatsApp Business Cloud API y WhatsApp Flows.
• PWA B2B "light" (presumiblemente — confirmar).
• Motor de fine-tuning de la IA.

Métricas SMART que nos pertenecen

Estas son nuestras y deben ser medibles desde el primer despliegue:

KPI	Meta	Dueño técnico
Latencia POST /orders → SAP	<60 s (P95)	Capa de integración SAP
OTIF (entregas a tiempo y completas)	98%	Orquestador 3PL
Discrepancias de precio entre oferta y cargo	0%	Servicio de pricing
Alucinaciones en asistente experto	0% (en HU-10)	Base de conocimiento que servimos
Retención de audit trail	5 años	Bucket inmutable + SAP
Tiempo de respuesta del War Room a fallas	<15 min	Operación + observabilidad

Roadmap visible (alto nivel)

Fase	Hito	Foco para dev
1. Fix the Basics	War Room, Data Sanity, Auditoría VB6	Limpiar maestros SAP, validar geocercas Texcoco, migrar lógica de precios VB6 al motor Nilo.
2. MVP Texcoco	3 asesores, 3PL integrado, adopción 10% al mes 3	APIs vivas, iFlow SAP <60 s, POD funcionando.
3. Escalamiento	Ruta Chalco, IA de sugerencia, comisiones híbridas	Más capacidad, recomendador, BNPL.

Para detalle de las HU técnicas y su mapeo a APIs e infra, ver 05-backlog.md.