FT-PLT-06 · Configuración de atributos por plantilla y por negocio…

En 30 segundos

Una misma plantilla sirve a Mercaderías, Suburbia y Marketplace, pero cada negocio necesita exigir cosas distintas. Esta épica deja que Gobierno de Producto marque, atributo por atributo y negocio por negocio, si se pide y si es requerido, recomendado u opcional, y calcula con eso la «vista efectiva»: la lista ya resuelta de lo que hay que pedir para una plantilla y un negocio. Esa vista es lo único que leen la captura, la validación en línea, el score, la IA y la API de terceros.

• Módulo dueño: MS-01 Catálogo. También participan: MS-02 Producto, MS-03 Migración y convivencia, MS-06 Evaluación, MS-10 Exportador al DWH, MS-11 Activos digitales.
• Etapa 2 · Plantilla. Recibe «PE-C · Catálogo vigente» y entrega «PE-3 · Plantilla asignada».
• APIs: construye 4 y usa 7 que construyen otras épicas.
• Eventos: publica 2 y consume 7.

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 Desligar un atributo sin perder valores

3.2 Paridad con P360 al migrar

3.3 Atributos adicionales del seller

4. Si algo sale mal

• Un cambio relaja lo que la plantilla hereda (baja un requerido o amplía una lista). El plan responde 422 BUSINESS_ERROR: el hijo sólo puede pedir más; si una rama no necesita un atributo, se configura un nivel abajo.
• Gobierno de Producto vuelve requerido un atributo en una plantilla con productos. Es una solicitud con impacto: el plan muestra cuántos borradores, enviados y aprobados hay. Al aprobarse, sólo afecta a borradores y capturas nuevas; lo enviado y lo aprobado no se bloquea.
• La vista quedó atrás de un cambio de atributo, lista o rama. MS-01 recalcula las vistas afectadas al consumir sus propios avisos; cada vista trae sus versiones de origen y los consumidores descartan versiones viejas.
• Al migrar, la vista de una plantilla no da los mismos atributos que P360 ese día. MS-03 registra la diferencia por plantilla y negocio y la plantilla no se da por migrada hasta conciliarla; el corte de R1 no avanza con diferencias abiertas.
• Producto no responde el conteo de impacto. El plan responde 503 DEPENDENCY_UNAVAILABLE y no se arma a medias; se reintenta sin abrir solicitud.

5. APIs

Las que construye esta épica (4)

null

{
  "success": true,
  "data": {
    "templateId": "EU4-0412",
    "version": 14,
    "bindings": [
      {
        "attributeId": "MATERIAL_VASO",
        "origin": "PROPIO",
        "order": 30,
        "section": "CARACTERISTICAS",
        "multivalued": false,
        "byBusiness": {
          "MER": {
            "included": true,
            "level": "OPTIONAL",
            "layer": 5
          },
          "SUB": {
            "included": true,
            "level": "REQUIRED",
            "layer": 3
          },
          "MKP": {
            "included": true,
            "level": "OPTIONAL",
            "layer": 5
          }
        },
        "valueFilter": {
          "allowedCodes": [
            "VID",
            "PLA",
            "ACI"
          ]
        },
        "dependency": null
      },
      {
        "attributeId": "MARCA",
        "origin": "GLOBAL",
        "order": 2,
        "section": "DATOS_BASE",
        "byBusiness": {
          "MER": {
            "included": true,
            "level": "REQUIRED",
            "layer": 1
          },
          "SUB": {
            "included": true,
            "level": "REQUIRED",
            "layer": 1
          },
          "MKP": {
            "included": true,
            "level": "REQUIRED",
            "layer": 1
          }
        }
      }
    ]
  }
}

{
  "operation": "UPDATE",
  "version": 14,
  "items": [
    {
      "attributeId": "MATERIAL_VASO",
      "byBusiness": {
        "MER": {
          "level": "REQUIRED",
          "layer": 3
        },
        "MKP": {
          "level": "RECOMMENDED",
          "layer": 4
        }
      }
    }
  ]
}

{
  "success": true,
  "data": {
    "planId": "pln-d4e7b2",
    "expiresAt": "2027-01-15T15:10:00Z",
    "requiresApproval": true,
    "views": [
      {
        "business": "MER",
        "required": {
          "before": 14,
          "after": 15
        },
        "recommended": {
          "before": 9,
          "after": 9
        },
        "optional": {
          "before": 67,
          "after": 66
        }
      },
      {
        "business": "MKP",
        "required": {
          "before": 10,
          "after": 10
        },
        "recommended": {
          "before": 6,
          "after": 7
        },
        "optional": {
          "before": 58,
          "after": 57
        }
      }
    ],
    "impact": {
      "productsByStatus": {
        "BORRADOR": 23,
        "EN_REVISION": 4,
        "APROBADO": 380
      },
      "appliesTo": "BORRADORES_Y_CAPTURAS_NUEVAS"
    },
    "warnings": [],
    "applyUrl": "/api/v2/catalog-plans/pln-d4e7b2/apply"
  }
}

null

{
  "success": true,
  "data": {
    "templateId": "EU4-0412",
    "business": "MER",
    "viewVersion": 31,
    "computedAt": "2027-01-15T15:20:03Z",
    "sourceVersions": {
      "EU4-0412": 15,
      "EU3-0398": 6,
      "GLOBAL": 22,
      "COLORES_LOV": 7
    },
    "sections": [
      {
        "section": "DATOS_BASE",
        "label": "Datos base",
        "order": 1
      },
      {
        "section": "CARACTERISTICAS",
        "label": "Características",
        "order": 2
      }
    ],
    "attributes": [
      {
        "attributeId": "MARCA",
        "label": "Marca",
        "section": "DATOS_BASE",
        "order": 2,
        "dataType": "LOV",
        "lovId": "MARCAS_ECC_LOV",
        "newValuePolicy": "REJECT",
        "level": "REQUIRED",
        "layer": 1,
        "requiredFor": [
          "ENVIO",
          "SKU"
        ],
        "variantLevel": "GENERIC",
        "inheritedFrom": "GLOBAL"
      },
      {
        "attributeId": "COLOR_PRINCIPAL",
        "label": "Color principal",
        "section": "CARACTERISTICAS",
        "order": 20,
        "dataType": "LOV",
        "lovId": "COLORES_LOV",
        "allowedCodes": [
          "0700",
          "0705",
          "0900"
        ],
        "newValuePolicy": "REQUEST",
        "level": "REQUIRED",
        "layer": 3,
        "requiredFor": [
          "ENVIO"
        ],
        "variantLevel": "VARIANT"
      },
      {
        "attributeId": "DESCRIPCION_LARGA",
        "label": "Descripción larga",
        "section": "CARACTERISTICAS",
        "order": 40,
        "dataType": "RICH_TEXT",
        "constraints": {
          "maxLength": 4000
        },
        "level": "RECOMMENDED",
        "layer": 4,
        "requiredFor": [
          "PUBLICACION:TIENDA"
        ]
      },
      {
        "attributeId": "CERTIFICADO_SOSTENIBLE",
        "label": "Certificado sostenible",
        "section": "CARACTERISTICAS",
        "order": 60,
        "dataType": "LOV",
        "lovId": "CERTIFICADOS_LOV",
        "level": "OPTIONAL",
        "layer": 5,
        "dependency": {
          "on": "PRACTICA_SOSTENIBLE",
          "showWhen": [
            "01",
            "02",
            "03"
          ],
          "requireWhen": [
            "01"
          ]
        }
      }
    ],
    "counts": {
      "required": 15,
      "recommended": 9,
      "optional": 66
    },
    "assetRequirements": {
      "PRINCIPAL": {
        "min": 1
      },
      "DETALLE": {
        "min": 3
      }
    },
    "nameRules": {
      "nameGuide": "Producto + Marca + Modelo",
      "orderOfAttributesForName": [
        "TIPO_PRODUCTO",
        "MARCA",
        "MODELO"
      ]
    },
    "extras": {
      "allowed": true,
      "source": "CATALOGO"
    },
    "warnings": []
  }
}

null

{
  "success": true,
  "data": {
    "templateId": "EU4-0412",
    "attributeId": "CERTIFICADO_SOSTENIBLE",
    "business": "MER",
    "viewVersion": 31,
    "appliedFilters": [
      "VALUE_FILTER:EU4-0412",
      "ACTIVE",
      "ENABLED_BY:PRACTICA_SOSTENIBLE=01"
    ],
    "items": [
      {
        "code": "C01",
        "label": "Comercio justo",
        "order": 1
      },
      {
        "code": "C04",
        "label": "Algodón orgánico",
        "order": 4
      }
    ],
    "page": 1,
    "size": 50,
    "total": 2
  }
}

Las que usa y construye otra épica (7)

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-PLT-06-1. La vista efectiva es la única definición de «qué se pide»: la leen la captura, la validación en línea, el score, la IA, la API de terceros y, desde R1, las pantallas de Entrada Única y de Foro por el BFF. No se construye GetTemplate ni ninguna ruta de compatibilidad. Por qué: Hoy hay cuatro definiciones de «los atributos de una plantilla»; con una sola vista se acaban las diferencias entre canales. Decisión 20 del backend compartido que adopta ADR-12. Se apoya en ADR-12, DEC-PLT-04, PD-03.
• D-PLT-06-2. Tres niveles y cinco capas a la vez: cada atributo de la vista trae su nivel (requerido, recomendado u opcional) y su capa (1 datos maestros, 2 súper obligatorio, 3 obligatorio del negocio, 4 sugerido, 5 opcional). Las capas 1 a 3 son «requerido». Por qué: La versión de cinco capas del 8-oct no invalida la de tres: así sirven las dos sin cambiar el contrato. Se apoya en RN-PLA-08, RF-PLA-05, DEC-45.
• D-PLT-06-3. Cada requerido dice para qué etapa lo es (requiredFor): las capas 1 a 3 frenan el envío de la propuesta y la capa 1 además la creación del SKU; el mínimo de cada canal no frena el envío: frena sólo la publicación en ese canal. Por qué: Dos carreteras: antes del SKU frena lo indispensable y la calidad del contenido frena la publicación por canal. Se apoya en PD-24, RF-PLA-02.
• D-PLT-06-4. Crecer sin nuevos obligatorios: todo atributo que se agrega a una plantilla con productos entra como recomendado u opcional. Volverlo requerido es una solicitud con impacto que nunca aplica hacia atrás: lo enviado y lo aprobado no se bloquean; sólo los borradores y las capturas nuevas. Por qué: Que Marketplace siga con sus 10 requeridos aunque la plantilla crezca a 52 atributos, y que la migración no bloquee productos por obligatorios que P360 no exigía. Se apoya en RN-PLA-11, RN-MIG-03, RN-PLA-09.
• D-PLT-06-5. La lista de atributos de una plantilla es su configuración más la global (la raíz) y lo heredado; las categorías de característica quedan como dato del nodo. Los obligatorios que el proveedor no ve siguen obligatorios, en una sección interna que frena la tarea de su área y nunca el envío del proveedor. Por qué: Es lo que hoy usan el portal y la aprobación, y se puede cambiar después sin volver a migrar. Se apoya en PD-03, DUD-03.
• D-PLT-06-6. Desligar no borra: quitar un atributo de una plantilla o de la raíz sólo deja de pedirlo; los valores siguen en el producto (MS-02) y reaparecen si el atributo se vuelve a ligar, en ese nivel o en otro. Por qué: El dato es del producto y su dueño es MS-02; la plantilla sólo decide qué se pide. Se apoya en DEC-ARQ-12, ADR-12.
• D-PLT-06-7. Los atributos adicionales del seller salen sólo del catálogo, nunca como texto libre, y quedan como opcionales de ese producto sin volverse obligatorios para nadie. La ficha técnica es un activo de MS-11. Por qué: Deja describir un producto técnico sin perder el gobierno del catálogo ni inflar la plantilla de todos. Se apoya en PEN-31, RF-PLA-08.
• D-PLT-06-8. La vista se calcula y se guarda para MER, SUB y MKP al aplicar cada cambio, no al leer, y la lectura responde en menos de 300 ms. Los cambios de la propia plantilla la recalculan en la misma transacción; los de atributos, listas, grupos o ancestros, al consumir sus avisos. Los valores de las listas grandes se piden aparte (API-01-108). Por qué: La vista la leen todas las etapas en cada captura: calcularla al leer repetiría el trabajo miles de veces y daría respuestas distintas en el mismo minuto. Se apoya en DEC-PLT-04, DEC-PLT-10.

Qué falta decidir

También siguen abiertos: PEN-84, Los negocios entregan cuántos y cuáles son sus obligatorios por plantilla; PEN-31, Confirmar que el seller sólo agrega atributos del catálogo, sin texto libre.

Fuentes

1. [D] trazabilidad/features/FT-PLT-06-configuracion-atributos-por-negocio.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.