sboulahtit/orion
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

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

Browse Source 
- 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:
Samir Boulahtit
2026-02-25 13:23:44 +01:00
parent 3df75e2e78
commit d648c921b7
50 changed files with 1104 additions and 1049 deletions
Download Patch File Download Diff File Expand all files Collapse all files

46
docs/frontend/storefront/ecommerce-components-proposal.md
View File

@@ -28,7 +28,7 @@ This document proposes a comprehensive set of reusable Jinja macro components fo
### Priority 1: Core Shopping Components
#### 1.1 Product Card
**File:** `app/templates/shared/macros/shop/product-card.html`
**File:** `app/templates/shared/macros/storefront/product-card.html`
A versatile product card for grids, carousels, and lists.
@@ -63,7 +63,7 @@ A versatile product card for grids, carousels, and lists.
---
#### 1.2 Product Grid
**File:** `app/templates/shared/macros/shop/product-grid.html`
**File:** `app/templates/shared/macros/storefront/product-grid.html`
Responsive grid layout for product listings.
@@ -85,7 +85,7 @@ Responsive grid layout for product listings.
---
#### 1.3 Add to Cart Button
**File:** `app/templates/shared/macros/shop/add-to-cart.html`
**File:** `app/templates/shared/macros/storefront/add-to-cart.html`
Standardized add-to-cart functionality.
@@ -115,7 +115,7 @@ Standardized add-to-cart functionality.
Shop-specific wrapper with stock validation:
```jinja
{{ shop_quantity_selector(
{{ storefront_quantity_selector(
model='quantity',
max='product.stock',
disabled_var='addingToCart',
@@ -128,7 +128,7 @@ Shop-specific wrapper with stock validation:
### Priority 2: Cart Components
#### 2.1 Mini Cart (Header Dropdown)
**File:** `app/templates/shared/macros/shop/mini-cart.html`
**File:** `app/templates/shared/macros/storefront/mini-cart.html`
Dropdown cart preview in the header.
@@ -151,7 +151,7 @@ Dropdown cart preview in the header.
---
#### 2.2 Cart Item Row
**File:** `app/templates/shared/macros/shop/cart-item.html`
**File:** `app/templates/shared/macros/storefront/cart-item.html`
Individual cart line item.
@@ -177,7 +177,7 @@ Individual cart line item.
---
#### 2.3 Cart Summary
**File:** `app/templates/shared/macros/shop/cart-summary.html`
**File:** `app/templates/shared/macros/storefront/cart-summary.html`
Order summary sidebar/section.
@@ -205,7 +205,7 @@ Order summary sidebar/section.
### Priority 3: Product Detail Components
#### 3.1 Product Gallery
**File:** `app/templates/shared/macros/shop/product-gallery.html`
**File:** `app/templates/shared/macros/storefront/product-gallery.html`
Image gallery with thumbnails and zoom.
@@ -229,7 +229,7 @@ Image gallery with thumbnails and zoom.
---
#### 3.2 Variant Selector
**File:** `app/templates/shared/macros/shop/variant-selector.html`
**File:** `app/templates/shared/macros/storefront/variant-selector.html`
Product variant selection (size, color, etc.).
@@ -255,7 +255,7 @@ Product variant selection (size, color, etc.).
---
#### 3.3 Product Info Block
**File:** `app/templates/shared/macros/shop/product-info.html`
**File:** `app/templates/shared/macros/storefront/product-info.html`
Product details section.
@@ -280,7 +280,7 @@ Product details section.
---
#### 3.4 Product Tabs
**File:** `app/templates/shared/macros/shop/product-tabs.html`
**File:** `app/templates/shared/macros/storefront/product-tabs.html`
Tabbed product information.
@@ -303,7 +303,7 @@ Tabbed product information.
### Priority 4: Navigation & Discovery
#### 4.1 Category Navigation
**File:** `app/templates/shared/macros/shop/category-nav.html`
**File:** `app/templates/shared/macros/storefront/category-nav.html`
Category browsing sidebar/menu.
@@ -326,12 +326,12 @@ Category browsing sidebar/menu.
---
#### 4.2 Breadcrumbs
**File:** `app/templates/shared/macros/shop/breadcrumbs.html`
**File:** `app/templates/shared/macros/storefront/breadcrumbs.html`
Navigation breadcrumb trail.
```jinja
{{ shop_breadcrumbs(
{{ storefront_breadcrumbs(
items=[
{'label': 'Home', 'url': '/'},
{'label': 'Electronics', 'url': '/category/electronics'},
@@ -343,7 +343,7 @@ Navigation breadcrumb trail.
---
#### 4.3 Search Bar
**File:** `app/templates/shared/macros/shop/search-bar.html`
**File:** `app/templates/shared/macros/storefront/search-bar.html`
Product search with autocomplete.
@@ -365,7 +365,7 @@ Product search with autocomplete.
---
#### 4.4 Filter Sidebar
**File:** `app/templates/shared/macros/shop/filter-sidebar.html`
**File:** `app/templates/shared/macros/storefront/filter-sidebar.html`
Product filtering panel.
@@ -390,7 +390,7 @@ Product filtering panel.
### Priority 5: Social Proof & Trust
#### 5.1 Star Rating
**File:** `app/templates/shared/macros/shop/star-rating.html`
**File:** `app/templates/shared/macros/storefront/star-rating.html`
Reusable star rating display.
@@ -407,7 +407,7 @@ Reusable star rating display.
---
#### 5.2 Review Card
**File:** `app/templates/shared/macros/shop/review-card.html`
**File:** `app/templates/shared/macros/storefront/review-card.html`
Individual product review.
@@ -431,7 +431,7 @@ Individual product review.
---
#### 5.3 Trust Badges
**File:** `app/templates/shared/macros/shop/trust-badges.html`
**File:** `app/templates/shared/macros/storefront/trust-badges.html`
Trust and security indicators.
@@ -454,7 +454,7 @@ Trust and security indicators.
### Priority 6: Promotional Components
#### 6.1 Sale Banner
**File:** `app/templates/shared/macros/shop/sale-banner.html`
**File:** `app/templates/shared/macros/storefront/sale-banner.html`
Promotional banner with countdown.
@@ -472,7 +472,7 @@ Promotional banner with countdown.
---
#### 6.2 Product Badge
**File:** `app/templates/shared/macros/shop/product-badge.html`
**File:** `app/templates/shared/macros/storefront/product-badge.html`
Product overlay badges.
@@ -486,7 +486,7 @@ Product overlay badges.
---
#### 6.3 Recently Viewed
**File:** `app/templates/shared/macros/shop/recently-viewed.html`
**File:** `app/templates/shared/macros/storefront/recently-viewed.html`
Recently viewed products carousel.
@@ -578,7 +578,7 @@ All shop components will use these CSS variables set by the store theme:
## File Structure
```
app/templates/shared/macros/shop/
app/templates/shared/macros/storefront/
├── product-card.html
├── product-grid.html
├── add-to-cart.html