Samir Boulahtit
c100d839f1
Implemented a complete shopping cart system with database persistence, replacing the previous stub implementation. The cart now properly stores items across sessions and follows the project's architecture patterns. Database Changes: - Add cart_items table with vendor_id, session_id, product_id, quantity, price_at_add - Create unique constraint to prevent duplicate items per session - Add indexes for session lookups and old cart cleanup - Run migration a2064e1dfcd4 to create cart_items table New Models & Schemas: - models/database/cart.py: CartItem SQLAlchemy model with relationships - models/schema/cart.py: Pydantic schemas for requests/responses * AddToCartRequest, UpdateCartItemRequest * CartResponse, CartItemResponse, CartOperationResponse, ClearCartResponse Exception Handling: - app/exceptions/cart.py: Cart-specific exceptions following project patterns * CartItemNotFoundException - item not found in cart * InsufficientInventoryForCartException - not enough inventory for cart operation * InvalidCartQuantityException - invalid quantity validation * CartValidationException - general cart validation * EmptyCartException - operations on empty cart * ProductNotAvailableForCartException - product unavailable - Updated app/exceptions/__init__.py to export cart exceptions Service Layer: - Implement cart_service.get_cart() - fetch cart from database with totals - Implement cart_service.add_to_cart() - create or update cart items with inventory checks - Implement cart_service.update_cart_item() - update quantity with validation - Implement cart_service.remove_from_cart() - delete cart item - Implement cart_service.clear_cart() - remove all items for session - Replace generic exceptions with cart-specific ones - Fix InsufficientInventoryException usage (was using wrong parameters) API Layer: - Update app/api/v1/shop/cart.py to use Pydantic schemas - Add response_model declarations to all endpoints - Add return type hints for type safety - Convert service dict responses to Pydantic models Features: - Cart items persist in database across server restarts - Inventory validation before adding/updating items - Price captured at time of adding to cart - Duplicate items update quantity instead of creating new entries - Full CRUD operations with proper error handling - Type-safe API with auto-generated OpenAPI documentation 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
81 lines
3.2 KiB
Python
81 lines
3.2 KiB
Python
# models/schema/cart.py
|
|
"""
|
|
Pydantic schemas for shopping cart operations.
|
|
"""
|
|
|
|
from datetime import datetime
|
|
from typing import List, Optional
|
|
from pydantic import BaseModel, Field, ConfigDict
|
|
|
|
|
|
# ============================================================================
|
|
# Request Schemas
|
|
# ============================================================================
|
|
|
|
class AddToCartRequest(BaseModel):
|
|
"""Request model for adding items to cart."""
|
|
product_id: int = Field(..., description="Product ID to add", gt=0)
|
|
quantity: int = Field(1, ge=1, description="Quantity to add")
|
|
|
|
|
|
class UpdateCartItemRequest(BaseModel):
|
|
"""Request model for updating cart item quantity."""
|
|
quantity: int = Field(..., ge=1, description="New quantity (must be >= 1)")
|
|
|
|
|
|
# ============================================================================
|
|
# Response Schemas
|
|
# ============================================================================
|
|
|
|
class CartItemResponse(BaseModel):
|
|
"""Response model for a single cart item."""
|
|
model_config = ConfigDict(from_attributes=True)
|
|
|
|
product_id: int = Field(..., description="Product ID")
|
|
product_name: str = Field(..., description="Product name")
|
|
quantity: int = Field(..., description="Quantity in cart")
|
|
price: float = Field(..., description="Price per unit when added to cart")
|
|
line_total: float = Field(..., description="Total price for this line (price * quantity)")
|
|
image_url: Optional[str] = Field(None, description="Product image URL")
|
|
|
|
|
|
class CartResponse(BaseModel):
|
|
"""Response model for shopping cart."""
|
|
vendor_id: int = Field(..., description="Vendor ID")
|
|
session_id: str = Field(..., description="Shopping session ID")
|
|
items: List[CartItemResponse] = Field(default_factory=list, description="Cart items")
|
|
subtotal: float = Field(..., description="Subtotal of all items")
|
|
total: float = Field(..., description="Total amount (currently same as subtotal)")
|
|
item_count: int = Field(..., description="Total number of items in cart")
|
|
|
|
@classmethod
|
|
def from_service_dict(cls, cart_dict: dict) -> "CartResponse":
|
|
"""
|
|
Create CartResponse from service layer dictionary.
|
|
|
|
This is a convenience method to convert the dictionary format
|
|
returned by cart_service into a proper Pydantic model.
|
|
"""
|
|
items = [CartItemResponse(**item) for item in cart_dict.get("items", [])]
|
|
return cls(
|
|
vendor_id=cart_dict["vendor_id"],
|
|
session_id=cart_dict["session_id"],
|
|
items=items,
|
|
subtotal=cart_dict["subtotal"],
|
|
total=cart_dict["total"],
|
|
item_count=len(items)
|
|
)
|
|
|
|
|
|
class CartOperationResponse(BaseModel):
|
|
"""Response model for cart operations (add, update, remove)."""
|
|
message: str = Field(..., description="Operation result message")
|
|
product_id: int = Field(..., description="Product ID affected")
|
|
quantity: Optional[int] = Field(None, description="New quantity (for add/update operations)")
|
|
|
|
|
|
class ClearCartResponse(BaseModel):
|
|
"""Response model for clearing cart."""
|
|
message: str = Field(..., description="Operation result message")
|
|
items_removed: int = Field(..., description="Number of items removed from cart")
|