FT-PLT-08 · Títulos, nombres y descripciones de producto

En 30 segundos

El título del producto se arma solo con la regla de su plantilla, igual que en P360, para que el cambio de sistema no mueva los nombres publicados. Esta épica calcula el título, el título sin marca y la descripción en el mismo momento en que cambia un dato que los forma, los recalcula sin esperar en la cola general cuando cambia la regla, arma el nombre completo de los configurables y ofrece al seller sugerencias de título con IA.

• Módulo dueño: MS-02 Producto. También participan: MS-01 Catálogo, MS-08 Adaptadores de salida, MS-15 IA y enriquecimiento.
• Etapa 3 · Captura. Recibe «PE-3 · Plantilla asignada» y entrega a otras épicas.
• APIs: construye 2 y usa 7 que construyen otras épicas.
• Eventos: publica 2 y consume 2.

1. Dónde encaja

Recibe

Entrega

Cambios de estado que hace

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 Sugerencias de título para el seller

3.2 Recalcular y comparar antes de republicar

3.3 Nombre de un configurable

4. Si algo sale mal

• La plantilla no tiene orden de atributos para el título ni lo hereda. Se usa el valor por omisión del negocio, como hoy: en Suburbia empieza por SB_0002 y usa BRAND_ID_S4H; en Liverpool y Marketplace, tipo de producto SAP, marca y modelo comercial o número de parte. El título sin marca es el mismo texto sin la marca.
• A un seller de Marketplace le falta un atributo del título. El título se arma con lo disponible y el plan avisa «tu título queda genérico: captura este dato»; no bloquea. El seller puede pedir sugerencias a la IA.
• La IA no responde al pedir sugerencias. La pantalla muestra sólo el título de la regla y deja escribir uno propio; nada se bloquea.
• Un interno fijó el título a mano. El recálculo no lo pisa: el plan lo cuenta como título fijado y Gobierno de Producto puede regresarlo a la regla con el plan de valores.
• El recálculo de una plantilla grande no termina antes de la siguiente carga. Cada producto se recalcula en su propia transacción, así que la carga lleva el título nuevo o el anterior completo, nunca uno a medias; el avance se ve en el recibo del trabajo.

5. APIs

Las que construye esta épica (2)

{
  "fields": [
    "productName",
    "descriptionLong"
  ],
  "language": "es",
  "max": 2
}

{
  "success": true,
  "data": {
    "productId": "PRD-0004812",
    "ruleTitle": "Playera MARCA01 deportiva de algodón",
    "suggestions": [
      {
        "productName": "Playera deportiva MARCA01 de algodón para hombre, cuello redondo",
        "descriptionLong": "Playera de algodón transpirable con cuello redondo, ideal para entrenar.",
        "confidence": 0.82,
        "aiJobId": "aij-5521"
      }
    ],
    "aiAvailable": true
  }
}

{
  "scope": {
    "templateId": "EU4-0412",
    "productIds": []
  },
  "fields": [
    "productName",
    "titleWithoutBrand",
    "descriptionLong"
  ],
  "republishApproved": true
}

{
  "success": true,
  "data": {
    "planId": "pln-2c66aa",
    "expiresAt": "2026-10-18T17:30:00Z",
    "summary": {
      "products": 1840,
      "willChange": 312,
      "approvedToRepublish": 287,
      "manualTitlesKept": 14
    },
    "sample": [
      {
        "productId": "PRD-0004812",
        "field": "titleWithoutBrand",
        "before": "Licuadora MARCA01 LX-200",
        "after": "Licuadora LX-200"
      }
    ],
    "estimatedMinutes": 6,
    "applyUrl": "/api/v2/product-plans/pln-2c66aa/apply"
  }
}

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-08-1. MS-02 calcula título, título sin marca y descripción con la regla de nombre de la plantilla, que guarda Catálogo (metadatos de nombre con herencia de EU4 a EU3). El cálculo vive junto al dato del producto. Por qué: El título se arma con valores del producto; calcularlo en otro lado obligaría a copiar esos valores. La regla sigue siendo de Catálogo. Se apoya en PD-05, DEC-ARQ-08, ADR-12.
• D-PLT-08-2. Precedencia del título: un valor fijado a mano gana sobre la regla y la regla gana cuando nadie lo fijó; la IA sólo sugiere y lo sugerido se guarda como propio si el usuario lo acepta. El producto guarda el origen del título (REGLA, MANUAL o IA aceptada). Por qué: Hoy el título tiene cinco escritores y gana el último, sin regla; guardar el origen evita que un recálculo pise lo que alguien corrigió. Se apoya en PEN-167, RN-ENR-05.
• D-PLT-08-3. El título se recalcula en la misma transacción en que cambia un dato que lo forma. Si cambia la regla de la plantilla, el recálculo corre en una cola propia de calculados, con prioridad sobre la cola general, y termina antes de 1 hora para una plantilla típica. Por qué: Hoy el título sin marca tarda hasta 45 días por la cola de cambios de P360 y repoblamiento aprueba una hora después. Se apoya en RF-PLA-16, DEC-86.
• D-PLT-08-4. Un producto aprobado cuyo título cambió por recálculo de la regla se republica directo, sin Revisión del cambio: su canal pasa de Publicado a Enviado. Por qué: Ningún dato del proveedor cambió; la regla ya pasó por la aprobación de cambios del catálogo. Se apoya en RF-PLA-16, FT-PRD-05.
• D-PLT-08-5. Si a un seller de Marketplace le falta un atributo del título, el título se arma con lo disponible y se le avisa, sin bloquear; la IA puede sugerir lo que falta. Por qué: Pedirlo como obligatorio contradice que los atributos del título no sean obligatorios en Marketplace; generarlo vacío deja títulos genéricos. Se apoya en PEN-137, RN-PLA-15.
• D-PLT-08-6. Hay una sola descripción, en el producto. La tienda, OMS, Señalización y el surtido la reciben de la misma foto de publicación. La ruta de hoy que usa XD no se construye y su reemplazo se decide con ADR-06. Por qué: Si cada sistema guarda su descripción, el surtido falla al buscar el producto; una fuente evita la diferencia. Se apoya en ADR-06, ADR-12.
• D-PLT-08-7. Antes del corte, la regla se prueba contra los 981 pares de la tienda y se reporta el porcentaje de acierto; la referencia se congela después del cambio de estrategia de título sin marca en P360. Por qué: La referencia de paridad se mueve con los scripts de títulos de P360. Se apoya en RSG-47, PEN-120, DEC-86.
• D-PLT-08-8. El nombre de cada miembro de un configurable se completa con los valores de su configuración, en el orden que dice la plantilla. Por qué: Hoy los configurables no reflejan su configuración en el nombre; la plantilla ya trae ese orden en 70 casos. Se apoya en DEC-85, PEN-119.

Qué falta decidir

También siguen abiertos: PEN-137, Confirmar con Gobierno de Producto qué hacer si al seller le falta un atributo del título (aquí: se arma con lo disponible y se avisa); PEN-26, Sesión pendiente de obligatoriedad y títulos; PEN-118, Definir qué es «product type» y qué información se mantiene de él.

Fuentes

1. [D] trazabilidad/features/FT-PLT-08-titulos-nombres-descripciones.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.