docs: consolidate navigation into 4 main sections
Reorganize mkdocs navigation from 14 top-level items to 4: 1. Home 2. Getting Started - Installation, quickstart, configuration 3. Documentation - All technical docs (Architecture, API, Backend, Frontend, Development, Migrations, Implementation, Testing, Deployment, Operations, Troubleshooting) 4. Business - Features, User Guides, Marketing This provides a cleaner navigation experience with logical grouping while keeping all content accessible through submenus. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
358
mkdocs.yml
358
mkdocs.yml
@@ -16,119 +16,131 @@ nav:
|
|||||||
- Getting Started:
|
- Getting Started:
|
||||||
- Installation: getting-started/installation.md
|
- Installation: getting-started/installation.md
|
||||||
- Quick Start: getting-started/quickstart.md
|
- Quick Start: getting-started/quickstart.md
|
||||||
|
- Configuration: getting-started/configuration.md
|
||||||
- Database Setup:
|
- Database Setup:
|
||||||
- Overview: getting-started/database-setup.md
|
- Overview: getting-started/database-setup.md
|
||||||
- Complete Setup Guide: getting-started/database-setup-guide.md
|
- Complete Setup Guide: getting-started/database-setup-guide.md
|
||||||
- Quick Reference: getting-started/database-quick-reference.md
|
- Quick Reference: getting-started/database-quick-reference.md
|
||||||
- CMS Quick Start: getting-started/cms-quick-start.md
|
- CMS Quick Start: getting-started/cms-quick-start.md
|
||||||
- Platform Homepage Quick Start: getting-started/platform-homepage-quick-start.md
|
- Platform Homepage Quick Start: getting-started/platform-homepage-quick-start.md
|
||||||
- Configuration: getting-started/configuration.md
|
|
||||||
|
|
||||||
# ============================================
|
# ============================================
|
||||||
# ARCHITECTURE (System-wide concepts)
|
# DOCUMENTATION (All Technical)
|
||||||
# ============================================
|
# ============================================
|
||||||
- Architecture:
|
- Documentation:
|
||||||
- Overview: architecture/overview.md
|
# --- Architecture ---
|
||||||
- Marketplace Integration: architecture/marketplace-integration.md
|
- Architecture:
|
||||||
- Architecture Patterns: architecture/architecture-patterns.md
|
- Overview: architecture/overview.md
|
||||||
- Language & i18n: architecture/language-i18n.md
|
- Architecture Patterns: architecture/architecture-patterns.md
|
||||||
- Money Handling: architecture/money-handling.md
|
- Multi-Tenant System: architecture/multi-tenant.md
|
||||||
- Company-Vendor Management: architecture/company-vendor-management.md
|
- Marketplace Integration: architecture/marketplace-integration.md
|
||||||
- Multi-Tenant System: architecture/multi-tenant.md
|
- Language & i18n: architecture/language-i18n.md
|
||||||
- Middleware Stack: architecture/middleware.md
|
- Money Handling: architecture/money-handling.md
|
||||||
- Request Flow: architecture/request-flow.md
|
- Company-Vendor Management: architecture/company-vendor-management.md
|
||||||
- Authentication & RBAC: architecture/auth-rbac.md
|
- Middleware Stack: architecture/middleware.md
|
||||||
- Frontend Structure: architecture/frontend-structure.md
|
- Request Flow: architecture/request-flow.md
|
||||||
- Models Structure: architecture/models-structure.md
|
- Authentication & RBAC: architecture/auth-rbac.md
|
||||||
- Background Tasks: architecture/background-tasks.md
|
- Frontend Structure: architecture/frontend-structure.md
|
||||||
- Capacity Planning: architecture/capacity-planning.md
|
- Models Structure: architecture/models-structure.md
|
||||||
- API Consolidation:
|
- Background Tasks: architecture/background-tasks.md
|
||||||
- Proposal: architecture/api-consolidation-proposal.md
|
- Capacity Planning: architecture/capacity-planning.md
|
||||||
- Migration Status: architecture/api-migration-status.md
|
- API Consolidation:
|
||||||
- Architecture Violations Status: architecture/architecture-violations-status.md
|
- Proposal: architecture/api-consolidation-proposal.md
|
||||||
- Diagrams:
|
- Migration Status: architecture/api-migration-status.md
|
||||||
- Multi-Tenant Diagrams: architecture/diagrams/multitenant-diagrams.md
|
- Architecture Violations Status: architecture/architecture-violations-status.md
|
||||||
- Vendor Domain Diagrams: architecture/diagrams/vendor-domain-diagrams.md
|
- Diagrams:
|
||||||
- Theme System:
|
- Multi-Tenant Diagrams: architecture/diagrams/multitenant-diagrams.md
|
||||||
- Overview: architecture/theme-system/overview.md
|
- Vendor Domain Diagrams: architecture/diagrams/vendor-domain-diagrams.md
|
||||||
- Theme Presets: architecture/theme-system/presets.md
|
- Theme System:
|
||||||
- URL Routing:
|
- Overview: architecture/theme-system/overview.md
|
||||||
- Overview: architecture/url-routing/overview.md
|
- Theme Presets: architecture/theme-system/presets.md
|
||||||
|
- URL Routing:
|
||||||
|
- Overview: architecture/url-routing/overview.md
|
||||||
|
|
||||||
# ============================================
|
# --- API Reference ---
|
||||||
# API DOCUMENTATION (For API Consumers)
|
- API Reference:
|
||||||
# ============================================
|
- Overview: api/index.md
|
||||||
- API Documentation:
|
- Shop API Reference: api/shop-api-reference.md
|
||||||
- Overview: api/index.md
|
- Authentication:
|
||||||
- Shop API Reference: api/shop-api-reference.md
|
- Guide: api/authentication.md
|
||||||
- Authentication:
|
- Quick Reference: api/authentication-quick-reference.md
|
||||||
- Guide: api/authentication.md
|
- Flow Diagrams: api/authentication-flow-diagrams.md
|
||||||
- Quick Reference: api/authentication-quick-reference.md
|
- RBAC:
|
||||||
- Flow Diagrams: api/authentication-flow-diagrams.md
|
- Developer Guide: api/rbac.md
|
||||||
- RBAC:
|
- Visual Guide: api/rbac-visual-guide.md
|
||||||
- Developer Guide: api/rbac.md
|
- Error Handling: api/error-handling.md
|
||||||
- Visual Guide: api/rbac-visual-guide.md
|
- Rate Limiting: api/rate-limiting.md
|
||||||
- Error Handling: api/error-handling.md
|
|
||||||
- Rate Limiting: api/rate-limiting.md
|
|
||||||
|
|
||||||
# ============================================
|
# --- Backend ---
|
||||||
# BACKEND (Development Reference)
|
- Backend:
|
||||||
# ============================================
|
- Overview: backend/overview.md
|
||||||
- Backend Development:
|
- Middleware Reference: backend/middleware-reference.md
|
||||||
- Overview: backend/overview.md
|
- RBAC Quick Reference: backend/rbac-quick-reference.md
|
||||||
- Middleware Reference: backend/middleware-reference.md
|
- Vendor RBAC: backend/vendor-rbac.md
|
||||||
- RBAC Quick Reference: backend/rbac-quick-reference.md
|
- Vendor-in-Token Architecture: backend/vendor-in-token-architecture.md
|
||||||
- Vendor RBAC: backend/vendor-rbac.md
|
- Admin Integration Guide: backend/admin-integration-guide.md
|
||||||
- Vendor-in-Token Architecture: backend/vendor-in-token-architecture.md
|
- Admin Feature Integration: backend/admin-feature-integration.md
|
||||||
- Admin Integration Guide: backend/admin-integration-guide.md
|
|
||||||
- Admin Feature Integration: backend/admin-feature-integration.md
|
|
||||||
|
|
||||||
# ============================================
|
# --- Frontend ---
|
||||||
# FRONTEND (Development Reference)
|
- Frontend:
|
||||||
# ============================================
|
- Overview: frontend/overview.md
|
||||||
- Frontend Development:
|
- CDN Fallback Strategy: frontend/cdn-fallback-strategy.md
|
||||||
- Overview: frontend/overview.md
|
- Tailwind CSS Build: frontend/tailwind-css.md
|
||||||
- CDN Fallback Strategy: frontend/cdn-fallback-strategy.md
|
- Shared Components:
|
||||||
- Tailwind CSS Build: frontend/tailwind-css.md
|
- Component Standards: frontend/shared/component-standards.md
|
||||||
- Shared Components:
|
- Jinja Macros Library: frontend/shared/jinja-macros.md
|
||||||
- Component Standards: frontend/shared/component-standards.md
|
- UI Components: frontend/shared/ui-components.md
|
||||||
- Jinja Macros Library: frontend/shared/jinja-macros.md
|
- UI Components Quick Reference: frontend/shared/ui-components-quick-reference.md
|
||||||
- UI Components: frontend/shared/ui-components.md
|
- Pagination: frontend/shared/pagination.md
|
||||||
- UI Components Quick Reference: frontend/shared/ui-components-quick-reference.md
|
- Pagination Quick Start: frontend/shared/pagination-quick-start.md
|
||||||
- Pagination: frontend/shared/pagination.md
|
- Platform Settings: frontend/shared/platform-settings.md
|
||||||
- Pagination Quick Start: frontend/shared/pagination-quick-start.md
|
- Sidebar Implementation: frontend/shared/sidebar.md
|
||||||
- Platform Settings: frontend/shared/platform-settings.md
|
- Logging System: frontend/shared/logging.md
|
||||||
- Sidebar Implementation: frontend/shared/sidebar.md
|
- Admin Frontend:
|
||||||
- Logging System: frontend/shared/logging.md
|
- Architecture: frontend/admin/architecture.md
|
||||||
- Admin Frontend:
|
- Page Templates: frontend/admin/page-templates.md
|
||||||
- Architecture: frontend/admin/architecture.md
|
- Vendor Frontend:
|
||||||
- Page Templates: frontend/admin/page-templates.md
|
- Architecture: frontend/vendor/architecture.md
|
||||||
- Vendor Frontend:
|
- Page Templates: frontend/vendor/page-templates.md
|
||||||
- Architecture: frontend/vendor/architecture.md
|
- Shop Frontend:
|
||||||
- Page Templates: frontend/vendor/page-templates.md
|
- Architecture: frontend/shop/architecture.md
|
||||||
- Shop Frontend:
|
- Page Templates: frontend/shop/page-templates.md
|
||||||
- Architecture: frontend/shop/architecture.md
|
- E-commerce Components Proposal: frontend/shop/ecommerce-components-proposal.md
|
||||||
- Page Templates: frontend/shop/page-templates.md
|
- Authentication Pages: frontend/shop/authentication-pages.md
|
||||||
- E-commerce Components Proposal: frontend/shop/ecommerce-components-proposal.md
|
- Navigation Flow: frontend/shop/navigation-flow.md
|
||||||
- Authentication Pages: frontend/shop/authentication-pages.md
|
|
||||||
- Navigation Flow: frontend/shop/navigation-flow.md
|
|
||||||
|
|
||||||
# ============================================
|
# --- Development ---
|
||||||
# DEVELOPMENT (Shared Development Resources)
|
- Development:
|
||||||
# ============================================
|
- Contributing Guide: development/contributing.md
|
||||||
- Development:
|
- Code Quality: development/code-quality.md
|
||||||
- Contributing Guide: development/contributing.md
|
- Architecture Rules: development/architecture-rules.md
|
||||||
- Code Quality: development/code-quality.md
|
- Security Rules: development/security-rules.md
|
||||||
- Architecture Rules: development/architecture-rules.md
|
- Performance Rules: development/performance-rules.md
|
||||||
- Security Rules: development/security-rules.md
|
- Code Quality Dashboard: development/code-quality-dashboard-implementation.md
|
||||||
- Performance Rules: development/performance-rules.md
|
- Icons Guide: development/icons-guide.md
|
||||||
- Code Quality Dashboard: development/code-quality-dashboard-implementation.md
|
- Naming Conventions: development/naming-conventions.md
|
||||||
- Icons Guide: development/icons-guide.md
|
- Auth Dependencies Guide: development/auth-dependencies-guide.md
|
||||||
- Naming Conventions: development/naming-conventions.md
|
- Customer Authentication:
|
||||||
- Auth Dependencies Guide: development/auth-dependencies-guide.md
|
- Implementation Guide: development/customer-authentication-implementation.md
|
||||||
- Customer Authentication:
|
- Quick Summary: development/customer-auth-summary.md
|
||||||
- Implementation Guide: development/customer-authentication-implementation.md
|
- Exception Handling: development/exception-handling.md
|
||||||
- Quick Summary: development/customer-auth-summary.md
|
- Frontend Exception Handling: development/frontend-exception-handling.md
|
||||||
|
- Error Rendering:
|
||||||
|
- Developer Documentation: development/error-rendering/error-rendering-developer-documentation.md
|
||||||
|
- Flow Diagram: development/error-rendering/html-error-rendering-flow-diagram.md
|
||||||
|
- Environment Detection: development/environment-detection.md
|
||||||
|
- Database Seeder:
|
||||||
|
- Documentation: development/database-seeder/database-seeder-documentation.md
|
||||||
|
- Makefile Guide: development/database-seeder/makefile-database-seeder.md
|
||||||
|
- Init Guide: development/database-seeder/database-init-guide.md
|
||||||
|
- Quick Reference: development/database-seeder/database-quick-reference-guide.md
|
||||||
|
- Seed Scripts Audit: development/seed-scripts-audit.md
|
||||||
|
- PyCharm Setup:
|
||||||
|
- Make Configuration: development/pycharm-configuration-make.md
|
||||||
|
- Troubleshooting: development/troubleshooting.md
|
||||||
|
- Synology Repo: development/synology-github-repo.md
|
||||||
|
|
||||||
|
# --- Migrations & Implementation ---
|
||||||
- Migrations:
|
- Migrations:
|
||||||
- Database Migrations: development/migration/database-migrations.md
|
- Database Migrations: development/migration/database-migrations.md
|
||||||
- Language & i18n Implementation: development/migration/language-i18n-implementation.md
|
- Language & i18n Implementation: development/migration/language-i18n-implementation.md
|
||||||
@@ -139,6 +151,7 @@ nav:
|
|||||||
- Multi-Marketplace Product Architecture: development/migration/multi-marketplace-product-architecture.md
|
- Multi-Marketplace Product Architecture: development/migration/multi-marketplace-product-architecture.md
|
||||||
- Product Migration Database Changes: development/migration/product-migration-database-changes.md
|
- Product Migration Database Changes: development/migration/product-migration-database-changes.md
|
||||||
- Vendor Operations Expansion: development/migration/vendor-operations-expansion.md
|
- Vendor Operations Expansion: development/migration/vendor-operations-expansion.md
|
||||||
|
|
||||||
- Implementation Plans:
|
- Implementation Plans:
|
||||||
- Admin Inventory Management: implementation/inventory-admin-migration.md
|
- Admin Inventory Management: implementation/inventory-admin-migration.md
|
||||||
- Admin Notification System: implementation/admin-notification-system.md
|
- Admin Notification System: implementation/admin-notification-system.md
|
||||||
@@ -151,96 +164,67 @@ nav:
|
|||||||
- Unified Order View: implementation/unified-order-view.md
|
- Unified Order View: implementation/unified-order-view.md
|
||||||
- VAT Invoice Feature: implementation/vat-invoice-feature.md
|
- VAT Invoice Feature: implementation/vat-invoice-feature.md
|
||||||
- OMS Feature Plan: implementation/oms-feature-plan.md
|
- OMS Feature Plan: implementation/oms-feature-plan.md
|
||||||
- Seed Scripts Audit: development/seed-scripts-audit.md
|
|
||||||
- Database Seeder:
|
# --- Testing ---
|
||||||
- Documentation: development/database-seeder/database-seeder-documentation.md
|
- Testing:
|
||||||
- Makefile Guide: development/database-seeder/makefile-database-seeder.md
|
- Testing Guide: testing/testing-guide.md
|
||||||
- Init Guide: development/database-seeder/database-init-guide.md
|
- Test Maintenance: testing/test-maintenance.md
|
||||||
- Quick Reference: development/database-seeder/database-quick-reference-guide.md
|
- Test Structure: testing/test-structure.md
|
||||||
- Exception Handling: development/exception-handling.md
|
- Vendor API Testing: testing/vendor-api-testing.md
|
||||||
- Frontend Exception Handling: development/frontend-exception-handling.md
|
|
||||||
- Error Rendering:
|
# --- Deployment & Operations ---
|
||||||
- Developer Documentation: development/error-rendering/error-rendering-developer-documentation.md
|
- Deployment:
|
||||||
- Flow Diagram: development/error-rendering/html-error-rendering-flow-diagram.md
|
- Overview: deployment/index.md
|
||||||
- Environment Detection: development/environment-detection.md
|
- Docker: deployment/docker.md
|
||||||
- Contributing: development/contributing.md
|
- Production: deployment/production.md
|
||||||
- PyCharm Setup:
|
- Environment Variables: deployment/environment.md
|
||||||
- Make Configuration: development/pycharm-configuration-make.md
|
- Stripe Integration: deployment/stripe-integration.md
|
||||||
- Troubleshooting: development/troubleshooting.md
|
|
||||||
- Synology Repo: development/synology-github-repo.md
|
- Operations:
|
||||||
|
- Platform Health: operations/platform-health.md
|
||||||
|
- Capacity Monitoring: operations/capacity-monitoring.md
|
||||||
|
- Image Storage: operations/image-storage.md
|
||||||
|
|
||||||
|
- Troubleshooting:
|
||||||
|
- Shop Frontend: troubleshooting/shop-frontend.md
|
||||||
|
|
||||||
# ============================================
|
# ============================================
|
||||||
# TESTING
|
# BUSINESS (Features, Guides, Marketing)
|
||||||
# ============================================
|
# ============================================
|
||||||
- Testing:
|
- Business:
|
||||||
- Testing Guide: testing/testing-guide.md
|
# --- Features ---
|
||||||
- Test Maintenance: testing/test-maintenance.md
|
- Features:
|
||||||
- Test Structure: testing/test-structure.md
|
- Content Management System:
|
||||||
- Vendor API Testing: testing/vendor-api-testing.md
|
- Overview: features/content-management-system.md
|
||||||
|
- Implementation Guide: features/cms-implementation-guide.md
|
||||||
|
- Platform Homepage: features/platform-homepage.md
|
||||||
|
- Vendor Landing Pages: features/vendor-landing-pages.md
|
||||||
|
- Subscription & Billing: features/subscription-billing.md
|
||||||
|
|
||||||
# ============================================
|
# --- User Guides ---
|
||||||
# DEPLOYMENT
|
- User Guides:
|
||||||
# ============================================
|
- User Management: guides/user-management.md
|
||||||
- Deployment:
|
- Product Management: guides/product-management.md
|
||||||
- Overview: deployment/index.md
|
- Inventory Management: guides/inventory-management.md
|
||||||
- Docker: deployment/docker.md
|
- Shop Setup: guides/shop-setup.md
|
||||||
- Production: deployment/production.md
|
- CSV Import: guides/csv-import.md
|
||||||
- Environment Variables: deployment/environment.md
|
- Marketplace Integration: guides/marketplace-integration.md
|
||||||
- Stripe Integration: deployment/stripe-integration.md
|
- Letzshop:
|
||||||
|
- Admin Management: guides/letzshop-admin-management.md
|
||||||
|
- Order Integration: guides/letzshop-order-integration.md
|
||||||
|
- Marketplace API: guides/letzshop-marketplace-api.md
|
||||||
|
|
||||||
# ============================================
|
# --- Marketing ---
|
||||||
# OPERATIONS (Platform Health & Monitoring)
|
- Marketing:
|
||||||
# ============================================
|
- Overview: marketing/index.md
|
||||||
- Operations:
|
- Feature List & Roadmap: marketing/features.md
|
||||||
- Platform Health: operations/platform-health.md
|
- Pricing Strategy: marketing/pricing.md
|
||||||
- Capacity Monitoring: operations/capacity-monitoring.md
|
- Strategy:
|
||||||
- Image Storage: operations/image-storage.md
|
- Back-Office Positioning: marketing/strategy/back-office-positioning.md
|
||||||
|
- Customer & Marketing: marketing/strategy/customer-marketing-positioning.md
|
||||||
# ============================================
|
- Outreach Templates:
|
||||||
# FEATURES
|
- Letzshop Automation: marketing/outreach/letzshop-automation.md
|
||||||
# ============================================
|
- Website Vendors: marketing/outreach/website-vendors.md
|
||||||
- Features:
|
|
||||||
- Content Management System:
|
|
||||||
- Overview: features/content-management-system.md
|
|
||||||
- Implementation Guide: features/cms-implementation-guide.md
|
|
||||||
- Platform Homepage: features/platform-homepage.md
|
|
||||||
- Vendor Landing Pages: features/vendor-landing-pages.md
|
|
||||||
- Subscription & Billing: features/subscription-billing.md
|
|
||||||
|
|
||||||
# ============================================
|
|
||||||
# USER GUIDES
|
|
||||||
# ============================================
|
|
||||||
- User Guides:
|
|
||||||
- User Management: guides/user-management.md
|
|
||||||
- Product Management: guides/product-management.md
|
|
||||||
- Inventory Management: guides/inventory-management.md
|
|
||||||
- Shop Setup: guides/shop-setup.md
|
|
||||||
- CSV Import: guides/csv-import.md
|
|
||||||
- Marketplace Integration: guides/marketplace-integration.md
|
|
||||||
- Letzshop:
|
|
||||||
- Admin Management: guides/letzshop-admin-management.md
|
|
||||||
- Order Integration: guides/letzshop-order-integration.md
|
|
||||||
- Marketplace API: guides/letzshop-marketplace-api.md
|
|
||||||
|
|
||||||
# ============================================
|
|
||||||
# TROUBLESHOOTING
|
|
||||||
# ============================================
|
|
||||||
- Troubleshooting:
|
|
||||||
- Shop Frontend: troubleshooting/shop-frontend.md
|
|
||||||
|
|
||||||
# ============================================
|
|
||||||
# MARKETING (Business Development)
|
|
||||||
# ============================================
|
|
||||||
- Marketing:
|
|
||||||
- Overview: marketing/index.md
|
|
||||||
- Feature List & Roadmap: marketing/features.md
|
|
||||||
- Pricing Strategy: marketing/pricing.md
|
|
||||||
- Strategy:
|
|
||||||
- Back-Office Positioning: marketing/strategy/back-office-positioning.md
|
|
||||||
- Customer & Marketing: marketing/strategy/customer-marketing-positioning.md
|
|
||||||
- Outreach Templates:
|
|
||||||
- Letzshop Automation: marketing/outreach/letzshop-automation.md
|
|
||||||
- Website Vendors: marketing/outreach/website-vendors.md
|
|
||||||
|
|
||||||
# Theme configuration
|
# Theme configuration
|
||||||
theme:
|
theme:
|
||||||
@@ -251,7 +235,7 @@ theme:
|
|||||||
toggle:
|
toggle:
|
||||||
icon: material/brightness-auto
|
icon: material/brightness-auto
|
||||||
name: Switch to light mode
|
name: Switch to light mode
|
||||||
|
|
||||||
# Palette toggle for light mode
|
# Palette toggle for light mode
|
||||||
- media: "(prefers-color-scheme: light)"
|
- media: "(prefers-color-scheme: light)"
|
||||||
scheme: default
|
scheme: default
|
||||||
@@ -356,4 +340,4 @@ extra:
|
|||||||
link: https://github.com/yourusername
|
link: https://github.com/yourusername
|
||||||
|
|
||||||
# Copyright
|
# Copyright
|
||||||
copyright: Copyright © 2024-2025 Wizamart Team
|
copyright: Copyright © 2024-2025 Wizamart Team
|
||||||
|
|||||||
Reference in New Issue
Block a user