docs: add consolidated dev URL reference and migrate /shop to /storefront
Some checks failed
CI / ruff (push) Successful in 10s
CI / validate (push) Has been cancelled
CI / dependency-scanning (push) Has been cancelled
CI / docs (push) Has been cancelled
CI / deploy (push) Has been cancelled
CI / pytest (push) Has been cancelled

- 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:
2026-02-25 13:23:44 +01:00
parent 3df75e2e78
commit d648c921b7
50 changed files with 1104 additions and 1049 deletions

View File

@@ -145,9 +145,9 @@ The attachment size limit is configurable via platform settings:
- **Default:** 10
- **Category:** messaging
## Shop (Customer) Interface
## Storefront (Customer) Interface
### API Endpoints (`/api/v1/shop/messages`)
### API Endpoints (`/api/v1/storefront/messages`)
| Endpoint | Method | Description |
|----------|--------|-------------|
@@ -160,8 +160,8 @@ The attachment size limit is configurable via platform settings:
### Frontend
- **Template:** `app/templates/shop/account/messages.html`
- **Page Route:** `/shop/account/messages` and `/shop/account/messages/{conversation_id}`
- **Template:** `app/templates/storefront/account/messages.html`
- **Page Route:** `/storefront/account/messages` and `/storefront/account/messages/{conversation_id}`
Features:
- Conversation list with unread badges
@@ -236,7 +236,7 @@ Messages is available under "Platform Administration" section.
### Store Sidebar
Messages is available under "Sales" section.
### Shop Account Dashboard
### Storefront Account Dashboard
Messages card is available on the customer account dashboard with unread count badge.
### Header Badge

View File

@@ -63,9 +63,9 @@ class PasswordResetToken(Base):
### API Endpoints
**File:** `app/api/v1/shop/auth.py`
**File:** `app/api/v1/storefront/auth.py`
#### POST /api/v1/shop/auth/forgot-password
#### POST /api/v1/storefront/auth/forgot-password
Request a password reset link.
@@ -97,7 +97,7 @@ def forgot_password(request: Request, email: str, db: Session = Depends(get_db))
if customer:
# Generate token and send email
plaintext_token = PasswordResetToken.create_for_customer(db, customer.id)
reset_link = f"{scheme}://{host}/shop/account/reset-password?token={plaintext_token}"
reset_link = f"{scheme}://{host}/storefront/account/reset-password?token={plaintext_token}"
email_service.send_template(
template_code="password_reset",
@@ -119,7 +119,7 @@ def forgot_password(request: Request, email: str, db: Session = Depends(get_db))
---
#### POST /api/v1/shop/auth/reset-password
#### POST /api/v1/storefront/auth/reset-password
Reset password using token from email.
@@ -279,8 +279,8 @@ class PasswordTooShortException(ValidationException):
#### Forgot Password Page
**Template:** `app/templates/shop/account/forgot-password.html`
**Route:** `/shop/account/forgot-password`
**Template:** `app/templates/storefront/account/forgot-password.html`
**Route:** `/storefront/account/forgot-password`
Features:
- Email input form
@@ -290,8 +290,8 @@ Features:
#### Reset Password Page
**Template:** `app/templates/shop/account/reset-password.html`
**Route:** `/shop/account/reset-password?token=...`
**Template:** `app/templates/storefront/account/reset-password.html`
**Route:** `/storefront/account/reset-password?token=...`
Features:
- New password input
@@ -379,15 +379,15 @@ If you didn't request this, you can safely ignore this email.
├── alembic/versions/
│ └── t8b9c0d1e2f3_add_password_reset_tokens.py
├── app/
│ ├── api/v1/shop/
│ ├── api/v1/storefront/
│ │ └── auth.py
│ ├── exceptions/
│ │ └── customer.py
│ ├── routes/
│ │ └── shop_pages.py
│ │ └── storefront_pages.py
│ ├── services/
│ │ └── customer_service.py
│ └── templates/shop/account/
│ └── templates/storefront/account/
│ ├── forgot-password.html
│ └── reset-password.html
├── models/