Files
orion/mkdocs.yml
Samir Boulahtit 86d67b5cfb feat: add customer authentication pages and documentation
Add complete customer authentication UI with login, registration,
forgot password, and dashboard pages.

Templates Added:
- app/templates/shop/account/login.html
  - Two-column layout with vendor branding
  - Email/password login with validation
  - Password visibility toggle
  - "Remember me" functionality
  - Error/success alerts
  - Loading states with spinner
- app/templates/shop/account/register.html
  - Customer registration form
  - Client-side validation (password strength, email format)
  - Marketing consent checkbox
  - Confirm password matching
- app/templates/shop/account/forgot-password.html
  - Password reset request page
  - Email validation
  - Success confirmation
- app/templates/shop/account/dashboard.html
  - Customer account dashboard
  - Overview of orders, profile, addresses

Styles Added:
- static/shared/css/auth.css
  - Authentication page styling
  - Two-column layout system
  - Form components and validation states
  - Theme-aware with CSS variables
  - Dark mode support
  - Mobile responsive
- static/shared/css/base.css updates
  - Enhanced utility classes
  - Additional form styles
  - Improved button states

Documentation Added:
- docs/frontend/shop/authentication-pages.md
  - Comprehensive guide to auth page implementation
  - Component architecture
  - API integration patterns
  - Theme customization
- docs/development/CUSTOMER_AUTHENTICATION_IMPLEMENTATION.md
  - Implementation details and technical decisions
  - Security considerations
  - Testing procedures
- docs/development/CUSTOMER_AUTH_SUMMARY.md
  - Quick reference guide
  - Endpoints and flows
- Updated docs/frontend/shop/architecture.md
  - Added authentication section
  - Documented all auth pages
- Updated docs/frontend/shop/page-templates.md
  - Added auth template documentation
- Updated mkdocs.yml
  - Added new documentation pages to navigation

Features:
- Full theme integration with vendor branding
- Alpine.js reactive components
- Tailwind CSS utility-first styling
- Client and server-side validation
- JWT token management
- Multi-access routing support (domain/subdomain/path)
- Error handling with user-friendly messages
- Loading states and animations
- Mobile responsive design
- Dark mode support

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-25 21:09:27 +01:00

284 lines
9.8 KiB
YAML

site_name: Wizamart Platform Documentation
site_description: Complete documentation for the Wizamart multi-tenant e-commerce platform
site_author: Wizamart Team
site_url: https://yourusername.github.io/wizamart/
repo_name: wizamart-platform
repo_url: https://github.com/yourusername/wizamart-platform
edit_uri: edit/main/docs/
nav:
- Home: index.md
# ============================================
# GETTING STARTED
# ============================================
- Getting Started:
- Installation: getting-started/installation.md
- Quick Start: getting-started/quickstart.md
- Database Setup:
- Overview: getting-started/database-setup.md
- Complete Setup Guide: getting-started/DATABASE_SETUP_GUIDE.md
- Quick Reference: getting-started/DATABASE_QUICK_REFERENCE.md
- CMS Quick Start: getting-started/cms-quick-start.md
- Configuration: getting-started/configuration.md
# ============================================
# ARCHITECTURE (System-wide concepts)
# ============================================
- Architecture:
- Overview: architecture/overview.md
- Multi-Tenant System: architecture/multi-tenant.md
- Middleware Stack: architecture/middleware.md
- Request Flow: architecture/request-flow.md
- Authentication & RBAC: architecture/auth-rbac.md
- API Consolidation:
- Proposal: architecture/API_CONSOLIDATION_PROPOSAL.md
- Migration Status: architecture/API_MIGRATION_STATUS.md
- Diagrams:
- Multi-Tenant Diagrams: architecture/diagrams/multitenant-diagrams.md
- Vendor Domain Diagrams: architecture/diagrams/vendor-domain-diagrams.md
- Theme System:
- Overview: architecture/theme-system/overview.md
- Theme Presets: architecture/theme-system/presets.md
- URL Routing:
- Overview: architecture/url-routing/overview.md
# ============================================
# API DOCUMENTATION (For API Consumers)
# ============================================
- API Documentation:
- Overview: api/index.md
- Shop API Reference: api/shop-api-reference.md
- Authentication:
- Guide: api/authentication.md
- Quick Reference: api/authentication-quick-reference.md
- Flow Diagrams: api/authentication-flow-diagrams.md
- RBAC:
- Developer Guide: api/RBAC.md
- Visual Guide: api/rbac-visual-guide.md
- Error Handling: api/error-handling.md
- Rate Limiting: api/rate-limiting.md
# ============================================
# BACKEND (Development Reference)
# ============================================
- Backend Development:
- Overview: backend/overview.md
- Middleware Reference: backend/middleware-reference.md
- RBAC Quick Reference: backend/rbac-quick-reference.md
- Admin Integration Guide: backend/admin-integration-guide.md
- Admin Feature Integration: backend/admin-feature-integration.md
# ============================================
# FRONTEND (Development Reference)
# ============================================
- Frontend Development:
- Overview: frontend/overview.md
- CDN Fallback Strategy: frontend/cdn-fallback-strategy.md
- Shared Components:
- UI Components: frontend/shared/ui-components.md
- UI Components Quick Reference: frontend/shared/ui-components-quick-reference.md
- Pagination: frontend/shared/pagination.md
- Pagination Quick Start: frontend/shared/pagination-quick-start.md
- Sidebar Implementation: frontend/shared/sidebar.md
- Logging System: frontend/shared/logging.md
- Admin Frontend:
- Architecture: frontend/admin/architecture.md
- Page Templates: frontend/admin/page-templates.md
- Vendor Frontend:
- Architecture: frontend/vendor/architecture.md
- Page Templates: frontend/vendor/page-templates.md
- Shop Frontend:
- Architecture: frontend/shop/architecture.md
- Page Templates: frontend/shop/page-templates.md
- Authentication Pages: frontend/shop/authentication-pages.md
- Navigation Flow: frontend/shop/navigation-flow.md
# ============================================
# DEVELOPMENT (Shared Development Resources)
# ============================================
- Development:
- Icons Guide: development/icons_guide.md
- Naming Conventions: development/naming-conventions.md
- Auth Dependencies Guide: development/AUTH_DEPENDENCIES_GUIDE.md
- Customer Authentication:
- Implementation Guide: development/CUSTOMER_AUTHENTICATION_IMPLEMENTATION.md
- Quick Summary: development/CUSTOMER_AUTH_SUMMARY.md
- Database Migrations: development/database-migrations.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
- Exception Handling: development/exception-handling.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
- Contributing: development/contributing.md
- PyCharm Setup:
- Make Configuration: development/pycharm-configuration-make.md
- Troubleshooting: development/troubleshooting.md
- Synology Repo: development/synology-github-repo.md
# ============================================
# TESTING
# ============================================
- Testing:
- Testing Guide: testing/testing-guide.md
- Test Maintenance: testing/test-maintenance.md
- Test Structure: testing/test-structure.md
- Vendor API Testing: testing/vendor-api-testing.md
# ============================================
# DEPLOYMENT
# ============================================
- Deployment:
- Overview: deployment/index.md
- Docker: deployment/docker.md
- Production: deployment/production.md
- Environment Variables: deployment/environment.md
- Stripe Integration: deployment/stripe-integration.md
# ============================================
# FEATURES
# ============================================
- Features:
- Content Management System:
- Overview: features/content-management-system.md
- Implementation Guide: features/cms-implementation-guide.md
- Vendor Landing Pages: features/vendor-landing-pages.md
# ============================================
# USER GUIDES
# ============================================
- User Guides:
- User Management: guides/user-management.md
- Product Management: guides/product-management.md
- Shop Setup: guides/shop-setup.md
- CSV Import: guides/csv-import.md
- Marketplace Integration: guides/marketplace-integration.md
# ============================================
# TROUBLESHOOTING
# ============================================
- Troubleshooting:
- Shop Frontend: troubleshooting/shop-frontend.md
# Theme configuration
theme:
name: material
palette:
# Palette toggle for automatic mode
- media: "(prefers-color-scheme)"
toggle:
icon: material/brightness-auto
name: Switch to light mode
# Palette toggle for light mode
- media: "(prefers-color-scheme: light)"
scheme: default
primary: blue
accent: blue
toggle:
icon: material/brightness-7
name: Switch to dark mode
# Palette toggle for dark mode
- media: "(prefers-color-scheme: dark)"
scheme: slate
primary: blue
accent: blue
toggle:
icon: material/brightness-4
name: Switch to system preference
features:
- navigation.tabs
- navigation.tabs.sticky
- navigation.sections
- navigation.expand
- navigation.path
- navigation.indexes
- toc.follow
- navigation.top
- search.suggest
- search.highlight
- content.tabs.link
- content.code.annotation
- content.code.copy
- content.action.edit
- content.action.view
icon:
repo: fontawesome/brands/github
# Plugins
plugins:
- search:
separator: '[\s\-,:!=\[\]()"`/]+|\.(?!\d)|&[lg]t;|(?!\b)(?=[A-Z][a-z])'
- mkdocstrings:
handlers:
python:
options:
docstring_style: google
show_source: true
show_root_heading: true
show_root_toc_entry: false
merge_init_into_class: true
# Markdown extensions
markdown_extensions:
- abbr
- admonition
- attr_list
- def_list
- footnotes
- md_in_html
- toc:
permalink: true
- pymdownx.arithmatex:
generic: true
- pymdownx.betterem:
smart_enable: all
- pymdownx.caret
- pymdownx.details
- pymdownx.emoji:
emoji_generator: !!python/name:material.extensions.emoji.to_svg
emoji_index: !!python/name:material.extensions.emoji.twemoji
- pymdownx.highlight:
anchor_linenums: true
line_spans: __span
pygments_lang_class: true
- pymdownx.inlinehilite
- pymdownx.keys
- pymdownx.magiclink:
normalize_issue_symbols: true
repo_url_shorthand: true
user: yourusername
repo: letzshop-import
- pymdownx.mark
- pymdownx.smartsymbols
- pymdownx.snippets
- pymdownx.superfences:
custom_fences:
- name: mermaid
class: mermaid
format: !!python/name:pymdownx.superfences.fence_code_format
- pymdownx.tabbed:
alternate_style: true
combine_header_slug: true
- pymdownx.tasklist:
custom_checkbox: true
- pymdownx.tilde
# Footer
extra:
social:
- icon: fontawesome/brands/github
link: https://github.com/yourusername
# Copyright
copyright: Copyright &copy; 2024-2025 Wizamart Team