Awahouse — Nigeria's verified property marketplace. Verified listings, escrow-protected payments, and monthly rent instalments for Lagos.
# Awahouse — Verified Property Marketplace
A verified property marketplace for the Nigerian real estate market. Solves three core problems: fraudulent listings, unverifiable property titles, and coercive upfront rent demands.
**Three pillars:**
- **Verified Listings** — multi-layer document + NIN verification before listing approval
- **Escrow Protection** — CBN-compliant trust account; funds released only after tenant confirms possession
- **Rent Monthly** — annual rent broken into monthly instalments, building a portable RentScore
**Target market:** Lagos, Nigeria (all 20 LGAs — Lagos-wide for MVP)
---
## Features
- **Role-based accounts** — single account with multi-role support: Tenant, Landlord, Agent, Admin; switch roles without re-registering
- **NIN verification** — via Dojah API; NIN hashed with bcrypt before storage (never stored in plaintext)
- **Professional body verification** — agents verify against LASRERA, ESVARBON, NIESV, AEAN, ERCAAN, or REDAN
- **Property listings** — full CRUD, image upload to Cloudflare R2 (resized to 1920×1080 + 400×300 thumbnails), PostgreSQL full-text search, PostGIS geo-search by LGA/radius
- **Verification badges** — 6 tiers: fully_verified, title_confirmed, agent_verified, nin_verified, transaction_verified, pending
- **Escrow engine** — finite state machine with 10 valid transitions; Paystack charge initiation + transfer payouts; 48-hour auto-release with BullMQ delayed jobs
- **Rent monthly** — 12-instalment scheduler triggered on escrow completion; late payment retry (3 attempts, exponential backoff)
- **RentScore** — 300–850 scoring system; deltas for on-time (+15), late (−10/–25), missed (−50), dispute (−30), escrow completed (+20)
- **Notifications** — SMS (Termii), email (Resend with React Email templates), in-app; all async via BullMQ
- **Admin dashboard** — verification queues, dispute resolution, KPI metrics (GTV, completed escrows, NIN verification rate)
- **Reviews** — post-escrow verified reviews; aggreg …