FT-RAC-06 · Métricas de tiempos por paso y clasificación de errores

En 30 segundos

Nadie sabe hoy dónde se atora un alta: no hay tiempos por paso, Compras aprueba sin ver y los errores no se clasifican por dónde se detectan. Esta épica hace que Reportes escuche los eventos del motor de estados, de SAP y de los canales, y guarde cuándo entra y sale cada producto de cada paso, cuántas veces vuelve y qué error tuvo. Con eso arma tarjetas de tiempos, de Compras, de errores y de publicación, donde «sin dato» nunca sale como cero.

• Módulo dueño: MS-04 Reportes. También participan: MS-02 Producto, MS-05 Auditoría, MS-07 Ingesta de archivos, MS-08 Adaptadores de salida.
• Etapa T · Transversal. Recibe de otras épicas y entrega «PE-T · Usuario con permisos y bitácora».
• APIs: construye 9 y usa 2 que construyen otras épicas.
• Eventos: publica 0 y consume 10.

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 El recorrido de un producto

3.2 Revisión de Compras y aprobadas sin revisión

3.3 Tablero a medida con diagnóstico

4. Si algo sale mal

• Un evento llega repetido o fuera de orden. Reportes lo descarta por su eventId y su versión; un paso cuya salida no ha llegado queda abierto, nunca se le inventa una fecha.
• Una tarjeta no tiene datos en el rango. Responde null con el motivo «sin dato», distinto de cero; si el cálculo falla, se conserva el último resultado bueno y se muestra el intento fallido.
• Un cálculo pasa de su presupuesto de tiempo. Queda FAILED con el motivo y no se relanza solo; el usuario lo pide otra vez y soporte puede encender el diagnóstico para ver por qué tardó.
• El producto viene de P360 y no hay historia previa. Sus pasos anteriores a la migración salen como «sin dato antes de la migración», o con la precisión de día si la historia migrada los trae.

5. APIs

Las que construye esta épica (9)

null

{
  "success": true,
  "data": {
    "items": [
      {
        "cardId": "COMPLETENESS",
        "title": "Completitud obligatoria por estado y negocio",
        "lastResult": {
          "computedAt": "2026-10-18T07:00:00Z",
          "from": null,
          "to": null
        },
        "lastAttempt": {
          "at": "2026-10-18T07:00:00Z",
          "status": "OK"
        }
      },
      {
        "cardId": "STEP_TIMES",
        "title": "Tiempo por paso",
        "lastResult": {
          "computedAt": "2026-10-18T07:00:00Z",
          "from": "2026-09-18",
          "to": "2026-10-18"
        },
        "lastAttempt": {
          "at": "2026-10-18T07:00:00Z",
          "status": "OK"
        }
      },
      {
        "cardId": "BUYER_REVIEW",
        "title": "Revisión de Compras",
        "lastResult": null,
        "state": "SIN_DATO",
        "lastAttempt": null
      }
    ]
  }
}

{
  "from": "2026-09-18",
  "to": "2026-10-18",
  "business": "MER"
}

{
  "success": true,
  "data": {
    "jobId": "job-card-5521",
    "status": "ACCEPTED",
    "links": {
      "result": "/api/v2/dashboards/fixed/STEP_TIMES/result"
    }
  }
}

null

{
  "success": true,
  "data": {
    "cardId": "STEP_TIMES",
    "from": "2026-09-18",
    "to": "2026-10-18",
    "business": "MER",
    "computedAt": "2026-10-18T15:21:40Z",
    "unit": "minutos",
    "rows": [
      {
        "step": "EN_REVISION · VISTO_BUENO_COMPRAS",
        "episodes": 412,
        "avg": 5230,
        "p50": 2880,
        "p90": 14400,
        "visitsAvg": 1.2
      },
      {
        "step": "CREACION_SKU · SKU_EN_SAP",
        "episodes": 388,
        "avg": 41,
        "p50": 18,
        "p90": 95,
        "visitsAvg": 1.0
      },
      {
        "step": "EN_ENRIQUECIMIENTO · QA_MANUAL",
        "episodes": 0,
        "avg": null,
        "p50": null,
        "p90": null,
        "state": "SIN_DATO",
        "reason": "Ningún producto pasó por QA manual en el rango"
      }
    ]
  }
}

null

{
  "success": true,
  "data": {
    "version": 4,
    "model": {
      "sets": [
        {
          "setId": "set-01",
          "name": "Completitud de vestidos",
          "cards": [
            {
              "cardId": "crd-11",
              "entity": "PRODUCT",
              "attribute": "MATERIAL",
              "metric": "NULLS",
              "n": 10,
              "filters": [
                {
                  "field": "Business",
                  "op": "EQ",
                  "value": "MER",
                  "negate": false
                },
                {
                  "field": "PrimaryProductTaxonomyGroup",
                  "op": "EQ",
                  "value": "EU4-0412",
                  "negate": false
                }
              ],
              "visual": "BARS"
            }
          ]
        }
      ]
    }
  }
}

{
  "version": 4,
  "model": {
    "sets": [
      {
        "setId": "set-01",
        "name": "Completitud de vestidos",
        "cards": [
          {
            "cardId": "crd-11",
            "entity": "PRODUCT",
            "attribute": "MATERIAL",
            "metric": "NULLS",
            "n": 10,
            "filters": [
              {
                "field": "Business",
                "op": "EQ",
                "value": "MER",
                "negate": false
              }
            ],
            "visual": "DONUT"
          }
        ]
      }
    ]
  }
}

{
  "success": true,
  "data": {
    "version": 5
  }
}

{
  "version": 5
}

{
  "success": true,
  "data": {
    "cardId": "crd-11",
    "metric": "NULLS",
    "universe": 6230,
    "withValue": 5118,
    "nulls": 1112,
    "nullsPct": 17.8486,
    "computedAt": "2026-10-18T15:30:12Z"
  }
}

{
  "enabled": true
}

{
  "success": true,
  "data": {
    "enabled": true,
    "until": "2026-10-18T17:30:00Z"
  }
}

null

{
  "success": true,
  "data": {
    "productId": "PRD-0004812",
    "business": "MER",
    "unit": "minutos",
    "steps": [
      {
        "step": "BORRADOR",
        "task": null,
        "enteredAt": "2026-10-08T15:00:00Z",
        "exitedAt": "2026-10-10T16:20:00Z",
        "minutes": 2960,
        "visit": 1
      },
      {
        "step": "EN_REVISION",
        "task": "VISTO_BUENO_COMPRAS",
        "enteredAt": "2026-10-10T16:20:00Z",
        "exitedAt": "2026-10-18T15:04:05Z",
        "minutes": 11444,
        "visit": 1
      },
      {
        "step": "BORRADOR",
        "task": "CORRECCION",
        "enteredAt": "2026-10-18T15:04:05Z",
        "exitedAt": null,
        "minutes": null,
        "visit": 2,
        "state": "ABIERTO"
      }
    ],
    "migratedHistory": {
      "source": "P360",
      "precision": "DAY",
      "until": null
    }
  }
}

null

{
  "success": true,
  "data": {
    "fixedCards": [
      {
        "cardId": "STEP_TIMES",
        "title": "Tiempo por paso",
        "computedAt": "2026-10-18T07:00:00Z",
        "state": "OK"
      },
      {
        "cardId": "BUYER_REVIEW",
        "title": "Revisión de Compras",
        "computedAt": null,
        "state": "SIN_DATO"
      }
    ],
    "customSets": [
      {
        "setId": "set-01",
        "name": "Completitud de vestidos",
        "cards": 3
      }
    ],
    "myTasks": [
      {
        "type": "VISTO_BUENO_COMPRAS",
        "open": 12,
        "oldestDays": 9
      }
    ],
    "unreadNotifications": 4,
    "visibilityAlerts": [
      {
        "scope": "SELLER",
        "sellerId": "SELLER-0001",
        "date": "2026-09-23",
        "changePct": -36.4
      }
    ]
  }
}

Las que usa y construye otra épica (2)

Su request y su response están en la página de la épica que la construye.

6. Eventos

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-06-1. Los tiempos se calculan con los eventos del motor (STATUS_CHANGED y TASK_CHANGED), nunca con fechas de modificación. Un paso es la estancia en un estado y en cada tarea abierta; se guardan entrada, salida, duración en minutos y número de visita. Lo anterior a la migración sale de la historia migrada de MS-05, con su precisión. Por qué: Hoy la duración de P360 no tiene unidad documentada y Omega calculaba con la historia de estado; la unidad explícita y las visitas son lo que pide H1. Se apoya en DUD-09, PD-18, RF-REP-02.
• D-RAC-06-2. Los puntos de detección son ocho: CAPTURA, REGLAS, VISTO_BUENO, SAP, IMAGENES, CALIDAD, PUBLICACION e INTEGRACION. Cada error trae su punto desde el evento que lo avisa (rechazo con su origen, error de SAP, rechazo o falta de acuse de un canal, imagen rechazada, renglón rechazado de una carga, calidad bajo el umbral). Los errores técnicos del portal los mide la observabilidad de la plataforma, no Reportes. Por qué: El catálogo de puntos no estaba en las fuentes; con el evento que ya existe, cada error se clasifica sin que nadie lo capture. Se apoya en RF-REP-02, DUD-31.
• D-RAC-06-3. Se conservan las 6 tarjetas fijas de Omega con sus definiciones y se suman 6: tiempo por paso, revisión de Compras, errores por punto de detección, de Aprobado a Publicado por canal, latencia de calculados y publicados enriquecidos. Un cálculo que falla conserva el último resultado bueno y no se relanza solo. Por qué: Las de Omega ya se usan; las nuevas son las métricas que piden las historias, en el mismo patrón de cálculo bajo demanda. Se apoya en RF-REP-03, PD-13, DUD-15.
• D-RAC-06-4. Cuenta como «aprobada sin revisión» la propuesta que Compras aceptó menos de 2 minutos después de tomar la tarea, o que Compras modificó en los 30 días siguientes a su visto bueno. Las cuatro métricas de Compras se ven por comprador y por sección. Por qué: El criterio no estaba definido; los dos supuestos son medibles con eventos que ya existen y Compras los puede ratificar. Se apoya en RF-REP-03.
• D-RAC-06-5. La latencia de un calculado se mide entre el cambio que lo dispara y su recálculo: MS-02 marca el evento del recálculo con el eventId que lo causó. El tiempo de Aprobado a Publicado se mide del STATUS_CHANGED a Aprobado al DELIVERY_RESULT de cada canal. Por qué: Sin la marca de causa no se puede saber qué recálculo corresponde a qué cambio; la meta de publicar en uno o dos minutos se verifica por canal. Se apoya en RF-REP-02, RF-PUB-01.
• D-RAC-06-6. La pantalla de tableros la compone el BFF (API-BFF-509): tarjetas de MS-04, las tareas abiertas de MS-02, los avisos de MS-14 y las alertas de visibilidad, y sólo muestra las tarjetas que el perfil puede ver. El cálculo vive en MS-04 y se hace sobre sus propios hechos, nunca sobre la base que opera. Por qué: La composición es del BFF por la decisión 19; calcular sobre los hechos evita los 14 minutos por tarjeta de Omega contra la base de operación. Se apoya en PD-30, PD-05.
• D-RAC-06-7. Los hechos de Reportes (report_facts) se arman sólo con eventos y no son fuente de ninguna operación: si falta un evento, el paso queda abierto o «sin dato», y nunca se corrige un producto con lo que diga un reporte. Por qué: Cada dato tiene un dueño; un reporte que se vuelve fuente es una copia que nadie concilia. Se apoya en ADR-12.

Qué falta decidir

Fuentes

1. [D] trazabilidad/features/FT-RAC-06-metricas-tiempos-paso-errores.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.