62 lines
2.0 KiB
Markdown
62 lines
2.0 KiB
Markdown
# Car Sells in Afghanistan
|
|
|
|
A modern, responsive car marketplace web application.
|
|
|
|
## Features
|
|
|
|
* **Car Listings:** Browse approved cars with filters (Make, Province, Price).
|
|
* **Sell Your Car:** Users can submit cars for sale (requires Admin approval).
|
|
* **Buying System:** Secure "Buy Now" flow with Bank Details capture.
|
|
* **Receipts:** Auto-generated printable receipts for sold cars.
|
|
* **Admin Dashboard:**
|
|
* Analytics (Revenue, Sales, Inventory).
|
|
* Approve/Reject Car Requests.
|
|
* Manage Users and Inventory.
|
|
* **Responsive Design:** Built with Bootstrap 5.
|
|
|
|
## Local Setup Instructions (XAMPP/LAMP)
|
|
|
|
1. **Clone/Copy** the project files to your web server root (e.g., `htdocs` or `/var/www/html`).
|
|
2. **Database Setup:**
|
|
* Create a MySQL database named `car_dealership`.
|
|
* Import the database structure. You can run the `setup_project.php` script if available, or manually import `db/migrations/*.sql`.
|
|
* **Quick Setup:** Access `http://localhost/setup_project.php` in your browser (if deployed).
|
|
3. **Configuration:**
|
|
* Edit `db/config.php` if your DB credentials differ from the defaults (User: `root`, Pass: empty).
|
|
4. **Run the App:**
|
|
* Open `http://localhost/` in your browser.
|
|
|
|
## Credentials
|
|
|
|
* **Admin User:**
|
|
* Username: `admin`
|
|
* Password: `123` (or `12345678` if updated manually)
|
|
|
|
## Usage Guide
|
|
|
|
### Selling a Car
|
|
1. Register/Login.
|
|
2. Click "Sell Your Car" in the navigation.
|
|
3. Fill out the form and upload an image.
|
|
4. Status will be "Pending" until approved by Admin.
|
|
|
|
### Buying a Car
|
|
1. Login.
|
|
2. Click on a car (must be "Approved").
|
|
3. Click "Buy Now".
|
|
4. Enter Bank Province and Account Number.
|
|
5. Confirm. You will be redirected to the Receipt.
|
|
|
|
### Admin Panel
|
|
1. Login as Admin.
|
|
2. Go to "Admin Panel" (dropdown menu).
|
|
3. **Sales Requests:** Approve newly submitted cars here.
|
|
4. **Sales History:** View all sold cars and revenue.
|
|
|
|
## Screenshots
|
|
|
|
*(Placeholders)*
|
|
* [Home Page]
|
|
* [Admin Dashboard]
|
|
* [Receipt]
|