FT-PRD-06 · Bandeja de pendientes y depuración de borradores…

En 30 segundos

Al entrar al portal, cada persona ve en una sola bandeja lo que tiene pendiente: las altas que dejó a medias, con el paso en que se quedó, y las tareas que le tocan a ella o a su área, ordenadas por vencimiento. Los líderes reparten su cola sin pisarse, nadie pierde lo que hereda al cambiar de responsable y los borradores abandonados se depuran solos, con aviso antes y sin borrar su historia.

• Módulo dueño: MS-02 Producto. También participan: MS-13 Identidad y acceso, MS-14 Avisos y ayuda, MS-05 Auditoría.
• Etapa T · Transversal. Recibe «PE-1 · Propuesta en Borrador» y entrega a otras épicas.
• APIs: construye 8 y usa 7 que construyen otras épicas.
• Eventos: publica 3 y consume 3.

1. Dónde encaja

Recibe

Entrega

Cambios de estado que hace

Tareas que abre o cierra: Corrección, Carga de imagen, Visto bueno de Compras, Gobierno de Datos, Sección con dueño, QA manual, Category, Revisión del cambio, Repoblamiento.

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 Descartar un pendiente o depurarlo por abandono

3.2 Colas por etapa con dueño

3.3 Pendientes heredados al cambiar de responsable

4. Si algo sale mal

• Dos personas intentan tomar la misma tarea. Gana la primera confirmación; la segunda recibe 423 LOCKED o 409 VERSION_CONFLICT y la tarea deja de ofrecérsele. Un caso asignado no aparece en la bolsa de nadie más.
• La asignación incluye una tarea que ya se cerró o es de otra cola. No se asigna ninguna (todo o nada) y la vista previa dice cuáles fallaron y por qué; el líder corrige la selección y vuelve a pedir el plan.
• Un borrador de pre-compra lleva meses sin cambios. No lo depura la regla general: su vigencia es la de pre-compra, de unos diez meses, con el mismo aviso siete días antes. El reloj distingue el tipo de borrador por su origen.
• Producto no responde cuando se arma la bandeja. El BFF responde 503 y no muestra una bandeja a medias. Si sólo falla Identidad, la bandeja sale con los códigos de área en lugar de los nombres.
• Una persona deja su área con tareas asignadas. Sus tareas regresan solas a la bolsa del área y el líder las ve sin asignar; nada queda huérfano aunque nadie reasigne la cartera.

5. APIs

Las que construye esta épica (8)

null

{
  "success": true,
  "data": {
    "items": [
      {
        "kind": "TASK",
        "taskId": "tsk-31877",
        "type": "CORRECCION",
        "productId": "PRD-0004812",
        "productName": "Licuadora de 10 velocidades",
        "label": "Rechazada",
        "openedBy": {
          "areaName": "Compras Hogar"
        },
        "dueAt": "2026-12-17T15:04:05Z",
        "ageDays": 8,
        "inheritedFrom": null,
        "actions": [
          "OPEN"
        ]
      },
      {
        "kind": "DRAFT",
        "productId": "PRD-0004901",
        "productName": "Juego de sábanas matrimonial",
        "label": "Borrador",
        "stepToResume": 2,
        "stepsComplete": [
          1,
          3,
          4,
          5
        ],
        "lastActivityAt": "2026-10-12T18:40:00Z",
        "purgeAt": "2027-01-10T18:40:00Z",
        "actions": [
          "RESUME",
          "DISCARD"
        ]
      }
    ],
    "page": 1,
    "size": 20,
    "total": 4
  }
}

null

{
  "success": true,
  "data": {
    "items": [
      {
        "taskId": "tsk-60311",
        "type": "QA_MANUAL",
        "productId": "PRD-0005120",
        "productName": "Sartén antiadherente 28 cm",
        "priority": "HIGH",
        "dueAt": "2026-10-20T09:00:00Z",
        "reason": "La revisión con IA no alcanzó el umbral",
        "assignee": null
      },
      {
        "taskId": "tsk-60290",
        "type": "QA_MANUAL",
        "productId": "PRD-0005098",
        "productName": "Batidora de inmersión",
        "priority": "NORMAL",
        "dueAt": "2026-10-21T11:00:00Z",
        "reason": "La revisión con IA no alcanzó el umbral",
        "assignee": {
          "userId": "USR-0193",
          "displayName": "Analista de QA 03"
        }
      }
    ],
    "page": 1,
    "size": 100,
    "total": 342
  }
}

null

{
  "success": true,
  "data": {
    "items": [
      {
        "taskId": "tsk-31877",
        "type": "VISTO_BUENO_COMPRAS",
        "status": "OPEN",
        "productId": "PRD-0004812",
        "business": "MER",
        "productName": "Licuadora de 10 velocidades",
        "supplierId": "PROV-0001",
        "area": "COMPRAS-HOGAR",
        "assignee": null,
        "openedAt": "2026-10-10T16:20:00Z",
        "dueAt": "2026-11-09T16:20:00Z",
        "ageDays": 8
      }
    ],
    "page": 1,
    "size": 50,
    "total": 1
  }
}

null

{
  "success": true,
  "data": {
    "taskId": "tsk-52108",
    "type": "REVISION_DEL_CAMBIO",
    "status": "OPEN",
    "version": 3,
    "productId": "PRD-0004812",
    "business": "MER",
    "openedAt": "2026-10-18T15:04:07Z",
    "openedBy": {
      "area": "COMPRAS-HOGAR",
      "role": "COMPRAS"
    },
    "origin": {
      "kind": "CHANGE_REQUEST",
      "changeId": "chg-7a10",
      "requestId": "req-71d2aa"
    },
    "queue": "LOGISTICA",
    "assignee": null,
    "inheritedFrom": null,
    "priority": "NORMAL",
    "dueAt": "2026-10-25T15:04:07Z",
    "blocks": "La republicación",
    "returnsTo": "APROBADO",
    "changes": [
      {
        "attribute": "PESO_EMPAQUE",
        "label": "Peso del empaque",
        "published": "1.2 kg",
        "proposed": "1.4 kg",
        "owner": "LOGISTICA"
      }
    ],
    "allowedCommands": [
      "CLAIM",
      "APPROVE",
      "REJECT",
      "COMMENT"
    ]
  }
}

null

{
  "success": true,
  "data": {
    "items": [
      {
        "at": "2026-10-18T15:04:07Z",
        "command": "OPENED",
        "by": {
          "system": "MS-02"
        },
        "note": "Cambio de un campo cuyo dueño es Logística"
      },
      {
        "at": "2026-10-19T14:10:00Z",
        "command": "CLAIM",
        "by": {
          "userId": "USR-0193",
          "area": "LOGISTICA"
        }
      },
      {
        "at": "2026-10-19T14:25:00Z",
        "command": "COMMENT",
        "by": {
          "userId": "USR-0193",
          "area": "LOGISTICA"
        },
        "comment": "Se confirma con la ficha técnica del proveedor"
      }
    ],
    "page": 1,
    "size": 50,
    "total": 3
  }
}

null

{
  "success": true,
  "data": {
    "items": [
      {
        "taskId": "tsk-60311",
        "type": "QA_MANUAL",
        "productId": "PRD-0005120",
        "productName": "Sartén antiadherente 28 cm",
        "business": "MER",
        "priority": "HIGH",
        "openedAt": "2026-10-17T09:00:00Z",
        "dueAt": "2026-10-20T09:00:00Z",
        "assignee": null,
        "reason": "La revisión con IA no alcanzó el umbral"
      }
    ],
    "page": 1,
    "size": 100,
    "total": 342
  }
}

{
  "assignee": "USR-0193",
  "taskIds": [
    "tsk-60311",
    "tsk-60315"
  ],
  "fromAssignee": null
}

{
  "success": true,
  "data": {
    "planId": "pln-3c77e1",
    "expiresAt": "2026-10-18T15:14:05Z",
    "requested": 2,
    "eligible": 2,
    "outOfState": 0,
    "notFound": 0,
    "assignedToOthers": 0,
    "applyUrl": "/api/v2/product-plans/pln-3c77e1/apply"
  }
}

null

{
  "success": true,
  "data": {
    "items": [
      {
        "taskId": "tsk-60311",
        "type": "QA_MANUAL",
        "productId": "PRD-0005120",
        "productName": "Sartén antiadherente 28 cm",
        "priority": "HIGH",
        "dueAt": "2026-10-20T09:00:00Z",
        "assignedAt": "2026-10-18T16:00:00Z",
        "inheritedFrom": null
      }
    ],
    "page": 1,
    "size": 50,
    "total": 20
  }
}

Las que usa y construye otra épica (7)

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-PRD-06-1. La bandeja es una composición del BFF (API-BFF-301 y API-BFF-302) sobre las tareas de MS-02, la etiqueta y el paso que calcula Producto y los nombres del directorio. MS-02 no tiene un endpoint de pantalla y el BFF no guarda ni decide nada. Hay una sola bandeja por perfil en la pantalla de inicio, sin otro tablero. Por qué: Las pantallas que juntan varios módulos van en el BFF (decisión 19 que adopta ADR-12) y así el endpoint de tareas sirve igual a todas las bandejas. Se apoya en ADR-12, P-03.
• D-PRD-06-2. Borrar y descartar son la misma acción, DISCARD: el borrador pasa a Cancelado (T11) con el motivo que da el usuario, sus EAN se liberan en la misma transacción y queda en su historial. Nada se borra físicamente. Por qué: Hoy se eliminan propuestas sin aviso y el proveedor regresa semanas después; el taller pidió avisar e historizar lo que se elimina. Se apoya en DEC-23, RF-ALT-09.
• D-PRD-06-3. La depuración la hace el reloj único de MS-02 con los plazos de la tabla DEADLINES: un borrador sin actividad vence a los 90 días y uno de pre-compra a los 300, con aviso siete días antes; al vencer, pasa a Cancelado con el motivo «Borrador abandonado» y el proveedor recibe aviso. Por qué: Concilia la depuración de 30 días que tenía P360, que no se sabe si corre, con la pre-compra de unos nueve meses; son los plazos que fijó FT-PRD-04 y se cambian sin desplegar código. Se apoya en DUD-24, RF-ALT-08, FT-PRD-04.
• D-PRD-06-4. Cada etapa con trabajo humano tiene una cola con líder: la asignación es todo o nada, una tarea asignada no se ofrece a nadie más y un resultado automático que no cumple (por ejemplo, la IA bajo el umbral) entra solo a la cola de su etapa. Por qué: Es lo que pide la cola con asignación por etapa y lo que ya hacen hoy las bolsas de QA, Category y Repoblamiento. Se apoya en RF-CAL-15, PD-29.
• D-PRD-06-5. Al salir alguien de su área (USER_CHANGED de MS-13), sus tareas regresan a la bolsa del área. El líder reasigna la cartera completa con API-02-037 y cada tarea guarda de quién se heredó y su fecha original de apertura, para no perder antigüedad. Por qué: Los pendientes muertos que nadie ve son un dolor de hoy; la antigüedad original evita que lo heredado parezca nuevo. Se apoya en PD-29, ADR-12.
• D-PRD-06-6. El aviso de pendientes es un resumen diario en pantalla y por correo, según las preferencias de cada usuario en MS-14, con lo que lleva más días sin movimiento; no hay un tablero aparte. Por qué: Responde la duda de canal (notificación o tablero) con las dos, a elección del usuario, y reusa lo que ya hace Entrada Única en su inicio. Se apoya en PEN-17, P-03.

Qué falta decidir

También siguen abiertos: PEN-17, Validar con UX que el resumen diario en pantalla y correo es suficiente para el seller.

Fuentes

1. [D] trazabilidad/features/FT-PRD-06-bandeja-pendientes-depuracion-borradores.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.