Cart Model

Shopping cart for users and guest sessions.

Overview

The Cart model represents a shopping cart for both authenticated users and guest sessions. It supports multi-tenancy, prescription management, and advanced cart operations.

Attributes

Attribute	Type	Description
id	int	Primary key
uuid	string	Unique identifier for routing
user_id	int	Foreign key to User (nullable)
carrier_id	int	Foreign key to Carrier
member_id	int	Foreign key to Member (nullable)
session_id	string	Guest session identifier (nullable)
status	string	Cart status (active, completed, abandoned)
expires_at	timestamp	Cart expiration timestamp
created_at	timestamp	Creation timestamp
updated_at	timestamp	Last update timestamp

Relationships

Belongs To

• belongsTo(User) - Associated user
• belongsTo(Carrier) - Associated carrier
• belongsTo(Member) - Associated member

Has Many

• hasMany(CartItem) - Cart items

Key Features

Multi-Tenancy

• Associated with a specific carrier
• Supports both user and guest carts

Cart Management

• Add, remove, update, and clear items
• Cart expiration and status management
• Guest to user cart conversion

Prescription Management

• Detects prescription items
• Tracks prescription status for each item

Price & Inventory

• Total calculations and formatting
• Inventory checks on add/update

Routing & UUIDs

• UUID-based routing for security
• Route key using UUID

Usage Examples

Creating a Cart

$cart = Cart::create([
    'uuid' => Str::uuid(),
    'user_id' => $user->id,
    'carrier_id' => $carrier->id,
    'status' => 'active',
    'expires_at' => now()->addDays(7)
]);

Adding Items

$cart->addItem($product, 2);

Removing Items

$cart->removeItem($product);

Updating Quantity

$cart->updateQuantity($product, 5);

Clearing the Cart

$cart->clear();

Getting Cart Items

$items = $cart->cartItems;

Calculating Totals

$total = $cart->total;
$formattedTotal = $cart->formatted_total;

Scopes

Active Carts

Cart::where('status', 'active')->get();

Non-Expired Carts

Cart::where('expires_at', '>', now())->get();

Route Key

The Cart model uses the uuid as the route key for secure routing:

// Route model binding uses UUID
Route::get('/carts/{cart}', function (Cart $cart) {
    return $cart;
});

Related Models

• User - Associated user
• Carrier - Associated carrier
• Member - Associated member
• CartItem - Cart items