# AFG CARS - Premium Car Marketplace Afghanistan (Offline Edition)

AFG CARS is a modern, responsive web application for buying and selling cars in Afghanistan. This version is specially prepared to run **completely offline** on a local XAMPP environment.

## 🚀 Key Features
- **Offline Ready**: No internet connection required. All assets (Bootstrap, Icons) are stored locally.
- **Car Listings**: Browse verified car listings across major Afghan cities (Kabul, Herat, etc.).
- **User Authentication**: Secure Login and Registration system.
- **Admin Dashboard**: Comprehensive panel for managing inventory, approvals, users, and sales.
- **User Dashboard**: Manage your own listings and view purchase history.
- **Simulation Systems**: Simulated banking payment and local mail logging.

## 💻 Installation (XAMPP)

1. **Move Project Folder**:
   - Copy the `afg-cars` folder into your XAMPP's `htdocs` directory (usually `C:\xampp\htdocs\`).

2. **Start Services**:
   - Open the XAMPP Control Panel.
   - Start **Apache** and **MySQL**.

3. **Database Setup (Automatic)**:
   - Open your browser and go to: `http://localhost/afg-cars/db/setup.php`
   - This script will automatically create the `afg_cars` database and all required tables.
   - It will also insert a default admin account and sample listings.

4. **Database Setup (Manual - Optional)**:
   - Go to `http://localhost/phpmyadmin/`.
   - Create a database named `afg_cars`.
   - Import the `db/database.sql` file.

## 🔐 Default Admin Credentials
- **Email**: `admin@gmail.com`
- **Password**: `12345678`

## 📁 Project Structure
- `admin/`: Admin-specific pages and dashboards.
- `assets/`: Local CSS, JS, and Bootstrap files.
- `db/`: Database configuration, setup script, and SQL schema.
- `includes/`: Reusable header and footer components.
- `mail/`: Offline mail simulation service.
- `user/`: User-specific dashboard and listing management.

## 🛠 Troubleshooting
- **Database Connection Error**: Ensure MySQL is running in XAMPP. Check `db/config.php` if you have changed the default XAMPP MySQL credentials (default is `root` with no password).
- **Broken Layout**: Ensure the `assets/bootstrap/` folder contains the required CSS and JS files.
- **Page Not Found**: Ensure you are accessing the project via `http://localhost/afg-cars/`.

## 🎓 University Project Note
This system is designed as a university final-year project to demonstrate full-stack web development capabilities using PHP, MySQL, and Bootstrap, with a focus on local enterprise deployment.