# Balinyaar — Product Documentation

Balinyaar is a trust-first home-nursing marketplace in Iran: independent, individually-verified nurses list configurable services; families search, book, pay, and review; the platform holds funds in an escrow-style ledger and pays nurses out weekly after a confirmed check-out.

This is the product/domain knowledge base — the source of truth for business rules, the data model, payments, and the market/legal research. Start with the Platform Summary & cross-cutting ground truths, then dive into the area you need.

> The Markdown files here are canonical. The matching `.html` files are a generated, cross-linked browsing view — see README to regenerate.

## Sections #

### 🧭 Overview #

What Balinyaar is, the four cross-cutting ground truths (no cash custody, 10% VAT, full-upfront BNPL, weekly nurse payout), the IRR/Toman rule, and a glossary of the Persian terms.

### 📋 Business Requirements #

The 14 functional areas — onboarding, verification, catalog & pricing, search, booking, EVV, cancellation, payments/escrow, BNPL, payouts, reviews, messaging, tax/legal, admin — each with business rules, Iran-specific considerations, MVP-vs-deferred scope, and supporting entities.

### 🗄️ Database Model #

The refined ~54-table SQL Server schema across 13 domains, plus ER & flow diagrams, design principles, the two resolved BNPL questions, and the key design decisions.

### 💳 Payments, Escrow & BNPL #

The fintech deep-dive (with sources): the Iranian payment reality, escrow as a double-entry ledger, the BNPL landscape & full-upfront finding, cancellation/refund + who-pays-the-nurse, and SnappPay / Digipay integration notes.

### 🔬 Research & Strategy #

Market & competitors, problems & risks, nurse identity/credential verification, the Iranian legal landscape, and go-to-market recommendations — adversarially fact-checked, with citations.

### 🗒️ Notes #

Living product notes: open questions and future ideas / backlog.

### 🖼️ Wireframes #

The Balinyaar screen wireframes (login/onboarding, nurse verification, booking, BNPL, patient record).

### 🇮🇷 Farsi documents #

Persian-language versions kept in parallel: the platform research report and the nurse verification-flow implementation guide.

## How the docs relate #

    flowchart LR
      OV["🧭 Overview<br/>ground truths + glossary"]
      RES["🔬 Research<br/>why: market, legal, risk"]
      BIZ["📋 Business Requirements<br/>what the platform must do"]
      DM["🗄️ Database Model<br/>how it's stored"]
      PAY["💳 Payments deep-dive<br/>the money mechanics"]

      OV --> BIZ
      RES --> BIZ
      BIZ --> DM
      BIZ <--> PAY
      PAY <--> DM

- Research explains why (market gap, legal track, trust risks). Business Requirements

states what must ship. Database Model is how it's stored. Payments is the money detail shared by the other three. They cross-link rather than repeat each other.

↑ Back to top