FT-ACT-04 · Variantes a partir de imágenes y herencia de imágenes por…

En 30 segundos

En moda, todas las tallas de un mismo color se ven igual. Esta épica guarda una sola vez las fotos de cada color y las aplica a todas sus tallas, también a las que se agreguen después, sin pisar las fotos propias de una talla. El video vive en la familia, el portal avisa cuando las fotos de un SKU vienen de su color y el seller puede crear una variante por color a partir de sus fotos.

• Módulo dueño: MS-11 Activos digitales. También participan: MS-02 Producto.
• Etapa 6 · Imágenes. Recibe de otras épicas y entrega «PE-7 · Imágenes listas».
• APIs: construye 0 y usa 9 que construyen otras épicas.
• Eventos: publica 3 y consume 3.

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 Herencia de las fotos del estudio sin pisar las propias

3.2 Variantes a partir de las fotos

3.3 Video de la familia y SKU que hereda de su color

4. Si algo sale mal

• Una talla ya tiene fotos propias cuando llega la herencia. El plan las lista como conflicto y las conserva; sólo se pisan si quien edita confirma con overwriteOwn. Nada cambia sin esa decisión explícita.
• Ninguna variante de un color tiene fotos. Ese color no procede y la revisión de cumplimiento dice cuál falta. En creación basta una variante por color (Mercaderías y Suburbia); en aprobación cada variante necesita su principal, propia o heredada.
• Se desliga una variante o cambia su color. MS-02 relee la galería: la variante deja las fotos heredadas de su color anterior, toma las del nuevo y conserva las propias.
• Las proporciones cambian entre tallas (por ejemplo, toallas por tamaño). Quien edita apaga la herencia para ese producto o en la carga masiva, y carga las fotos por variante.
• Un color no trae foto al crear variantes desde fotos. La variante sí se crea, queda sin imagen y «no procede» hasta que tenga una principal propia o heredada; el portal se lo muestra al seller.

5. APIs

Las que construye esta épica (0)

Ninguna: todo lo que usa ya lo construye otra épica.

Las que usa y construye otra épica (9)

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-ACT-04-1. Cada activo se guarda una vez con su alcance: familia (el video), color (todas las tallas de ese color) o variante (propio). MS-11 resuelve la galería de cada variante: lo propio gana, lo que le falta se hereda de su color sin renombrar y el video viene de la familia. Por qué: Son los tres escenarios que dictó el negocio en S16 (sin herencia, total y parcial) y cumplen «guardadas una sola vez» de RF-IMG-06; la herencia deja de vivir sólo en el código de Foro. Se apoya en RF-IMG-06, PD-05, ADR-12.
• D-ACT-04-2. La herencia nunca pisa fotos propias sin una decisión explícita en el plan (overwriteOwn); en la carga masiva del estudio y por producto se puede apagar. Por qué: Es la regla de Foro de no planchar lo que ya existe y la opción que hoy tiene su carga masiva. Se apoya en RN-IMG-07, RF-IMG-07.
• D-ACT-04-3. Una imagen heredada cuenta igual que una propia para «procede» y para el mínimo de aprobación de la variante. Por qué: En S16 la variante cumple «ya sea heredadas o de manera individual»; exigir propias obligaría a repetir la misma foto en cada talla, que es lo que la herencia evita. Se apoya en RF-IMG-06, FT-ACT-01.
• D-ACT-04-4. Una talla nueva hereda sola: al ligarla, MS-02 relee la galería efectiva y copia las URL de su color; no se recaptura nada. Por qué: Las fotos son del color, no de la talla; así se cumple el criterio de la talla 21 sin trabajo de más. Se apoya en RF-IMG-06.
• D-ACT-04-5. Variantes desde fotos: la pantalla confirma los colores y pide a MS-02 una variante por color con API-02-014; un color sin foto sí crea su variante, que no procede hasta tener principal. Las tallas se capturan después. Por qué: Ligar y crear variantes es de MS-02; Activos sólo dice qué fotos tiene cada color. Responde la duda del color sin foto sin bloquear al seller. Se apoya en RF-PLA-18, RN-PLA-16.
• D-ACT-04-6. La bandera IncludeImageInheritance de P360 no se migra como dato del producto: la herencia queda en el alcance de cada activo, y la migración revisa los 2,693 artículos que la tienen. Por qué: Ningún código la usa hoy; mantenerla crearía una segunda forma de decir lo mismo. Se apoya en DUD-29.
• D-ACT-04-7. Mercaderías usa el mismo mecanismo (fotos primero, variantes después) cuando se resuelva PEN-81; no se crea una regla por negocio nueva hasta entonces. Por qué: La capacidad es la misma para cualquier negocio; lo que falta es la decisión de orden en Mercaderías. Se apoya en PEN-81.

Qué falta decidir

También siguen abiertos: PEN-81, Gobierno de Producto decide si Mercaderías también captura fotos antes que variantes.

Fuentes

1. [D] trazabilidad/features/FT-ACT-04-variantes-imagenes-herencia-color.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.