xobiya/car-broker-showcase
Domain:
digital infrastructureRecord type:
software
Creator:
xob
Host:
AutoBroker Ethiopia is a premium, full-stack web application that digitises the vehicle brokerage business in Ethiopia. It enables brokers to list and manage imported vehicles, buyers to browse and inquire about cars priced in ETB (Ethiopian Birr), and administrators to oversee the entire procurement pipeline.
# 🚗 AutoBroker Ethiopia — Elite Vehicle Procurement Concierge
**A full-stack vehicle procurement platform tailored for the Ethiopian automotive market.**
---
## 📖 Overview
**AutoBroker Ethiopia** is a premium, full-stack web application that digitises the vehicle brokerage business in Ethiopia. It enables brokers to list and manage imported vehicles, buyers to browse and inquire about cars priced in ETB (Ethiopian Birr), and administrators to oversee the entire procurement pipeline.
The platform runs seamlessly with an **in-memory simulated database** (zero setup) or a production **MySQL** backend.
---
## ✨ Features
### 🏠 Public Showroom
- Browse premium, broker-approved vehicle listings
- Filter by brand, fuel type, transmission, and price range
- Detailed vehicle pages with full specs, mileage, and sourcing savings
- Submit buyer inquiries (leads) directly from a vehicle listing
### 👤 Authentication
- Lightweight email-based registration and login (no passwords)
- Role-based access: `buyer`, `broker`, `admin`
### 🧑💼 Broker Dashboard
- View your personal vehicle listings and their statuses (`pending`, `approved`, `sold`)
- Track buyer inquiries and leads tied to your listings
- Review your commission earnings
### 🛡️ Admin Panel
- Full vehicle lifecycle management: approve, edit, or delete listings
- Lead management with status tracking (`new` → `contacted` → `negotiating` → `sold`)
- Sales recording and revenue/commission analytics
- Real-time dashboard statistics (total vehicles, leads, revenue, commissions)
---
## 🏗️ Tech Stack
| Layer | Technology |
|---|---|
| **Frontend** | React 19, TypeScript, Vite 6, Tailwind CSS v4 |
| **Backend** | Node.js, Express 4, TypeScript (`tsx` dev runner) |
| **Database** | MySQL 2 (optional) / In-Memory fallback |
| **Animations** | Motion (Framer Motion v12) |
| **Icons** | Lucide React |
| **Build** | esbuild (production bundle) |
---
## 📁 Project Structure
```
car-broker-showcase/
├── backend/ …