FT-RAC-08 · Monitoreo de visibilidad y alertas de caída de SKUs…

En 30 segundos

El 23 de septiembre un seller pasó de 1,354 a 861 productos visibles y se enteró el negocio, no un sistema; las causas se buscaron a mano. Esta épica cuenta cada día, en productos, lo que se ve en la tienda por seller, por universo y del catálogo; lo compara con el día anterior y con una línea base; avisa sola cuando cae más del umbral, y deja bajar del seller a cada producto no visible con su causa.

• Módulo dueño: MS-04 Reportes. También participan: MS-08 Adaptadores de salida, MS-02 Producto, MS-07 Ingesta de archivos, MS-03 Migración y convivencia, MS-14 Avisos y ayuda.
• Etapa T · Transversal. Recibe «PE-9 · Publicado por canal» y entrega «PE-T · Usuario con permisos y bitácora».
• APIs: construye 4 y usa 12 que construyen otras épicas.
• Eventos: publica 1 y consume 1.

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 Cruzar con el universo de una incidencia

3.2 Comparar contra una línea base elegida

3.3 La pantalla de procesos

4. Si algo sale mal

• La foto de la tienda no llega. Ese día no se calcula: el conteo sale «sin dato», nunca cero visibles, la línea base no se mueve y Operación recibe la alerta técnica por MS-14.
• La caída es menor que el umbral. No alerta; el conteo queda en el historial y se ve en el diagnóstico.
• Un producto cumple todo y no está indexado. Queda como «sin indexar, causa desconocida» y Marketplace lo escala al equipo de la tienda con la lista.
• La tienda trae SKU que el PIM no tiene. No cuentan como visibles del seller; aparecen como INEXISTENTE en la conciliación de FT-RAC-04.
• Un módulo no responde a la pantalla de procesos. Su bloque sale «sin dato» y los demás se muestran; el reintento sólo se ofrece donde el dueño respondió.

5. APIs

Las que construye esta épica (4)

null

{
  "success": true,
  "data": {
    "scope": "SELLER",
    "sellerId": "SELLER-0001",
    "unit": "productos",
    "baseline": {
      "kind": "DATE",
      "date": "2026-09-22",
      "visible": 1354
    },
    "days": [
      {
        "date": "2026-09-21",
        "visible": 1352,
        "changePctVsBaseline": -0.1,
        "alert": false
      },
      {
        "date": "2026-09-23",
        "visible": 861,
        "changePctVsBaseline": -36.4,
        "alert": true,
        "alertId": "alr-0923-01"
      },
      {
        "date": "2026-09-24",
        "visible": 873,
        "changePctVsBaseline": -35.5,
        "alert": true
      },
      {
        "date": "2026-09-25",
        "visible": null,
        "state": "SIN_DATO",
        "reason": "No llegó la foto de la tienda"
      }
    ]
  }
}

null

{
  "success": true,
  "data": {
    "sellerId": "SELLER-0001",
    "date": "2026-09-24",
    "products": 1400,
    "visible": 873,
    "notVisible": 527,
    "byCause": {
      "SIN_CATEGORIA": 301,
      "SIN_RELACION_GENERICO_VARIANTE": 44,
      "SIN_OFERTA_ACTIVA": 62,
      "NO_PUBLICADO": 18,
      "SIN_INDEXAR_CAUSA_DESCONOCIDA": 102
    },
    "items": [
      {
        "productId": "PRD-0007710",
        "cause": "SIN_CATEGORIA",
        "detail": "La categoría catst-000812 no está en la tienda"
      },
      {
        "productId": "PRD-0007711",
        "cause": "SIN_INDEXAR_CAUSA_DESCONOCIDA",
        "detail": "Publicado con categoría y oferta activa; no aparece en el índice"
      }
    ],
    "page": 1,
    "size": 100,
    "total": 527
  }
}

null

{
  "success": true,
  "data": {
    "sapFiles": {
      "inProgress": 2,
      "failed": 1,
      "oldestFailedAt": "2026-10-18T09:12:00Z"
    },
    "uncertainBatches": [
      {
        "destination": "OMS",
        "batches": 3,
        "products": 214,
        "oldestAt": "2026-10-18T11:40:00Z"
      }
    ],
    "deliveryByChannel": [
      {
        "channel": "OMS",
        "pending": 120,
        "sent": 214,
        "error": 9,
        "oldestSentWithoutAckMinutes": 95
      },
      {
        "channel": "TIENDA",
        "pending": 40,
        "sent": 18,
        "error": 2,
        "oldestSentWithoutAckMinutes": 7
      }
    ],
    "coexistence": {
      "receiptCursorLagMinutes": 4,
      "lastSweepAt": "2026-10-18T14:00:00Z"
    },
    "actions": [
      {
        "label": "Reenviar lote incierto",
        "api": "API-08-002"
      },
      {
        "label": "Republicar productos en Error",
        "api": "API-02-039"
      },
      {
        "label": "Reprocesar archivo de SAP",
        "api": "API-07-002"
      }
    ]
  }
}

null

{
  "success": true,
  "data": {
    "business": null,
    "asOf": "2026-10-18T15:20:00Z",
    "channels": [
      {
        "channel": "OMS",
        "pending": 120,
        "sent": 214,
        "error": 9,
        "withdrawn": 3,
        "oldestSentWithoutAckAt": "2026-10-18T13:45:00Z"
      },
      {
        "channel": "TIENDA",
        "pending": 40,
        "sent": 18,
        "error": 2,
        "withdrawn": 0,
        "oldestSentWithoutAckAt": "2026-10-18T15:13:00Z"
      }
    ]
  }
}

Las que usa y construye otra épica (12)

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-08-1. La visibilidad sale de la foto diaria de la tienda (visible e indexado por sitio) y de Marketplace (ofertas activas), que trae MS-08 con la misma extracción que usa FT-RAC-04. Reportes no llama a la tienda. Por qué: La fuente de visibilidad vive en e-commerce y sólo los adaptadores hablan con los externos. Se apoya en PD-09, DUD-10, FT-RAC-04.
• D-RAC-08-2. Se cuenta en productos, no en variantes, por seller, por universo y del catálogo general, contra el día anterior y contra una línea base: por omisión la mediana de los últimos 7 días, y el analista puede fijar una fecha. Alerta por omisión con 8 % de caída por seller o universo y 6 % en el catálogo; los dos umbrales se cambian en la alerta. Por qué: Así lo acordó el taller (8 a 10 % y 6 %); la mediana evita que un día malo mueva la línea base, que no estaba decidida. Se apoya en PEN-124, RN-REP-02, RN-REP-01.
• D-RAC-08-3. La alerta la manda MS-14 en pantalla y por correo al equipo de Marketplace y a quien se suscriba, con el seller, el conteo, la línea base, el cambio en porcentaje y la liga al diagnóstico. Por qué: Hoy no hay canal; MS-14 ya es el único que avisa a personas. Se apoya en PEN-124, DEC-94.
• D-RAC-08-4. Cada producto no visible lleva una sola causa, en este orden: SIN_CATEGORIA, SIN_RELACION_GENERICO_VARIANTE, SIN_OFERTA_ACTIVA, NO_PUBLICADO y SIN_INDEXAR_CAUSA_DESCONOCIDA. Por qué: Son las condiciones de visibilidad de hoy; una sola causa por producto permite sumar y no contar dos veces. Se apoya en RN-PUB-01.
• D-RAC-08-5. La pantalla de procesos la compone el BFF (API-BFF-510) con lo de cada dueño: archivos de SAP (MS-07), lotes inciertos (MS-08), estado por canal (MS-02) y convivencia (MS-03). Reintentar es siempre la acción del dueño: republicar en MS-02, reenviar en MS-08 o reprocesar en MS-07. Los outbox de cada módulo los vigila la observabilidad de la plataforma. Por qué: La composición es del BFF y la decisión de reintentar es de quien tiene el dato; los outbox de hoy por destino ya no existen en el TO-BE. Se apoya en PD-30, ADR-12.
• D-RAC-08-6. Para cruzar con una incidencia, el analista registra su universo como lista en MS-02 y pide un exporte de tipo VISIBILITY_CROSS_CHECK; el resultado cuenta en productos cuántos faltantes están en ese universo y cuántos tienen otra causa. Por qué: Reusa la lista y el exporte que ya existen, sin una herramienta aparte. Se apoya en DEC-88, RN-REP-01.
• D-RAC-08-7. Si la foto no llega, el día queda «sin dato»: no se calculan cero visibles ni se mueve la línea base. Por qué: Un cero donde no se midió dispararía una alerta falsa y movería la base. Se apoya en RN-REP-02.

Qué falta decidir

También siguen abiertos: PEN-124, El área de reportes con el proponente ratifica los umbrales finales y el canal de la alerta; PEN-123, Confirmar si los 23 mil sin indexar son los mismos 23 mil sin categoría.

Fuentes

1. [D] trazabilidad/features/FT-RAC-08-monitoreo-visibilidad-alertas-caida.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.