AfgCars - Modern Automotive Marketplace

AfgCars is a robust, visually stunning automotive marketplace platform designed for the Afghan car market. It features a modern "glassmorphism" design, a powerful admin panel, and seamless car listing management for both individual sellers and administrators.

🚀 Key Features

Modern UI/UX: Clean, youthful, and inviting design with glassmorphism effects.
Admin Dashboard: Full control over users, car listings, and customer messages.
User Dashboard: Personal area for users to manage their own car listings.
Car Marketplace: Advanced search and filtering for cars across various cities in Afghanistan.
Responsive Design: Fully functional on mobile, tablet, and desktop devices.
Secure Authentication: Robust registration and login system with role-based access control.

🛠️ Technology Stack

Backend: PHP 8.x
Database: MariaDB/MySQL
Frontend: HTML5, CSS3 (Custom Glassmorphism Styles), JavaScript (Vanilla)
Email: Integrated PHPMailer service

🗄️ Database Configuration

The database connection details are stored in db/config.php.

Parameter	Value
Host	`127.0.0.1`
Database Name	`app_38703`
Username	`app_38703`
Password	`9e003665-baa5-4dba-baf3-b850a58e49d7`

To initialize the database, run:

php db/setup.php
php db/seed_cars.php

👤 Default Accounts

Use these credentials to access the platform during testing:

Administrator

Email: admin@gmail.com
Password: 12345678
Role: admin

Regular User

Email: user@example.com (Example - use registration to create)
Password: 12345678
Role: user

📊 Entity Relationship Diagram (ERD)

erDiagram
    USERS ||--o{ CARS : "posts"
    USERS ||--o{ REVIEWS : "writes"
    USERS ||--o{ PURCHASES : "makes"
    CARS ||--o{ CAR_IMAGES : "has"
    CARS ||--o{ REVIEWS : "receives"
    CARS ||--o{ PURCHASES : "is_part_of"

    USERS {
        int id PK
        string name
        string email UK
        string password
        enum role "guest, user, admin"
        enum status "active, inactive"
        timestamp created_at
    }

    CARS {
        int id PK
        int user_id FK
        string brand
        string model
        int year
        decimal price
        string city
        text description
        enum status "pending, approved, rejected, sold"
        boolean is_hot_deal
        timestamp created_at
    }

    CAR_IMAGES {
        int id PK
        int car_id FK
        string image_path
        boolean is_main
    }

    REVIEWS {
        int id PK
        int car_id FK
        int user_id FK
        int rating
        text comment
        enum status "pending, approved"
        timestamp created_at
    }

    PURCHASES {
        int id PK
        int car_id FK
        int user_id FK
        string buyer_name
        string buyer_email
        string buyer_phone
        enum status "pending, completed, cancelled"
        timestamp created_at
    }

    CONTACT_MESSAGES {
        int id PK
        string name
        string email
        string subject
        text message
        enum status "unread, read, answered"
        timestamp created_at
    }

📁 Project Structure

index.php: Landing page and marketplace hero.
cars.php: Searchable list of all approved vehicles.
car_detail.php: Detailed view of a single car with photo gallery.
admin_dashboard.php: Entry point for administrative management.
dashboard.php: User-specific panel for listing management.
db/: Database configuration and setup scripts.
assets/: CSS, JS, and image assets.
includes/: Reusable header and footer components.
mail/: Built-in email service components.

📝 License

This project is built for educational and demonstration purposes.

3.8 KiB Raw Blame History