Dominio Catalog

Propósito

Modela y publica la oferta comercial del tenant: productos, variantes, categorías, marcas, atributos, inventario, bundles y grupos destacados.

Modelo

CatalogItem es la raíz del producto y se relaciona con tenant, categoría, marca, inventario, variantes, atributos, adjuntos y grupos destacados.
Variant, ItemAttribute, Attribute, AttributeOption y VariantDefinition describen opciones comercializables.
Inventory administra stock disponible, reservado y comprado.
Category soporta jerarquía y categorías globales o propias del tenant.
FeaturedGroup y FeaturedItem organizan secciones destacadas.
BundleComponent representa los componentes de un paquete.

Servicios

CatalogService: alta, búsqueda, detalle, listado por categoría y eliminación.
CatalogInventoryService: consulta, reserva, libera y confirma inventario.
FeaturedGroupService: pagina los ítems destacados para la tienda.
OnTicketFeaturedGroupService: administra grupos destacados del panel para sitios de tickets.

Endpoints de tienda

Bajo /tenants/{tenant:codigo} se publican catálogo, búsqueda, categoría, detalle, alta de ítems y paginación de grupos destacados.

Endpoints administrativos

Bajo /v1/adminapp/tenant/featured-groups, con auth:sanctum y adminapp.tenant, se listan, crean y actualizan grupos destacados.

Dependencias y reglas

Usa Attachable para imágenes/archivos, Tenant para aislamiento y Ticket/Event para vigencia y fechas. Cart y Purchase consumen sus precios, variantes e inventario. Los cambios de stock deben pasar por CatalogInventoryService para conservar reservas y disponibilidad.