FT-PRD-07 · Captura guiada por pasos con los mínimos primero

En 30 segundos

Capturar un producto hoy mezcla lo opcional con lo obligatorio y parte de la plantilla completa. Esta épica divide la captura en cinco pasos, cada uno con un área dueña: el primero pide sólo los obligatorios del negocio, los opcionales se saltan y se retoman, el avance se ve por sección y todo se guarda en la propuesta, nunca en la pantalla. Al final el proveedor o seller envía y la propuesta pasa a la Validación automática.

• Módulo dueño: MS-02 Producto. También participan: MS-01 Catálogo, MS-11 Activos digitales, MS-14 Avisos y ayuda.
• Etapa 3 · Captura. Recibe «PE-3 · Plantilla asignada», «PE-6 · SKU asignado» y entrega «PE-4 · Propuesta enviada», «PE-8 · Aprobado».
• APIs: construye 5 y usa 12 que construyen otras épicas.
• Eventos: publica 4 y consume 3.

1. Dónde encaja

Recibe

Entrega

Cambios de estado que hace

Tareas que abre o cierra: Sección con dueño.

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 Retomar después: autoguardado y pasos pendientes

3.2 Guía de tallas: tabla o imagen

3.3 Un área completa su sección

4. Si algo sale mal

• El proveedor intenta cerrar un paso con un obligatorio vacío. Puede guardar lo que capturó, pero el paso no se cierra: la pantalla marca con asterisco rojo cada faltante y muestra la lista que devuelve el plan.
• Se corta la sesión a media captura. Lo tecleado está en el autoguardado del servidor; al volver, la pantalla lo recupera y lo revisa contra la versión actual antes de guardarlo. El portal no guarda nada.
• Otra persona cambió la propuesta o cambió la plantilla mientras se capturaba. La confirmación responde 409 VERSION_CONFLICT; la pantalla recarga la propuesta, vuelve a revisar lo autoguardado y señala los campos que cambiaron.
• El proveedor envía y faltan datos de candado. El plan de envío sale bloqueado con la lista de faltantes por sección (por ejemplo, imagen principal o datos logísticos); la propuesta sigue en Borrador.
• Un área no llena su sección obligatoria. Su tarea sigue abierta y bloquea el Aprobado; MS-14 le recuerda al área dueña y la bandeja de pendientes la muestra con su antigüedad.

5. APIs

Las que construye esta épica (5)

{
  "productId": "PRD-0004812",
  "draftId": "drf-20c9",
  "origin": "PORTAL",
  "evaluationId": null,
  "submitOnApply": false,
  "base": {
    "supplierPartNumber": "PL-889"
  },
  "axes": [
    {
      "attributeId": "COLOR",
      "codes": [
        "NEGRO",
        "BLANCO"
      ]
    },
    {
      "attributeId": "TALLA",
      "codes": [
        "CH",
        "M",
        "G"
      ]
    }
  ],
  "variants": [
    {
      "axisValues": {
        "COLOR": "NEGRO",
        "TALLA": "CH"
      },
      "ean": "7501234567916",
      "values": [
        {
          "attributeId": "PESO_NETO",
          "value": "0.18",
          "unit": "kg"
        },
        {
          "attributeId": "ALTO_EMPAQUE",
          "value": "3",
          "unit": "cm"
        }
      ]
    }
  ]
}

{
  "success": true,
  "data": {
    "planId": "pln-5d92e1",
    "expiresAt": "2026-10-18T16:45:00Z",
    "canApply": true,
    "summary": {
      "variantsToCreate": 6,
      "withEan": 1,
      "withoutEan": 5
    },
    "variants": [
      {
        "axisValues": {
          "COLOR": "NEGRO",
          "TALLA": "CH"
        },
        "ean": "7501234567916",
        "fieldErrors": []
      },
      {
        "axisValues": {
          "COLOR": "BLANCO",
          "TALLA": "G"
        },
        "ean": null,
        "fieldErrors": [
          {
            "path": "/variants/5/values/PESO_NETO",
            "code": "REQUIRED",
            "message": "El peso neto es dato logístico obligatorio para pedir el SKU",
            "effect": "BLOCKS_SUBMIT"
          }
        ]
      }
    ],
    "stepComplete": false,
    "applyUrl": "/api/v2/product-plans/pln-5d92e1/apply"
  }
}

null

{
  "success": true,
  "data": {
    "items": [
      {
        "draftId": "drf-20c9",
        "productId": "PRD-0004812",
        "step": "ATRIBUTOS",
        "baseVersion": 7,
        "version": 3,
        "updatedAt": "2026-10-17T23:10:00Z",
        "expiresAt": "2027-01-15T18:02:00Z"
      }
    ],
    "page": 1,
    "size": 50,
    "total": 1
  }
}

{
  "productId": "PRD-0004812",
  "step": "ATRIBUTOS",
  "baseVersion": 7,
  "payload": {
    "values": [
      {
        "attributeId": "COMPOSICION",
        "text": "100% algod"
      }
    ]
  }
}

{
  "success": true,
  "data": {
    "draftId": "drf-20c9",
    "version": 1,
    "expiresAt": "2027-01-15T18:02:00Z"
  }
}

null

{
  "success": true,
  "data": {
    "draftId": "drf-20c9",
    "productId": "PRD-0004812",
    "step": "ATRIBUTOS",
    "baseVersion": 7,
    "currentProductVersion": 8,
    "stale": true,
    "payload": {
      "values": [
        {
          "attributeId": "COMPOSICION",
          "text": "100% algodón"
        },
        {
          "attributeId": "CUIDADOS",
          "text": "Lavar a mano"
        }
      ]
    },
    "version": 3
  }
}

{
  "payload": {
    "values": [
      {
        "attributeId": "COMPOSICION",
        "text": "100% algodón"
      },
      {
        "attributeId": "CUIDADOS",
        "text": "Lavar a mano"
      }
    ]
  }
}

{
  "success": true,
  "data": {
    "draftId": "drf-20c9",
    "version": 4,
    "payloadSha256": "5c2d81e0",
    "unchanged": false
  }
}

Las que usa y construye otra épica (12)

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-PRD-07-1. El borrador es la propuesta en Borrador dentro de products: cada «Guardar» confirma los valores del paso con el plan de valores. El portal no guarda datos del catálogo. Por qué: Un solo dueño del dato y una sola copia; la propuesta vive en el PIM desde que se guarda. Se apoya en ADR-12, FT-PRD-04.
• D-PRD-07-2. El autoguardado (product_drafts) guarda sólo lo tecleado en el paso en curso que todavía no se confirma, aunque no pase la validación; es por usuario, va ligado a la versión de la propuesta, se borra al guardar el paso y vence con la propuesta. No es una segunda copia de la ficha. Por qué: No se pierde trabajo si se corta la sesión y el portal no tiene que guardar nada; lo confirmado vive sólo en products. Se apoya en DMS-39, ADR-12.
• D-PRD-07-3. Cinco pasos con área dueña: 1 Datos básicos (Compras); 2 Atributos (Gobierno de Producto, con secciones de Sostenibilidad, VAS y Legal); 3 Variantes y datos logísticos (Compras, proveedor y Logística); 4 Imágenes y videos (Gobierno de Producto y E-commerce); 5 Manuales y NOM (proveedor, E-commerce y Legal). El paso de cada atributo sale de su sección en la plantilla (Catálogo) y el área dueña, de la tabla de dueños de campos del motor; cambiar el reparto es configuración. Por qué: Es la propuesta del tablero; los datos logísticos van con las variantes porque son por artículo y SAP los exige para crear el SKU. Se apoya en P-22, RF-ALT-03.
• D-PRD-07-4. El primer paso muestra sólo las tres capas que se llenan sí o sí (datos maestros, súper obligatorios y obligatorios del negocio); sugeridos y opcionales van en bloques que se saltan y se retoman. La completitud de obligatorios es sí o no. Por qué: Separa lo indispensable de lo opcional, como pidió el taller, sin volver la completitud un porcentaje. Se apoya en DEC-43, DEC-48, P-23, PEN-33.
• D-PRD-07-5. La composición de la pantalla (propuesta, vista efectiva, listas y permisos) vive en el BFF del portal, en la pantalla de propuesta de FT-PRD-09 (API-BFF-201); el avance por paso y el autoguardado los pide la pantalla a MS-02. MS-02 sólo da dominio: valores, planes, candados y autoguardado. Por qué: Hoy esa composición está copiada en 4 apps del navegador; ponerla en MS-02 lo ataría a una pantalla, y hacer otra composición para la captura duplicaría la de la propuesta. Lo fija la decisión 19 que adopta ADR-12. Se apoya en ADR-12.
• D-PRD-07-6. Una sola captura para los tres negocios: la de Marketplace es más corta porque su vista efectiva pide menos, no porque haya otra pantalla, otro motor u otra máquina de estados. Por qué: Las plantillas se comparten y sólo cambia la obligatoriedad; dos capturas duplicarían reglas. Se apoya en DEC-03, DEC-43, RN-GEN-02.
• D-PRD-07-7. Toda validación nueva corre dentro del plan del paso donde se captura el dato (por ejemplo, la lista negra al capturar la marca); ninguna agrega una pantalla. Por qué: Cada candado suma clics; correrlos dentro del mismo plan cumple «pocos clics» sin perder control. Se apoya en RF-GEN-06.
• D-PRD-07-8. La guía de tallas es un atributo compuesto de la plantilla (renglones de talla con sus medidas) o una imagen con tipo de activo «guía de tallas» en Activos digitales; aplica a los tres negocios cuando la plantilla tiene talla. Por qué: No existe en P360 ni en los diseños; así no se crea una entidad nueva y cada dato queda con su dueño. Se apoya en RF-PLA-20.
• D-PRD-07-9. Las secciones de las áreas se llenan en la misma pantalla, desde su tarea Sección con dueño, después del SKU y en paralelo con la foto. Por qué: Es la segunda carretera de la máquina de estados: el proveedor no espera a Legal o a Sostenibilidad para pedir su SKU. Se apoya en PD-29, P-22.

Qué falta decidir

Fuentes

1. [D] trazabilidad/features/FT-PRD-07-captura-guiada-por-pasos.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.