hamid
3.2 KiB
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
.htmlfiles 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.