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/frontend/storefront/authentication-pages.md

@@ -1,8 +1,8 @@
-# Shop Authentication Pages
+# Storefront Authentication Pages
 
 ## Overview
 
-This document details the implementation of customer authentication pages in the shop frontend. All pages use Tailwind CSS, Alpine.js, and integrate with the multi-theme system for a branded, consistent experience across all stores.
+This document details the implementation of customer authentication pages in the storefront frontend. All pages use Tailwind CSS, Alpine.js, and integrate with the multi-theme system for a branded, consistent experience across all stores.
 
 ## Implementation Date
 2025-11-24
@@ -12,8 +12,8 @@ This document details the implementation of customer authentication pages in the
 ## 📄 Available Pages
 
 ### 1. Login Page
-**Location:** `app/templates/shop/account/login.html`
-**Route:** `/shop/account/login`
+**Location:** `app/templates/storefront/account/login.html`
+**Route:** `/storefront/account/login`
 
 #### Features
 - Two-column layout with store branding on the left
@@ -41,7 +41,7 @@ function customerLogin() {
 
         async handleLogin() {
             // Validates input
-            // Calls POST /api/v1/shop/auth/login
+            // Calls POST /api/v1/storefront/auth/login
             // Stores token in localStorage
             // Redirects to account page or return URL
         }
@@ -50,15 +50,15 @@ function customerLogin() {
 ```
 
 #### API Integration
-- **Endpoint:** `POST /api/v1/shop/auth/login`
+- **Endpoint:** `POST /api/v1/storefront/auth/login`
 - **Request:** `{ email_or_username: string, password: string }`
 - **Response:** `{ access_token: string, user: object }`
 
 ---
 
 ### 2. Register Page
-**Location:** `app/templates/shop/account/register.html`
-**Route:** `/shop/account/register`
+**Location:** `app/templates/storefront/account/register.html`
+**Route:** `/storefront/account/register`
 
 #### Features
 - Two-column layout with store branding
@@ -110,7 +110,7 @@ function customerRegistration() {
 
         async handleRegister() {
             // Validates form
-            // Calls POST /api/v1/shop/auth/register
+            // Calls POST /api/v1/storefront/auth/register
             // Shows success message
             // Redirects to login with ?registered=true
         }
@@ -119,15 +119,15 @@ function customerRegistration() {
 ```
 
 #### API Integration
-- **Endpoint:** `POST /api/v1/shop/auth/register`
+- **Endpoint:** `POST /api/v1/storefront/auth/register`
 - **Request:** `{ first_name: string, last_name: string, email: string, phone?: string, password: string, marketing_consent: boolean }`
 - **Response:** `{ message: string }`
 
 ---
 
 ### 3. Forgot Password Page
-**Location:** `app/templates/shop/account/forgot-password.html`
-**Route:** `/shop/account/forgot-password`
+**Location:** `app/templates/storefront/account/forgot-password.html`
+**Route:** `/storefront/account/forgot-password`
 
 #### Features
 - Two-column layout with store branding
@@ -142,7 +142,7 @@ function customerRegistration() {
   - Instructions to check inbox
   - Option to retry if email not received
 - Theme-aware styling
-- Links back to login and shop homepage
+- Links back to login and storefront homepage
 - Dark mode support
 - Mobile responsive
 
@@ -159,7 +159,7 @@ function forgotPassword() {
 
         async handleSubmit() {
             // Validates email
-            // Calls POST /api/v1/shop/auth/forgot-password
+            // Calls POST /api/v1/storefront/auth/forgot-password
             // Sets emailSent = true on success
             // Shows confirmation message
         }
@@ -168,7 +168,7 @@ function forgotPassword() {
 ```
 
 #### API Integration
-- **Endpoint:** `POST /api/v1/shop/auth/forgot-password`
+- **Endpoint:** `POST /api/v1/storefront/auth/forgot-password`
 - **Request:** `{ email: string }`
 - **Response:** `{ message: string }`
 
@@ -214,7 +214,7 @@ All authentication pages inject the store's theme CSS variables for consistent b
 
 ### Benefits
 - ✅ Each store's auth pages automatically match their brand
-- ✅ Consistent with main shop design
+- ✅ Consistent with main storefront design
 - ✅ Dark mode adapts to store colors
 - ✅ Professional, polished appearance
 - ✅ No custom CSS needed per store
@@ -303,7 +303,7 @@ All authentication pages inject the store's theme CSS variables for consistent b
 ## 🔗 Navigation Flow
 
 ```
-Shop Homepage
+Storefront Homepage
     ↓
 Login Page ←→ Register Page
     ↓              ↓
@@ -314,16 +314,16 @@ Check Email   Account/Cart
 
 ### Link Structure
 - **Login Page:**
-  - "Forgot password?" → `/shop/account/forgot-password`
-  - "Create an account" → `/shop/account/register`
-  - "← Continue shopping" → `/shop/`
+  - "Forgot password?" → `/storefront/account/forgot-password`
+  - "Create an account" → `/storefront/account/register`
+  - "← Continue shopping" → `/storefront/`
 
 - **Register Page:**
-  - "Already have an account? Sign in instead" → `/shop/account/login`
+  - "Already have an account? Sign in instead" → `/storefront/account/login`
 
 - **Forgot Password Page:**
-  - "Remember your password? Sign in" → `/shop/account/login`
-  - "← Continue shopping" → `/shop/`
+  - "Remember your password? Sign in" → `/storefront/account/login`
+  - "← Continue shopping" → `/storefront/`
 
 All links use `{{ base_url }}` for multi-access routing support.
 
@@ -386,12 +386,12 @@ No code changes needed - all controlled via theme configuration.
 
 ```
 app/
-├── templates/shop/account/
+├── templates/storefront/account/
 │   ├── login.html              ← Customer login page
 │   ├── register.html           ← Customer registration page
 │   └── forgot-password.html    ← Password reset page
 │
-└── api/v1/shop/
+└── api/v1/storefront/
     └── auth.py                 ← Authentication endpoints
 
 static/shared/css/
@@ -463,7 +463,7 @@ Possible additions:
 
 ## 📚 Related Documentation
 
-- [Shop Frontend Architecture](./architecture.md)
+- [Storefront Frontend Architecture](./architecture.md)
 - [Page Template Guide](./page-templates.md)
 - [Theme System Overview](../../architecture/theme-system/overview.md)
 - [Theme Presets](../../architecture/theme-system/presets.md)