# Minimalist T-Shirt E-Commerce Demo

A beautiful, self-contained, and completely responsive T-shirt e-commerce showcase built with Apple Store-like aesthetics.

## Features
- **Monochrome & Minimalist Aesthetic**: Apple Store-inspired design system with light and dark theme persistence.
- **Zero Build Tooling**: No `npm`, `composer`, or external databases. Runs on standard PHP built-in server.
- **Product Tiers**: Three tiers (Basic, Pro, Luxury) presented with individual configurators.
- **Dynamic Configurator**: Adjust sizes, conditions for trade-in discounts, and extended warranty plans with live updates.
- **Session-Based Bag**: Local shopping bag persisted across product details and pages.
- **Demo Checkout & Text-only Receipt**: Fully functional visual checkout flow.

## Running Locally

To run this application, make sure you have PHP 7.4 or higher installed on your machine.

### Windows (Double-Click)
Double-click `start.bat`. This automatically starts the local PHP server and opens the storefront in your web browser.

### Linux / macOS
Run the shell script:
```bash
chmod +x start.sh
./start.sh
```

### Manual Command
1. Open your terminal in this directory.
2. Start the built-in PHP server:
   ```bash
   php -S localhost:8000
   ```
3. Open your browser and navigate to `http://localhost:8000`.

---

## Admin Backend

The admin dashboard is located at `/admin` (e.g. `http://localhost:8000/admin`).

### Login Credentials
- **Username**: `admin`
- **Password**: `admin123`
*Note: This is demo-grade authentication intended for local simulation purposes.*

### Product Data Store
Products are stored in a flat JSON file at [data/products.json](file:///d:/Local%20Server/htdocs/0048_Local%20E-Commerce/data/products.json). Editing, adding, or deleting products in the admin panel updates this file immediately, and changes propagate dynamically to the frontend listings and product configurations.

### Dashboard Analytics Metrics
Daily metrics are logged in [data/analytics.json](file:///d:/Local%20Server/htdocs/0048_Local%20E-Commerce/data/analytics.json) and displayed on the dashboard:
- **Today's Visitors**: Tracks unique PHP sessions visiting the site during the calendar day.
- **Order Requests**: Measures checkout initiation attempts (hits on the `checkout.php` page).
- **Items Sold**: The total count of products purchased in completed checkout sessions (`success.php`).

### Self-Hosted Hero Video
- **File Location**: [assets/video/hero.mp4](file:///d:/Local%20Server/htdocs/0048_Local%20E-Commerce/assets/video/hero.mp4)
- **Fallback Poster Image**: [assets/video/poster.png](file:///d:/Local%20Server/htdocs/0048_Local%20E-Commerce/assets/video/poster.png)
- **Swapping Video**: To use a custom video, replace the file at `assets/video/hero.mp4` with your preferred MP4 file. The video will automatically auto-crop and loop to fit the hero banner layout.