FT-ACT-06 · Recepción del trabajo de Foro y control de edición…

En 30 segundos

Después de la toma, el estudio edita las fotos, las hereda a las tallas de cada color y captura atributos, título y descripción en el módulo del estudio de Vendor Center. Esta épica recibe ese trabajo en el PIM sin copias ni avisos dobles, cierra la tarea Foro y, mientras está abierta, no deja que nadie más edite el producto. También resuelve los regresos a Gobierno de Datos y el cambio de plantilla que pide el estudio.

• Módulo dueño: MS-12 Estudio fotográfico. También participan: MS-11 Activos digitales, MS-02 Producto, MS-13 Identidad y acceso, MS-14 Avisos y ayuda, MS-15 IA y enriquecimiento.
• Etapa 6 · Imágenes. Recibe de otras épicas y entrega «PE-7 · Imágenes listas».
• APIs: construye 2 y usa 23 que construyen otras épicas.
• Eventos: publica 7 y consume 5.

1. Dónde encaja

Recibe

Entrega

Tareas que abre o cierra: Foro: muestra, foto y enriquecimiento, Gobierno de Datos, Revisión del cambio, Corrección.

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 El estudio rechaza por plantilla equivocada

3.2 El estudio regresa el producto a Gobierno de Datos

3.3 Alguien intenta editar mientras el producto está en el estudio

4. Si algo sale mal

• El producto cambió desde que entró al estudio (por ejemplo, SAP cambió la marca). API-12-007 responde 409; la pantalla del capturista muestra el cambio (API-12-010), vuelve a pedir plantilla, listas y atributos, y el estudio cierra después.
• A una variante le falta la principal o a la captura le falta un dato del estudio. API-12-007 responde 422 con lo que falta por variante o por sección; Foro sigue abierta y nada se cierra a medias.
• MS-02 no puede cerrar Foro al recibir CAPTURE_COMPLETED porque algo cambió en el camino. MS-02 deja Foro abierta con el motivo y publica TASK_CHANGED; MS-14 avisa al jefe del estudio, que corrige y vuelve a finalizar.
• El estudio manda un SKU, una marca o una talla distintos de los del PIM. API-02-012 rechaza esos campos porque no son editables para el estudio y guarda el resto; el capturista ve cuáles se rechazaron.
• El comprador no atiende el cambio de plantilla. No se cancela nada: el reloj de MS-02 le recuerda con la antigüedad por pantalla y correo (API-14-005) y su bandeja lo ordena por días; el producto espera en el estudio.

5. APIs

Las que construye esta épica (2)

{
  "role": "EDITOR",
  "userId": "usr-7f20",
  "version": 4
}

{
  "success": true,
  "data": {
    "workId": "wrk-50a1",
    "assignee": {
      "userId": "usr-7f20",
      "role": "EDITOR"
    },
    "previous": null,
    "version": 5
  }
}

null

{
  "success": true,
  "data": {
    "work": {
      "workId": "wrk-50a1",
      "sku": "1000004812",
      "step": "EDITION",
      "state": "TO_EDIT",
      "version": 6
    },
    "colors": [
      {
        "colorCode": "AZUL",
        "variants": [
          {
            "variantId": "VAR-0004812-01",
            "sku": "1000004812",
            "size": "CH",
            "representative": true
          },
          {
            "variantId": "VAR-0004812-02",
            "sku": "1000004813",
            "size": "G"
          },
          {
            "variantId": "VAR-0004812-03",
            "sku": "1000004814",
            "size": "XG",
            "ownImages": 1
          }
        ],
        "photos": [
          {
            "assetId": "ast-7c21e4",
            "assetType": "PRINCIPAL",
            "position": 1,
            "status": "FROZEN",
            "originalUrl": "cdn.ejemplo.mx/trabajo/ast-7c21e4-original.jpg",
            "editedUrl": "cdn.ejemplo.mx/trabajo/ast-7c21e4.jpg"
          }
        ]
      }
    ],
    "video": null
  }
}

Las que usa y construye otra épica (23)

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-06-1. La edición y la captura del estudio se hacen en el módulo M6 de Vendor Center (F-PORTAL), por el BFF; el portal del estudio sólo opera lo físico. Las pantallas se escriben una sola vez, en R2, contra el BFF. Por qué: Decisiones 2, 19 y 20 del backend compartido que adopta ADR-12: sin compatibilidad, las pantallas de catálogo de Foro se reescriben de todos modos. Se apoya en ADR-12, PD-06.
• D-ACT-06-2. El estudio informa hechos y MS-02 cambia tareas: al finalizar, MS-12 revisa con MS-11 (principal por variante) y con el candado de MS-02 (API-02-101) que no falte nada, y avisa CAPTURE_COMPLETED; con ese evento MS-02 cierra Foro, marca que enriqueció el estudio y abre calidad. Por qué: Es la regla del motor (D-FLU-01-3): sólo MS-02 cambia estado y tareas. La revisión previa evita que el cierre falle en silencio. Se apoya en FT-FLU-01, PD-29.
• D-ACT-06-3. Mientras Foro está abierta, sólo el estudio escribe el producto y sus imágenes: el motor devuelve sólo lectura a los demás y cualquier escritura por el portal, la API de terceros, la carga masiva o Activos responde 423 LOCKED. No se notifica a Foro: se bloquea. Por qué: Decide PEN-141 y la mitad de PEN-51: bloquear en el dato cierra la doble captura que hoy sólo bloquea el portal, como ya hace Entrada Única en la carga de imágenes. Se apoya en PEN-141, PEN-51, RF-INT-08.
• D-ACT-06-4. Precedencia de los atributos de internet: antes de Foro queda lo del dueño del contenido; durante Foro el estudio llena lo vacío y puede cambiar valores del proveedor sólo en los grupos de campos de los que el motor lo hace dueño, y cada valor guarda su origen (FORO). SKU, marca y talla no los cambia el estudio. Por qué: Aplica la regla propuesta para PEN-167 (gana el dueño; la IA y Foro llenan o proponen) y RN-ENR-02; responde la otra mitad de PEN-51. Se apoya en PEN-167, PEN-51, FT-PRD-05.
• D-ACT-06-5. El estudio no copia fotos al bucket ni avisa a Entrada Única: el agente sube cada foto una vez a MS-11 y la herencia se aplica en MS-11. Se apagan LasImagenes2, AutForoWrite, process-forum-documents y el doble envío a P360; ninguno se construye. Por qué: Una foto de Foro llega hoy dos veces a P360 por dos caminos; con un registro único no hay nada que reconciliar. Se apoya en DUD-29, ADR-12.
• D-ACT-06-6. El regreso a Gobierno de Datos es la acción RETURN_TO_GDD del motor con un motivo de lista cerrada que arranca con los comentarios de hoy: color erróneo, grupo de artículo erróneo, sección errónea, marca errónea, dato maestro faltante y otro (con comentario). El trabajo del estudio queda en pausa hasta que se cierre. Por qué: Responde P-34 tal como lo propone el tablero: una lista corta en lugar de comentarios libres. Se apoya en P-34, FT-RAC-04.
• D-ACT-06-7. La plantilla equivocada se resuelve con una solicitud de cambio (API-02-310) que revisa el comprador dueño del SKU en su tarea Revisión del cambio, también antes de Aprobado; el comprador elige la plantilla y Gobierno de Datos la aplica. Sin plazo que cancele: el reloj de MS-02 sólo recuerda con la antigüedad. Por qué: S34: el comprador valida el cambio de plantilla y pide alertas, no un plazo fijo. Se usa la tarea que ya existe en lugar de crear otra. Se apoya en S34-PEN-03, FT-PRD-05.
• D-ACT-06-8. Al cambiar de plantilla, MS-02 conserva los datos maestros y los atributos que existen en las dos plantillas y vacía los demás; si el producto entró por Entrada Única abre Corrección al proveedor, y si Gobierno de Datos lo decide pide el prellenado a la IA desde la imagen. Por qué: Cumple S34-RN-05 sin perder lo que sigue valiendo; vaciar todo obligaría a capturar otra vez SKU y datos de SAP. Se apoya en S34-PEN-03, PEN-167.
• D-ACT-06-9. La etiqueta «En proceso Liverpool» la decide la tabla de MS-02 con el origen de la tarea: si QA regresa al estudio lo que éste enriqueció, el proveedor ve «En proceso Liverpool»; si va al proveedor, «Rechazada». Por qué: Es la regla de hoy (R-FLU-06) llevada a tareas, como ya la tomó FT-RAC-05. Se apoya en FT-RAC-05, PD-29.

Qué falta decidir

También siguen abiertos: PEN-51, Gobierno de Producto ratifica la precedencia de los atributos de internet entre el portal y el estudio; PEN-141, Ratificar el bloqueo en el dato (423) mientras el producto está en el estudio; S34-PEN-03, Confirmar que el comprador elige la plantilla destino y no sólo da el visto bueno.

Fuentes

1. [D] trazabilidad/features/FT-ACT-06-recepcion-foro-control-edicion.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.