Files

ncoronel 172e14ae9b Squashed commit of the following:

commit 1dc4e29c69
Author: ncoronel <ncoronel@quo.ar>
Date:   Wed Aug 19 13:58:03 2026 -0300

    refactor(reservations): unify expiration command

commit 093e894cc3
Author: ncoronel <ncoronel@quo.ar>
Date:   Wed Aug 19 13:48:09 2026 -0300

    feat(cart): expire abandoned stock reservations

commit fdf0f3328f
Author: ncoronel <ncoronel@quo.ar>
Date:   Wed Aug 19 12:53:12 2026 -0300

    refactor(stock): implement expiration for stock reservations and add configuration

commit 8d6bcdcc43
Author: ncoronel <ncoronel@quo.ar>
Date:   Wed Aug 19 12:38:21 2026 -0300

    refactor(cart): invalidate payment on actual changes

commit 3206e293eb
Author: ncoronel <ncoronel@quo.ar>
Date:   Wed Aug 19 12:24:48 2026 -0300

    refactor(cart): own checkout item editing

commit aed99bd05e
Author: ncoronel <ncoronel@quo.ar>
Date:   Wed Aug 19 12:14:57 2026 -0300

    refactor(checkout): remove legacy purchase item reservations

commit f1649e0e4b
Author: ncoronel <ncoronel@quo.ar>
Date:   Wed Aug 19 12:06:29 2026 -0300

    refactor(checkout): materialize purchase items on confirmation

commit e6c4b40a37
Author: ncoronel <ncoronel@quo.ar>
Date:   Wed Aug 19 12:06:19 2026 -0300

    feat(inventory): add traceable cart stock reservations

2026-08-19 13:59:38 -03:00

1.9 KiB

Raw Blame History

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.
StockReservation atribuye cada unidad reservada a un ítem de carrito y, durante checkout, a una compra, con estados active, committed, released y expired.
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.
StockReservationService: mantiene el ledger de reservas sincronizado con Inventory.reserved_stock.
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.

1.9 KiB Raw Blame History