FT-PLT-02 · Catálogo de atributos

En 30 segundos

Cada dato que se le pide a un producto es un atributo del catálogo: su tipo, sus restricciones, su lista de valores y a qué sistemas viaja. Hoy esas reglas están regadas en tablas y en código, y cada canal valida distinto. Esta épica deja un solo catálogo de atributos que dicta cómo se valida un valor en la pantalla, la carga masiva y la API, y qué viaja a cada sistema, incluidos los bloques de varias filas y los atributos que aparecen según otro.

• Módulo dueño: MS-01 Catálogo. También participan: MS-13 Identidad y acceso, MS-02 Producto, MS-08 Adaptadores de salida.
• Etapa C · Configura el catálogo. Recibe «PE-T · Usuario con permisos y bitácora» y entrega «PE-C · Catálogo vigente».
• APIs: construye 4 y usa 6 que construyen otras épicas.
• Eventos: publica 1 y consume 3.

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 Cambiar el tipo de un atributo de lista

3.2 Bloques de filas y atributos condicionales

3.3 Lo que no es de SAP no viaja a SAP

4. Si algo sale mal

• Se quiere cambiar el tipo o la lista de un atributo que ya tiene valores. El plan responde 409 IMMUTABLE_ID con cuántos productos tienen valor. Se crea un atributo nuevo y el viejo se desactiva; los productos conservan su valor en el viejo.
• Se pide borrar un atributo usado por una plantilla, una regla o un producto. El plan responde 422 BUSINESS_ERROR y ofrece desactivarlo: deja de pedirse en las capturas nuevas y nadie pierde un valor.
• Un valor capturado no cumple las restricciones (101 caracteres en un texto de 100). La validación en línea de MS-02 lo rechaza con VALIDATION_ERROR en la ruta del campo; la regla sale del atributo y es la misma en la pantalla, la carga masiva y la API.
• Un usuario sin perfil intenta crear, editar o borrar un atributo. MS-01 decide con los roles de MS-13 y responde 403 AUTHORIZATION_ERROR; no se abre ninguna solicitud.

5. APIs

Las que construye esta épica (4)

null

{
  "success": true,
  "data": {
    "items": [
      {
        "attributeId": "ATR-0003001",
        "name": {
          "es": "Potencia",
          "en": "Power"
        },
        "dataType": "DECIMAL",
        "constraints": {
          "min": 0,
          "max": 5000,
          "decimals": 1,
          "unit": "W"
        },
        "multivalued": false,
        "lovId": null,
        "groups": [
          "CARACTERISTICAS",
          "DESTINO:TIENDA"
        ],
        "relevantFor": [
          "TIENDA",
          "MARKETPLACE",
          "DWH"
        ],
        "systemOfRecord": "PIM",
        "origin": "LIVERPOOL",
        "status": "ACTIVE",
        "version": 3
      }
    ],
    "page": 1,
    "size": 50,
    "total": 1
  }
}

null

{
  "success": true,
  "data": {
    "attributeId": "MARCA",
    "name": {
      "es": "Marca",
      "en": "Brand"
    },
    "helpText": {
      "es": "La marca comercial del producto, como la registra SAP"
    },
    "dataType": "LOV",
    "lov": {
      "lovId": "MARCAS_ECC_LOV",
      "lovByBusiness": {
        "SUB": "MARCAS_S4H_LOV"
      },
      "newValuePolicy": "REJECT"
    },
    "multivalued": false,
    "constraints": {},
    "composite": null,
    "dependency": null,
    "metadata": {
      "systemOfRecord": "SAP",
      "origin": "ERP",
      "relevantFor": [
        "SAP",
        "TIENDA",
        "OMS",
        "MARKETPLACE",
        "SENALIZACION",
        "DWH"
      ],
      "uniqueByBusiness": false,
      "validity": [
        "TODOS"
      ],
      "variantLevel": "GENERIC"
    },
    "externalIds": {
      "ECC": "BRAND_ID",
      "S4H": "BRAND_ID"
    },
    "groups": [
      "DATOS_MAESTROS",
      "DESTINO:SAP",
      "DESTINO:TIENDA",
      "SECCION:DATOS_BASE"
    ],
    "status": "ACTIVE",
    "version": 7,
    "audit": {
      "origin": "MIGRATION",
      "loadedAt": "2026-12-05T06:00:00Z",
      "updatedAt": "2027-01-12T17:40:00Z"
    }
  }
}

{
  "operation": "CREATE",
  "channel": "PORTAL",
  "items": [
    {
      "attributeId": null,
      "name": {
        "es": "Potencia",
        "en": "Power"
      },
      "helpText": {
        "es": "Potencia del motor en watts"
      },
      "dataType": "DECIMAL",
      "constraints": {
        "min": 0,
        "max": 5000,
        "decimals": 1,
        "unit": "W"
      },
      "multivalued": false,
      "metadata": {
        "systemOfRecord": "PIM",
        "origin": "LIVERPOOL",
        "relevantFor": [
          "TIENDA",
          "MARKETPLACE",
          "DWH"
        ],
        "variantLevel": "GENERIC"
      },
      "groups": [
        "CARACTERISTICAS"
      ]
    }
  ]
}

{
  "success": true,
  "data": {
    "planId": "pln-a41c09",
    "expiresAt": "2027-01-12T15:14:05Z",
    "requiresApproval": true,
    "summary": {
      "create": 1,
      "update": 0,
      "blocked": 0
    },
    "items": [
      {
        "attributeId": null,
        "idAssignedOn": "APPROVAL",
        "idPattern": "ATR-{número}",
        "action": "CREATE",
        "changes": [
          {
            "path": "dataType",
            "before": null,
            "after": "DECIMAL"
          },
          {
            "path": "constraints.max",
            "before": null,
            "after": 5000
          }
        ]
      }
    ],
    "applyUrl": "/api/v2/catalog-plans/pln-a41c09/apply"
  }
}

{
  "by": "ATTRIBUTE",
  "keys": [
    "COLOR_PRINCIPAL"
  ],
  "business": [
    "MER",
    "SUB",
    "MKP"
  ]
}

{
  "success": true,
  "data": {
    "countedAt": "2027-01-12T15:06:00Z",
    "items": [
      {
        "key": "COLOR_PRINCIPAL",
        "products": 0,
        "withValue": 0,
        "published": 0,
        "byStatus": {
          "BORRADOR": 0,
          "EN_REVISION": 0,
          "APROBADO": 0
        },
        "byBusiness": {
          "MER": 0,
          "SUB": 0,
          "MKP": 0
        }
      }
    ]
  }
}

Las que usa y construye otra épica (6)

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-02-1. Tipos de dato: los ocho de hoy (texto, entero, decimal, verdadero o falso, fecha, fecha y hora, lista y compuesto) más texto enriquecido, moneda y referencia a otro objeto. Las restricciones (longitud, mínimo, máximo, decimales, unidad, patrón) viven en el atributo, no en tablas sueltas, y una plantilla sólo puede endurecerlas. Por qué: DEC-ARQ-12 mete lo que pide la ERF. Hoy ninguna de las 24,217 características usa las cotas del modelo y las restricciones están en la configuración por plantilla. Se apoya en DEC-ARQ-12, PD-14, DUD-01.
• D-PLT-02-2. El código de un atributo nunca cambia. Su tipo y su lista tampoco, en cuanto un producto tiene valor; mientras nadie lo use, el plan permite cambiarlos y exige el tipo nuevo al quitar la lista. Para saberlo, MS-01 le pregunta a Producto (PEDIDA-PLT-02-1). Por qué: Concilia lo que pide la ERF (quitar la lista exige el tipo nuevo) con la inmutabilidad que protege los valores ya capturados. Se apoya en PD-16, DEC-PLT-06.
• D-PLT-02-3. Los metadatos de comportamiento son campos del atributo: sistema dueño, origen (ERP o Liverpool, como los …VaD), relevancia por destino, único por negocio, validez por tipo de producto y si se captura por variante. Ningún adaptador guarda listas de campos en código: MS-08 y MS-10 leen la salida de MS-01 (API-01-105). Por qué: Hoy la relevancia vive en tres diccionarios y las salidas la deciden con listas propias; con un solo dueño, cambiar qué viaja a un sistema es una solicitud, no un despliegue. Se apoya en DEC-PLT-08, DEC-ARQ-09.
• D-PLT-02-4. Atributos condicionales: la regla por omisión (mostrar, ocultar o volver obligatorio según el valor de otro atributo) se declara en el atributo; cada plantilla puede cambiarla en su configuración y la vista efectiva resuelve cuál aplica, con más de un nivel de dependencia. Por qué: Hoy la dependencia es una propiedad suelta de la configuración y sólo llega a un nivel; sin la fachada de compatibilidad (decisión 20) no hay que copiar esa limitación. Se apoya en DEC-ARQ-12, DEC-PLT-11, ADR-12.
• D-PLT-02-5. Los bloques de N filas son el tipo compuesto, con sus campos (porcentaje, material, parte) y un máximo de filas. La composición textil aplanada en cinco atributos se convierte al migrar con la regla que valide Gobierno de Producto. Por qué: Guardar filas en vez de columnas numeradas deja capturar los materiales que haga falta y validarlos igual. Se apoya en DEC-PLT-07.
• D-PLT-02-6. La validez por tipo de producto se modela desde ya y se llena con los seis tipos propuestos cuando se ratifiquen; mientras, todo atributo vale para todos los tipos. Las hijas de rechazo no son atributos: el motivo de rechazo viaja con el producto (MS-02). Por qué: No se bloquea el catálogo esperando una tabla que no existe, y no se migran 2,632 árboles de rechazo como si fueran atributos. Se apoya en PD-17, DUD-19, DEC-ARQ-09.

Qué falta decidir

Fuentes

1. [D] trazabilidad/features/FT-PLT-02-catalogo-de-atributos.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.