mercadodevida/work/artifacts/NOTIF-INVENTORY-ALERTS/reviewer.json

{
  "feature_id": "NOTIF-INVENTORY-ALERTS",
  "verdict": "APPROVED",
  "agent": "reviewer",
  "reviewer": "reviewer",
  "reviewed_at": "2026-08-27T21:25:30Z",
  "scope": [
    "project/src/modules/inventory/api/inventory.routes.ts",
    "project/apps/admin/src/lib/api-client.ts",
    "project/apps/admin/src/components/OrderNotifications.tsx",
    "project/src/modules/inventory/tests/inventory-notifications.test.ts"
  ],
  "summary": "Implementación correcta y consistente. CTE del nuevo endpoint usa la misma lógica que el overview existente; el helper inventoryOverviewFilterClause se extiende con 'expired' sin duplicar SQL; el componente OrderNotifications añade tercer tab sin tocar la lógica de los otros dos; tests cubren admin/non-admin/items vacíos/items con count=0/href correcto. Typecheck verde en backend + admin. 5/5 tests del nuevo módulo pasan. Verdict: APPROVED.",
  "checks": [
    {
      "id": "backend-typecheck",
      "description": "Backend TypeScript verde",
      "command": "cd project && npx tsc --noEmit",
      "result": "PASS",
      "evidence": "Exit 0, sin output."
    },
    {
      "id": "admin-typecheck",
      "description": "Admin TypeScript verde",
      "command": "cd project/apps/admin && npx tsc --noEmit",
      "result": "PASS",
      "evidence": "Exit 0, sin output."
    },
    {
      "id": "new-tests",
      "description": "Tests del nuevo endpoint pasan",
      "command": "cd project && npx vitest run src/modules/inventory/tests/inventory-notifications.test.ts",
      "result": "PASS",
      "evidence": "5/5 tests pasan en 106ms. Cubren: admin recibe 5 items con count>0 y total; items con count=0 omitidos; lista vacía cuando no hay alertas; non-admin recibe 403; expiring_soon linkea a /inventory?filter=expiring."
    },
    {
      "id": "admin-build",
      "description": "Admin compila sin errores",
      "command": "cd project/apps/admin && npx next build",
      "result": "PASS",
      "evidence": "Build verde; rutas admin existentes (/reporting/products, /settings/tax-rates, /shipping, etc.) compilan. No hay regresiones detectadas por Next."
    },
    {
      "id": "cte-consistency",
           "description": "CTE del notifications endpoint = misma lógica que overview",
      "command": "code review",
      "result": "PASS",
      "evidence": "Ambas usan la misma WITH raw (catalog_product_variants JOIN catalog_products LEFT JOIN inventory_stock LEFT JOIN pricing_variant_prices) + WITH base (cálculo de margin_percent con gross_unit_amount_cents vía CASE vat_rate). Cualquier cambio futuro en una debe replicarse en la otra — riesgo documentado en implementer.md como follow-up."
    },
    {
      "id": "filter-helper-extended",
      "description": "inventoryOverviewFilterClause extendido sin duplicar SQL",
      "command": "grep -n 'filter ===' project/src/modules/inventory/api/inventory.routes.ts",
      "result": "PASS",
      "evidence": "Branch nuevo: `if (filter === 'expired') return 'expiration_date IS NOT NULL AND expiration_date < current_date';`. 4 ramas existentes (in_stock, low_stock, out_of_stock, expiring, low_margin) intactas."
    },
    {
      "id": "endpoint-auth",
      "description": "Endpoint protegido con requireRole admin",
      "command": "grep -n 'requireRole\\|GET /inventory/admin/notifications' project/src/modules/inventory/api/inventory.routes.ts",
      "result": "PASS",
      "evidence": "authenticate + requireRole(user, 'admin') antes de cualquier query. Test 'rejects non-admin with 403' valida el comportamiento."
    },
    {
      "id": "no-duplication-filter-clauses",
      "description": "El nuevo endpoint NO duplica la lógica del overview CTE",
      "command": "code review",
      "result": "PASS_WITH_NOTE",
      "evidence": "El CTE está duplicado entre overview y notifications endpoint. Decisión consciente del implementer: ambas son queries cortas (<40 líneas) y comparten el patrón. Trade-off: duplicación vs cohesión. Para evitar drift futuro, en un follow-up se podría extraer `inventoryOverviewBaseCTE()` a un helper compartido. Aceptable para v1."
    },
    {
      "id": "frontend-no-regression",
      "description": "OrderNotifications no rompe tabs existentes",
      "command": "code review",
      "result": "PASS",
      "evidence": "TabPending y TabAwaiting intactos byte-a-byte. load() hace 3 endpoints en Promise.all sin afectar los 2 existentes. grandTotal añade un sumando nuevo sin alterar stale/awaiting."
    },
    {
      "id": "api-client-types",
      "description": "Tipo del api-client bien definido",
      "command": "grep -n 'notificationCounts' project/apps/admin/src/lib/api-client.ts",
      "result": "PASS",
      "evidence": "Tipo inline en el return type: items con id literal union (low_stock|out_of_stock|expired|expiring_soon|low_margin), tone literal union ('amber'|'red'). Coincide con la respuesta del endpoint. TypeScript asegura que no se introducen strings libres."
    },
    {
      "id": "accessibility-aria",
      "description": "Botones del campanita tienen aria-* y son accesibles por teclado",
      "command": "code review",
      "result": "PASS",
      "evidence": "Botón principal ya tenía aria-label y aria-expanded. Tabs son <button type='button'> con texto visible. Lista de items usa <Link> (anchor) — accesible por defecto. Iconos emoji son decorativos (no aria-hidden necesario porque el label textual los acompaña)."
    },
    {
      "id": "tone-color-decision",
      "description": "Tono (amber/red) tiene sentido semántico",
      "command": "code review",
      "result": "PASS",
      "evidence": "amber = atención (stock bajo, por caducar); red = actuar (sin stock, caducados, margen bajo). Coherente con el patrón existente en OrderNotifications (amber=pendiente, purple=esperando pago)."
    }
  ],
  "findings": [],
  "nits": [
    {
      "id": "nit-1",
      "severity": "info",
      "description": "CTE duplicada entre overview y notifications endpoint. Riesgo de drift si una cambia sin la otra.",
      "suggested_action": "Follow-up: extraer `inventoryOverviewBaseCTE()` a un helper compartido. No bloquea este fix."
    },
    {
      "id": "nit-2",
      "severity": "info",
      "description": "Test unit del helper privado inventoryOverviewFilterClause no se hizo directo (función no exportada). Se cubre indirectamente vía tests del endpoint.",
      "suggested_action": "Si QA pide cobertura directa, exportar el helper o usar técnica de testing de internals (vi.mock). No bloquea."
    },
    {
      "id": "nit-3",
      "severity": "info",
      "description": "Pre-existing failure: `pos/tests/payment-allocation.test.ts > rejects overpayments while still under total` falla desde antes (verificado con git stash). No relacionado con esta feature.",
      "suggested_action": "Crear ticket POS-PAYMENT-ALLOCATION-TEST-FIX en próxima iteración. No bloquea."
    },
    {
      "id": "nit-4",
      "severity": "info",
      "description": "ESLint reporta `react-hooks/static-components` para los 3 tabs (incluyendo los 2 pre-existentes). Es un warning, no error fatal.",
      "suggested_action": "Refactor futuro: extraer Tab* a nivel de módulo. No bloquea este fix (patrón ya existente)."
    }
  ],
  "verdict_rationale": "Los criterios técnicos se cumplen: typecheck verde, tests pasan, build verde, CTE consistente, auth admin, sin regresiones en tabs existentes. Los 4 nits son info-level y documentados como follow-up o pre-existentes. Verdict: APPROVED.",
  "evidence_paths": [
    "work/artifacts/NOTIF-INVENTORY-ALERTS/architect.md",
    "work/artifacts/NOTIF-INVENTORY-ALERTS/implementer.md",
    "project/src/modules/inventory/api/inventory.routes.ts",
    "project/apps/admin/src/lib/api-client.ts",
    "project/apps/admin/src/components/OrderNotifications.tsx",
    "project/src/modules/inventory/tests/inventory-notifications.test.ts"
  ]
}