AFG CARS - Premium Car Marketplace Afghanistan

Welcome to AFG CARS, an enterprise-level automotive marketplace platform specifically designed for the Afghanistan market (2026 Edition). This application provides a seamless experience for buying, selling, and managing vehicle listings with a modern, high-end UI and robust administrative features.

🚀 Key Features

1. Advanced Marketplace

Verified Listings: High-quality vehicle listings with detailed specifications.
Smart Search: Filter by Brand, Model, Year, Location (Kabul, Herat, etc.), and Price range.
Badging System: Visual indicators for "Hot Deals" and "SOLD" status.

2. Role-Based Access Control (RBAC)

Guests: Browse cars, search the market, and view company information.
Registered Users: List their own cars for sale, manage favorites, track purchases, and submit reviews.
Administrators: Full control over listing approvals, user management, sales tracking, and system notifications.

3. User & Admin Dashboards

User Hub: Track pending/approved listings, manage personal car ads, and view purchase history.
Admin Command Center: Review user-submitted cars for approval, view total revenue, manage users, and receive real-time alerts.

4. Enterprise-Grade Systems

Review & Rating System: Users can rate vehicles and leave feedback for sold items.
Simulated Purchase System: Integrated "Buy Now" flow featuring major Afghanistan banks (DAB, Azizi, AIB, etc.).
Contact & Mail Integration: Functional contact forms using the platform's internal mail service.

5. Physical Presence

Detailed information about physical showrooms in Kabul, Herat, Mazar-i-Sharif, and Kandahar.

🛠 Tech Stack

Language: PHP 8.x (Vanilla)
Database: MariaDB / MySQL (via PDO)
Frontend: Bootstrap 5, Inter Typography, Bi-Icons
Styling: Custom CSS with modern glassmorphism and soft gradient effects
AI Integration: Local AI Proxy for advanced processing
Mail Service: PHPMailer-based MailService

⚙️ Installation & How to Run

Prerequisites

A web server (Apache/Nginx) with PHP 8.x support.
MariaDB or MySQL database server.

Setup Steps

Clone the Repository: Place the project files into your web server's document root (e.g., /var/www/html or htdocs).
Database Configuration:
- Open db/config.php and update the DB_HOST, DB_NAME, DB_USER, and DB_PASS constants to match your local environment.
- Run the database initialization script by visiting http://your-domain/db/setup.php in your browser. This will create the necessary tables and seed the initial admin user.
- Alternatively, run php db/run_migrations.php from the terminal.
Environment Variables: Ensure your .env file (if applicable) contains the necessary mail and AI configuration as described in the system documentation.
Access the Site: Open your browser and navigate to the project root (e.g., http://localhost).

🔐 Default Credentials (Enterprise Edition)

Role	Email	Password
Admin	`admin@gmail.com`	`12345678`

📁 Project Structure

index.php - Enterprise landing page with "Hot Deals" and Hero section.
cars.php - Marketplace search and listing page.
admin/ - Administrative dashboard and management scripts.
user/ - Registered user dashboard and car submission area.
db/ - Database configuration, setup scripts, and migrations.
includes/ - Reusable UI components (Header, Footer).
assets/ - CSS, JS, and image assets.
mail/ - Integrated mail service logic.

📄 License & Notes

This project is built for the Flatlogic LAMP VM.

Reminder: Always click Save in the Flatlogic editor to sync changes to the platform.
SEO: Every page is optimized with unique meta titles and descriptions for maximum visibility.

Last Updated: February 13, 2026

4.0 KiB Raw Blame History