sadiq
This commit is contained in:
Flatlogic Bot
parent
0c0cc2ad68
commit
c7120bdcbd
109
README.md
Normal file
109
README.md
Normal file
@ -0,0 +1,109 @@
|
||||
# Premium Car Marketplace - Afghanistan 2026 🇦🇫
|
||||
**University Final-Year Project by Mohammad Sadiq**
|
||||
|
||||
Welcome to the **Premium Car Marketplace**, a high-end web application specifically designed for the automotive market in Afghanistan. This project combines modern "Glassmorphism" UI design with a robust PHP backend to provide a seamless car buying and selling experience.
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Project Overview
|
||||
This platform is a comprehensive car listing and management system. It features:
|
||||
- **Hot Deals Section:** Highlighting premium listings on the homepage.
|
||||
- **Dynamic Browsing:** Search and filter through over 20 detailed car listings across Kabul, Herat, Mazar-i-Sharif, and more.
|
||||
- **Detailed Specifications:** Each car has a dedicated page with high-quality images and technical details.
|
||||
- **Contact System:** Integrated messaging for buyers to reach out.
|
||||
- **Admin Management:** Secure backend for listing control.
|
||||
|
||||
---
|
||||
|
||||
## 🛠 Tech Stack
|
||||
- **Backend:** PHP 8.x (Vanilla PHP for high performance)
|
||||
- **Database:** MariaDB / MySQL (using PDO for secure, prepared statements)
|
||||
- **Frontend:** HTML5, Custom CSS3 (No Bootstrap - 100% custom Obsidian & Gold design system)
|
||||
- **Design Pattern:** Glassmorphism (Translucent backgrounds, vibrant accents)
|
||||
- **Image Sourcing:** Pexels API integration for high-quality automotive visuals.
|
||||
|
||||
---
|
||||
|
||||
## 💻 How to Run This Project
|
||||
|
||||
### Prerequisites
|
||||
1. **XAMPP / WAMP / MAMP:** Ensure you have a local server environment installed.
|
||||
2. **PHP 8.0+**
|
||||
3. **MySQL/MariaDB**
|
||||
|
||||
### Setup Instructions
|
||||
1. **Clone the Project:** Place the project folder inside your server's root directory (e.g., `htdocs` for XAMPP).
|
||||
2. **Database Configuration:**
|
||||
- Open your PHPMyAdmin.
|
||||
- Create a new database named `car_marketplace`.
|
||||
- Import the `db/database.sql` file located in the project folder.
|
||||
- Verify `db/config.php` matches your local credentials:
|
||||
```php
|
||||
define('DB_HOST', '127.0.0.1');
|
||||
define('DB_NAME', 'car_marketplace');
|
||||
define('DB_USER', 'root');
|
||||
define('DB_PASS', '');
|
||||
```
|
||||
3. **Initialize Data:**
|
||||
- Run the `setup.php` file in your browser (`http://localhost/your-folder/setup.php`) to ensure all tables and demo data are correctly initialized.
|
||||
4. **Access the Site:**
|
||||
- Open `http://localhost/your-folder/index.php` in your browser.
|
||||
|
||||
---
|
||||
|
||||
## 📊 Database Documentation
|
||||
|
||||
### Entity Relationship
|
||||
The database consists of three primary tables:
|
||||
|
||||
1. **`users`**: Stores user accounts with roles (`admin`, `user`).
|
||||
- `id`: Primary Key
|
||||
- `role`: Distinguishes between standard users and site managers.
|
||||
2. **`cars`**: The core data table.
|
||||
- `brand`, `model`, `year`, `price`: Primary specifications.
|
||||
- `city`: Location-based filtering (Kabul, Herat, etc.).
|
||||
- `is_hot_deal`: Flag for homepage promotion.
|
||||
3. **`contact_messages`**: Stores inquiries from the contact form.
|
||||
|
||||
### Initial Admin Credentials
|
||||
- **Email:** `admin@gmail.com`
|
||||
- **Password:** `12345678`
|
||||
|
||||
---
|
||||
|
||||
## 📚 Project Monograph (University Report)
|
||||
|
||||
### 1. Abstract
|
||||
The "Premium Car Marketplace" is a digital solution addressing the lack of centralized, high-quality automotive platforms in Afghanistan. By utilizing a modern tech stack and custom UI design, the project demonstrates how localized software can meet international standards of quality and performance.
|
||||
|
||||
### 2. Introduction
|
||||
In the current digital age, the automotive industry in Afghanistan relies heavily on social media groups which lack structure and security. This project proposes a centralized web platform that provides structure, verification, and a premium user experience for both buyers and sellers.
|
||||
|
||||
### 3. System Objectives
|
||||
- **Standardization:** Create a uniform way to list car specifications.
|
||||
- **Aesthetics:** Implement a "Dark Mode" Obsidian & Gold UI for a premium brand feel.
|
||||
- **Security:** Use SQL injection prevention and secure password hashing.
|
||||
- **User Engagement:** Provide interactive elements and smooth transitions.
|
||||
|
||||
### 4. Design Philosophy
|
||||
The UI follows the **Glassmorphism** trend, which utilizes:
|
||||
- **Blur Effects:** Creating depth with semi-transparent layers.
|
||||
- **Vibrant Accents:** Using Gold (`#d4af37`) against Obsidian (`#0f0f12`) for high contrast.
|
||||
- **Responsiveness:** A custom grid system that works on mobile, tablet, and desktop.
|
||||
|
||||
### 5. Methodology
|
||||
The project was developed using the **Agile** methodology, starting with a core database schema, followed by modular PHP component development (headers, footers, database helpers), and finally, the implementation of the custom CSS design system.
|
||||
|
||||
### 6. Conclusion
|
||||
This system proves that high-performance, visually stunning web applications can be built with minimal external dependencies. It serves as a solid foundation for a real-world enterprise application in the Afghanistan tech sector.
|
||||
|
||||
---
|
||||
|
||||
## 👤 Developer Information
|
||||
- **Name:** Mohammad Sadiq
|
||||
- **Project Role:** Full-Stack Developer & UI/UX Designer
|
||||
- **University Project Year:** 2026
|
||||
- **Contact:** admin@gmail.com
|
||||
|
||||
---
|
||||
*Note: This project was generated as part of a University Final-Year Project simulation.*
|
||||
Loading…
x
Reference in New Issue
Block a user