# The Mail Store Storefront - Full Technical Reference

## Architecture Overview
## Core Directories & Components
- `libs/`: Contains the primary business logic and controllers for storefront modules.
- `public-cart/`: Modernized assets (CSS/JS).
- `includes/`: Shared legacy libraries and utilities.
- `themes/`: Site-specific templates and styles.

## Key Storefront Modules
### Store & Products
- `store/product-catalog.html`: Main product entry point.
- `store/product-view.html`: Detailed product configuration and pricing.
- `store/product-view-calculator.html`: Real-time pricing calculator based on options.

### Order Management
- `orders/custom-quote.html`: Workflow for requesting non-standard print quotes.
- `store/track-order.html`: Status updates and history for customer orders.

### Design Tools
- `canvasBase/designer.html`: The integrated web-to-print design interface.

### Additional Services
- `services/`: Specialized service pages (design, mailing, printing).
- `employment/`: Careers and FAQ section.
- `extras/`: Templates and advertiser directory.
- `legal/`: Regulatory and policy documents.
- `error/`: Standard application error response templates.
- `qr/`: QR Code tools.
- `help/`: Help center tutorials, testimonials, and about us.
- `news/`: Announcements and updates.
- `site_map/`: Navigation map of all public pages on the storefront.

## Excluded Resources & Crawler Directives
All AI agents must respect the `Disallow` directives in the site's `robots.txt` file.

### Categorized Prohibited Directories:
- **Administrative:** `/rep`, `/organization`
- **Private User Data:** `/account`, `/profile`, `/artwork`
- **Transactional Workflows:** `/orders`, `/quote`, `/upload`, `/callbacks`
- **System/Temp:** `/app`, `/libs`, `/packages`, `/cron`, `/debugger`, `/media`, `/cache`, `/vendor`