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

2.1 KiB

Raw Blame History

Dominio Cart

Propósito

Gestiona el carrito activo de un tenant tanto para visitantes como para usuarios autenticados.

Modelo

Cart: pertenece a un tenant y opcionalmente a un usuario; calcula el total y permite agregar, actualizar o quitar ítems.
CartItem: referencia un CatalogItem y, opcionalmente, una Variant; sólo persiste la selección y cantidad, y expone siempre los datos vigentes del catálogo.

Servicios

CartService: obtiene el carrito, modifica ítems y administra la cookie del token invitado.
ExpireCartReservationsService: libera las reservas vencidas de carritos activos y elimina los carritos que quedan vacíos.
GuestCartMergeService: incorpora el carrito invitado al usuario cuando este se autentica.

Endpoints

Bajo /tenants/{tenant:codigo}:

GET /cart.
POST /cart/items.
PATCH /cart/items/{cartItem}.
DELETE /cart/items/{cartItem}.

Contratos

AddCartItemRequest y UpdateCartItemQuantityRequest validan selección y cantidad. CartResource y CartItemResource estabilizan la respuesta pública. Cada ítem expone nombre, imagen y precio_unitario en la raíz, priorizando la variante seleccionada y usando el catálogo base como respaldo. La variante seleccionada se serializa en variant; las variantes alternativas no forman parte de la respuesta del carrito.

Dependencias y reglas

Depende de Catalog para productos y variantes, de Tenant para aislar datos y de Auth cuando existe usuario. Toda operación debe comprobar que carrito e ítem pertenecen al tenant actual.

Un carrito puede pasar a checkout. Las compras directas usan un carrito técnico con origin=direct_checkout; los carritos normales conservan origin=user y pueden restaurarse al cancelar o vencer la compra.

El comando unificado php artisan reservations:expire procesa primero las compras vencidas y luego las reservas activas sin compra cuyo expires_at haya vencido. Se ejecuta cada minuto mediante el scheduler, conserva la fila de reserva con estado expired, elimina el ítem abandonado y elimina lógicamente el carrito cuando queda vacío.

2.1 KiB Raw Blame History