# 🚗 RentFlow — Multi-Tenant Car Rental SaaS + Marketplace

## Platform Model

**Rental Companies (B2B)** — pay RentFlow a subscription (AmanPay or PayPal), get:
- A fully private dashboard (zero data overlap with any other company)
- Fleet management with vehicle photo upload (photos auto-appear on global marketplace)
- Promotional offers management
- A white-label site at `company.rentflow.com` where renters book and pay

**Renters (B2C)** — free account, can:
- Browse ALL companies' vehicles and offers on `rentflow.com/explore`
- Click a vehicle → **redirected to the company's site** to book and pay
- Receive full notifications (Email + SMS + WhatsApp + Push + In-App)
- Track all bookings across companies in one account

---

## ⚠️ Payment Providers — Stripe Has Been Removed

| Provider | Purpose |
|----------|---------|
| **AmanPay** (amanpay.net) | Primary. National/international cards, cash (3000+ points), e-wallet. Moroccan PCI-DSS Level-1 PSP. |
| **PayPal** | Secondary. Global coverage. |

**Two payment contexts:**
1. Company pays RentFlow subscription → RentFlow's own AmanPay/PayPal account
2. Renter pays company for rental → Company's own AmanPay merchant + PayPal account (direct, no intermediary)

---

## 🌐 Marketplace is Discovery Only — No Booking on rentflow.com/explore

The global marketplace shows all vehicles with photos from all companies. When a renter clicks "Book this vehicle", they are **redirected to the company's branded site** (`{slug}.rentflow.com/book?vehicleId=X&from=Y&to=Z&ref=marketplace`). The booking form is pre-filled. All payment happens on the company site using the company's own payment accounts.

---

## 📸 Vehicle Photos → Marketplace Visibility

```
Company uploads photos in /dashboard/fleet
  → Stored in Cloudinary
  → Vehicle.photos[] holds the URLs
  → First photo = cover image on marketplace cards
  → All photos shown in marketplace vehicle gallery
  → isPublished=true makes vehicle appear on marketplace
```

---

## 🏗 Five-Layer Architecture

```
Layer 1A: rentflow.com              — B2B marketing site
Layer 1B: rentflow.com/explore      — B2C marketplace (discovery + redirect only)
Layer 2:  app.rentflow.com          — Company dashboard (private, subscription-gated)
Layer 3:  {slug}.rentflow.com       — Company branded site (booking + payment here)
Layer 4:  api.rentflow.com          — REST API
```

---

## 📁 Project Structure

```
rental-car-site/
├── README.md
├── docs/
│   ├── ARCHITECTURE.md       ← Payment providers, marketplace redirect model, photo flow
│   ├── DESIGN_SYSTEM.md
│   ├── PAGES.md              ← All pages. Marketplace = discovery only. Booking = company site.
│   ├── FEATURES.md
│   └── DEPLOYMENT.md
└── skills/
    ├── rental-car-website/
    ├── rental-car-components/
    ├── rental-car-backend/
    │   └── references/
    │       ├── schema.md               ← AmanPay/PayPal fields, no Stripe
    │       ├── api-routes.md           ← All routes
    │       ├── payment-service.md      ← AmanPay + PayPal implementation ← KEY FILE
    │       ├── subscription-service.md ← Manual renewal, plan prices in MAD/USD/EUR
    │       ├── subdomain-service.md    ← Marketplace redirect + company site
    │       └── notification-service.md ← All 5 channels
    └── rental-car-i18n/
```

---

## 🛠 Tech Stack

| Concern | Technology |
|---------|-----------|
| Subscription payment | AmanPay (primary) + PayPal (secondary) |
| Rental payment | Company's own AmanPay merchant + PayPal |
| PDF generation | `@react-pdf/renderer` — server-side, on-demand, never stored |
| Damage diagrams | SVG top-down car map (22 zones, React interactive + PDF static render) |
| Insurance | Per-company configurable policies with per-day/flat/% charge types |
| Pricing rules | Age/experience-based surcharges & discounts (configurable per company) |
| Email | Resend |
| SMS + WhatsApp | Twilio |
| Push | Firebase FCM |
| Real-time in-app | Socket.io + Redis |
| Images | Cloudinary |
| Company auth | Clerk |
| Renter auth | JWT (custom) |
| API | Node.js + Express + Prisma + PostgreSQL |
| Frontend | Next.js 14 + React 18 + Vite |
| Deployment | Vercel + Railway |