← Arquitectura por épica

Arquitectura · Configuración del catálogo

Arquitectura del Nuevo PIM por épica · corte del 18-oct-2026

Propuesta del TL: no sustituye la spec de cada épica

Actualizado el 18-oct-2026. Primera versión.

Qué responde. ¿Con qué reglas se catalogan los productos? Qué épicas resuelven esta parte del hilo, en qué orden y cómo se pasan el producto.

Para quién. Los equipos de las épicas de esta etapa y arquitectura.

Estado. [Propuesta] del TL del Nuevo PIM, 18-oct-2026, construida sobre ADR-12. La spec de cada épica dice el qué; estas páginas, el cómo.

Fuente. docs/arquitectura/por-epica/, generada con generar.py.

En 30 segundos

  • Recibe «PE-T · Usuario con permisos y bitácora» y entrega «PE-C · Catálogo vigente».
  • 8 épicas, en el orden en que conviene construirlas: FT-PLT-01, FT-PLT-02, FT-REF-01, FT-CAT-01, FT-CAT-06, FT-PLT-03, FT-PLT-04, FT-PLT-09.

Cómo se pasan el producto

PE-10 · Cambio aprobado

PE-9 · Publicado por canal

PE-C · Catálogo vigente

PE-T · Usuario con permisos y bitácora

FT-PLT-01
Fundamentos de gobierno de…

FT-PLT-02
Catálogo de atributos

FT-REF-01
Datos de referencia administrables

FT-CAT-01
Administración del árbol de…

FT-CAT-06
Agrupadores y corrección masiva…

FT-PLT-03
Listas de valores y modelo…

FT-PLT-04
Grupos de atributos y mínimos de…

FT-PLT-09
Carga masiva de configuración de…

Épicas de la etapa C

Las épicas

FT-PLT-01 · Fundamentos de gobierno de plantillas

Plantillas, atributos y listas las usan todos los portales y SAP, así que un cambio mal hecho afecta a miles de productos. Esta épica pone las reglas comunes de toda escritura del catálogo: cada objeto conserva su identificador para siempre, todo cambio queda como solicitud pendiente hasta que otra persona autorizada lo aprueba, y cada campo cambiado deja su antes y su después en la bitácora. Así nada llega a la captura sin control y siempre se sabe quién cambió qué.

DueñoRecibe deEntrega a
MS-01 CatálogoPE-T, FT-USR-02, FT-ARQ-02, FT-IA-04PE-C, FT-PLT-02, FT-PLT-05, FT-PLT-09, FT-PLT-07, FT-MIG-02

FT-PLT-02 · Catálogo de atributos

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.

DueñoRecibe deEntrega a
MS-01 CatálogoPE-T, FT-PLT-01PE-C, FT-PLT-03, FT-PLT-04, FT-PLT-06

FT-REF-01 · Datos de referencia administrables

Las reglas de alta, el archivo a SAP y la publicación consultan tablas que no son productos ni plantillas: tallas normalizadas, impuestos y márgenes, excepciones de publicación, proveedores exentos de EAN, la secuencia de variantes. Hoy se cargan con programas de un solo uso y se editan a mano. Esta épica las vuelve diccionarios administrables, cada uno con su llave, su área dueña y su bitácora, cargados tal cual desde P360, y deja los catálogos de SAP como copia de consulta que sólo escribe SAP.

DueñoRecibe deEntrega a
MS-01 CatálogoPE-T, FT-INT-04, FT-MIG-02PE-C, FT-PLT-07, FT-CAT-04, FT-CAT-01, FT-CAT-05, FT-PRD-03, FT-REF-02, FT-REF-03, FT-INT-03, FT-FLU-07, FT-INT-04

FT-CAT-01 · Administración del árbol de categorías web

El árbol de categorías web es el menú de la tienda: los productos cuelgan de sus hojas. Hoy mover o dar de baja una rama exige exportar, borrar y recargar archivos. Esta épica deja a Category administrarlo en el portal: crear con un asistente que valida nivel y mínimos, aprobar antes de que viaje, mover ramas, desligar sin borrar ni dejar productos huérfanos, cargar en masa con revisión previa y traer el árbol vivo de P360.

DueñoRecibe deEntrega a
MS-01 CatálogoPE-T, FT-USR-02, FT-ARQ-02, FT-REF-01, FT-CAT-02PE-C, FT-CAT-02, FT-CAT-03, FT-CAT-06, FT-RAC-07

FT-CAT-06 · Agrupadores y corrección masiva de categorías con…

Cuando miles de productos se quedan sin categoría, o con un agrupador distinto al de la tienda, dejan de verse. Esta épica corrige en masa sólo la categoría, sobre el universo completo y sin tocar otros campos; republica lo corregido para que la tienda lo vuelva a indexar; deja el rastro de cada corrida para revertirla, y avisa cuando la tienda descarta una actualización en lugar de perderla en silencio.

DueñoRecibe deEntrega a
MS-02 ProductoPE-9, PE-C, FT-CAT-02, FT-INT-01, FT-INT-07, FT-CAT-01, FT-RAC-04, FT-RAC-07, FT-RAC-08PE-10, FT-INT-01, FT-RAC-08

FT-PLT-03 · Listas de valores y modelo canónico con equivalencias por…

Muchos atributos se llenan eligiendo de una lista (colores, materiales, marcas). Esta épica gobierna esas listas: cada valor tiene un código único que es lo que guarda el producto, una etiqueta que se puede corregir sin tocar productos y la forma en que lo recibe cada sistema (la tienda, SAP, Marketplace). También resuelve qué pasa cuando el proveedor no encuentra su valor, cómo se retira un valor sin perder lo histórico y cómo se fusionan dos valores moviendo los productos.

DueñoRecibe deEntrega a
MS-01 CatálogoPE-T, FT-PLT-02, FT-INT-04PE-C, FT-PLT-06, FT-PLT-10, FT-PRD-07, FT-INT-07, FT-INT-04

FT-PLT-04 · Grupos de atributos y mínimos de información por sistema…

Cada sistema que recibe productos (SAP, la tienda, OMS, Marketplace, Señalización, el almacén de datos) necesita un juego distinto de atributos, y hoy esas listas viven escondidas en código y en siete tipos de «grupo» que no se hablan. Esta épica junta los atributos en grupos con tipo: por destino, por sección, por permiso o para la etapa de placeholder. Así se sabe qué viaja a cada sistema, cuál es su mínimo y qué negocios lo exigen, sin listas fijas en ningún adaptador.

DueñoRecibe deEntrega a
MS-01 CatálogoPE-T, FT-PLT-02PE-C, FT-PLT-06, FT-INT-01, FT-INT-02, FT-USR-02

FT-PLT-09 · Carga masiva de configuración de plantillas con…

Configurar miles de plantillas una por una es imposible, y hoy se hace con programas de un solo uso que no validan nada. Esta épica deja cargar la configuración del catálogo por archivo CSV o por API: el archivo se valida completo, renglón por renglón, sin tocar la base; si todo está bien, se aplica con la misma aprobación que la pantalla y con los mismos avisos. Sirve para cargar el nivel de cada atributo por negocio en muchas plantillas y para preparar un ambiente vacío.

DueñoRecibe deEntrega a
MS-01 CatálogoPE-T, FT-PLT-06, FT-PLT-01, FT-RAC-01PE-C

Fuentes

  1. [D] docs/arquitectura/por-epica/base/hilo.json: las etapas y los puntos de encuentro.
  2. [D] docs/arquitectura/por-epica/epicas/: la arquitectura de cada épica.