FT-RAC-04 · Consistencia entre sistemas y gobierno de datos proactivo

En 30 segundos

Hoy las diferencias entre el PIM, el portal y la tienda las descubre el negocio y se corrigen a mano: 23 mil productos sin categoría, registros que son producto en un sistema y SKU en otro. Esta épica concilia cada día, por variante, lo que tiene el PIM con lo que tienen la tienda y Marketplace, detecta los casos conocidos sin filtros de fecha, los prioriza por oferta activa y los manda a la bandeja de Gobierno de Datos, una tarea por caso y negocio.

• Módulo dueño: MS-04 Reportes. También participan: MS-08 Adaptadores de salida, MS-02 Producto, MS-11 Activos digitales, MS-14 Avisos y ayuda.
• Etapa 7 · Calidad y categoría. Recibe «PE-9 · Publicado por canal», «PE-6 · SKU asignado» y entrega «PE-8 · Aprobado».
• APIs: construye 6 y usa 8 que construyen otras épicas.
• Eventos: publica 2 y consume 3.

1. Dónde encaja

Recibe

Entrega

Tareas que abre o cierra: Gobierno de Datos.

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 Foro o Compras piden una corrección a Gobierno de Datos

3.2 Imagen en cuarentena

3.3 Configurar un caso y correr a mano

4. Si algo sale mal

• La foto de la tienda o de Marketplace no llega o llega incompleta. La corrida no compara: el resultado queda «sin dato» con la fecha de la última foto buena, nunca «cero diferencias», y Gobierno de Datos recibe el aviso.
• Un hallazgo ya tiene una tarea abierta de su caso y negocio. Se suma a esa tarea y se actualiza su conteo; no se abre otra.
• Un caso lleva 5 días hábiles sin atenderse. El motor pasa la tarea a la cola de Category, como se hace hoy con lo no resuelto, y lo avisa.
• Se quiere migrar o cortar un universo con diferencias. La corrida exige la confirmación escrita de Gobierno de Datos y la deja en la bitácora; sin ella, el universo no se da por bueno.
• Un producto es producto en la tienda y SKU en el PIM. Queda como TIPO_DISTINTO con el valor de cada sistema; Reportes no corrige nada, lo decide Gobierno de Datos con la herramienta del dueño.

5. APIs

Las que construye esta épica (6)

{
  "scope": {
    "business": "MKP",
    "sellerId": null
  },
  "cases": [
    "INEXISTENTE_EN_TIENDA",
    "SIN_CATEGORIA_EN_TIENDA",
    "TIPO_DISTINTO",
    "APROBADO_INCOMPLETO"
  ],
  "cutoff": "2026-10-18T06:00:00Z",
  "confirmForMigration": false
}

{
  "success": true,
  "data": {
    "jobId": "job-con-0418",
    "status": "ACCEPTED",
    "links": {
      "findings": "/api/v2/consistency/findings?runId=job-con-0418"
    }
  }
}

null

{
  "success": true,
  "data": {
    "summary": [
      {
        "case": "TIPO_DISTINTO",
        "business": "MKP",
        "open": 412,
        "withActiveOffer": 97,
        "taskId": "tsk-40112"
      }
    ],
    "items": [
      {
        "findingId": "fnd-88123",
        "case": "TIPO_DISTINTO",
        "objectType": "VARIANT",
        "sku": "1000004812",
        "productId": "PRD-0004812",
        "business": "MKP",
        "values": {
          "PIM": "SKU",
          "TIENDA": "PRODUCTO"
        },
        "activeOffer": true,
        "cutoff": "2026-10-18T06:00:00Z",
        "status": "OPEN",
        "taskId": "tsk-40112"
      }
    ],
    "page": 1,
    "size": 100,
    "total": 412
  }
}

null

{
  "success": true,
  "data": {
    "items": [
      {
        "monitorId": "mon-con-sin-categoria-mkp",
        "type": "CONSISTENCY_CASE",
        "case": "SIN_CATEGORIA_EN_TIENDA",
        "business": "MKP",
        "opensTask": true,
        "closeAfterDaysWithoutCases": 1,
        "escalateAfterWorkdays": 5,
        "version": 2
      },
      {
        "monitorId": "mon-con-cumplimiento-mer",
        "type": "CONSISTENCY_CASE",
        "case": "BAJO_CUMPLIMIENTO",
        "business": "MER",
        "thresholdPct": 95,
        "dailyListTo": "AREA:FORO",
        "opensTask": false,
        "version": 1
      },
      {
        "monitorId": "mon-vis-seller",
        "type": "VISIBILITY_DROP",
        "scope": "SELLER",
        "thresholdPct": 8,
        "baseline": "MEDIAN_7D",
        "schedule": "DIARIO 07:00",
        "notify": [
          "AREA:MARKETPLACE"
        ],
        "version": 3
      },
      {
        "monitorId": "mon-vis-catalogo",
        "type": "VISIBILITY_DROP",
        "scope": "CATALOG",
        "thresholdPct": 6,
        "baseline": "MEDIAN_7D",
        "schedule": "DIARIO 07:00",
        "notify": [
          "AREA:MARKETPLACE",
          "AREA:GOBIERNO_PRODUCTO"
        ],
        "version": 1
      }
    ]
  }
}

{
  "version": 3,
  "thresholdPct": 10,
  "baseline": "PREVIOUS_DAY",
  "notify": [
    "AREA:MARKETPLACE"
  ]
}

{
  "success": true,
  "data": {
    "monitorId": "mon-vis-seller",
    "version": 4,
    "effectiveFrom": "2026-10-19T07:00:00Z"
  }
}

{
  "destination": "TIENDA",
  "kind": "VARIANTS_VISIBILITY",
  "business": "MKP",
  "sellerId": null,
  "site": null,
  "asOf": "2026-10-18T06:00:00Z",
  "requestedBy": "MS-04"
}

{
  "success": true,
  "data": {
    "jobId": "job-ext-0418",
    "status": "ACCEPTED"
  }
}

{
  "action": "OPEN_OR_UPDATE",
  "type": "GOBIERNO_DE_DATOS",
  "origin": "REPORTS",
  "caseId": "SIN_CATEGORIA_EN_TIENDA",
  "business": "MKP",
  "findingsRef": "job-con-0418",
  "count": 23104,
  "sampleProductIds": [
    "PRD-0007710",
    "PRD-0007711"
  ]
}

{
  "success": true,
  "data": {
    "taskId": "tsk-40112",
    "status": "OPEN",
    "queue": "GOBIERNO_DATOS",
    "created": false,
    "count": 23104
  }
}

Las que usa y construye otra épica (8)

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-RAC-04-1. Las fotos de la tienda y de Marketplace las trae MS-08, que ya tiene la conexión con esos destinos: Reportes pide la extracción, MS-08 deja el archivo normalizado con su huella en el almacén y avisa con EXTRACTION_READY. Reportes nunca llama a la tienda ni a Marketplace. Por qué: Los externos sólo hablan con los adaptadores, y la lectura de e-commerce no tenía dueño. Se apoya en PD-09, DUD-10, ADR-12.
• D-RAC-04-2. La conciliación es diaria, por variante, sin filtro de fecha y con fecha de corte. Arranca con cuatro casos: INEXISTENTE_EN_TIENDA, SIN_CATEGORIA_EN_TIENDA, TIPO_DISTINTO (producto en uno y SKU en otro, con el valor de cada sistema) y APROBADO_INCOMPLETO (sin imagen principal, grupo de artículos o número de proveedor). Los casos son configuración de Reportes, no código. Por qué: El filtro de fechas dejó casos fuera; con un barrido completo el reporte sin categoría tiene que dar cero. Se apoya en RF-CAL-01, RF-CAL-02, DEC-96.
• D-RAC-04-3. Gobierno de Datos tiene una sola bandeja, la de tareas de MS-02: cada caso por negocio abre una tarea GOBIERNO_DE_DATOS con la liga a sus hallazgos, no una por producto, y se cierra sola después de un día sin casos. Por qué: Hoy se abre un ticket por escenario y negocio y se cierra tras monitorear; una tarea por producto inundaría la bandeja. Se apoya en RN-CAL-01, PEN-60.
• D-RAC-04-4. Qué resultados del SKU abren tarea: un SKU fallido (141) abre GOBIERNO_DE_DATOS con el error clasificado; uno exitoso sólo si es de la línea SFERA o si la IA dio confianza de 0.999517 o menos y falta grupo de artículos o sección; los demás no. La abre el motor de MS-02 al procesar el 122 y el 141. Por qué: Son los disparadores que ya funcionan hoy; una tarea para cada creación exitosa no sirve a nadie. Se apoya en PEN-60, DUD-32.
• D-RAC-04-5. Los hallazgos se separan por negocio y se ordenan por oferta activa, tomada de la foto de Marketplace o de la tienda; lo no resuelto en 5 días hábiles pasa a Category. Por qué: La remediación de hoy atiende primero lo que vende y escala a Category lo no resuelto. Se apoya en RN-CAL-02, DEC-75.
• D-RAC-04-6. Mientras no exista otra cuarentena, una imagen en cuarentena es una imagen que Activos (MS-11) rechazó: su ASSET_REJECTED aparece como alerta en el tablero de calidad. Por qué: La cuarentena no existe en código; el rechazo de Activos ya es un evento. Se apoya en DUD-35.
• D-RAC-04-7. Las gestiones de Data Maestra y lo que Foro detecta mal se piden dentro del PIM como solicitud de cambio de MS-02 (API-02-310), con el valor observado y el propuesto; la revisa Gobierno de Datos como dueño del dato y, al aprobar, el cambio queda aplicado con quién lo pidió, quién lo aprobó y cuándo. Por qué: Ya existe la solicitud de cambio con revisión por dueño; no hace falta otro formulario ni un ticket. Se apoya en PEN-95, DUD-32.
• D-RAC-04-8. El umbral de cumplimiento de Mercaderías (95 % de obligatorios) es un caso más de la conciliación; su listado diario se manda al equipo de Foro y no se mezcla con la meta de listas de valores ni con el 85/95 del score de Marketplace. Por qué: La historia lo pide como listado diario para trabajo manual, no como compuerta del flujo. Se apoya en RF-CAL-14.

Qué falta decidir

También siguen abiertos: PEN-60, Negocio ratifica qué resultados de la creación del SKU abren tarea de Gobierno de Datos (propuesta en D-RAC-04-4); PEN-95, Foro confirma si su menú para mandar datos a Gobierno de Datos llegó a producción.

Fuentes

1. [D] trazabilidad/features/FT-RAC-04-consistencia-sistemas-gobierno-datos-proactivo.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.