docs: add consolidated dev URL reference and migrate /shop to /storefront
Some checks failed
Some checks failed
- 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:
@@ -148,39 +148,39 @@ function myPageComponent() {
|
||||
return {
|
||||
...data(),
|
||||
currentPage: 'my-page',
|
||||
|
||||
|
||||
items: [],
|
||||
loading: false,
|
||||
|
||||
|
||||
async init() {
|
||||
pageLog.info('Initializing page');
|
||||
|
||||
|
||||
// Prevent double init
|
||||
if (window._myPageInitialized) return;
|
||||
window._myPageInitialized = true;
|
||||
|
||||
|
||||
const start = performance.now();
|
||||
|
||||
|
||||
try {
|
||||
pageLog.group('Loading Data');
|
||||
await this.loadData();
|
||||
pageLog.groupEnd();
|
||||
|
||||
|
||||
const duration = performance.now() - start;
|
||||
window.LogConfig.logPerformance('Page Init', duration);
|
||||
|
||||
|
||||
pageLog.info('Page initialized successfully');
|
||||
} catch (error) {
|
||||
window.LogConfig.logError(error, 'Page Init');
|
||||
}
|
||||
},
|
||||
|
||||
|
||||
async loadData() {
|
||||
const url = '/api/my-data';
|
||||
window.LogConfig.logApiCall('GET', url, null, 'request');
|
||||
|
||||
|
||||
const data = await apiClient.get(url);
|
||||
|
||||
|
||||
window.LogConfig.logApiCall('GET', url, data, 'response');
|
||||
this.items = data;
|
||||
}
|
||||
@@ -300,7 +300,7 @@ The system automatically detects which frontend based on URL:
|
||||
|----------|----------|--------|
|
||||
| `/admin/*` | admin | `ADMIN:` |
|
||||
| `/store/*` | store | `STORE:` |
|
||||
| `/shop/*` | shop | `SHOP:` |
|
||||
| `/storefront/*` | storefront | `SHOP:` |
|
||||
|
||||
---
|
||||
|
||||
@@ -338,21 +338,21 @@ const DEFAULT_LOG_LEVELS = {
|
||||
window.LogConfig = {
|
||||
// Log levels
|
||||
LOG_LEVELS: { ERROR: 1, WARN: 2, INFO: 3, DEBUG: 4 },
|
||||
|
||||
|
||||
// Current config
|
||||
frontend: 'admin' | 'store' | 'shop',
|
||||
environment: 'development' | 'production',
|
||||
logLevel: 1 | 2 | 3 | 4,
|
||||
|
||||
|
||||
// Default logger
|
||||
log: { error(), warn(), info(), debug(), group(), groupEnd(), table(), time(), timeEnd() },
|
||||
|
||||
|
||||
// Pre-configured loggers
|
||||
loggers: { stores, products, orders, ... },
|
||||
|
||||
|
||||
// Create custom logger
|
||||
createLogger(prefix, level?),
|
||||
|
||||
|
||||
// Utility functions
|
||||
logApiCall(method, url, data?, status),
|
||||
logError(error, context),
|
||||
|
||||
@@ -327,13 +327,13 @@ Tab navigation components for switching between content sections.
|
||||
|
||||
---
|
||||
|
||||
## E-commerce Components (Shop Frontend)
|
||||
## E-commerce Components (Storefront Frontend)
|
||||
|
||||
Reusable macros for shop/storefront functionality. Located in `app/templates/shared/macros/shop/`.
|
||||
Reusable macros for storefront functionality. Located in `app/templates/shared/macros/storefront/`.
|
||||
|
||||
### 🛍️ Product Card
|
||||
```html
|
||||
{% from 'shared/macros/shop/product-card.html' import product_card %}
|
||||
{% from 'shared/macros/storefront/product-card.html' import product_card %}
|
||||
|
||||
{# Basic product card #}
|
||||
{{ product_card(product_var='product') }}
|
||||
@@ -360,7 +360,7 @@ Reusable macros for shop/storefront functionality. Located in `app/templates/sha
|
||||
|
||||
### 🛍️ Product Grid
|
||||
```html
|
||||
{% from 'shared/macros/shop/product-grid.html' import product_grid %}
|
||||
{% from 'shared/macros/storefront/product-grid.html' import product_grid %}
|
||||
|
||||
{# Basic grid #}
|
||||
{{ product_grid(products_var='products', loading_var='loading') }}
|
||||
@@ -381,7 +381,7 @@ Reusable macros for shop/storefront functionality. Located in `app/templates/sha
|
||||
|
||||
### 🛒 Add to Cart
|
||||
```html
|
||||
{% from 'shared/macros/shop/add-to-cart.html' import add_to_cart_button, add_to_cart_form, buy_now_button %}
|
||||
{% from 'shared/macros/storefront/add-to-cart.html' import add_to_cart_button, add_to_cart_form, buy_now_button %}
|
||||
|
||||
{# Simple button #}
|
||||
{{ add_to_cart_button(action='addToCart()') }}
|
||||
@@ -397,11 +397,11 @@ Reusable macros for shop/storefront functionality. Located in `app/templates/sha
|
||||
- `add_to_cart_button()` - Simple button with loading state
|
||||
- `add_to_cart_form()` - Form with quantity selector + button
|
||||
- `buy_now_button()` - Direct checkout button
|
||||
- `shop_quantity_selector()` - Stock-aware quantity input
|
||||
- `storefront_quantity_selector()` - Stock-aware quantity input
|
||||
|
||||
### 🛒 Mini Cart (Header)
|
||||
```html
|
||||
{% from 'shared/macros/shop/mini-cart.html' import mini_cart, mini_cart_icon %}
|
||||
{% from 'shared/macros/storefront/mini-cart.html' import mini_cart, mini_cart_icon %}
|
||||
|
||||
{# Complete mini cart with dropdown #}
|
||||
{{ mini_cart(cart_var='cart', show_var='showCart') }}
|
||||
@@ -419,7 +419,7 @@ Reusable macros for shop/storefront functionality. Located in `app/templates/sha
|
||||
|
||||
### 🖼️ Product Gallery (Priority 3)
|
||||
```html
|
||||
{% from 'shared/macros/shop/product-gallery.html' import product_gallery %}
|
||||
{% from 'shared/macros/storefront/product-gallery.html' import product_gallery %}
|
||||
|
||||
{# Full gallery with thumbnails, zoom, and lightbox #}
|
||||
{{ product_gallery(images_var='product.images', enable_zoom=true, enable_lightbox=true) }}
|
||||
@@ -436,7 +436,7 @@ Reusable macros for shop/storefront functionality. Located in `app/templates/sha
|
||||
|
||||
### 🎨 Variant Selector (Priority 3)
|
||||
```html
|
||||
{% from 'shared/macros/shop/variant-selector.html' import size_selector, color_swatches %}
|
||||
{% from 'shared/macros/storefront/variant-selector.html' import size_selector, color_swatches %}
|
||||
|
||||
{# Size buttons with size guide link #}
|
||||
{{ size_selector(sizes_var='product.sizes', show_guide=true) }}
|
||||
@@ -453,7 +453,7 @@ Reusable macros for shop/storefront functionality. Located in `app/templates/sha
|
||||
|
||||
### 📄 Product Info (Priority 3)
|
||||
```html
|
||||
{% from 'shared/macros/shop/product-info.html' import product_info, product_price %}
|
||||
{% from 'shared/macros/storefront/product-info.html' import product_info, product_price %}
|
||||
|
||||
{# Complete info block #}
|
||||
{{ product_info(product_var='product', show_store=true, show_rating=true) }}
|
||||
@@ -473,7 +473,7 @@ Reusable macros for shop/storefront functionality. Located in `app/templates/sha
|
||||
|
||||
### 📑 Product Tabs (Priority 3)
|
||||
```html
|
||||
{% from 'shared/macros/shop/product-tabs.html' import product_tabs %}
|
||||
{% from 'shared/macros/storefront/product-tabs.html' import product_tabs %}
|
||||
|
||||
{# Tabbed product information #}
|
||||
{{ product_tabs(
|
||||
@@ -486,7 +486,7 @@ Reusable macros for shop/storefront functionality. Located in `app/templates/sha
|
||||
|
||||
### 📂 Category Navigation (Priority 4)
|
||||
```html
|
||||
{% from 'shared/macros/shop/category-nav.html' import category_nav, category_tree, category_menu %}
|
||||
{% from 'shared/macros/storefront/category-nav.html' import category_nav, category_tree, category_menu %}
|
||||
|
||||
{# Sidebar with nested categories #}
|
||||
{{ category_nav(categories_var='categories', current_var='currentCategory', show_count=true) }}
|
||||
@@ -502,10 +502,10 @@ Reusable macros for shop/storefront functionality. Located in `app/templates/sha
|
||||
|
||||
### 🍞 Breadcrumbs (Priority 4)
|
||||
```html
|
||||
{% from 'shared/macros/shop/breadcrumbs.html' import shop_breadcrumbs, compact_breadcrumbs %}
|
||||
{% from 'shared/macros/storefront/breadcrumbs.html' import storefront_breadcrumbs, compact_breadcrumbs %}
|
||||
|
||||
{# Static breadcrumbs #}
|
||||
{{ shop_breadcrumbs(items=[
|
||||
{{ storefront_breadcrumbs(items=[
|
||||
{'label': 'Electronics', 'url': '/electronics'},
|
||||
{'label': 'Audio', 'url': '/audio'},
|
||||
{'label': 'Headphones'}
|
||||
@@ -515,11 +515,11 @@ Reusable macros for shop/storefront functionality. Located in `app/templates/sha
|
||||
{{ compact_breadcrumbs(parent={'label': 'Audio', 'url': '/audio'}, current='Headphones') }}
|
||||
```
|
||||
|
||||
**Macros:** `shop_breadcrumbs()`, `auto_breadcrumbs()`, `compact_breadcrumbs()`
|
||||
**Macros:** `storefront_breadcrumbs()`, `auto_breadcrumbs()`, `compact_breadcrumbs()`
|
||||
|
||||
### 🔍 Search Bar (Priority 4)
|
||||
```html
|
||||
{% from 'shared/macros/shop/search-bar.html' import search_bar, search_autocomplete %}
|
||||
{% from 'shared/macros/storefront/search-bar.html' import search_bar, search_autocomplete %}
|
||||
|
||||
{# Basic search #}
|
||||
{{ search_bar(placeholder='Search products...') }}
|
||||
@@ -535,7 +535,7 @@ Reusable macros for shop/storefront functionality. Located in `app/templates/sha
|
||||
|
||||
### 🎛️ Filter Sidebar (Priority 4)
|
||||
```html
|
||||
{% from 'shared/macros/shop/filter-sidebar.html' import filter_sidebar, price_filter, sort_dropdown %}
|
||||
{% from 'shared/macros/storefront/filter-sidebar.html' import filter_sidebar, price_filter, sort_dropdown %}
|
||||
|
||||
{# Complete filter panel #}
|
||||
{{ filter_sidebar(filters_var='filters', active_filters_var='activeFilters', on_change='filterProducts()') }}
|
||||
@@ -551,7 +551,7 @@ Reusable macros for shop/storefront functionality. Located in `app/templates/sha
|
||||
|
||||
### ⭐ Star Rating (Priority 5)
|
||||
```html
|
||||
{% from 'shared/macros/shop/star-rating.html' import star_rating, rating_input, rating_summary, compact_rating %}
|
||||
{% from 'shared/macros/storefront/star-rating.html' import star_rating, rating_input, rating_summary, compact_rating %}
|
||||
|
||||
{# Static star rating with half-star support #}
|
||||
{{ star_rating(rating=4.5, show_value=true, show_count=true, count=127) }}
|
||||
@@ -573,7 +573,7 @@ Reusable macros for shop/storefront functionality. Located in `app/templates/sha
|
||||
|
||||
### 💬 Reviews (Priority 5)
|
||||
```html
|
||||
{% from 'shared/macros/shop/reviews.html' import review_card, review_list, review_form, review_summary_section %}
|
||||
{% from 'shared/macros/storefront/reviews.html' import review_card, review_list, review_form, review_summary_section %}
|
||||
|
||||
{# Single review card with helpful buttons #}
|
||||
{{ review_card(review_var='review', on_helpful='markHelpful(review.id)') }}
|
||||
@@ -592,7 +592,7 @@ Reusable macros for shop/storefront functionality. Located in `app/templates/sha
|
||||
|
||||
### 🛡️ Trust Badges (Priority 5)
|
||||
```html
|
||||
{% from 'shared/macros/shop/trust-badges.html' import trust_badges, trust_banner, payment_icons, guarantee_badge, security_seals, checkout_trust_section %}
|
||||
{% from 'shared/macros/storefront/trust-badges.html' import trust_badges, trust_banner, payment_icons, guarantee_badge, security_seals, checkout_trust_section %}
|
||||
|
||||
{# Trust badges grid #}
|
||||
{{ trust_badges(badges=['secure_payment', 'free_shipping', 'easy_returns', 'support_24_7'], layout='grid') }}
|
||||
|
||||
Reference in New Issue
Block a user