2.1 KiB
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 unCatalogItemy, opcionalmente, unaVariant; 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.