50 lines
2.5 KiB
Markdown
50 lines
2.5 KiB
Markdown
# 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. |