# Transition to a Pure Classified Ads Platform (Jiji-style)

## Goal

Convert the marketplace from a payment/escrow + affiliate-commission model into a
classified ads platform where buyers contact sellers directly (call/chat), while
preserving a monetization path via paid listing features and signup referrals.

## Why the affiliate-commission model must change

Once a buyer calls a seller directly and the deal happens off-platform, there is no
payment event to attach a commission to. Commission-on-sale is therefore impossible
to track reliably. The platform must monetize **listings and attention** instead of
**transactions** — exactly how Jiji operates.

## New monetization model

- **Free basic listings** (keeps supply high).
- **Paid features** (the new revenue engine):
  - Boost / Promote (already exists via `promotedUntil` + `PromoteButton`).
  - Featured / Top placement.
  - Urgent badge.
  - Listing renewal (already exists via product lifecycle).
- **Affiliate earnings** shift to:
  - Signup referral bonus (already exists, `EARNINGS_PER_REFERRAL = 50`).
  - Commission when a referred **seller** buys a boost/featured/renewal (trackable,
    tied to a real payment, fraud-resistant).
- **Digital products** optionally keep escrow + commission (deliverable online, so
  commission stays trackable). Physical products become pure classified.

## New user flow

```mermaid
flowchart TD
    A[Buyer views listing] --> B[Click Show Phone Number]
    B --> C[Safety Warning Modal]
    C --> D[Reveal Phone with animation]
    D --> E[Log ContactEvent]
    E --> F[Buyer calls or chats seller]
    F --> G[Deal happens offline]
    G --> H[No platform commission]

    S[Seller posts ad] --> S1[Phone field focus]
    S1 --> S2[Scam Warning Modal with siren]
    S2 --> S3[Enter phone with country code]
    S3 --> S4[Free listing]
    S4 --> S5[Optional paid boost or featured]
    S5 --> S6[Affiliate earns on boost purchase]
```

## Key decisions locked in

1. **Monetization:** Jiji-style (free listings + paid boosts/featured; affiliates earn
   on paid features + signup referrals).
2. **Phone reveal:** gated behind a "Show Phone Number" button with an animated reveal
   and a safety warning modal (no online payment; meet in a safe place; verify the item
   physically).
3. **Phone input:** country-code picker using the existing `react-phone-number-input`
   (same as the registration page).
4. **Seller scam warning:** on focusing the phone field, show a modal with an animated
   glowing siren warning that fraud/scam attempts lead to arrest and prosecution.
5. **NDPC compliance:** strong Privacy Policy, Terms, and Cookie Policy in a new footer;
   users must accept a checkbox before using the platform.

## Implementation phases

1. **Schema & data model** — add `Product.phone`, a `ContactEvent` model, a
   `ListingPayment` model, and consent fields on `User`.
2. **Classified transition** — remove price/payment/escrow for physical products;
   replace `BuyButton` with Call/Chat CTAs; keep digital escrow optional.
3. **Phone reveal + safety warning** — new `PhoneRevealButton` component.
4. **Seller phone field + scam warning** — add phone input to create/edit forms with
   the animated siren modal.
5. **NDPC compliance** — footer with policy links, Cookie Policy page, consent gate.
6. **Monetization** — paid boost/featured flow + affiliate commission on paid features.
7. **Analytics** — lead funnel (views → reveals → chats), seller + admin dashboards.

See the todo list for the full actionable breakdown.