FT-PLT-10 · Fachada v1 compatible con P360 para Entrada Única y Foro

En 30 segundos

Hoy el navegador de Vendor Center arma la pantalla de captura llamando directo a P360: la plantilla, una lista y un habilitador por atributo, las marcas, el margen y la revisión de sección. Esta épica define las rutas del BFF del portal que reemplazan esas llamadas en R1, con qué endpoints de Catálogo se arman y cómo se apaga cada llamada vieja cuando su tráfico llega a cero.

• Módulo dueño: MS-01 Catálogo. También participan: MS-03 Migración y convivencia.
• Etapa 2 · Plantilla. Recibe «PE-C · Catálogo vigente» y entrega «PE-3 · Plantilla asignada».
• APIs: construye 7 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 Paridad y apagado con tráfico cero

3.2 Revisión de plantilla y sección en la carga masiva

3.3 Aviso a la copia de plantillas de Entrada Única

4. Si algo sale mal

• MS-01 no responde al armar el formulario. El BFF responde 503 y la pantalla muestra el error; nunca un formulario o una lista vacíos sin aviso, como pasa hoy cuando P360 falla.
• La paridad del día encuentra diferencias sin justificar. Esa operación no se cambia en las apps hasta que Gobierno de Producto las cierre; si ya se cambió, la app regresa a la llamada de P360 con su interruptor mientras P360 viva.
• Una operación vieja no llega a cero. No se quita de la entrada de P360: se busca quién la sigue llamando y se mueve; si no es una pantalla (un script o la IA), se decide con ADR-06.
• Un proveedor intenta ver el alcance de otro proveedor. El BFF toma al proveedor de la sesión y MS-01 responde 403 si no coincide; la pantalla no lo muestra.
• Llegan dos avisos de plantilla por el mismo cambio. No puede pasar con un solo emisor: el de MS-01 se enciende por tópico en la misma ventana en que se apaga el de P360 (FT-MIG-04).

5. APIs

Las que construye esta épica (7)

null

{
  "success": true,
  "data": {
    "templateId": "EU4-0412",
    "templateName": "Camisas",
    "business": "MER",
    "creationType": "CreateProposal",
    "sourceVersions": {
      "templateView": 41,
      "lovs": 12
    },
    "lastModified": "2026-10-17T22:10:00Z",
    "sections": [
      {
        "code": "DATOS_BASE",
        "label": "Datos base",
        "order": 1,
        "attributes": [
          {
            "id": "TamanoUnico",
            "label": "Talla",
            "dataType": "LOV",
            "mandatory": true,
            "editable": true,
            "multiValued": false,
            "order": 4,
            "values": {
              "inline": true,
              "items": [
                {
                  "code": "S",
                  "label": "Chica"
                },
                {
                  "code": "M",
                  "label": "Mediana"
                },
                {
                  "code": "L",
                  "label": "Grande"
                }
              ]
            }
          },
          {
            "id": "CertificadoSostenible",
            "label": "Certificado sostenible",
            "dataType": "LOV",
            "mandatory": false,
            "editable": true,
            "multiValued": true,
            "order": 12,
            "enabledBy": {
              "attribute": "AE485",
              "values": [
                "SI"
              ]
            },
            "values": {
              "inline": false,
              "url": "/bff/v1/catalog/capture-form/values?templateId=EU4-0412&attributeId=CertificadoSostenible&business=MER"
            }
          },
          {
            "id": "NombreProducto",
            "label": "Nombre del producto",
            "dataType": "TEXT",
            "mandatory": true,
            "editable": true,
            "order": 2,
            "enabledBy": {
              "attribute": "TipoProducto",
              "values": [
                "CAMISA",
                "BLUSA"
              ]
            }
          }
        ]
      },
      {
        "code": "FOTOS",
        "label": "Fotos",
        "order": 9,
        "attributes": []
      }
    ]
  }
}

null

{
  "success": true,
  "data": {
    "items": [
      {
        "code": "XS",
        "label": "Extra chica",
        "order": 1
      },
      {
        "code": "S",
        "label": "Chica",
        "order": 2
      },
      {
        "code": "M",
        "label": "Mediana",
        "order": 3
      }
    ],
    "page": 1,
    "size": 50,
    "total": 19
  }
}

null

{
  "success": true,
  "data": {
    "canCatalog": true,
    "sectionLinked": true,
    "brands": [
      {
        "code": "MARCA01",
        "label": "Marca Uno"
      }
    ],
    "itemGroups": [
      {
        "code": "424104421",
        "label": "Camisas de caballero"
      }
    ],
    "message": null
  }
}

{
  "business": "MER",
  "items": [
    {
      "row": 2,
      "templateId": "EU4-0412",
      "section": "424"
    },
    {
      "row": 3,
      "templateId": "EU4-0413",
      "section": "531"
    }
  ]
}

{
  "success": true,
  "data": {
    "items": [
      {
        "row": 2,
        "exists": true
      },
      {
        "row": 3,
        "exists": false,
        "message": "La plantilla no está asociada a la sección"
      }
    ]
  }
}

null

{
  "success": true,
  "data": {
    "items": [
      {
        "taxIndicator": "G5",
        "label": "Indicador G5",
        "factor": "1.2528"
      },
      {
        "taxIndicator": "E2",
        "label": "IVA 16 %",
        "factor": "1.16"
      }
    ],
    "sourceVersions": {
      "MargenVsIndicadorImp": 7,
      "MWSKZLOV": 12
    }
  }
}

null

{
  "success": true,
  "data": {
    "items": [
      {
        "code": "E2",
        "label": "IVA 16 %"
      },
      {
        "code": "G5",
        "label": "Indicador G5"
      }
    ],
    "page": 1,
    "size": 50,
    "total": 36
  }
}

null

{
  "success": true,
  "data": {
    "items": [
      {
        "templateId": "EU4-0412",
        "name": "Camisas",
        "path": "Ropa > Caballero > Camisas"
      }
    ],
    "page": 1,
    "size": 20,
    "total": 1
  }
}

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-PLT-10-1. FT-PLT-10 deja de ser fachada: no se construye ninguna ruta /public/rt de catálogo (API-01-054 a API-01-066). Cada operación de plantilla que hoy llama el navegador a P360 se reemplaza por una ruta del BFF que se arma con endpoints de MS-01, y cada app la cambia una sola vez, en R1. Por qué: Lo fija la decisión 20, que adopta ADR-12: cambiar los fronts una vez y no mantener capas temporales. Reemplaza el sentido de DEC-PLT-11 para los fronts. Se apoya en ADR-12, DEC-PLT-11, PD-06.
• D-PLT-10-2. Una llamada por pantalla: el formulario de captura (API-BFF-101) junta la plantilla, las listas chicas y los habilitadores, incluido el del nombre de producto, que hoy son una llamada más una por atributo, copiadas en 4 apps. Las listas grandes van con búsqueda y páginas (API-BFF-102). Marcas, grupos y sección ligada se responden juntos (API-BFF-103), porque la pantalla los pide en el mismo «Siguiente». Por qué: Quita la composición del navegador y baja de unos 5 s de P360 a la meta de 300 ms de promedio y 800 ms de máximo por pantalla. Se apoya en ADR-12, DEC-PLT-04.
• D-PLT-10-3. El BFF no decide nada: el filtro de valores y la dependencia del padre (API-01-108), el alcance del proveedor y la liga plantilla–sección (API-01-202) y el factor de margen (API-01-012) salen de MS-01; el BFF junta, pagina, pone etiquetas, agrupa para la pantalla y toma al proveedor de la sesión. Por qué: Es la regla del BFF de la decisión 19: sin base y sin reglas; si aparece una, se muda al servicio dueño. Se apoya en ADR-12.
• D-PLT-10-4. Cómo se apaga cada llamada vieja: antes de cambiarla, MS-03 compara cada día P360 contra MS-01 con el juego de referencia del mismo día; con cero diferencias sin justificar se cambia en las apps; cuando la entrada de P360 cuenta cero llamadas del navegador a esa operación durante 14 días seguidos, se quita de esa entrada. P360 sigue atendiendo a otros consumidores hasta R3. Por qué: Una captura de otro día no sirve porque la configuración cambia a diario; y sólo el conteo en la entrada prueba que nadie la sigue llamando. Se apoya en RSG-50, PD-12.
• D-PLT-10-5. Lo que no es pantalla no entra aquí: GetTemplates y la carga por archivo del backend de Entrada Única siguen contra P360 hasta su apagado en R3; GetTemplateForo y las listas que pide el backend de Foro se apagan con él en R2, cuando el módulo de Foro en Vendor Center use estas mismas rutas; los scripts de Gobierno de Producto y la IA de plantillas se deciden con ADR-06. Por qué: La decisión 20 sólo cambia los fronts; los consumidores que no son pantalla tienen su propia fecha de apagado. Se apoya en PD-30, PD-31, ADR-06.
• D-PLT-10-6. La copia de plantillas de Entrada Única se mantiene con los avisos de hoy hasta que se apague con Entrada Única. Mientras P360 sea la fuente del catálogo, los manda P360; desde el corte del catálogo, MS-01 manda idmc_put_template e idmc_put_value-list-relation con el mismo cuerpo desde su outbox, con un interruptor por tópico que se enciende en la misma ventana en que se apaga el de P360. Por qué: Entrada Única usa su copia hasta que sus pantallas de producto se mudan, y dos emisores duplicarían avisos; es la misma regla que FT-INT-06 fija para los avisos de producto. Se apoya en DEC-PLT-12, PD-12, FT-INT-06.
• D-PLT-10-7. El margen sigue calculándose en el navegador sólo en R1, con los factores que da API-BFF-105 en vez de P360; desde R2 lo devuelve calculado el plan de valores de MS-02 y el cálculo sale del navegador. Por qué: En R1 todavía no existe MS-02, el motor único de reglas, y no se construye un evaluador temporal en MS-01. Se apoya en ADR-12, FT-PLT-07.

Qué falta decidir

También siguen abiertos: PEN-94, Confirmar en qué momento consulta Foro la plantilla y las listas.

Fuentes

1. [D] trazabilidad/features/FT-PLT-10-fachada-v1-compatible-p360.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.