# AFG CARS - Premium Car Marketplace Afghanistan

Welcome to **AFG CARS**, an enterprise-level automotive marketplace platform specifically designed for the Afghanistan market (2026 Edition). This application provides a seamless experience for buying, selling, and managing vehicle listings with a modern, high-end UI and robust administrative features.

---

## 🚀 Key Features

### 1. Advanced Marketplace
* **Verified Listings:** High-quality vehicle listings with detailed specifications.
* **Smart Search:** Filter by Brand, Model, Year, Location (Kabul, Herat, etc.), and Price range.
* **Badging System:** Visual indicators for "Hot Deals" and "SOLD" status.

### 2. Role-Based Access Control (RBAC)
* **Guests:** Browse cars, search the market, and view company information.
* **Registered Users:** List their own cars for sale, manage favorites, track purchases, and submit reviews.
* **Administrators:** Full control over listing approvals, user management, sales tracking, and system notifications.

### 3. User & Admin Dashboards
* **User Hub:** Track pending/approved listings, manage personal car ads, and view purchase history.
* **Admin Command Center:** Review user-submitted cars for approval, view total revenue, manage users, and receive real-time alerts.

### 4. Enterprise-Grade Systems
* **Review & Rating System:** Users can rate vehicles and leave feedback for sold items.
* **Simulated Purchase System:** Integrated "Buy Now" flow featuring major Afghanistan banks (DAB, Azizi, AIB, etc.).
* **Contact & Mail Integration:** Functional contact forms using the platform's internal mail service.

### 5. Physical Presence
* Detailed information about physical showrooms in **Kabul, Herat, Mazar-i-Sharif, and Kandahar**.

---

## 🛠 Tech Stack

*   **Language:** PHP 8.x (Vanilla)
*   **Database:** MariaDB / MySQL (via PDO)
*   **Frontend:** Bootstrap 5, Inter Typography, Bi-Icons
*   **Styling:** Custom CSS with modern glassmorphism and soft gradient effects
*   **AI Integration:** Local AI Proxy for advanced processing
*   **Mail Service:** PHPMailer-based `MailService`

---

## ⚙️ Installation & How to Run

### Prerequisites
*   A web server (Apache/Nginx) with PHP 8.x support.
*   MariaDB or MySQL database server.

### Setup Steps
1.  **Clone the Repository:**
    Place the project files into your web server's document root (e.g., `/var/www/html` or `htdocs`).

2.  **Database Configuration:**
    *   Open `db/config.php` and update the `DB_HOST`, `DB_NAME`, `DB_USER`, and `DB_PASS` constants to match your local environment.
    *   Run the database initialization script by visiting `http://your-domain/db/setup.php` in your browser. This will create the necessary tables and seed the initial admin user.
    *   Alternatively, run `php db/run_migrations.php` from the terminal.

3.  **Environment Variables:**
    Ensure your `.env` file (if applicable) contains the necessary mail and AI configuration as described in the system documentation.

4.  **Access the Site:**
    Open your browser and navigate to the project root (e.g., `http://localhost`).

---

## 🔐 Default Credentials (Enterprise Edition)

| Role | Email | Password |
| :--- | :--- | :--- |
| **Admin** | `admin@gmail.com` | `12345678` |

---

## 📁 Project Structure

*   `index.php` - Enterprise landing page with "Hot Deals" and Hero section.
*   `cars.php` - Marketplace search and listing page.
*   `admin/` - Administrative dashboard and management scripts.
*   `user/` - Registered user dashboard and car submission area.
*   `db/` - Database configuration, setup scripts, and migrations.
*   `includes/` - Reusable UI components (Header, Footer).
*   `assets/` - CSS, JS, and image assets.
*   `mail/` - Integrated mail service logic.

---

## 📄 License & Notes

This project is built for the **Flatlogic LAMP VM**. 
*   **Reminder:** Always click **Save** in the Flatlogic editor to sync changes to the platform.
*   **SEO:** Every page is optimized with unique meta titles and descriptions for maximum visibility.

---
*Last Updated: February 13, 2026*