docs: add consolidated dev URL reference and migrate /shop to /storefront
Some checks failed
Some checks failed
- Add Development URL Quick Reference section to url-routing overview with all login URLs, entry points, and full examples - Replace /shop/ path segments with /storefront/ across 50 docs files - Update file references: shop_pages.py → storefront_pages.py, templates/shop/ → templates/storefront/, api/v1/shop/ → api/v1/storefront/ - Preserve domain references (orion.shop) and /store/ staff dashboard paths - Archive docs left unchanged (historical) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -92,7 +92,7 @@ Centralized class for detecting which frontend a request targets based on URL pa
|
||||
2. Path-based detection:
|
||||
- `/admin/*`, `/api/v1/admin/*` → ADMIN
|
||||
- `/store/*`, `/api/v1/store/*` → STORE
|
||||
- `/storefront/*`, `/shop/*`, `/stores/*` → STOREFRONT
|
||||
- `/storefront/*`, `/stores/*` → STOREFRONT
|
||||
- `/api/v1/platform/*` → PLATFORM
|
||||
3. Store subdomain → STOREFRONT
|
||||
4. Store context set → STOREFRONT
|
||||
@@ -210,17 +210,17 @@ Middleware for request/response logging and performance monitoring.
|
||||
|
||||
**Modern Approach: Double Router Mounting**
|
||||
|
||||
Instead of using middleware to rewrite paths, the application registers shop routes **twice** with different prefixes:
|
||||
Instead of using middleware to rewrite paths, the application registers storefront routes **twice** with different prefixes:
|
||||
|
||||
```python
|
||||
# In main.py
|
||||
app.include_router(shop_pages.router, prefix="/shop")
|
||||
app.include_router(shop_pages.router, prefix="/stores/{store_code}/shop")
|
||||
app.include_router(storefront_pages.router, prefix="/storefront")
|
||||
app.include_router(storefront_pages.router, prefix="/stores/{store_code}/storefront")
|
||||
```
|
||||
|
||||
**How It Works:**
|
||||
- **Subdomain/Custom Domain Mode**: Routes match `/shop/*` prefix
|
||||
- **Path-Based Development Mode**: Routes match `/stores/{store_code}/shop/*` prefix
|
||||
- **Subdomain/Custom Domain Mode**: Routes match `/storefront/*` prefix
|
||||
- **Path-Based Development Mode**: Routes match `/stores/{store_code}/storefront/*` prefix
|
||||
- FastAPI handles routing naturally without path manipulation
|
||||
- Store code is available as a path parameter when needed
|
||||
|
||||
|
||||
Reference in New Issue
Block a user