FT-IA-05 · Enriquecimiento continuo después de crear el SKU y después…

En 30 segundos

En Marketplace el SKU nace con lo mínimo para vender rápido, sobre todo en la carga masiva, y el contenido se completa después sin frenar la venta. Esta épica corre la IA una sola vez después de crear el SKU y otra después de publicar (con fuentes externas por marca y modelo), aplica sola lo de confianza alta, manda a Gobierno de Datos lo de confianza baja, marca el artículo como enriquecido y revisa la calidad con IA (QA con IA) antes de aprobar.

• Módulo dueño: MS-15 IA y enriquecimiento. También participan: MS-01 Catálogo, MS-02 Producto.
• Etapa 7 · Calidad y categoría. Recibe «PE-6 · SKU asignado», «PE-7 · Imágenes listas», «PE-9 · Publicado por canal» y entrega «PE-10 · Cambio aprobado».
• APIs: construye 2 y usa 9 que construyen otras épicas.
• Eventos: publica 3 y consume 4.

1. Dónde encaja

Recibe

Entrega

Cambios de estado que hace

Tareas que abre o cierra: QA con IA, Gobierno de Datos, QA manual.

2. Diagrama de contexto

Quién participa y cómo se conecta. Las pantallas llegan por el BFF del portal, que valida el token y compone; cada módulo vuelve a validar el token y decide sus permisos con los roles de MS-13.

🟩 Verde: nuevo, se construye · 🟦 Azul: ya existe y se queda, se reutiliza su código · 🟧 Naranja: temporal o se retira (se apaga en R3) · ⬜ Gris: sistema externo · ★ módulo dueño

3. Diagrama de flujo

El camino principal, paso por paso. Cuando una pantalla llama a un módulo se ven dos flechas: la pantalla al BFF y el BFF al módulo. Los eventos salen del outbox del módulo después de guardar; quien los consume ignora los repetidos.

3.1 Después de publicar: completar por marca y modelo

3.2 Confianza baja: revisa Gobierno de Datos

3.3 Fuentes, ventana y umbrales

4. Si algo sale mal

• El producto ya pasó por este disparo o está fuera de su ventana. MS-15 lo omite y lo dice en el trabajo (skipped); no se paga el modelo y el producto sigue su camino.
• Una fuente externa trae otra estructura u otras unidades. MS-15 lo lleva al atributo que ya existe y a sus unidades (pulgadas a centímetros); lo que no tiene atributo se queda en el trabajo de IA y no entra al producto.
• El modelo de QA con IA no responde. La tarea cae a QA manual con el motivo «sin dato» y nada se aprueba sin revisión (FT-RAC-03).
• El enriquecimiento posterior cambia un producto ya publicado. Sólo se aplican opcionales de confianza alta, nunca datos maestros de SAP; el producto vuelve a Aprobado, los canales pasan a Enviado y la tienda conserva lo publicado hasta el acuse.

5. APIs

Las que construye esta épica (2)

{
  "trigger": "SKU_ASSIGNED",
  "business": "MKP",
  "scope": "MISSING_ENRICHABLE",
  "items": [
    {
      "productId": "PRD-0004812",
      "version": 9
    },
    {
      "productId": "PRD-0004813",
      "version": 4
    }
  ]
}

{
  "success": true,
  "data": {
    "jobId": "job-0004100",
    "status": "ACCEPTED",
    "items": 2,
    "skipped": [],
    "links": {
      "self": "/api/v2/ai/jobs/job-0004100"
    }
  }
}

{
  "productId": "PRD-0004890",
  "version": 12,
  "business": "MKP",
  "purpose": "SCORE",
  "respond": "SYNC",
  "variantId": null,
  "checks": [
    "IMAGE_VS_TITLE",
    "IMAGE_VS_GENDER",
    "IMAGE_VS_SIZE",
    "COLOR_VS_IMAGE"
  ]
}

{
  "success": true,
  "data": {
    "jobId": "job-0004188",
    "status": "DONE",
    "confidence": 0.62,
    "acceptThreshold": 0.85,
    "passes": false,
    "findings": [
      {
        "check": "IMAGE_VS_TITLE",
        "attribute": "TITULO",
        "finding": "La imagen muestra una playera de niño y el título dice «hombre»",
        "confidence": 0.91,
        "suggestion": {
          "value": "Playera de algodón con estampado para niño"
        }
      },
      {
        "check": "IMAGE_VS_SIZE",
        "attribute": "TALLA",
        "finding": "La talla capturada es de adulto y las imágenes son de niño",
        "confidence": 0.84,
        "suggestion": {
          "value": "8"
        }
      }
    ],
    "route": {
      "suggested": "PROVEEDOR",
      "why": "Los datos del producto no coinciden con su imagen"
    }
  }
}

Las que usa y construye otra épica (9)

Su request y su response están en la página de la épica que la construye.

6. Eventos

Publica

Consume

7. Datos

Cada colección tiene un solo dueño, el único que escribe en ella.

8. Historias que cubre

9. Decisiones de esta épica

Las tomó el TL como arquitecto; quedan como [Propuesta] hasta que el equipo de la épica las revise.

• D-IA-05-1. MS-02 decide cuándo (al crear el SKU y al publicar, una sola vez por disparo) y MS-15 decide qué (sólo atributos enriquecibles y perseguidos que faltan, dentro de la ventana, de la fuente con más valor de verdad). Nada de esto es una tarea que bloquee: el producto se aprueba y se publica aunque el enriquecimiento no haya terminado. Por qué: Dos carreteras: el enriquecimiento corre fuera de la ruta de publicación y no frena la venta. Se apoya en RN-GEN-03, RN-ENR-08, RN-ENR-07.
• D-IA-05-2. Después del SKU, lo que alcanza el umbral de su tarea se aplica sin persona (origen IA, visible para el seller como «agregado por IA» y corregible) y lo de confianza baja va a Gobierno de Datos, no al seller. En el alta, en cambio, todo lo sugerido lo confirma el usuario (FT-IA-01): son dos reglas acotadas por canal, la opción A de PD-27. Por qué: En la carga masiva el seller «puede que ni vea el paso»; mandar todo a revisión humana recrearía el cuello de botella, y sólo lo dudoso necesita a una persona. Se apoya en PD-27, PEN-47, DEC-47.
• D-IA-05-3. El enriquecimiento nunca toca datos maestros que van a SAP: MS-15 no los propone y MS-02 rechaza escrituras de origen IA sobre ellos. Tampoco sobrescribe lo que mandó el dueño del contenido: sólo llena lo vacío. Por qué: Un dato maestro cambiado por la IA rompería la conciliación con SAP; lo del dueño gana. Se apoya en RN-INT-07, FT-PRD-10.
• D-IA-05-4. Un solo paso por producto: reconocimiento de imagen y fuentes externas juntos, con las fuentes y su valor de verdad (el sitio de la marca antes que los marketplaces) por categoría, marca y grupo de artículos en la configuración de MS-15. Lo externo se lleva a la estructura y a las unidades de la plantilla; lo descubierto se mapea al atributo que ya existe y lo que no tiene atributo se queda en el trabajo de IA, sin entrar al producto, hasta que se decida PEN-167. Por qué: No pagar dos veces, no copiar errores de fuera y no duplicar atributos. Se apoya en PEN-167, PEN-192.
• D-IA-05-5. QA con IA: MS-15 revisa la coherencia con el umbral de su tarea por negocio y devuelve qué no cuadra y a quién sugiere mandarlo; si su resultado decide o sólo se mide lo controla el interruptor del motor de MS-02 (FT-RAC-03). Si el modelo no responde, cae a QA manual. Por qué: La IA propone y el motor decide con una regla; ningún umbral vive en dos lugares. Se apoya en PD-27, DUD-35, FT-RAC-03.
• D-IA-05-6. El artículo queda marcado como enriquecido, con fecha y trabajo, aunque no se encuentre nada; esa marca es la que impide repetirlo y la que dice qué falta enriquecer. Por qué: Saber qué sólo se publicó y qué además se enriqueció, sin gastar IA de más. Se apoya en PEN-34, RF-ENR-12.

Qué falta decidir

También siguen abiertos: PEN-47, Quién valida lo que la IA agrega cuando el seller no ve el paso (aquí: Gobierno de Datos lo de confianza baja); PEN-34, La ventana real de enriquecimiento (aquí 90 días desde el SKU); PEN-167, Dónde guardar y cómo mapear lo que la IA descubre y no tiene atributo en la plantilla; PEN-192, Qué atributos enriquecidos se mandan a qué sistemas.

Fuentes

1. [D] trazabilidad/features/FT-IA-05-enriquecimiento-continuo-post-sku-publicacion.md: la ficha de la épica, con sus historias, reglas y bloqueos.
2. [D] ADR-12 · Un solo sistema: backend compartido y una sola base (sección 3.4).
3. [D] docs/arquitectura/por-epica/base/: piezas, colecciones, eventos y el hilo de punta a punta.
4. [D] docs/arquitectura/omega-a-pim-headless/contratos-api.md: convenciones y endpoints de partida.
5. [D] docs/arquitectura/maquina-de-estados-to-be/propuesta-maquina-de-estados.md §7: estados, tareas y canales.
6. [I] Las decisiones de la sección 9 son del TL sobre esas fuentes.