ECHO — Documentación interna

Appearance

Pendientes / preguntas para el equipo ​

Lista accionable de preguntas que surgieron al leer el PR/FAQ y conviene resolver antes (o muy temprano durante) la construcción. Ordenadas por prioridad de bloqueo: las primeras invalidan o reescriben este repo si la respuesta es distinta a lo asumido.

Bloqueadores (frontera con Nilo) ​

1. Confirmar el modelo de colaboración con Nilo. ⚠️ Crítico

  • ¿Es estrictamente "Nilo consume nuestras APIs" o también construyen parte del backend?
  • Toda esta documentación está escrita bajo la premisa "ellos = agente, nosotros = APIs/integración". Si la frontera cae en otro lado, hay que reescribir.

2. ¿Existe ya un contrato de APIs / OpenAPI spec que Nilo espera?

  • Si no, ¿quién redacta el primer borrador? Propuesta: nosotros, basados en 03-apis-e-integracion.md.
  • ¿Hay sandbox de Nilo donde podamos probar el flujo end-to-end?

3. Autenticación entre Nilo y nosotros.

  • ¿mTLS, OAuth 2.0 client credentials, API keys con rotación, o combinación?
  • ¿Rotación periódica obligatoria?
  • ¿Cómo se gestiona en GCP Secret Manager (consistente con 02-arquitectura.md)?

4. ¿Nilo entrega también la PWA B2B "light"?

  • El PR/FAQ menciona "WhatsApp & 'Light' B2B Ejemplo: Nilo Commerce" como la suite.
  • Si nosotros la construimos, sube significativamente la carga del equipo y cambia el stack (probablemente Quasar, React o Next.js).

5. Modelo de eventos: ¿push o pull entre Nilo y nosotros?

  • ¿Nilo publica webhooks que nosotros consumimos (cierre de carrito, identificación de cliente)? En el de identificación: ¿el payload incluye BSUID además de teléfono? (BSUID es el identificador estable post-jun 2026 — ver 04-cumplimiento.md).
  • ¿Nosotros publicamos webhooks a Nilo (cambio de estatus de entrega)?
  • ¿O todo se hace request/response?

Arquitectura interna ​

6. Application Integration (GCP) vs SAP BTP Integration Suite.

  • El onboarding habló de Application Integration en GCP. El PR/FAQ exige BTP iPaaS para SAP.
  • Necesitamos un diagrama oficial que muestre quién orquesta qué:
    • Hipótesis A: BTP solo para el último hop a SAP; Application Integration orquesta todo lo demás.
    • Hipótesis B: BTP es el orquestador maestro; Application Integration solo para tareas locales GCP.
  • Esta decisión afecta latencia, costos y owner de cada iFlow.

7. División GitLab vs GitHub.

  • ¿Qué vive en cada uno? ¿Por convención de equipo o de tecnología?
  • ¿En cuál de los dos está pensado vivir el repo del backend/integración?
  • ¿CI/CD existe ya como template?

8. ¿Existe ya una app móvil en Distribución / GTM/App? (pregunta abierta del propio PR/FAQ §4.2 en EPIC 03)

  • Si ya hay app de asesor / app del repartidor, no la duplicamos.
  • ¿Está integrada con DispatchTrack o cargaríamos esa integración nosotros?

9. Decisión técnica sobre el motor de recomendación (HU-09).

  • ¿Lo aloja Nilo, o nosotros lo construimos con Vertex AI / BigQuery sobre historial SAP?
  • Implica un volumen de trabajo muy distinto.

Seguridad y compliance ​

10. Estrategia anti SIM Swapping en HU-08.

  • ¿2FA por monto, biometría (si hay PWA), reto out-of-band, detección por API del operador (Twilio Verify / Telesign)?
  • ¿Reemplazo de OTP por WhatsApp para usuarios sin teléfono visible (username adoptado)? Las plantillas de autenticación de WhatsApp requieren teléfono; árbol de decisión en 04-cumplimiento.md.
  • ¿Quién hace la auditoría de ciberseguridad mencionada en el PR/FAQ? ¿Equipo interno o consultora externa?
  • ¿Es gate de despliegue?

11. Validación de límite de crédito en tiempo real.

  • ¿Llamada síncrona a SAP cada POST /v1/orders (más exacto, más lento)?
  • ¿Caché con TTL corto + invalidación por evento (más rápido, riesgo de overbooking de crédito)?
  • ¿Qué nivel de overbooking acepta Finanzas?

12. Testing de IA: 0% alucinaciones en HU-10.

  • Nilo opera el RAG, nosotros servimos la base de conocimiento. ¿De quién es la responsabilidad de medir la métrica?
  • ¿Cómo se hace evaluación automatizada de alucinaciones? ¿Dataset de regresión compartido entre Nilo y nosotros?
  • ¿Quién aprueba cambios a la base de conocimiento?

13. Migración de la lógica de precios VB6.

  • ¿Quién audita el código VB6 actual?
  • ¿Quién lo traduce al motor de Nilo / SAP MDM?
  • ¿Qué timeline tiene? Es Hito 3 (Fix the Basics).
  • ¿Pruebas de regresión: SKU × Tier comparando salida VB6 vs MDM?

Producto / negocio que condiciona el diseño ​

14. Offline mode (zonas con baja señal — Texcoco).

  • ¿Es responsabilidad del cliente (WhatsApp ya tiene offline) o de un componente nuestro?
  • Para el asesor: ¿Nilo lo cubre, o nosotros construimos algo del lado PWA / app móvil?

15. Modelo de facturas globales — cadencia y formato.

  • ¿Diaria, quincenal, o ambas configurables por ruta?
  • ¿Formato del reporte para Finanzas?
  • ¿Quién valida que el SAT acepte la consolidación que generamos?

16. Marcado del canal de venta para comisiones híbridas.

  • El PR/FAQ define dos comisiones distintas: "Venta Directa" (asesor visita física) vs "Venta Digital ECHO" (cliente autoservicio en WhatsApp), con porcentaje mayor para la segunda.
  • ¿Cómo diferenciamos en SAP SD una orden creada vía Nilo de una orden tradicional? ¿Campo custom en POST /v1/orders (p.ej. sales_channel: "ECHO" | "VAB_DIRECT"), Sales Organization distinta, o code de orden tipo "Z*"?
  • ¿Nosotros exponemos un endpoint para que RH/Comisiones lea ventas atribuidas, o lo lee directo de SAP por el código de canal?
  • Definición temprana: si no, RH no puede calcular las comisiones híbridas al cierre del primer mes.

17. Motor de Promociones — quién ejecuta las 20+ dinámicas.

  • El PR/FAQ menciona soporte para >20 dinámicas (descuentos escalonados, bonificaciones, combos).
  • ¿Las calcula Nilo Commerce con motor propio, SAP MDM nativamente vía BAPI, o nosotros como capa intermedia?
  • Si Nilo calcula combos/bonificaciones, ¿cómo inyectamos el descuento en SAP SD sin romper ALCOA Exacto y el cuadre contable? (¿condiciones de precio Z* en el iFlow?)
  • Pruebas de regresión: comparar precio Nilo vs precio cobrado en SAP, no solo VB6 vs MDM.

18. BNPL — proveedor financiero y dueño de la integración.

  • ¿Quién es el partner? (Kueski, Mercado Crédito, Aplazo, banco propio…)
  • ¿La integración financiera la hace Nilo desde su plataforma o nosotros desde GCP?
  • Endpoint propuesto POST /v1/credit/apply (ya listado en 03-apis-e-integracion.md): definir si encapsula al partner o si Nilo llama directo y solo nos avisa el resultado.
  • Implicación regulatoria: ¿BNPL es producto crediticio regulado por CNBV? ¿necesitamos KYC adicional al RFC?

19. Tickets de soporte — sistema destino.

  • HU del asistente experto incluye "creación de tickets de soporte directamente en WhatsApp".
  • ¿Hacia qué herramienta viajan? (Zendesk, Salesforce Service Cloud, ServiceNow, SAP CS, otro)
  • ¿Construimos endpoint POST /v1/support/tickets en nuestra capa, o Nilo provee su propio back-office?
  • ¿SLA del ticket es responsabilidad nuestra o del owner del ITSM?

20. Lealtad y gamificación — dónde viven puntos, badges y leaderboards.

  • PR/FAQ describe Leaderboards en tiempo real, Badges y Quests (modelo Skinner) para asesores, + acumulación/redención de puntos para clientes digitales.
  • ¿Existe ya un motor de lealtad en Rotoplas? ¿O lo construimos sobre Vertex AI / BigQuery leyendo ventas SAP?
  • Si Nilo calcula puntos, ¿necesita un endpoint nuestro GET /v1/sales/by-customer?since=… que devuelva el ledger?
  • Leaderboards en tiempo real → ¿streaming desde SAP o snapshot diario? Afecta arquitectura.

21. Cut-off times — dónde viven los horarios de corte logístico.

  • PR/FAQ exige recordatorios basados en cut-off ("pídelo antes de las 14:00 para entrega hoy").
  • ¿Los horarios viven en SAP SD (por ruta/almacén) o en DispatchTrack?
  • ¿Necesitamos endpoint GET /v1/logistics/cutoffs?route={id} para que Nilo lea y programe recordatorios?
  • ¿Quién es la fuente de verdad si hay discrepancia entre SAP y 3PL?

Equipo y operación ​

22. Reparto de trabajo en el equipo.

  • Con Montserrat (Xideral) cubriendo "Desarrollo End-to-End, Integración UI/UX, APIs y BD":
    • ¿Quién hace SAP/BTP iFlows? ¿Hay equipo SAP separado?
    • ¿Quién hace la integración 3PL (DispatchTrack)?
    • ¿Quién hace la capa de APIs frente a Nilo?
    • ¿Quién hace observabilidad/infra?
  • Yo (Luis Josafat) soy responsable interno; Adrián Monroy es el manager. ¿Hay tech lead asignado?

23. War Room — herramientas y on-call.

  • SLA de respuesta <15 min: ¿quién está de guardia los primeros 90 días?
  • ¿Existe ya el canal de Slack / Teams del proyecto?
  • ¿Hay runbooks heredados de otros proyectos eCommerce?

24. Entornos.

  • ¿Hay sandbox de SAP / BTP / DispatchTrack / Nilo disponible desde día 1?
  • ¿Cuántos entornos (dev/staging/prod)? ¿Datos sintéticos o mascarados?

Cómo usar esta lista ​

Llevar esto a la próxima reunión del Core Team (o al primer touchpoint con Nilo). Marcar cada pendiente con:

  • ✅ Resuelto + link a doc/decisión.
  • 🔄 En discusión + dueño.
  • ❌ Bloqueado + razón.

Conforme se resuelvan, mover la información relevante a los documentos correspondientes (02-arquitectura.md, 03-apis-e-integracion.md, etc.) y eliminar de aquí.