# app/api/v1/shop/pages.py """ Shop/Customer HTML page routes using Jinja2 templates. These routes serve the public-facing shop interface for customers. Authentication required only for account pages. Routes: - GET /shop/ → Shop homepage / product catalog - GET /shop/products → Product catalog - GET /shop/products/{id} → Product detail page - GET /shop/categories/{slug} → Category products - GET /shop/cart → Shopping cart - GET /shop/checkout → Checkout process - GET /shop/account/register → Customer registration - GET /shop/account/login → Customer login - GET /shop/account/dashboard → Customer dashboard (auth required) - GET /shop/account/orders → Order history (auth required) - GET /shop/account/orders/{id} → Order detail (auth required) - GET /shop/account/profile → Customer profile (auth required) - GET /shop/account/addresses → Address management (auth required) """ from fastapi import APIRouter, Request, Depends, Path from fastapi.responses import HTMLResponse, RedirectResponse from fastapi.templating import Jinja2Templates from sqlalchemy.orm import Session from app.api.deps import get_current_customer_user, get_db from models.database.user import User router = APIRouter() templates = Jinja2Templates(directory="app/templates") # ============================================================================ # PUBLIC SHOP ROUTES (No Authentication Required) # ============================================================================ @router.get("/shop/", response_class=HTMLResponse, include_in_schema=False) @router.get("/shop/products", response_class=HTMLResponse, include_in_schema=False) async def shop_products_page(request: Request): """ Render shop homepage / product catalog. Shows featured products and categories. """ return templates.TemplateResponse( "shop/products.html", { "request": request, } ) @router.get("/shop/products/{product_id}", response_class=HTMLResponse, include_in_schema=False) async def shop_product_detail_page( request: Request, product_id: int = Path(..., description="Product ID") ): """ Render product detail page. Shows product information, images, reviews, and buy options. """ return templates.TemplateResponse( "shop/product.html", { "request": request, "product_id": product_id, } ) @router.get("/shop/categories/{category_slug}", response_class=HTMLResponse, include_in_schema=False) async def shop_category_page( request: Request, category_slug: str = Path(..., description="Category slug") ): """ Render category products page. Shows all products in a specific category. """ return templates.TemplateResponse( "shop/category.html", { "request": request, "category_slug": category_slug, } ) @router.get("/shop/cart", response_class=HTMLResponse, include_in_schema=False) async def shop_cart_page(request: Request): """ Render shopping cart page. Shows cart items and allows quantity updates. """ return templates.TemplateResponse( "shop/cart.html", { "request": request, } ) @router.get("/shop/checkout", response_class=HTMLResponse, include_in_schema=False) async def shop_checkout_page(request: Request): """ Render checkout page. Handles shipping, payment, and order confirmation. """ return templates.TemplateResponse( "shop/checkout.html", { "request": request, } ) @router.get("/shop/search", response_class=HTMLResponse, include_in_schema=False) async def shop_search_page(request: Request): """ Render search results page. Shows products matching search query. """ return templates.TemplateResponse( "shop/search.html", { "request": request, } ) # ============================================================================ # CUSTOMER ACCOUNT - PUBLIC ROUTES (No Authentication) # ============================================================================ @router.get("/shop/account/register", response_class=HTMLResponse, include_in_schema=False) async def shop_register_page(request: Request): """ Render customer registration page. No authentication required. """ return templates.TemplateResponse( "shop/account/register.html", { "request": request, } ) @router.get("/shop/account/login", response_class=HTMLResponse, include_in_schema=False) async def shop_login_page(request: Request): """ Render customer login page. No authentication required. """ return templates.TemplateResponse( "shop/account/login.html", { "request": request, } ) @router.get("/shop/account/forgot-password", response_class=HTMLResponse, include_in_schema=False) async def shop_forgot_password_page(request: Request): """ Render forgot password page. Allows customers to reset their password. """ return templates.TemplateResponse( "shop/account/forgot-password.html", { "request": request, } ) # ============================================================================ # CUSTOMER ACCOUNT - AUTHENTICATED ROUTES # ============================================================================ @router.get("/shop/account/", response_class=RedirectResponse, include_in_schema=False) async def shop_account_root(): """ Redirect /shop/account/ to dashboard. """ return RedirectResponse(url="/shop/account/dashboard", status_code=302) @router.get("/shop/account/dashboard", response_class=HTMLResponse, include_in_schema=False) async def shop_account_dashboard_page( request: Request, current_user: User = Depends(get_current_customer_user), db: Session = Depends(get_db) ): """ Render customer account dashboard. Shows account overview, recent orders, and quick links. Requires customer authentication. """ return templates.TemplateResponse( "shop/account/dashboard.html", { "request": request, "user": current_user, } ) @router.get("/shop/account/orders", response_class=HTMLResponse, include_in_schema=False) async def shop_orders_page( request: Request, current_user: User = Depends(get_current_customer_user), db: Session = Depends(get_db) ): """ Render customer orders history page. Shows all past and current orders. Requires customer authentication. """ return templates.TemplateResponse( "shop/account/orders.html", { "request": request, "user": current_user, } ) @router.get("/shop/account/orders/{order_id}", response_class=HTMLResponse, include_in_schema=False) async def shop_order_detail_page( request: Request, order_id: int = Path(..., description="Order ID"), current_user: User = Depends(get_current_customer_user), db: Session = Depends(get_db) ): """ Render customer order detail page. Shows detailed order information and tracking. Requires customer authentication. """ return templates.TemplateResponse( "shop/account/order-detail.html", { "request": request, "user": current_user, "order_id": order_id, } ) @router.get("/shop/account/profile", response_class=HTMLResponse, include_in_schema=False) async def shop_profile_page( request: Request, current_user: User = Depends(get_current_customer_user), db: Session = Depends(get_db) ): """ Render customer profile page. Edit personal information and preferences. Requires customer authentication. """ return templates.TemplateResponse( "shop/account/profile.html", { "request": request, "user": current_user, } ) @router.get("/shop/account/addresses", response_class=HTMLResponse, include_in_schema=False) async def shop_addresses_page( request: Request, current_user: User = Depends(get_current_customer_user), db: Session = Depends(get_db) ): """ Render customer addresses management page. Manage shipping and billing addresses. Requires customer authentication. """ return templates.TemplateResponse( "shop/account/addresses.html", { "request": request, "user": current_user, } ) @router.get("/shop/account/wishlist", response_class=HTMLResponse, include_in_schema=False) async def shop_wishlist_page( request: Request, current_user: User = Depends(get_current_customer_user), db: Session = Depends(get_db) ): """ Render customer wishlist page. View and manage saved products. Requires customer authentication. """ return templates.TemplateResponse( "shop/account/wishlist.html", { "request": request, "user": current_user, } ) @router.get("/shop/account/settings", response_class=HTMLResponse, include_in_schema=False) async def shop_settings_page( request: Request, current_user: User = Depends(get_current_customer_user), db: Session = Depends(get_db) ): """ Render customer account settings page. Configure notifications, privacy, and preferences. Requires customer authentication. """ return templates.TemplateResponse( "shop/account/settings.html", { "request": request, "user": current_user, } ) # ============================================================================ # STATIC CONTENT PAGES # ============================================================================ @router.get("/shop/about", response_class=HTMLResponse, include_in_schema=False) async def shop_about_page(request: Request): """ Render about us page. """ return templates.TemplateResponse( "shop/about.html", { "request": request, } ) @router.get("/shop/contact", response_class=HTMLResponse, include_in_schema=False) async def shop_contact_page(request: Request): """ Render contact us page. """ return templates.TemplateResponse( "shop/contact.html", { "request": request, } ) @router.get("/shop/faq", response_class=HTMLResponse, include_in_schema=False) async def shop_faq_page(request: Request): """ Render FAQ page. """ return templates.TemplateResponse( "shop/faq.html", { "request": request, } ) @router.get("/shop/privacy", response_class=HTMLResponse, include_in_schema=False) async def shop_privacy_page(request: Request): """ Render privacy policy page. """ return templates.TemplateResponse( "shop/privacy.html", { "request": request, } ) @router.get("/shop/terms", response_class=HTMLResponse, include_in_schema=False) async def shop_terms_page(request: Request): """ Render terms and conditions page. """ return templates.TemplateResponse( "shop/terms.html", { "request": request, } )