clean and refine product docs structure
This commit is contained in:
hamid
@@ -0,0 +1,81 @@
|
||||
# Platform Summary & Cross-Cutting Ground Truths
|
||||
|
||||
[← Product docs home](../index.md)
|
||||
|
||||
**Balinyaar is a trust-first home-nursing marketplace in Iran.** Independent,
|
||||
individually-verified nurses register, list configurable services with their own pricing, and pass
|
||||
a multi-step verification pipeline anchored on the MoH **پروانه صلاحیت حرفهای**
|
||||
(professional-competency license). Families search — filtered by city/district **and same-gender
|
||||
caregiver preference** — pick a nurse and a service variant, submit a booking request, and pay
|
||||
**through the platform** after the nurse accepts. The platform records the money as an **internal
|
||||
escrow ledger state** (not platform-held cash), the nurse performs one or more EVV-verified visits,
|
||||
and the platform pays the nurse **weekly, after the dispute window closes**, minus a platform
|
||||
commission. All post-booking communication runs through an admin-readable ticket system.
|
||||
|
||||
At launch the platform operates under a **partner licensed home-nursing center
|
||||
(مرکز مشاوره و ارائه مراقبتهای پرستاری در منزل)** — the Asanism-style model — which is the legal
|
||||
vehicle and the likely **merchant-of-record** for payments while Balinyaar's own MoH permit is in
|
||||
process.
|
||||
|
||||
---
|
||||
|
||||
## The four cross-cutting ground truths
|
||||
|
||||
These hold across **every** business area and data-model domain. They are the load-bearing
|
||||
decisions the rest of the docs assume.
|
||||
|
||||
1. **Balinyaar cannot legally custody customer cash.** Under Iranian rules a پرداختیار (payment
|
||||
facilitator) is forbidden from holding deposits, running wallets, or moving money between
|
||||
merchants. Money always flows card → licensed PSP → Shaparak settlement → **bank-registered
|
||||
IBANs**. "Escrow" is therefore an **internal ledger state** over funds custodied at a licensed
|
||||
provider/partner bank — never a Balinyaar-owned cash balance.
|
||||
See [escrow as a ledger](../payments/escrow-ledger.md) and the
|
||||
[`ledger_entries`](../data-model/06-payments-ledger-and-refunds.md) entity.
|
||||
2. **VAT is 10%**, not 9% — it rose from 9% to 10% in 1403 (7% government + 3% municipal) and is
|
||||
treated as a **configurable** rate. See [Iranian payment reality §2.6](../payments/iranian-payment-reality.md)
|
||||
and [tax, invoicing & legal](../business/13-tax-invoicing-and-legal.md).
|
||||
3. **BNPL is full-upfront.** A BNPL provider settles **one full-amount lump (net of its commission)
|
||||
to the merchant-of-record**, bears 100% of customer-default risk, and owns the customer's
|
||||
installment repayment entirely. A BNPL order behaves in Balinyaar's books exactly like a card
|
||||
payment landing net-of-fee. See [the full-upfront finding](../payments/bnpl-landscape.md).
|
||||
4. **The nurse is paid by Balinyaar, weekly, on Balinyaar's own schedule** — gated on EVV
|
||||
completion and a closed dispute window — regardless of how the family paid. See
|
||||
[who pays the nurse & when](../payments/cancellation-and-payout.md) and [payouts](../business/10-payouts.md).
|
||||
|
||||
---
|
||||
|
||||
## Money is IRR Rials, always
|
||||
|
||||
All monetary values are in **IRR (Rials)**, stored as `BIGINT`. **Toman is a display concern only**
|
||||
and is converted to/from Rials **solely at an external provider's API boundary** (e.g. SnappPay
|
||||
quotes Toman). No floats anywhere on the money path.
|
||||
|
||||
---
|
||||
|
||||
## Glossary — the Persian terms you will keep meeting
|
||||
|
||||
| Term | What it is |
|
||||
| --- | --- |
|
||||
| پرداختیار (payment facilitator) | The PSP-contracted license class an MVP marketplace rides on; **barred from custodying funds**. |
|
||||
| تسهیم (settlement-sharing) | Shaparak/provider splitting one card payment across registered IBANs — the compliant marketplace primitive. |
|
||||
| Shaparak (شاپرک) | Iran's national card-payment switch; settles to registered IBANs. |
|
||||
| IBAN / شِبا (Sheba) | The bank account number money settles to; must be ownership-verified for nurse payouts. |
|
||||
| پروانه صلاحیت حرفهای | MoH professional-competency license — the single most important nurse credential; bundles a criminal-record screen. |
|
||||
| نظام پرستاری (INO) | Iranian Nursing Organization; membership number used as a verification cross-check. |
|
||||
| عدم سوء پیشینه | Criminal-record ("no record") certificate; consent-gated to the individual, no company API. |
|
||||
| Shahkar (شاهکار) | Government service matching a SIM ↔ national ID (کد ملی). |
|
||||
| سامانه مودیان | Iran's taxpayer / e-invoicing system (22-digit fiscal numbers). |
|
||||
| اینماد / e-namad | Electronic trust symbol; de-facto mandatory to obtain an online payment gateway. |
|
||||
| شبانهروزی | 24-hour / live-in care shift — the dominant elder-care shape. |
|
||||
| EVV | Electronic Visit Verification — GPS + timestamped nurse check-in/out per visit. |
|
||||
| BNPL | Buy-Now-Pay-Later (خرید اقساطی). |
|
||||
| Asanism model | Going to market by partnering with already-licensed home-nursing centers. |
|
||||
|
||||
---
|
||||
|
||||
## Where to go next
|
||||
|
||||
- **[Business Requirements](../business/index.md)** — what the platform must do, area by area.
|
||||
- **[Database Model](../data-model/index.md)** — the ~54-table schema, domain by domain.
|
||||
- **[Payments deep-dive](../payments/index.md)** — escrow, settlement, BNPL, integrations.
|
||||
- **[Research & Strategy](../research/index.md)** — market, risks, verification, legal, GTM.
|
||||
Reference in New Issue
Block a user