# app/modules/cart/routes/api/storefront.py """ Cart Module - Storefront API Routes Public endpoints for managing shopping cart in storefront. Uses store from middleware context (StoreContextMiddleware). No authentication required - uses session ID for cart tracking. Store Context: require_store_context() - detects store from URL/subdomain/domain """ import logging from fastapi import APIRouter, Body, Depends, Path from sqlalchemy.orm import Session from app.core.database import get_db from app.modules.cart.schemas import ( AddToCartRequest, CartOperationResponse, CartResponse, ClearCartResponse, UpdateCartItemRequest, ) from app.modules.cart.services import cart_service from app.modules.tenancy.models import Store from middleware.store_context import require_store_context router = APIRouter() logger = logging.getLogger(__name__) # ============================================================================ # CART ENDPOINTS # ============================================================================ @router.get("/cart/{session_id}", response_model=CartResponse) # public def get_cart( session_id: str = Path(..., description="Shopping session ID"), store: Store = Depends(require_store_context()), db: Session = Depends(get_db), ) -> CartResponse: """ Get shopping cart contents for current store. Store is automatically determined from request context (URL/subdomain/domain). No authentication required - uses session ID for cart tracking. Path Parameters: - session_id: Unique session identifier for the cart """ logger.info( f"[CART_STOREFRONT] get_cart for session {session_id}, store {store.id}", extra={ "store_id": store.id, "store_code": store.subdomain, "session_id": session_id, }, ) cart = cart_service.get_cart(db=db, store_id=store.id, session_id=session_id) logger.info( f"[CART_STOREFRONT] get_cart result: {len(cart.get('items', []))} items in cart", extra={ "session_id": session_id, "store_id": store.id, "item_count": len(cart.get("items", [])), "total": cart.get("total", 0), }, ) return CartResponse.from_service_dict(cart) @router.post("/cart/{session_id}/items", response_model=CartOperationResponse) # public def add_to_cart( session_id: str = Path(..., description="Shopping session ID"), cart_data: AddToCartRequest = Body(...), store: Store = Depends(require_store_context()), db: Session = Depends(get_db), ) -> CartOperationResponse: """ Add product to cart for current store. Store is automatically determined from request context (URL/subdomain/domain). No authentication required - uses session ID. Path Parameters: - session_id: Unique session identifier for the cart Request Body: - product_id: ID of product to add - quantity: Quantity to add (default: 1) """ logger.info( f"[CART_STOREFRONT] add_to_cart: product {cart_data.product_id}, qty {cart_data.quantity}, session {session_id}", extra={ "store_id": store.id, "store_code": store.subdomain, "session_id": session_id, "product_id": cart_data.product_id, "quantity": cart_data.quantity, }, ) result = cart_service.add_to_cart( db=db, store_id=store.id, session_id=session_id, product_id=cart_data.product_id, quantity=cart_data.quantity, ) db.commit() logger.info( f"[CART_STOREFRONT] add_to_cart result: {result}", extra={ "session_id": session_id, "result": result, }, ) return CartOperationResponse(**result) @router.put( "/cart/{session_id}/items/{product_id}", response_model=CartOperationResponse ) # public def update_cart_item( session_id: str = Path(..., description="Shopping session ID"), product_id: int = Path(..., description="Product ID", gt=0), cart_data: UpdateCartItemRequest = Body(...), store: Store = Depends(require_store_context()), db: Session = Depends(get_db), ) -> CartOperationResponse: """ Update cart item quantity for current store. Store is automatically determined from request context (URL/subdomain/domain). No authentication required - uses session ID. Path Parameters: - session_id: Unique session identifier for the cart - product_id: ID of product to update Request Body: - quantity: New quantity (must be >= 1) """ logger.debug( f"[CART_STOREFRONT] update_cart_item: product {product_id}, qty {cart_data.quantity}", extra={ "store_id": store.id, "store_code": store.subdomain, "session_id": session_id, "product_id": product_id, "quantity": cart_data.quantity, }, ) result = cart_service.update_cart_item( db=db, store_id=store.id, session_id=session_id, product_id=product_id, quantity=cart_data.quantity, ) db.commit() return CartOperationResponse(**result) @router.delete( "/cart/{session_id}/items/{product_id}", response_model=CartOperationResponse ) # public def remove_from_cart( session_id: str = Path(..., description="Shopping session ID"), product_id: int = Path(..., description="Product ID", gt=0), store: Store = Depends(require_store_context()), db: Session = Depends(get_db), ) -> CartOperationResponse: """ Remove item from cart for current store. Store is automatically determined from request context (URL/subdomain/domain). No authentication required - uses session ID. Path Parameters: - session_id: Unique session identifier for the cart - product_id: ID of product to remove """ logger.debug( f"[CART_STOREFRONT] remove_from_cart: product {product_id}", extra={ "store_id": store.id, "store_code": store.subdomain, "session_id": session_id, "product_id": product_id, }, ) result = cart_service.remove_from_cart( db=db, store_id=store.id, session_id=session_id, product_id=product_id ) db.commit() return CartOperationResponse(**result) @router.delete("/cart/{session_id}", response_model=ClearCartResponse) # public def clear_cart( session_id: str = Path(..., description="Shopping session ID"), store: Store = Depends(require_store_context()), db: Session = Depends(get_db), ) -> ClearCartResponse: """ Clear all items from cart for current store. Store is automatically determined from request context (URL/subdomain/domain). No authentication required - uses session ID. Path Parameters: - session_id: Unique session identifier for the cart """ logger.debug( f"[CART_STOREFRONT] clear_cart for session {session_id}", extra={ "store_id": store.id, "store_code": store.subdomain, "session_id": session_id, }, ) result = cart_service.clear_cart(db=db, store_id=store.id, session_id=session_id) db.commit() return ClearCartResponse(**result)