FT-PLT-07 · Reglas de atributos

En 30 segundos

Muchas reglas de hoy están escondidas en el código de P360: la talla normalizada, el envase, el impuesto y los datos maestros que exige SAP. Esta épica las vuelve reglas explícitas de Catálogo, con versión, vigencia y prueba previa, para que el sistema calcule lo que el proveedor no debe capturar y bloquee lo incoherente al guardar, igual en pantalla, en archivo o por API.

• Módulo dueño: MS-01 Catálogo. También participan: MS-02 Producto, MS-05 Auditoría, MS-11 Activos digitales.
• Etapa 3 · Captura. Recibe «PE-3 · Plantilla asignada» y entrega «PE-C · Catálogo vigente».
• APIs: construye 4 y usa 7 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 El comprador corrige el envase calculado

3.2 Tendencias: alta, cambio y baja

3.3 Activo que depende de un atributo

4. Si algo sale mal

• Una regla de calidad no se cumple (precio de venta menor que el de compra). El plan de MS-02 responde con el campo y el mensaje de la regla; en Mercaderías y Suburbia no deja guardar, en Marketplace avisa y baja el score. La pantalla lo marca en el momento.
• La prueba previa muestra que una regla de paridad no da lo mismo que calculó P360. El plan lista los productos y los dos valores; Gobierno de Producto corrige la regla. Una regla de paridad no se activa con diferencias sin justificar.
• MS-02 no puede correr la prueba sobre la muestra. El plan responde 503 y no se confirma una regla sin probar; Gobierno de Producto la reintenta.
• La regla nueva depende de otro calculado y forma un ciclo. El plan responde 422 con la cadena del ciclo y no se puede confirmar.
• Una regla cambia mientras un proveedor tiene un plan abierto. La confirmación responde 409 VERSION_CONFLICT porque el plan se armó con otra versión del conjunto de reglas; la pantalla pide el plan otra vez.

5. APIs

Las que construye esta épica (4)

null

{
  "success": true,
  "data": {
    "rulesetVersion": "rs-EU4-0412-MER-41",
    "items": [
      {
        "ruleId": "rul-000231",
        "type": "DERIVED_VALUE",
        "target": {
          "attribute": "TamanoUnicoSTD"
        },
        "scope": {
          "business": [
            "MER",
            "SUB"
          ],
          "templateIds": [
            "EU4-0412"
          ],
          "productKinds": [
            "PROPOSAL",
            "PLACEHOLDER"
          ]
        },
        "expression": {
          "op": "LOOKUP",
          "table": "TallaNormalizada",
          "key": [
            "MARCA",
            "TamanoUnico"
          ],
          "separator": "<::>"
        },
        "overridableBy": [],
        "version": 3,
        "status": "ACTIVE",
        "validFrom": "2026-11-01T06:00:00Z",
        "validTo": null,
        "origin": "PARIDAD_P360"
      },
      {
        "ruleId": "rul-000245",
        "type": "QUALITY_CHECK",
        "target": {
          "attribute": "PrecioVenta"
        },
        "scope": {
          "business": [
            "MER",
            "SUB",
            "MKP"
          ],
          "templateIds": [
            "*"
          ],
          "productKinds": [
            "PROPOSAL"
          ]
        },
        "expression": {
          "op": "GTE",
          "left": "PrecioVenta",
          "right": "PrecioCompra"
        },
        "effect": {
          "MER": "BLOCK",
          "SUB": "BLOCK",
          "MKP": "WARN"
        },
        "message": {
          "es": "El precio de venta no puede ser menor que el de compra"
        },
        "fields": [
          "PrecioVenta",
          "PrecioCompra"
        ],
        "version": 1,
        "status": "ACTIVE",
        "validFrom": "2026-11-01T06:00:00Z",
        "validTo": null,
        "origin": "ERF_1_1"
      }
    ],
    "page": 1,
    "size": 50,
    "total": 2
  }
}

{
  "operation": "CREATE",
  "items": [
    {
      "type": "DERIVED_VALUE",
      "target": {
        "attribute": "TamanoUnicoSTD"
      },
      "scope": {
        "business": [
          "MER",
          "SUB"
        ],
        "templateIds": [
          "EU4-0412"
        ],
        "productKinds": [
          "PROPOSAL",
          "PLACEHOLDER"
        ]
      },
      "expression": {
        "op": "LOOKUP",
        "table": "TallaNormalizada",
        "key": [
          "MARCA",
          "TamanoUnico"
        ],
        "separator": "<::>"
      },
      "validFrom": "2026-11-01T06:00:00Z",
      "origin": "PARIDAD_P360"
    }
  ],
  "test": {
    "cases": [
      {
        "values": {
          "MARCA": "MARCA01",
          "TamanoUnico": "M"
        },
        "expect": {
          "TamanoUnicoSTD": "MED"
        }
      }
    ],
    "sample": {
      "templateIds": [
        "EU4-0412"
      ],
      "business": "MER",
      "size": 1000,
      "compareWithStored": true
    }
  }
}

{
  "success": true,
  "data": {
    "planId": "pln-r81c20",
    "expiresAt": "2026-10-18T15:14:05Z",
    "items": [
      {
        "ruleId": "rul-000231",
        "operation": "CREATE",
        "version": 1,
        "readsAttributes": [
          "MARCA",
          "TamanoUnico"
        ],
        "readsTables": [
          "TallaNormalizada"
        ],
        "cases": {
          "passed": 1,
          "failed": 0
        },
        "sample": {
          "evaluated": 1000,
          "sameAsStored": 1000,
          "different": 0,
          "examples": []
        }
      }
    ],
    "applyUrl": "/api/v2/catalog-plans/pln-r81c20/apply"
  }
}

null

{
  "success": true,
  "data": {
    "templateId": "EU4-0412",
    "business": "MER",
    "supplierId": "PROV-0001",
    "canCatalog": true,
    "brands": [
      {
        "code": "MARCA01",
        "label": "Marca Uno"
      }
    ],
    "itemGroups": [
      {
        "ecc": "424104421",
        "s4h": "424104421",
        "section": "424",
        "direction": "9",
        "label": "Camisas de caballero"
      }
    ],
    "section": {
      "code": "424",
      "linked": true
    },
    "rules": [
      {
        "ruleId": "rul-000771",
        "type": "SUPPLIER_SCOPE",
        "version": 4
      },
      {
        "ruleId": "rul-000112",
        "type": "ALLOWED_BRANDS_BY_TEMPLATE",
        "version": 9
      },
      {
        "ruleId": "rul-000113",
        "type": "ALLOWED_ITEM_GROUPS_BY_TEMPLATE",
        "version": 6
      }
    ],
    "rulesetVersion": "rs-EU4-0412-MER-41"
  }
}

{
  "rule": {
    "type": "DERIVED_VALUE",
    "target": {
      "attribute": "TamanoUnicoSTD"
    },
    "expression": {
      "op": "LOOKUP",
      "table": "TallaNormalizada",
      "key": [
        "MARCA",
        "TamanoUnico"
      ],
      "separator": "<::>"
    }
  },
  "cases": [
    {
      "values": {
        "MARCA": "MARCA01",
        "TamanoUnico": "M"
      },
      "expect": {
        "TamanoUnicoSTD": "MED"
      }
    }
  ],
  "sample": {
    "templateIds": [
      "EU4-0412"
    ],
    "business": "MER",
    "productKinds": [
      "PROPOSAL"
    ],
    "size": 1000,
    "compareWithStored": true
  }
}

{
  "success": true,
  "data": {
    "cases": {
      "passed": 1,
      "failed": 0
    },
    "sample": {
      "evaluated": 1000,
      "sameAsStored": 1000,
      "different": 0,
      "wouldBlock": 0,
      "examples": []
    }
  }
}

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-07-1. MS-01 define las reglas y MS-02 las ejecuta con su único motor, el de FT-RAC-01: no hay evaluador ni servicio de reglas en MS-01. MS-01 guarda tipo, alcance, efecto por negocio, vigencia, versión y casos de prueba, revisa que la regla esté bien armada y avisa RULE_CHANGED; MS-02 la lee con API-01-016, la guarda en caché y la corre en cada plan. La prueba previa también la corre MS-02, para que lo probado sea lo que se aplicará. Por qué: Una regla con dos implementaciones se desincroniza. Y no hay llamada de red al guardar: el motor tiene las reglas en caché. Se apoya en DMS-68, DEC-PRD-08, FT-RAC-01, ADR-12.
• D-PLT-07-2. Cuatro tipos nuevos en governance_rules, junto a los 9 de relación: DERIVED_VALUE (calculados y datos maestros inferidos), QUALITY_CHECK (calidad, con efecto BLOCK o WARN por negocio), ASSET_REQUIREMENT (un activo que se pide según el valor de un atributo) y TREND (tendencias). Cada regla lleva alcance por negocio, plantilla y tipo de producto (propuesta o placeholder), vigencia, versión, mensaje y casos de prueba. Por qué: Convierte las reglas escondidas en datos con dueño, como pide el diseño de plantillas, sin inventar un lenguaje nuevo por cada caso. Se apoya en DEC-PLT-14, DEC-PLT-08, S36-RF-05, S36-RF-06.
• D-PLT-07-3. Paridad primero: los calculados de CreateProposal (talla normalizada, color de Suburbia, talla hacia SAP, envase e impuesto por negocio, con E2 fijo en Marketplace) se cargan como reglas DERIVED_VALUE y no se activan hasta que la prueba sobre 1,000 productos migrados dé lo mismo que guardó P360. Por qué: Si el PIM calcula distinto que P360, la creación del SKU se rompe al apagarlo; la muestra migrada trae el valor de P360 para comparar. Se apoya en RF-PLA-13, RN-PLA-14, DEC-ARQ-02.
• D-PLT-07-4. Un cambio de regla aplica hacia adelante, desde su vigencia: no recalcula productos ya guardados. La excepción son las tendencias: al crearse, cambiar o darse de baja, MS-02 recalcula en segundo plano qué productos y placeholders la cumplen. Por qué: Recalcular lo guardado cambiaría datos que ya están en SAP o en la tienda sin que nadie los revise; la tendencia es informativa y debe reflejar siempre su definición vigente. Se apoya en S36-RF-06, DEC-PLT-14.
• D-PLT-07-5. El comprador dueño del dato corrige el envase calculado sin ticket ni aprobación: MS-02 guarda el valor a mano, lo marca como corregido y no lo vuelve a calcular hasta que el comprador lo libere. La corrección queda en la bitácora con el antes y el después. Por qué: Hoy el envase se corrige por ticket después de publicar; el taller pidió que el dueño del dato lo cambie y que quede detectado. Se apoya en RN-CAL-05, DEC-21, PEN-11.
• D-PLT-07-6. El margen es un calculado DERIVED_VALUE con la tabla MargenVsIndicadorImp: desde R2 lo devuelve el plan de valores de MS-02 y deja de calcularse en el navegador. En R1 la pantalla sólo cambia de dónde lee los factores (API-BFF-105 en vez de P360). Por qué: El cálculo es una regla y su lugar es el motor; en R1 todavía no existe MS-02 y no se construye un evaluador temporal en MS-01. Se apoya en ADR-12, FT-RAC-01.
• D-PLT-07-7. El alcance del proveedor (SUPPLIER_SCOPE) y las marcas y grupos permitidos por plantilla, negocio y proveedor se resuelven en un solo lugar, API-01-202, que usan la captura por el BFF, MS-02 al validar y el gateway de terceros. Por qué: Hoy la misma resolución vive en P360 y se pide desde el navegador y desde el backend de Entrada Única; con un dueño no hay dos respuestas distintas. Se apoya en DEC-PLT-14, PD-05.
• D-PLT-07-8. Qué reglas piden aprobación al confirmar (API-01-004): las que cambian lo que el sistema calcula, bloquea o exige (DERIVED_VALUE, QUALITY_CHECK y ASSET_REQUIREMENT) quedan como solicitud y las aprueba otra persona de Gobierno de Producto (API-01-103). Se aplican al confirmar las de relación que acotan o clasifican (las 9 de hoy, sitios por negocio y lista negra) y las tendencias. Por qué: Una regla de cálculo mal escrita cambia miles de productos y merece dos manos; un veto de marca o una tendencia no pueden esperar una aprobación. Es lo que FT-PLT-01 deja a esta épica. Se apoya en DEC-ARQ-12, FT-PLT-01.

Qué falta decidir

También siguen abiertos: PEN-11, Confirmar con Mercaderías la regla fina del envase y qué roles la pueden corregir.

Fuentes

1. [D] trazabilidad/features/FT-PLT-07-reglas-atributos-calculados-calidad.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.