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/architecture/url-routing/overview.md

@@ -42,6 +42,61 @@ http://localhost:8000/platforms/loyalty/storefront/TECHPRO/cart
 
 ---
 
+## Development URL Quick Reference
+
+All development URLs use `http://localhost:8000` as the base.
+
+### Login Pages
+
+| Panel | URL | Description |
+|-------|-----|-------------|
+| Admin | `/admin/login` | Platform-wide admin panel |
+| Merchant | `/merchants/login` | Merchant management panel |
+| Store Dashboard | `/platforms/{platform_code}/store/{store_code}/login` | Store staff login |
+| Storefront | `/platforms/{platform_code}/storefront/{store_code}/account/login` | Customer login |
+
+### Key Entry Points
+
+| Panel | URL | Description |
+|-------|-----|-------------|
+| Admin Dashboard | `/admin/` | Admin panel home |
+| Merchant Dashboard | `/merchants/dashboard` | Merchant panel home |
+| Store Dashboard | `/platforms/{platform_code}/store/{store_code}/dashboard` | Store management |
+| Storefront Homepage | `/platforms/{platform_code}/storefront/{store_code}/` | Customer-facing store |
+| Platform Homepage | `/platforms/{platform_code}/` | Platform marketing site |
+
+### Full Example (OMS Platform, Store Code "ACME")
+
+```
+Admin login:          http://localhost:8000/admin/login
+Merchant login:       http://localhost:8000/merchants/login
+Store login:          http://localhost:8000/platforms/oms/store/ACME/login
+Store dashboard:      http://localhost:8000/platforms/oms/store/ACME/dashboard
+Storefront login:     http://localhost:8000/platforms/oms/storefront/ACME/account/login
+Storefront homepage:  http://localhost:8000/platforms/oms/storefront/ACME/
+Storefront products:  http://localhost:8000/platforms/oms/storefront/ACME/products
+Storefront cart:      http://localhost:8000/platforms/oms/storefront/ACME/cart
+Storefront checkout:  http://localhost:8000/platforms/oms/storefront/ACME/checkout
+Storefront account:   http://localhost:8000/platforms/oms/storefront/ACME/account/dashboard
+```
+
+### API Endpoints
+
+```
+Admin API:       http://localhost:8000/api/v1/admin/...
+Store API:       http://localhost:8000/api/v1/store/...
+Storefront API:  http://localhost:8000/api/v1/storefront/...
+```
+
+### Notes
+
+- **Admin and Merchant** panels are global — no platform prefix needed.
+- **Store and Storefront** panels require the `/platforms/{platform_code}/` prefix in development. This prefix is stripped by `PlatformContextMiddleware` before routing.
+- In **production**, storefronts are accessed via subdomain (`acme.omsflow.lu/`) or custom domain. The root path `/` is the storefront.
+- The storefront router is **double-mounted** at `/storefront/` and `/storefront/{store_code}/` to support both production and development modes transparently.
+
+---
+
 ## Multi-Platform URL Routing
 
 Orion supports multiple platforms (OMS, Loyalty, Site Builder), each with its own marketing site and store ecosystem.