refactor(routes): move storefront routes to their modules

Phase 4 of storefront restructure plan - move API routes from legacy
app/api/v1/storefront/ to their respective modules:

- customers: auth, profile, addresses routes combined into storefront.py
- orders: order history viewing routes
- checkout: order placement (place_order endpoint)
- messaging: customer messaging routes

Updated app/api/v1/storefront/__init__.py to import from modules:
- cart_router from app.modules.cart
- catalog_router from app.modules.catalog
- checkout_router from app.modules.checkout
- customers_router from app.modules.customers
- orders_router from app.modules.orders
- messaging_router from app.modules.messaging

Legacy route files in app/api/v1/storefront/ can now be deleted
in Phase 6.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

app/api/v1/storefront/__init__.py

@@ -6,28 +6,33 @@ This module aggregates all storefront-related JSON API endpoints (public facing)
 Uses vendor context from middleware - no vendor_id in URLs.
 
 Endpoints:
-- Products: Browse catalog, search products
-- Cart: Shopping cart operations (session-based)
-- Orders: Order placement and history (requires auth)
-- Auth: Customer login, registration, password reset
-- Content Pages: CMS pages (about, faq, etc.)
+- Products: Browse catalog, search products (catalog module)
+- Cart: Shopping cart operations (cart module)
+- Orders: Order history viewing (orders module)
+- Checkout: Order placement (checkout module)
+- Auth: Customer login, registration, password reset (customers module)
+- Profile/Addresses: Customer profile management (customers module)
+- Messages: Customer messaging (messaging module)
+- Content Pages: CMS pages (cms module)
 
 Authentication:
 - Products, Cart, Content Pages: No auth required
-- Orders: Requires customer authentication (get_current_customer_api)
+- Orders, Profile, Messages: Requires customer authentication
 - Auth: Public (login, register)
 
-Note: Previously named "shop", renamed to "storefront" as not all platforms
-sell items - storefront is a more accurate term for the customer-facing interface.
+Note: Routes are now served from their respective modules.
 """
 
 from fastapi import APIRouter
 
-# Import storefront routers
-from . import addresses, auth, carts, messages, orders, products, profile
-
-# CMS module router
+# Import module routers
+from app.modules.cart.routes.api import storefront_router as cart_router
+from app.modules.catalog.routes.api import storefront_router as catalog_router
+from app.modules.checkout.routes.api import storefront_router as checkout_router
 from app.modules.cms.routes.api.storefront import router as cms_storefront_router
+from app.modules.customers.routes.api import storefront_router as customers_router
+from app.modules.messaging.routes.api import storefront_router as messaging_router
+from app.modules.orders.routes.api import storefront_router as orders_router
 
 # Create storefront router
 router = APIRouter()
@@ -36,28 +41,25 @@ router = APIRouter()
 # STOREFRONT API ROUTES (All vendor-context aware via middleware)
 # ============================================================================
 
-# Addresses (authenticated)
-router.include_router(addresses.router, tags=["storefront-addresses"])
+# Customer authentication and account management (customers module)
+router.include_router(customers_router, tags=["storefront-auth", "storefront-profile", "storefront-addresses"])
 
-# Authentication (public)
-router.include_router(auth.router, tags=["storefront-auth"])
+# Product catalog browsing (catalog module)
+router.include_router(catalog_router, tags=["storefront-products"])
 
-# Products (public)
-router.include_router(products.router, tags=["storefront-products"])
+# Shopping cart (cart module)
+router.include_router(cart_router, tags=["storefront-cart"])
 
-# Shopping cart (public - session based)
-router.include_router(carts.router, tags=["storefront-cart"])
+# Order placement (checkout module)
+router.include_router(checkout_router, tags=["storefront-checkout"])
 
-# Orders (authenticated)
-router.include_router(orders.router, tags=["storefront-orders"])
+# Order history viewing (orders module)
+router.include_router(orders_router, tags=["storefront-orders"])
 
-# Messages (authenticated)
-router.include_router(messages.router, tags=["storefront-messages"])
+# Customer messaging (messaging module)
+router.include_router(messaging_router, tags=["storefront-messages"])
 
-# Profile (authenticated)
-router.include_router(profile.router, tags=["storefront-profile"])
-
-# CMS module router (self-contained module)
+# CMS content pages (cms module)
 router.include_router(
     cms_storefront_router, prefix="/content-pages", tags=["storefront-content-pages"]
 )