mercadodevida/work/artifacts/INVENTORY-OPT/implementer.md

Implementer evidence — INVENTORY-OPT

Cambios realizados

1) Nuevo endpoint backend optimizado

Añadí GET /inventory/admin/overview en:

• project/src/modules/inventory/api/inventory.routes.ts

El endpoint:

• pagina server-side (limit, offset)
• busca por nombre, SKU o EAN
• aplica filtros server-side:
  • all
  • in_stock
  • low_stock
  • out_of_stock
  • expiring
  • low_margin
• devuelve filas ya enriquecidas con:
  • producto
  • variante
  • stock
  • precio
  • margen
  • caducidad
• devuelve además stats agregados para cards del dashboard de inventario

2) Eliminación del N+1 en admin inventory

Antes la página hacía:

• productsApi.list(limit=100)
• getVariants() por producto
• getAvailability() por fila
• getVariantPrice() por fila

Ahora la página consume una única llamada paginada:

• inventoryApi.listOverview(...)

3) UI admin paginada

Actualicé:

• project/apps/admin/src/app/(dashboard)/inventory/page.tsx
• project/apps/admin/src/lib/api-client.ts
• project/apps/admin/src/types/index.ts

La página ahora:

• usa búsqueda debounced server-side
• usa filtros server-side
• muestra paginación real
• sigue permitiendo editar inline:
  • stock
  • EAN
  • caducidad

4) Test de integración real PostgreSQL

Añadí:

• project/src/app/tests/inventory-admin-overview.itest.ts

Valida:

• paginación
• búsqueda por EAN
• filtro low_margin
• filtro expiring
• stats agregados

Validación

• cd project && npm run typecheck ✅
• cd project && npm run build ✅
• cd project/apps/admin && npm run build ✅
• cd project && TEST_DATABASE_URL=postgres://mdv:mdv_dev_only@localhost:5432/mercadodevida_test npx vitest run src/app/tests/inventory-admin-overview.itest.ts --no-file-parallelism ✅
• ./scripts/verify.sh ✅
• git diff --check ✅

Decisiones técnicas

• No introduje un módulo nuevo: reutilicé inventory.routes.ts porque el problema principal era de lectura agregada para admin.
• El inventario se optimiza a nivel de query y tráfico HTTP, que era el cuello de botella real para 10k+ productos.
• Mantuve edición inline en la UI para no romper el flujo actual del admin.

Deuda / siguiente paso

• Si el volumen sigue creciendo, el siguiente paso natural sería añadir índices específicos para búsquedas admin por nombre/SKU/EAN o una vista materializada/consulta especializada.
• La build del admin sigue mostrando warnings preexistentes de Turbopack sobre acceso dinámico a ficheros en uploads; no están relacionados con INVENTORY-OPT.