FT-MIG-02 · Migración de plantillas, atributos y listas de valores

En 30 segundos

Los productos sólo se pueden migrar a plantillas que ya existan. Esta épica copia de P360 al Catálogo del Nuevo PIM las plantillas, atributos, listas, reglas y diccionarios vivos, con una carga que se puede repetir sin duplicar; la concilia contra P360 y la mantiene al día hasta el corte, para que las pantallas vean lo mismo que hoy.

• Módulo dueño: MS-03 Migración y convivencia. También participan: MS-01 Catálogo.
• Etapa M · Migración. Recibe de otras épicas y entrega «PE-C · Catálogo vigente».
• APIs: construye 1 y usa 5 que construyen otras épicas.
• Eventos: publica 1 y consume 0.

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 Incremental del catálogo hasta el corte

3.2 Paridad de la vista efectiva contra GetTemplate

3.3 Repetir la carga sin duplicar

4. Si algo sale mal

• Una plantilla de P360 no tiene atributos. Se carga como nodo para no romper el árbol y queda en la lista que decide Gobierno de Producto; no frena la carga.
• Un atributo dependiente tiene un padre que no es visible. Queda como incidencia con sus filas de origen; no se descarta en silencio como hace hoy P360.
• Las copias de la configuración no coinciden (catálogo 54001 frente al diccionario 17). Gana el 54001, que es lo que lee GetTemplate desde el 8-ago; la diferencia queda explicada en la conciliación.
• El incremental pierde un cambio. La huella semanal lo detecta y esa parte del catálogo se vuelve a cargar; la diferencia queda en la conciliación.
• Una corrida se cae a la mitad. Se reanuda desde el último lote confirmado; como la carga es por llave, repetir no duplica.

5. APIs

Las que construye esta épica (1)

null

{
  "success": true,
  "data": {
    "items": [
      {
        "check": "C1",
        "scope": {
          "type": "SalesItemFamily",
          "business": "MER",
          "status": "APROBADO"
        },
        "expected": 412118,
        "actual": 412090,
        "diff": 28,
        "explained": 28,
        "byReason": [
          {
            "code": "NO_TEMPLATE",
            "count": 21
          },
          {
            "code": "EAN_COLLISION",
            "count": 7
          }
        ]
      },
      {
        "check": "C5",
        "scope": {
          "type": "SalesItemFamily",
          "business": "MKP",
          "status": "APROBADO"
        },
        "expected": 3120,
        "actual": 3118,
        "diff": 2,
        "explained": 0,
        "byReason": [
          {
            "code": "OUTPUT_RULE_BLOCKS",
            "rule": "RUL-PUB-0776",
            "count": 2
          }
        ]
      }
    ],
    "page": 1,
    "size": 50,
    "total": 2
  }
}

Las que usa y construye otra épica (5)

Su request y su response están en la página de la épica que la construye.

6. Eventos

Publica

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-MIG-02-1. La fuente es una sola: el la base de P360 de P360, lo vivo de la revisión 1, con la configuración de atributos del catálogo 54001 sin filtrar el tipo de creación. La revisión 2 no entra; la copia de Omega y la réplica de Foro no son fuente. Por qué: Es lo que leen hoy las consultas de producción; la copia equivocada rompe la paridad de GetTemplate. Se apoya en DEC-ARQ-06, DEC-ARQ-07, DUD-04.
• D-MIG-02-2. La carga es reejecutable por llave de negocio con los ID de P360 (API-01-053) y, en la carga completa, sin eventos: repetirla no duplica ni cambia nada y cada corrida deja su huella. Por qué: Así se puede ensayar en ambientes vacíos y repetir hasta que la conciliación salga limpia. Se apoya en FT-PLT-01, DEC-PLT-06.
• D-MIG-02-3. Las relaciones escondidas en datos (LookupValueReference y StructureGroupMap) se cargan como reglas con tipo, alcance y objetivo; StructureGroupMap queda como la clasificación automática de grupo con producto a plantilla. Por qué: Hoy son reglas sin inventario que asignan plantilla a cerca de 317 mil productos; como reglas tienen dueño y se ven. Se apoya en DEC-PLT-14, RSG-12.
• D-MIG-02-4. Cada negocio visible (LIV, SBB, MKP) recibe su propia obligatoriedad cuando la configuración trae varios. La paridad se mide comparando GetTemplate de P360 contra la vista efectiva de MS-01 (API-01-028), que es la que usa el BFF: 900 respuestas y luego 9,261. La ruta /public/rt no se construye. Por qué: Sin capa de compatibilidad (decisión 20 que adopta ADR-12) las pantallas leen la vista efectiva; eso es lo que tiene que responder igual. Se apoya en RSG-50, ADR-12.
• D-MIG-02-5. P360 es la fuente del catálogo hasta el corte de R3. Un incremental cada hora (marcas de tiempo de diccionarios, listas, grupos y características) más una huella semanal mantienen la copia. A diferencia de la carga completa, el incremental sí avisa con los eventos normales de MS-01 para que las cachés y la bitácora lo vean. Si la administración de plantillas pasa antes al PIM, su cambio se escribe en P360 por MS-03 (D-MIG-04-3). Por qué: Congelar plantillas de R1 a R3 dejaría a Gobierno de Datos meses sin ajustar; un solo maestro con escritura por MS-03 evita dos versiones. Se apoya en PD-12, PD-11, FT-MIG-04.
• D-MIG-02-6. Nada queda sin explicar: lo que no se carga tiene su exclusión documentada o su incidencia, con diferencia cero en nodos, listas, pares del EAV y metadatos, y las 300 plantillas de muestra sin diferencias sin explicar. Por qué: Es el criterio de aceptación del plan de migración y la base para firmar. Se apoya en DMS-85, DMS-88.

Qué falta decidir

Fuentes

1. [D] trazabilidad/features/FT-MIG-02-migracion-plantillas-atributos-listas.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.