hamid
76 lines
11 KiB
HTML
76 lines
11 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
<title>Balinyaar — Product Documentation — Balinyaar docs</title>
|
|
<link rel="stylesheet" href="assets/doc.css">
|
|
</head>
|
|
<body>
|
|
<div class="layout">
|
|
<aside class="sidebar">
|
|
<a class="brand" href="index.html"><span class="dot"></span> Balinyaar docs</a>
|
|
<p class="tagline">Trust-first home-nursing marketplace · Iran</p>
|
|
<nav><div class="group"><div class="label">Start here</div><ul><li><a class="active" href="index.html">Docs home</a></li><li><a href="overview/platform-summary.html">Platform summary & ground truths</a></li></ul></div><div class="group"><div class="label">Business requirements</div><ul><li><a href="business/index.html">Overview & MVP scope</a></li><li><a href="business/01-actors-and-onboarding.html">1. Actors & onboarding</a></li><li><a href="business/02-nurse-verification.html">2. Nurse verification</a></li><li><a href="business/03-service-catalog-and-pricing.html">3. Service catalog & pricing</a></li><li><a href="business/04-search-and-matching.html">4. Search & matching</a></li><li><a href="business/05-booking-and-scheduling.html">5. Booking & scheduling</a></li><li><a href="business/06-evv-and-service-delivery.html">6. EVV / service delivery</a></li><li><a href="business/07-cancellation-and-refunds.html">7. Cancellation & refunds</a></li><li><a href="business/08-payments-and-escrow.html">8. Payments & escrow</a></li><li><a href="business/09-installments-bnpl.html">9. Installments / BNPL</a></li><li><a href="business/10-payouts.html">10. Payouts to nurses</a></li><li><a href="business/11-reviews-trust-and-safety.html">11. Reviews, trust & safety</a></li><li><a href="business/12-messaging-and-emergencies.html">12. Messaging & emergencies</a></li><li><a href="business/13-tax-invoicing-and-legal.html">13. Tax, invoicing & legal</a></li><li><a href="business/14-notifications-and-admin.html">14. Notifications & admin</a></li></ul></div><div class="group"><div class="label">Database model</div><ul><li><a href="data-model/index.html">Overview & decisions</a></li><li><a href="data-model/diagrams.html">Diagrams</a></li><li><a href="data-model/01-identity-and-access.html">1. Identity & access</a></li><li><a href="data-model/02-geography.html">2. Geography</a></li><li><a href="data-model/03-services-and-pricing.html">3. Services & pricing</a></li><li><a href="data-model/04-verification-and-credentials.html">4. Verification & credentials</a></li><li><a href="data-model/05-booking-and-scheduling.html">5. Booking & scheduling</a></li><li><a href="data-model/06-payments-ledger-and-refunds.html">6. Payments, ledger & refunds</a></li><li><a href="data-model/07-payouts.html">7. Payouts</a></li><li><a href="data-model/08-bnpl.html">8. BNPL / installments</a></li><li><a href="data-model/09-messaging.html">9. Messaging</a></li><li><a href="data-model/10-reviews-and-records.html">10. Reviews & records</a></li><li><a href="data-model/11-notifications.html">11. Notifications</a></li><li><a href="data-model/12-audit-config-and-reference.html">12. Audit, config & reference</a></li><li><a href="data-model/13-partner-centers-and-future.html">13. Partner centers & future</a></li></ul></div><div class="group"><div class="label">Payments deep-dive</div><ul><li><a href="payments/index.html">Overview & exec summary</a></li><li><a href="payments/iranian-payment-reality.html">Iranian payment reality</a></li><li><a href="payments/escrow-ledger.html">Escrow as a ledger</a></li><li><a href="payments/bnpl-landscape.html">BNPL landscape & finding</a></li><li><a href="payments/cancellation-and-payout.html">Cancellation & nurse payout</a></li><li><a href="payments/integration-notes.html">Integration & schema touchpoints</a></li><li><a href="payments/sources.html">Recommendations & sources</a></li></ul></div><div class="group"><div class="label">Research & strategy</div><ul><li><a href="research/index.html">Overview & exec summary</a></li><li><a href="research/market-and-competitors.html">Market & competitors</a></li><li><a href="research/problems-and-risks.html">Problems & risks</a></li><li><a href="research/verification.html">Verification (research)</a></li><li><a href="research/legal-landscape.html">Legal landscape</a></li><li><a href="research/go-to-market.html">Go-to-market & sources</a></li></ul></div><div class="group"><div class="label">Notes & more</div><ul><li><a href="notes/open-questions.html">Open questions</a></li><li><a href="notes/future-ideas.html">Future ideas</a></li><li><a href="wireframes/index.html">Wireframes</a></li><li><a href="fa/index.html">Farsi documents</a></li></ul></div></nav>
|
|
</aside>
|
|
<main class="main"><div class="content">
|
|
<div class="topbar"><button class="theme-toggle" type="button" onclick="__t()">theme</button></div>
|
|
<h1 id="balinyaar-product-documentation">Balinyaar — Product Documentation</h1>
|
|
<p><strong>Balinyaar</strong> 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.</p>
|
|
<p>This is the product/domain knowledge base — the <strong>source of truth</strong> for business rules, the data model, payments, and the market/legal research. Start with the <strong><a href="overview/platform-summary.html">Platform Summary & cross-cutting ground truths</a></strong>, then dive into the area you need.</p>
|
|
<blockquote><p>The Markdown files here are canonical. The matching <code>.html</code> files are a generated, cross-linked browsing view — see <a href="README.html#regenerating-the-html-view">README</a> to regenerate.</p>
|
|
</blockquote>
|
|
<hr>
|
|
<h2 id="sections">Sections <a class="anchor" href="#sections" aria-hidden="true">#</a></h2>
|
|
<h3 id="-overviewoverviewplatform-summarymd">🧭 <a href="overview/platform-summary.html">Overview</a> <a class="anchor" href="#-overviewoverviewplatform-summarymd" aria-hidden="true">#</a></h3>
|
|
<p>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.</p>
|
|
<h3 id="-business-requirementsbusinessindexmd">📋 <a href="business/index.html">Business Requirements</a> <a class="anchor" href="#-business-requirementsbusinessindexmd" aria-hidden="true">#</a></h3>
|
|
<p>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.</p>
|
|
<h3 id="-database-modeldata-modelindexmd">🗄️ <a href="data-model/index.html">Database Model</a> <a class="anchor" href="#-database-modeldata-modelindexmd" aria-hidden="true">#</a></h3>
|
|
<p>The refined ~54-table SQL Server schema across 13 domains, plus <a href="data-model/diagrams.html">ER & flow diagrams</a>, design principles, the two resolved BNPL questions, and the key design decisions.</p>
|
|
<h3 id="-payments-escrow-bnplpaymentsindexmd">💳 <a href="payments/index.html">Payments, Escrow & BNPL</a> <a class="anchor" href="#-payments-escrow-bnplpaymentsindexmd" aria-hidden="true">#</a></h3>
|
|
<p>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.</p>
|
|
<h3 id="-research-strategyresearchindexmd">🔬 <a href="research/index.html">Research & Strategy</a> <a class="anchor" href="#-research-strategyresearchindexmd" aria-hidden="true">#</a></h3>
|
|
<p>Market & competitors, problems & risks, nurse identity/credential verification, the Iranian legal landscape, and go-to-market recommendations — adversarially fact-checked, with citations.</p>
|
|
<h3 id="-notesnotesopen-questionsmd">🗒️ <a href="notes/open-questions.html">Notes</a> <a class="anchor" href="#-notesnotesopen-questionsmd" aria-hidden="true">#</a></h3>
|
|
<p>Living product notes: <a href="notes/open-questions.html">open questions</a> and <a href="notes/future-ideas.html">future ideas / backlog</a>.</p>
|
|
<h3 id="-wireframeswireframesindexhtml">🖼️ <a href="wireframes/index.html">Wireframes</a> <a class="anchor" href="#-wireframeswireframesindexhtml" aria-hidden="true">#</a></h3>
|
|
<p>The Balinyaar screen wireframes (login/onboarding, nurse verification, booking, BNPL, patient record).</p>
|
|
<h3 id="-farsi-documentsfaindexhtml">🇮🇷 <a href="fa/index.html">Farsi documents</a> <a class="anchor" href="#-farsi-documentsfaindexhtml" aria-hidden="true">#</a></h3>
|
|
<p>Persian-language versions kept in parallel: the platform research report and the nurse verification-flow implementation guide.</p>
|
|
<hr>
|
|
<h2 id="how-the-docs-relate">How the docs relate <a class="anchor" href="#how-the-docs-relate" aria-hidden="true">#</a></h2>
|
|
<pre class="mermaid">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</pre>
|
|
<ul>
|
|
<li><strong>Research</strong> explains <em>why</em> (market gap, legal track, trust risks). <strong>Business Requirements</strong></li>
|
|
</ul>
|
|
<p> states <em>what</em> must ship. <strong>Database Model</strong> is <em>how</em> it's stored. <strong>Payments</strong> is the <em>money detail</em> shared by the other three. They cross-link rather than repeat each other.</p>
|
|
<a class="back-to-top" href="#">↑ Back to top</a>
|
|
</div></main>
|
|
</div>
|
|
<script>
|
|
(function(){var k='balinyaar-docs-theme';var s=localStorage.getItem(k);
|
|
if(s)document.documentElement.setAttribute('data-theme',s);
|
|
else if(matchMedia('(prefers-color-scheme: dark)').matches)document.documentElement.setAttribute('data-theme','dark');})();
|
|
function __t(){var d=document.documentElement;var n=d.getAttribute('data-theme')==='dark'?'light':'dark';
|
|
d.setAttribute('data-theme',n);localStorage.setItem('balinyaar-docs-theme',n);}
|
|
</script>
|
|
<script type="module">
|
|
import mermaid from 'https://cdn.jsdelivr.net/npm/mermaid@11/dist/mermaid.esm.min.mjs';
|
|
const dark = document.documentElement.getAttribute('data-theme') === 'dark';
|
|
mermaid.initialize({ startOnLoad: true, theme: dark ? 'dark' : 'neutral' });
|
|
</script>
|
|
</body>
|
|
</html>
|