FT-IA-01 · Prellenado con IA y validación obligatoria del usuario

En 30 segundos

Capturar a mano una plantilla de hasta 50 atributos es lento, y lo que el seller ya publica en su página no debería recapturarse. Esta épica propone valores con IA a partir de la URL, la imagen o un producto del catálogo y los muestra aparte, como sugerencias. El usuario confirma, corrige o quita cada uno antes de avanzar: nada sugerido llega al SKU sin que una persona lo confirme, y queda registrado qué propuso la IA y qué se aceptó.

• Módulo dueño: MS-15 IA y enriquecimiento. También participan: MS-01 Catálogo, MS-02 Producto, MS-06 Evaluación.
• Etapa 3 · Captura. Recibe «PE-3 · Plantilla asignada» y entrega a otras épicas.
• APIs: construye 1 y usa 8 que construyen otras épicas.
• Eventos: publica 2 y consume 2.

1. Dónde encaja

Recibe

Entrega

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 Valores sin confirmar al enviar

3.2 Primer corte: prellenar con el catálogo

3.3 Atributos desde la foto del proveedor

4. Si algo sale mal

• La IA tarda o no responde. El usuario captura a mano; si las sugerencias llegan después, aparecen aparte y el candado sólo cuenta las que llegaron. Nada se queda detenido esperando a la IA.
• La IA propone un valor que no está en la lista de valores del atributo. MS-15 lo descarta antes de mostrarlo (valida contra la vista efectiva); si el atributo acepta solicitudes de valor nuevo, se muestra como «pedir valor» y no como sugerencia.
• La plantilla cambió entre la sugerencia y la confirmación. El plan de valores avisa por campo qué ya no aplica; las sugerencias de atributos que ya no existen se descartan.
• El usuario corrige casi todo lo que propone la IA. Las métricas por modelo lo muestran; Administración del catálogo puede subir el umbral para mostrar sugerencias o apagar la tarea.

5. APIs

Las que construye esta épica (1)

{
  "productId": "PRD-0004812",
  "version": 2,
  "business": "MKP",
  "templateId": "EU4-0412",
  "scope": {
    "type": "TEMPLATE",
    "attributeGroup": null
  },
  "sources": {
    "sourceJobId": "job-0003311",
    "imageAssetIds": [
      "ast-0004410"
    ],
    "catalogProductId": null
  }
}

{
  "success": true,
  "data": {
    "jobId": "job-0003320",
    "status": "ACCEPTED",
    "links": {
      "self": "/api/v2/ai/jobs/job-0003320"
    }
  }
}

Las que usa y construye otra épica (8)

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-01-1. Todo lo prellenado es sugerencia: vive en el trabajo de IA (ai_jobs de MS-15) y no entra al producto hasta que la persona lo confirma o lo corrige con el plan de valores de MS-02, que guarda la procedencia de cada valor (sugerido por IA, confirmado o corregido, quién y cuándo). Por qué: La validación del usuario siempre va; además así se sabe de dónde salió cada dato, que hoy P360 no guarda. Se apoya en RN-ENR-05, DEC-50, RF-CAL-12.
• D-IA-01-2. El candado es del servidor: con AI_SUGGESTION_READY, MS-02 marca la propuesta con sugerencias por confirmar y el candado de envío (FT-RAC-01) no pasa hasta que cada una se confirme, se corrija o se quite. La pantalla sólo lo muestra. Por qué: Si sólo lo cuidara la pantalla, la API o una pantalla vieja podrían enviar valores de IA sin revisar. Se apoya en RF-ENR-02, RN-ENR-05.
• D-IA-01-3. Sólo se prellenan los atributos que el negocio ve en la plantilla (vista efectiva de MS-01); los marcados como de contexto (medidas, material sin empaque) no se infieren de la foto y quedan como «falta contexto». Por qué: La IA no deduce medidas de una imagen; prellenarlas daría datos falsos con apariencia de buenos. Se apoya en PEN-45, RF-ENR-10.
• D-IA-01-4. Primer corte sin IA: si la búsqueda encontró un producto del catálogo que sirve de base, se prellena con sus datos como sugerencia; la imagen y la URL esperan a que entre la IA. Por qué: Da valor desde el primer corte aunque la IA sea prioridad 2 del BRD. Se apoya en PD-01, DUD-35.
• D-IA-01-5. Por características (marca y modelo, sin página ni imagen) no se prellena mientras no se confirme que la IA puede buscar fuera con certeza; la opción existe apagada en la configuración de MS-15. Por qué: Sin certeza de la búsqueda externa se llenaría la ficha con el producto equivocado. Se apoya en PEN-46, PEN-21, RN-ENR-06.
• D-IA-01-6. Lo que viene de la página del seller o de la imagen se toma del trabajo de IA de la identificación (FT-REF-04): no se vuelve a leer la página. Por qué: Un solo pago del modelo por propuesta y la misma lectura en todo el alta. Se apoya en RF-ENR-05, RF-MAT-05.

Qué falta decidir

También siguen abiertos: PEN-45, La lista de atributos que la IA puede inferir y los que necesitan contexto; PEN-46, Si la IA puede buscar fuera con marca y modelo con certeza (camino características).

Fuentes

1. [D] trazabilidad/features/FT-IA-01-prellenado-ia-validacion-usuario.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.