tbianchini/shopit-back
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
16bc657a31b30e99ddfa51c65e85b57d38156697
shopit-back/app/Domains/Cart/documentacion/README.md

1.4 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; expone la selección efectiva.

Servicios

  • CartService: obtiene el carrito, modifica ítems y administra la cookie del token invitado.
  • 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.