Módulo Web Catálogo

Módulo Catálogo

Objetivo

Explorar catálogo comercial real de BoostAPI sin resolver negocio en frontend.

Rutas reales

• /catalogo
• /catalogo/lead/:leadId

Contrato operativo

• El backend es dueño de:
  • precio efectivo
  • precio público vs especial
  • stock visible
  • media final
  • seller/agencia contextual
• Frontend:
  • renderiza la UI actual
  • usa response.products
  • pagina con pagination.nextItemsOffset y pagination.nextBundlesOffset
  • abre detalle con GET /api/catalogo/products/:catalogId

Flujo web

1. La página protegida carga context y la primera página de products en modo quote.
2. CatalogueClient conserva la UI actual y administra:
   • búsqueda real
   • filtros por supercategoría/categoría
   • scroll infinito
   • modal de detalle
   • carrito local visual
3. La capa browser consume solo el BFF local:
   • /api/catalogo/context
   • /api/catalogo/products
   • /api/catalogo/products/:catalogId
   • /api/catalogo/stock-preview

Reglas cerradas

• La grilla se renderiza con products; frontend no mezcla items y bundles.
• kind es metadata, no el eje principal de la UI.
• price ya viene resuelto y es el valor a mostrar.
• stock_display_value es el valor a pintar.
• Bundles ya usan el stock real calculado por backend.
• El stock afectado por el draft se sobrepone con POST /api/catalogo/stock-preview.
• El preview devuelve stock restante; el frontend mantiene el máximo editable como cantidad actual + stock restante.
• La fecha y el número junto al camión siguen hardcodeados en UI.
• No existe ya simulación de entrada Default / Client / Edit.

Componentes clave

• CatalogueClient: estado del módulo, caché en memoria, stock preview y orquestación.
• CatalogueHeader: shell visual existente para modo, seller, agencia y carrito.
• CatalogueControls: búsqueda, filtros y toggle de vista.
• ProductList: render grid/list e infinite scroll.
• ProductDetailModal: detalle on-demand por catalogId.
• QuotationDrawer: permanece local/visual en esta fase.