YeboCars Architecture Overview
Formerly known as Bamzu — A TikTok-style car marketplace with AI-powered search, VIN lookup, and dealer management.
System Architecture
┌─────────────────────────────────────────────────────────────────┐
│ YeboCars Platform │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ Frontend │ │ API │ │ Services │ │
│ │ (React) │◄──►│ (Express) │◄──►│ (Business) │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ TikTok-style│ │ Middleware │ │ AI Services │ │
│ │ Car Browser │ │ (Auth, Rate) │ │ (Search) │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
│ │ │ │
│ ▼ ▼ │
│ ┌──────────────────────────────┐ │
│ │ PostgreSQL + Prisma │ │
│ │ (20+ Models) │ │
│ └──────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘Technology Stack
| Layer | Technology | Purpose |
|---|---|---|
| Frontend | React + TypeScript | TikTok-style car browser |
| API | Express.js + TypeScript | RESTful API server |
| Database | PostgreSQL + Prisma | Data persistence with ORM |
| AI | Natural Language Search | AI-powered car matching |
| VIN | VIN Decoder Service | Vehicle identification |
| Payments | Stripe | Dealer subscription billing |
| Hosting | Google Cloud Run | Auto-scaling containers |
Core Features
🚗 Car Marketplace Features
- Car Listings — Comprehensive vehicle listings with specs
- TikTok-Style Browsing — Vertical swipe interface for car discovery
- Multi-Country — Country-specific pricing and currency
- Dealer & Private Sellers — Both dealer and private listings
🔍 AI Search
- Natural Language Search — "Show me SUVs under $30k good for families"
- Lifestyle Recommendations — Match cars to user lifestyle
- Price Insights — Market position analysis
🔢 VIN Services
- VIN Lookup — Decode vehicle identification numbers
- Auto-fill Specs — Pre-populate listing from VIN
- Vehicle History — Basic vehicle information
💰 Dealer Platform
- Dealer Dashboard — Manage inventory, leads, analytics
- Subscription Plans — Basic, Dealer, Pro tiers
- Lead Management — Track inquiries and test drives
Key Metrics
| Metric | Description |
|---|---|
| 20+ Models | Prisma schema with full relational integrity |
| 80+ Endpoints | RESTful endpoints for all features |
| 3 Dealer Plans | Basic ($10), Dealer ($25), Pro ($60) |
| Multi-Country | Localized pricing and currencies |
Related Documentation
- Services Deep Dive — All business logic services
- Route Map — Complete API endpoint documentation
- Data Models — Full Prisma schema with every field
- AI Search — Natural language search and recommendations
- Billing — Stripe integration and dealer plans
- Frontend — React app pages and components