docs: add consolidated dev URL reference and migrate /shop to /storefront

- 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>

docs/development/customer-auth-summary.md

@@ -16,16 +16,16 @@
 ## Key Files
 
 ### Created
-- `app/templates/shop/account/login.html`
-- `app/templates/shop/account/register.html`
-- `app/templates/shop/account/forgot-password.html`
-- `app/templates/shop/account/dashboard.html`
+- `app/templates/storefront/account/login.html`
+- `app/templates/storefront/account/register.html`
+- `app/templates/storefront/account/forgot-password.html`
+- `app/templates/storefront/account/dashboard.html`
 
 ### Modified
-- `app/api/v1/shop/auth.py` - Dynamic cookie paths
+- `app/api/v1/storefront/auth.py` - Dynamic cookie paths
 - `app/api/deps.py` - Customer authentication dependency
 - `app/services/customer_service.py` - Direct JWT token creation
-- `app/routes/shop_pages.py` - Customer type hints
+- `app/routes/storefront_pages.py` - Customer type hints
 - `middleware/store_context.py` - Harmonized detection methods
 
 ## Critical Architecture Decision
@@ -41,10 +41,10 @@ JWT tokens have `type: "customer"` to distinguish them.
 
 ```python
 # Domain/Subdomain access
-cookie_path = "/shop"
+cookie_path = "/storefront"
 
-# Path-based access (/stores/orion/shop)
-cookie_path = f"/stores/{store_code}/shop"
+# Path-based access (/storefront/orion)
+cookie_path = f"/storefront/{store_code}"
 ```
 
 ## Authentication Flow
@@ -58,7 +58,7 @@ cookie_path = f"/stores/{store_code}/shop"
 ## Logout Flow
 
 1. User clicks "Logout" button → Custom Tailwind modal appears
-2. User confirms → API call to `/api/v1/shop/auth/logout`
+2. User confirms → API call to `/api/v1/storefront/auth/logout`
 3. Cookie deleted, localStorage cleared
 4. Success toast shown, redirect to login page
 
@@ -68,9 +68,9 @@ cookie_path = f"/stores/{store_code}/shop"
 
 ```
 # Path-based access
-http://localhost:8000/stores/orion/shop/account/login
-http://localhost:8000/stores/orion/shop/account/register
-http://localhost:8000/stores/orion/shop/account/dashboard
+http://localhost:8000/storefront/orion/account/login
+http://localhost:8000/storefront/orion/account/register
+http://localhost:8000/storefront/orion/account/dashboard
 ```
 
 ## Next Steps (TODO)