FT-ACT-01 · Tipos de activo digital y reglas de imágenes por…

En 30 segundos

Hoy cada sistema revisa las fotos a su manera: Entrada Única con su configuración, Foro con la suya y P360 con atributos de la plantilla. Esta épica deja un solo catálogo de tipos de activo (principal, detalle, video, certificado, boceto…) con su ficha técnica, su nombre y su posición, y una sola revisión de si un producto ya tiene las imágenes que pide su plantilla en su negocio. La usan el portal, el estudio y el motor de estados.

• Módulo dueño: MS-11 Activos digitales. También participan: MS-01 Catálogo, MS-02 Producto.
• Etapa 6 · Imágenes. Recibe «PE-C · Catálogo vigente», «PE-T · Usuario con permisos y bitácora» y entrega a otras épicas.
• APIs: construye 4 y usa 10 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 Un archivo que no cumple la ficha o rebasa el máximo

3.2 Boceto para un placeholder

3.3 La foto llega con su nombre y sufijo

4. Si algo sale mal

• Una plantilla no trae mínimos de imágenes. La revisión usa el mínimo de la ficha del tipo, con la principal siempre obligatoria, y lo dice en requirement.source. Gobierno de Producto ve la plantilla marcada para completar sus mínimos; ningún producto queda sin regla.
• Se quiere bajar el máximo de un tipo que ya usan productos publicados. El plan responde 422 BUSINESS_ERROR y dice cuántos activos quedarían fuera. Nada se borra solo: Gobierno de Producto decide antes de confirmar.
• La vista efectiva de MS-01 no responde. MS-11 usa su copia en caché mientras no venza (diez minutos, y se invalida con TEMPLATE_VIEW_CHANGED). Sin copia vigente responde 503 DEPENDENCY_UNAVAILABLE; el portal deja guardar el borrador, pero no enviar.
• Un producto de una marca exceptuada no trae principal. La revisión aplica la excepción registrada en MS-01 y la nombra en exceptionsApplied; el candado de envío no lo frena y la bitácora conserva qué excepción se usó.

5. APIs

Las que construye esta épica (4)

null

{
  "success": true,
  "data": {
    "catalogVersion": 12,
    "items": [
      {
        "code": "PRINCIPAL",
        "name": "Imagen principal",
        "status": "ACTIVE",
        "uploadedBy": [
          "PROVEEDOR",
          "SELLER",
          "ESTUDIO"
        ],
        "publishable": true,
        "scopes": [
          "VARIANT",
          "COLOR"
        ],
        "maxCount": 1,
        "positions": {
          "from": 1,
          "to": 1
        },
        "sheet": {
          "widthPx": 940,
          "heightPx": 1215,
          "dpi": 72,
          "formats": [
            "jpg"
          ],
          "maxBytes": 1048576
        },
        "naming": {
          "pattern": "{sku}",
          "suffixFrom": null,
          "suffixTo": null
        },
        "folder": "i/",
        "rejectionReasons": [
          {
            "code": "LOGO_VISIBLE",
            "type": "ESTETICA",
            "label": "Se ve un logotipo"
          },
          {
            "code": "FONDO_NO_BLANCO",
            "type": "TECNICA",
            "label": "El fondo no es blanco"
          }
        ]
      },
      {
        "code": "DETALLE",
        "name": "Imagen de detalle",
        "status": "ACTIVE",
        "uploadedBy": [
          "PROVEEDOR",
          "SELLER",
          "ESTUDIO"
        ],
        "publishable": true,
        "scopes": [
          "VARIANT",
          "COLOR"
        ],
        "maxCount": 19,
        "positions": {
          "from": 2,
          "to": 20
        },
        "sheet": {
          "widthPx": 940,
          "heightPx": 1215,
          "dpi": 72,
          "formats": [
            "jpg"
          ],
          "maxBytes": 1048576
        },
        "naming": {
          "pattern": "{sku}_{n}p",
          "suffixFrom": 1,
          "suffixTo": 19
        },
        "folder": "i/"
      },
      {
        "code": "VIDEO",
        "name": "Video del producto",
        "status": "ACTIVE",
        "uploadedBy": [
          "PROVEEDOR",
          "ESTUDIO"
        ],
        "publishable": true,
        "scopes": [
          "FAMILY"
        ],
        "maxCount": 1,
        "kinds": [
          "FILE",
          "LINK"
        ],
        "sheet": {
          "formats": [
            "mp4"
          ],
          "maxBytes": 8388608
        },
        "naming": {
          "pattern": "{genericSku}"
        },
        "folder": "v/"
      },
      {
        "code": "CERTIFICADO_SOSTENIBLE",
        "name": "Certificado sostenible",
        "status": "ACTIVE",
        "uploadedBy": [
          "PROVEEDOR"
        ],
        "publishable": false,
        "scopes": [
          "FAMILY"
        ],
        "maxCount": 1,
        "sheet": {
          "formats": [
            "pdf"
          ],
          "maxBytes": 10485760
        },
        "condition": {
          "attribute": "AE485",
          "requiredUnlessValueIn": [
            "0006"
          ]
        },
        "naming": null,
        "folder": "privado/d/"
      },
      {
        "code": "BOCETO",
        "name": "Boceto de placeholder",
        "status": "ACTIVE",
        "uploadedBy": [
          "PROVEEDOR"
        ],
        "publishable": false,
        "onlyFor": "PLACEHOLDER",
        "scopes": [
          "FAMILY",
          "COLOR"
        ],
        "maxCount": 5,
        "sheet": {
          "formats": [
            "jpg",
            "png"
          ],
          "maxBytes": 5242880
        },
        "naming": null,
        "folder": "privado/boceto/"
      }
    ],
    "page": 1,
    "size": 50,
    "total": 14
  }
}

{
  "code": "DETALLE",
  "version": 12,
  "changes": {
    "addRejectionReasons": [
      {
        "code": "SOMBRA_FUERTE",
        "type": "TECNICA",
        "label": "La sombra tapa el producto"
      }
    ]
  },
  "comment": "Motivo que pidió QA para rechazar fotos de detalle"
}

{
  "success": true,
  "data": {
    "planId": "pln-a51c07",
    "expiresAt": "2026-10-18T16:40:00Z",
    "impact": {
      "templatesUsingType": 4082,
      "assetsNoLongerCompliant": 0,
      "openRejectionsAffected": 0
    },
    "warnings": [],
    "applyUrl": "/api/v2/asset-plans/pln-a51c07/apply"
  }
}

{}

{
  "success": true,
  "data": {
    "requestId": "req-3d8f21",
    "status": "ACCEPTED",
    "receiptUrl": "/api/v2/asset-receipts/req-3d8f21"
  }
}

null

{
  "success": true,
  "data": {
    "productId": "PRD-0004812",
    "business": "MER",
    "template": "EU4-0412",
    "stage": "APPROVAL",
    "meets": false,
    "requirement": {
      "source": "vista efectiva de EU4-0412 para MER, versión 7",
      "byType": {
        "PRINCIPAL": {
          "min": 1,
          "max": 1
        },
        "DETALLE": {
          "min": 2,
          "max": 5
        },
        "ISOMETRICO": {
          "min": 1,
          "max": 5
        }
      }
    },
    "exceptionsApplied": [],
    "conditional": [
      {
        "assetType": "CERTIFICADO_SOSTENIBLE",
        "required": false,
        "because": "AE485 = 0006 (No aplica)"
      }
    ],
    "variants": [
      {
        "variantId": "VAR-0004812-01",
        "sku": "1000004812",
        "colorCode": "AZUL",
        "procede": true,
        "meets": true,
        "byType": [
          {
            "assetType": "PRINCIPAL",
            "have": 1,
            "own": 1,
            "inherited": 0,
            "missing": 0
          },
          {
            "assetType": "DETALLE",
            "have": 2,
            "own": 2,
            "inherited": 0,
            "missing": 0
          },
          {
            "assetType": "ISOMETRICO",
            "have": 1,
            "own": 1,
            "inherited": 0,
            "missing": 0
          }
        ]
      },
      {
        "variantId": "VAR-0004812-04",
        "sku": "1000004815",
        "colorCode": "ROJO",
        "procede": false,
        "meets": false,
        "byType": [
          {
            "assetType": "PRINCIPAL",
            "have": 0,
            "own": 0,
            "inherited": 0,
            "missing": 1
          },
          {
            "assetType": "DETALLE",
            "have": 1,
            "own": 1,
            "inherited": 0,
            "missing": 1
          },
          {
            "assetType": "ISOMETRICO",
            "have": 1,
            "own": 1,
            "inherited": 0,
            "missing": 0
          }
        ]
      }
    ],
    "missing": [
      {
        "variantId": "VAR-0004812-04",
        "assetType": "PRINCIPAL",
        "count": 1
      },
      {
        "variantId": "VAR-0004812-04",
        "assetType": "DETALLE",
        "count": 1
      }
    ]
  }
}

Las que usa y construye otra épica (10)

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-01-1. Un solo catálogo de tipos de activo en MS-11 (asset_types) con ficha técnica, quién carga, posiciones, nombre y sufijo, carpeta, si se publica y motivos de rechazo por tipo. Entrada Única deja su configuración de medios y Foro la suya: el portal, el estudio y los módulos leen API-11-001. Por qué: Hoy la misma regla vive en tres lugares (configuración de EU, texto de la plantilla y atributos de P360) y se contradice. Un dueño por dato. Se apoya en ADR-12, RF-IMG-10, DUD-29.
• D-ACT-01-2. El mínimo y el máximo por tipo son de la plantilla y su negocio: viven en los metadatos de la plantilla en MS-01 (FT-PLT-05) y se leen en la vista efectiva. MS-11 no guarda reglas por plantilla; sólo evalúa con API-11-014 contra lo que tiene cada variante. Por qué: La plantilla ya es de MS-01; copiar sus mínimos en MS-11 crearía una segunda fuente, que es justo el problema de NumberOf*Images contra Min/Max. Se apoya en FT-PLT-05, PD-05, ADR-12.
• D-ACT-01-3. Nombres y posiciones: principal = SKU sin sufijo; detalle de 1P a 19P (19 detalles y la principal suman 20 posiciones); isométrico 20 a 24; smos 25; ambientada 30 a 35; video con el SKU genérico; los documentos no se renombran. La posición 21 se rechaza. Por qué: Es lo que dictó el negocio en S16 y confirma el código; «hasta 20» son los detalles con la principal, no el rango de sufijos. Se apoya en PEN-52, PEN-159, RF-IMG-10.
• D-ACT-01-4. Dos etapas de cumplimiento: en creación, Mercaderías y Suburbia piden el mínimo en una variante por color y Marketplace una imagen; en aprobación, cada variante debe tener el mínimo con imágenes propias o heredadas de su color. La principal es obligatoria siempre. Por qué: Son los escenarios del Inventario L4 y del AS-IS de Marketplace; contar la heredada como propia evita exigir fotos repetidas (FT-ACT-04). Se apoya en RN-ALT-02, RN-ALT-04, FT-ACT-04.
• D-ACT-01-5. Las excepciones a la obligatoriedad de imágenes por marca, proveedor o negocio son una regla de captura de MS-01 (un tipo nuevo en governance_rules, administrado con API-01-017). MS-11 sólo la aplica y dice cuál usó. Por qué: Las reglas de captura ya son de Catálogo; una excepción en el código de MS-11 no se vería ni se auditaría. Se apoya en DEC-PLT-14, PD-01.
• D-ACT-01-6. Documentos y video: el certificado sostenible sólo es obligatorio si el atributo AE485 es distinto de «No aplica» (0006), con la liga atributo–activo de la plantilla; certificado y carta responsiva nunca se publican; el video vive en la familia y puede ser archivo o enlace (YouTube, InStore), con varios enlaces que la publicación manda separados por coma. Por qué: Es el comportamiento que el negocio describió en S16 y el que hoy lee la tienda en el campo Video. Se apoya en S16-RF-01, RF-IMG-10.
• D-ACT-01-7. El boceto es un tipo sólo para placeholders: no exige ficha técnica, vive en la zona privada y nunca se congela ni se publica. En una propuesta o un producto se rechaza. Por qué: Lo pide el comprador para ver un diseño que todavía no se fabrica, sin rebajar la regla de las fotos de producto. Se apoya en S36-RF-07.
• D-ACT-01-8. El catálogo arranca con los once tipos que maneja el negocio, el boceto y la guía de tallas que pide FT-PRD-07; contenido sindicado queda inactivo y NOM y manual Liverpool quedan en revisión hasta que se corrija la ERF 1.4. Por qué: Los tipos son datos, no código: se pueden prender o corregir sin desplegar, y la migración tiene destino para todos los grupos de P360. Se apoya en DUD-29, PD-01, FT-PRD-07.

Qué falta decidir

También siguen abiertos: PEN-159, Confirmar la ambientada como tipo aparte con sufijos 30 a 35; PEN-149, El equipo de Entrada Única confirma que hoy la principal es obligatoria al crear la propuesta.

Fuentes

1. [D] trazabilidad/features/FT-ACT-01-tipos-activo-reglas-imagenes.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.