YeboShops Architecture Overview
Formerly known as Vavu — A TikTok-style classifieds marketplace with AI-powered product processing and secure escrow payments.
System Architecture
┌─────────────────────────────────────────────────────────────────┐
│ YeboShops Platform │
├─────────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ Frontend │ │ API │ │ Services │ │
│ │ (React) │◄──►│ (Express) │◄──►│ (Business) │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
│ │ │ │ │
│ ▼ ▼ ▼ │
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ TikTok-style│ │ Middleware │ │ AI Services │ │
│ │ Browser │ │ (Auth, Rate) │ │ (Gemini) │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
│ │ │ │
│ ▼ ▼ │
│ ┌──────────────────────────────┐ │
│ │ PostgreSQL + pgvector │ │
│ │ (14 Models) │ │
│ └──────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘Technology Stack
| Layer | Technology | Purpose |
|---|---|---|
| Frontend | React + TypeScript | TikTok-style product browser |
| API | Express.js + TypeScript | RESTful API server |
| Database | PostgreSQL + Prisma | Data persistence with ORM |
| Vector Search | pgvector + Voyage AI | Semantic product search |
| AI Processing | Google Gemini | Product analysis & categorization |
| Payments | Internal Wallet + Escrow | Secure P2P transactions |
| Hosting | Google Cloud Run | Auto-scaling containers |
Core Features
🛒 Marketplace Features
- Shop Management — Create and manage shops with custom branding
- Product Listings — AI-powered product creation with auto-categorization
- TikTok-Style Browsing — Vertical swipe interface for product discovery
- Multi-Currency — Country-specific currency support
💰 Payment System
- Wallet System — User wallets with confirmed/unconfirmed balances
- Secure Payments — Escrow-based transactions with completion codes
- Dispute Resolution — Built-in dispute handling workflow
🤖 AI Capabilities
- Gemini AI Processing — Automatic product analysis from images
- Vector Search — Semantic search using Voyage AI embeddings
- Natural Language Search — Conversational product discovery
💬 Communication
- Real-time Chat — Buyer-seller messaging with product context
- Notifications — Push notifications for orders, chats, payments
- Shop Following — Follow shops for updates
Key Metrics
| Metric | Description |
|---|---|
| 14 Core Models | Prisma schema with full relational integrity |
| 30+ API Routes | RESTful endpoints for all features |
| 512-dim Vectors | Product embeddings for semantic search |
| 6 Payment States | Complete escrow lifecycle management |
Related Documentation
- Services Deep Dive — All business logic services
- Route Map — Complete API endpoint documentation
- Data Models — Full Prisma schema with every field
- Payments System — Escrow and wallet mechanics
- AI Processing — Gemini integration and vector search
- Frontend — React app pages and components