Files
orion/app/routes/shop_pages.py

400 lines
11 KiB
Python

# app/routes/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,
}
)