carmanagement/PAGES.md

# Pages Specification — RentFlow

---

## LAYER 1A — Marketing Site (rentflow.com)

### `/` — Home
Sections:
1. Hero — "Run your rental car business like a pro" + CTA
2. Two-column value: "For rental companies" / "For renters"
3. Social proof bar
4. Pain points (for companies)
5. Features grid — fleet, photos, offers, site, CRM, analytics
6. **Marketplace callout** — "Your vehicle photos appear on the RentFlow global marketplace automatically"
7. How it works — 3 steps
8. Pricing teaser (AmanPay / PayPal accepted badges shown)
9. Testimonials
10. Final CTA

### `/pricing` — Pricing
- Three plan cards (Starter / Growth / Pro) with monthly/annual toggle
- **Payment method icons:** AmanPay logo + PayPal logo
- "Pay securely with AmanPay (cards, cash, e-wallet) or PayPal"
- Supported currencies: MAD, USD, EUR
- FAQ section

### `/features`, `/about`, `/contact`, `/blog` — standard

---

## LAYER 1B — Global Marketplace (rentflow.com/explore)

> **Design principle:** This is a DISCOVERY layer. No booking form, no payment form.
> Every CTA leads to the company's own site.

### `/explore` — Marketplace Home

Sections:

1. **Search Hero**
   - Headline: "Find your next rental — from trusted local companies"
   - Search bar: [City / Location] [Pick-up date] [Return date] [Search]
   - Popular cities quick links

2. **Featured Offers Carousel**
   - "🔥 Current Deals" header
   - Horizontal scroll of offer cards:
     - Vehicle photo (from company upload)
     - Company logo + name
     - Offer title + discount badge (e.g. "20% OFF")
     - Valid until date
     - **"View Deal →"** → links to `/explore/[slug]#offers`

3. **All Available Vehicles**
   - Grid of vehicle cards showing ALL published vehicles from ALL companies:
     - **Vehicle photo** (first photo from `Vehicle.photos[]`)
     - Make, model, year, category badge
     - Company logo + name (clickable)
     - Daily rate + currency
     - Active offer badge (if applicable, e.g. "20% OFF until July 31")
     - Star rating from reviews
     - **"Book at [Company Name] →"** — on click: redirect to `{slug}.rentflow.com/book?vehicleId=X&from=Y&to=Z&ref=marketplace`
   - Filter panel: category, transmission, fuel type, price range, city, offer only
   - Sort: price (low-high, high-low), rating, newest

4. **Browse by Category**
   - Economy · Compact · SUV · Luxury · Van · Truck · Electric

5. **Browse by Company**
   - Company cards: logo, name, city, rating, vehicle count, active offer badge
   - **"View Fleet →"** → `/explore/[slug]`

6. **How It Works** (for first-time visitors)
   - 3 steps: 1. Browse vehicles → 2. Click to go to company site → 3. Book & pay directly

### `/explore?...` — Search Results
- Same vehicle card grid, filtered by search params
- No booking happens here — every card links to company site with pre-filled params
- Availability indicator on each card ("3 available for your dates" vs "Check availability")

### `/explore/[slug]` — Company Marketplace Profile
This is the company's listing on the RentFlow marketplace (RentFlow-styled, not their branded site).

Sections:
1. Company header — logo, display name, city/country, rating, phone, "Save" heart
2. **Current Offers section** — offer cards with discount badges
3. **Available Vehicles grid** — all published vehicles with photos
   - Each card: photo(s), specs, daily rate, offer badge, **"Book at [Company Name] →"** redirect button
4. **Reviews** — renter reviews with star ratings + company replies
5. Contact info — email, phone, WhatsApp link (opens `wa.me/...`)
6. "Visit their website →" link to `{slug}.rentflow.com`

### `/explore/[slug]/vehicles/[id]` — Vehicle Detail (Marketplace)
- **Photo gallery** (all `Vehicle.photos[]` uploaded by company)
- Full specs: make, model, year, color, category, seats, transmission, fuel, features
- Daily rate + active offer badge + calculated total for selected dates
- Availability calendar (shows blocked dates — unavailable for booking)
- Company info sidebar: logo, name, rating, phone, WhatsApp
- **BIG CTA: "Book at [Company Name] →"**
  - Redirects to: `{slug}.rentflow.com/book?vehicleId=[id]&from=[startDate]&to=[endDate]&ref=marketplace`
  - Opens in same tab

### No `/explore/[slug]/book` page
There is no booking flow on the marketplace. Booking happens entirely on the company's site.

---

## LAYER 1B — Renter Account

### `/renter/signup`, `/renter/login`
Standard auth pages. Login with Google optional.

### `/renter/dashboard` — My Rentals
- Cross-company reservations list (tabs: Upcoming / Active / Past / Cancelled)
- Each card: company logo, vehicle photo, dates, status, "View" → links to company site booking detail

### `/renter/notifications` — Notification Inbox
- All in-app notifications (new booking, reminders, offers, etc.)

### `/renter/saved-companies`
- Saved companies with "New Offer" badges if they have active offers
- "View Fleet →" links to marketplace profile

### `/renter/profile`
- Personal info, locale, currency preference
- Notification preferences matrix (Email / SMS / WhatsApp / Push per event type)

---

## LAYER 2 — Company Dashboard (app.rentflow.com)

### Auth

#### `/signup` — Signup Wizard
1. Account (name, email, password)
2. Company (name, country, phone)
3. Plan selection (Starter / Growth / Pro + Monthly / Annual + currency: MAD / USD / EUR)
4. Payment:
   - **Option A: Pay with AmanPay** → shows AmanPay widget (card, cash, e-wallet)
   - **Option B: Pay with PayPal** → redirect to PayPal, return here
   - AmanPay and PayPal logos shown prominently
   - "Supported: Visa, Mastercard, CMI, cash at 3000+ points, PayPal"

#### `/onboarding` — 4-Step Wizard
1. Company profile (address, phone)
2. Branding (logo, color, subdomain)
3. **Add first vehicle + upload photos** — emphasize: "Photos appear on the global marketplace"
4. Launch: "Your site is live at [slug].rentflow.com" + "Your vehicles are now visible on rentflow.com/explore"

### Dashboard Pages

#### `/dashboard` — Home
- Subscription status banner (trial / past-due / renewal due)
- KPI cards + active offers widget + booking source breakdown

#### `/dashboard/fleet` — Fleet Management
- Vehicle list with status + published/unpublished badge
- **Photos column** — thumbnail of first photo, "0 photos" warning badge if none uploaded
- Vehicle detail:
  - **Photos section at top** — drag-drop upload area
  - "Photos appear on marketplace" callout
  - Upload multiple photos (Cloudinary)
  - Reorder photos (first = cover image)
  - Delete photos
  - Specs + maintenance + reservation history

#### `/dashboard/offers` — Offers
- Create / manage promotional offers
- `isPublic` toggle: "Show on global marketplace"
- `isFeatured` toggle: "Feature on explore homepage" (GROWTH+ plan badge)

#### `/dashboard/reservations`
- Source filter includes MARKETPLACE (bookings from renter redirected from explore)

#### `/dashboard/billing` — Billing & Plan
- Current plan + status
- **"Renew Subscription"** button (manual renewal — AmanPay or PayPal)
- Invoice history (with AmanPay transaction IDs or PayPal capture IDs)
- Payment methods accepted: AmanPay badge + PayPal badge

#### `/dashboard/settings` — Settings
- **Payments tab** ← UPDATED:
  - "Your rental payment methods" section (what renters use to pay YOU)
  - AmanPay section: Merchant ID input + Secret Key input + "Test connection" button
  - PayPal section: PayPal business email input + "Connect PayPal" button
  - Active payment methods shown with green/grey status dots
  - "If no payment method configured, renters can only make reservation requests (pay on pickup)"

#### `/dashboard/notifications` — Notification Center
- Inbox tab (in-app notification log)
- Preferences tab (Email / SMS / In-App / Push matrix per event type)

---

## LAYER 3 — Company Public Site ({slug}.rentflow.com)

> All booking and payment happens here. Company's brand. Company's AmanPay/PayPal.

### `/` — Home
- Company header: logo + name + nav
- Hero: tagline + hero image + "Browse Our Vehicles" CTA
- **Active Offers section** — offer banners with countdown (valid until X days)
- Vehicle grid (all published vehicles with photos)
- Footer: contact + social + "Powered by RentFlow" (Pro removes)

### `/vehicles/[id]` — Vehicle Detail
- Photo gallery (all company-uploaded photos, full lightbox)
- Specs + features list
- Daily rate + active offer badge
- Availability calendar
- "Book Now" CTA

### `/offers` — All Offers
- All active offers with banner images, descriptions, discount badges, valid until
- "Book with this offer" → pre-fills booking form with offer applied

### `/book` — Booking Flow

The booking form accepts a `?vehicleId=X&from=Y&to=Z&ref=marketplace&offerId=O` querystring.
When `ref=marketplace` is present, the reservation is tagged as source=MARKETPLACE.

**Step 1 — Vehicle & Dates**
- Vehicle card (pre-filled if from marketplace redirect or offer click)
- Date range picker
- Active offer applied (if applicable) + promo code input
- Price breakdown: base rate − discount = total

**Step 2 — Your Details**
- First name, last name, email, phone (required)
- Driver license (optional, company-configurable)
- Renter account login prompt (optional — "Save this booking to your RentFlow account")

**Step 3 — Payment**
- Order summary card
- **Payment method selection:**
  - **AmanPay tab** (if company has AmanPay configured):
    - AmanPay widget loads inline (card national, card international, cash)
    - Powered by AmanPay + M2T + PCI-DSS badge
  - **PayPal tab** (if company has PayPal configured):
    - PayPal buttons component
  - If only one method: show directly without tabs
  - If none: "Contact us to reserve" + company phone/WhatsApp
- "Confirm & Pay" / "Confirm Reservation"

### `/book/confirmation` — Booking Confirmed
- Booking reference number
- Full summary
- Company contact info
- "Download receipt" (PDF, optional)
- "Track this booking" → link to renter account
- Notifications already sent automatically

### `/contact` — Contact
- Contact form → email via Resend to company

---

## Admin Panel (admin.rentflow.com — internal)

> Separate app from the company dashboard. Own auth (JWT + TOTP 2FA). Only RentFlow staff.

### Auth
- `/admin/login` — email + password + optional 2FA code field (shown if 2FA enabled)
- `/admin/login/2fa` — TOTP entry step

### `/admin` — Overview Dashboard
- Platform KPI cards: Total Companies, Active, Trialing, Suspended, MRR, Churn
- Recent signups feed
- Quick links to all sections

### `/admin/companies` — Company List
- Search (name, email, slug), filter (plan, status, country), sort (name, MRR, created)
- Table: Logo, Name, Plan badge, Status badge, Vehicle count, Employee count, MRR, Actions
- Actions: View | Edit | Suspend/Reactivate | Delete
- Bulk: Suspend selected, Export CSV

### `/admin/companies/:id` — Company Detail
- Tabs: Overview | Staff | Subscription | Activity | Settings
- **Overview**: brand info, legal info, payment accounts status
- **Staff tab**:
  - Employee table: name, email, role badge, status (Active/Deactivated), last login
  - Actions per employee: Edit | Change Role | Deactivate/Reactivate | Reset Password | Impersonate
  - "Add Employee" button → modal: name, email, role → sends Clerk invitation
  - Role dropdown: OWNER / MANAGER / AGENT with permission matrix tooltip
- **Subscription tab**:
  - Current plan, status, billing period, last payment, next renewal
  - Invoice history table
  - Override controls: force status, change plan, mark invoice paid, add free period
- **Activity tab**: recent reservations, offers, audit events for this company

### `/admin/renters` — Renter Accounts
- Search by name, email, phone
- Filter: blocked / unblocked
- Table: name, email, phone, joined, reservation count, blocked badge
- Actions: View | Block/Unblock

### `/admin/metrics` — Platform Analytics
- MRR trend chart
- New companies per week
- Subscription breakdown by plan (donut chart)
- Marketplace: impressions, bookings, top companies
- Notification delivery rates per channel

### `/admin/users` — Admin User Management (SUPER_ADMIN only)
- List of admin accounts: name, email, role, 2FA status, last login
- Create admin: name, email, role → password emailed
- Edit role | Deactivate | View audit trail

### `/admin/audit-logs` — Audit Log
- Searchable, filterable (by admin, action, company, date range)
- Columns: Timestamp, Admin, Action, Target, Before/After (expandable), IP, Note
- Export CSV button

### `/admin/settings` — Admin Panel Settings
- Admin account: update own name, email, password
- 2FA: setup QR code, verify, enable/disable