clean and refine product docs structure
This commit is contained in:
hamid
@@ -0,0 +1,59 @@
|
||||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<title>Future Ideas & Backlog — 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 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="open-questions.html">Open questions</a></li><li><a class="active" href="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="future-ideas-backlog">Future Ideas & Backlog</h1>
|
||||
<p><a href="../index.html">← Product docs home</a></p>
|
||||
<p>Raw product thinking captured for later — <strong>not</strong> committed MVP scope. Original notes were in Farsi (<code>additional-info.txt</code>); kept verbatim with light framing.</p>
|
||||
<hr>
|
||||
<h2 id="1-platform-owned-pricing-flow-آینده-future">1. Platform-owned pricing flow (آینده / future) <a class="anchor" href="#1-platform-owned-pricing-flow-آینده-future" aria-hidden="true">#</a></h2>
|
||||
<p>فلوی قیمت باید سمت ما باشه:</p>
|
||||
<ul>
|
||||
<li>وقتی فرد میخواد دستمزد ساعتی و روزانهاش رو مشخص کنه، باید یه <strong>رنجی از بازار</strong> بهش نشون بدیم و</li>
|
||||
</ul>
|
||||
<p> چند تا نکته بنویسیم: اگر زیاد گذاشت یا کم، که «رنج مناسبی نذاشتی و مشتریهات کم میشه»؛ و نسبت به <strong>سابقه و مهارتها</strong> یه <strong>عدد پیشنهادی</strong> توی بازه بهش نشون بدیم که کار رو راحتتر کنه.</p>
|
||||
<ul>
|
||||
<li>در آینده باید داستان <strong>بوست (boost)</strong> رو برای هر دو طرف مشخص کنیم — اگر مشتری بخواد زودتر کسی رو</li>
|
||||
</ul>
|
||||
<p> پیدا کنه، یا پرستار بخواد زودتر کار بگیره (مرحلهٔ خیلی بعد).</p>
|
||||
<ul>
|
||||
<li>کل پروسهٔ <strong>بید زدن (bidding)</strong> پرستارها رو بذاریم برای بعداً — چون مشتری رو ناراضی میکنه و الان</li>
|
||||
</ul>
|
||||
<p> وقتش نیست.</p>
|
||||
<blockquote><p>Relates to today's MVP, where nurses set their own transparent prices per variant — see <a href="../business/03-service-catalog-and-pricing.html">Service Catalog & Pricing</a>. Surge/boost/bidding are explicitly <strong>deferred</strong> there.</p>
|
||||
</blockquote>
|
||||
<hr>
|
||||
<h2 id="2-installments-only-above-a-meaningful-threshold">2. Installments only above a meaningful threshold <a class="anchor" href="#2-installments-only-above-a-meaningful-threshold" aria-hidden="true">#</a></h2>
|
||||
<p>سیستم اقساطی باید بصرفه باشه — نباید برای <strong>یک روز</strong> خدمات قسطی بدیم. برای درخواستهای <strong>بالای سه روز</strong> (شاید حتی بالاتر) منطقیتره که عددش معنیدار بشه — کسی ۴–۵ تومن رو قسطی نمیکنه. (این گمان هست؛ باید دیتای بیشتری ببینیم.)</p>
|
||||
<p>پس نیاز داریم بتونیم برای <strong>بازههای قیمتی متفاوت</strong>، گزینههای پرداخت (کارت / BNPL) رو <strong>فعال یا غیرفعال</strong> کنیم.</p>
|
||||
<blockquote><p>Implementation hook: a config-driven rule that enables/disables BNPL by booking total / duration. See the <a href="../business/09-installments-bnpl.html">BNPL business area</a> and <code>platform_configs</code> in <a href="../data-model/12-audit-config-and-reference.html">audit, config & reference</a>.</p>
|
||||
</blockquote>
|
||||
<hr>
|
||||
<h2 id="3-blog-آینده-future">3. Blog (آینده / future) <a class="anchor" href="#3-blog-آینده-future" aria-hidden="true">#</a></h2>
|
||||
<p>برای آینده، یک <strong>بلاگ</strong> در نظر داشته باشیم.</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>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
@@ -0,0 +1,45 @@
|
||||
# Future Ideas & Backlog
|
||||
|
||||
[← Product docs home](../index.md)
|
||||
|
||||
Raw product thinking captured for later — **not** committed MVP scope. Original notes were in Farsi
|
||||
(`additional-info.txt`); kept verbatim with light framing.
|
||||
|
||||
---
|
||||
|
||||
## 1. Platform-owned pricing flow (آینده / future)
|
||||
|
||||
فلوی قیمت باید سمت ما باشه:
|
||||
|
||||
- وقتی فرد میخواد دستمزد ساعتی و روزانهاش رو مشخص کنه، باید یه **رنجی از بازار** بهش نشون بدیم و
|
||||
چند تا نکته بنویسیم: اگر زیاد گذاشت یا کم، که «رنج مناسبی نذاشتی و مشتریهات کم میشه»؛ و نسبت به
|
||||
**سابقه و مهارتها** یه **عدد پیشنهادی** توی بازه بهش نشون بدیم که کار رو راحتتر کنه.
|
||||
- در آینده باید داستان **بوست (boost)** رو برای هر دو طرف مشخص کنیم — اگر مشتری بخواد زودتر کسی رو
|
||||
پیدا کنه، یا پرستار بخواد زودتر کار بگیره (مرحلهٔ خیلی بعد).
|
||||
- کل پروسهٔ **بید زدن (bidding)** پرستارها رو بذاریم برای بعداً — چون مشتری رو ناراضی میکنه و الان
|
||||
وقتش نیست.
|
||||
|
||||
> Relates to today's MVP, where nurses set their own transparent prices per variant — see
|
||||
> [Service Catalog & Pricing](../business/03-service-catalog-and-pricing.md). Surge/boost/bidding
|
||||
> are explicitly **deferred** there.
|
||||
|
||||
---
|
||||
|
||||
## 2. Installments only above a meaningful threshold
|
||||
|
||||
سیستم اقساطی باید بصرفه باشه — نباید برای **یک روز** خدمات قسطی بدیم. برای درخواستهای **بالای سه
|
||||
روز** (شاید حتی بالاتر) منطقیتره که عددش معنیدار بشه — کسی ۴–۵ تومن رو قسطی نمیکنه. (این گمان
|
||||
هست؛ باید دیتای بیشتری ببینیم.)
|
||||
|
||||
پس نیاز داریم بتونیم برای **بازههای قیمتی متفاوت**، گزینههای پرداخت (کارت / BNPL) رو **فعال یا
|
||||
غیرفعال** کنیم.
|
||||
|
||||
> Implementation hook: a config-driven rule that enables/disables BNPL by booking
|
||||
> total / duration. See the [BNPL business area](../business/09-installments-bnpl.md) and
|
||||
> `platform_configs` in [audit, config & reference](../data-model/12-audit-config-and-reference.md).
|
||||
|
||||
---
|
||||
|
||||
## 3. Blog (آینده / future)
|
||||
|
||||
برای آینده، یک **بلاگ** در نظر داشته باشیم.
|
||||
@@ -0,0 +1,63 @@
|
||||
<!DOCTYPE html>
|
||||
<html lang="en">
|
||||
<head>
|
||||
<meta charset="utf-8">
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1">
|
||||
<title>Open Questions & To-Do Backlog — 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 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 class="active" href="open-questions.html">Open questions</a></li><li><a href="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="open-questions-to-do-backlog">Open Questions & To-Do Backlog</h1>
|
||||
<p><a href="../index.html">← Product docs home</a></p>
|
||||
<p>From <code>whatsInYourMind.txt</code> — things to build, research, or decide. Some are now resolved in the refined data model; marked below.</p>
|
||||
<hr>
|
||||
<h2 id="build-surface-backlog">Build / surface backlog <a class="anchor" href="#build-surface-backlog" aria-hidden="true">#</a></h2>
|
||||
<ul>
|
||||
<li><strong>Ticket page</strong> — the admin-readable messaging surface; modeled in</li>
|
||||
</ul>
|
||||
<p> <a href="../data-model/09-messaging.html">Messaging (ticket system)</a> and required by <a href="../business/12-messaging-and-emergencies.html">Messaging & On-Site Emergencies</a>.</p>
|
||||
<ul>
|
||||
<li><strong>Backoffice / admin</strong> — see <a href="../business/14-notifications-and-admin.html">Notifications & Admin / Backoffice</a>.</li>
|
||||
<li><strong>Verify the registration code</strong> — OTP confirmation step in onboarding.</li>
|
||||
<li><strong>Rate limiting</strong> — abuse protection on auth/OTP and API.</li>
|
||||
<li><strong>Workbox for cache</strong> (maybe) — PWA/offline caching, client-side.</li>
|
||||
</ul>
|
||||
<h2 id="needs-research">Needs research <a class="anchor" href="#needs-research" aria-hidden="true">#</a></h2>
|
||||
<ul>
|
||||
<li><strong>Terms of Service page</strong> — <em>(needs research)</em>.</li>
|
||||
<li><strong>Privacy & Policy page</strong> — <em>(needs research)</em>.</li>
|
||||
</ul>
|
||||
<hr>
|
||||
<h2 id="resolved-questions-kept-for-the-record">Resolved questions (kept for the record) <a class="anchor" href="#resolved-questions-kept-for-the-record" aria-hidden="true">#</a></h2>
|
||||
<p>These were the two hardest open questions; both are now <strong>answered</strong> against verified payment research and built into the model.</p>
|
||||
<ul>
|
||||
<li><del>اگر پرداخت قسطی داشته باشیم و طرف اون وسط بخواد کنسل کنه چی میشه؟</del></li>
|
||||
</ul>
|
||||
<p> <strong>(BNPL booking cancelled mid-plan — what happens?)</strong> → Resolved. Money always flows <code>customer ↔ provider ↔ Balinyaar</code>; Balinyaar calls the provider's revert/cancel/update API and the provider unwinds the customer's installments. See <a href="../payments/cancellation-and-payout.html">Q1 — cancellation/refund</a> and <a href="../data-model/index.html">the two questions</a>.</p>
|
||||
<ul>
|
||||
<li><del>BNPL اگر باشه خب پول پرستار رو کی میده؟</del></li>
|
||||
</ul>
|
||||
<p> <strong>(Under BNPL, who pays the nurse?)</strong> → Resolved. <strong>Balinyaar</strong> pays the nurse, on its own weekly schedule, from <code>gross − balinyaar_commission</code> — identical to a card booking; the BNPL commission is a platform expense, never the nurse's. See <a href="../payments/cancellation-and-payout.html">Q2 — who pays the nurse & when</a>.</p>
|
||||
<hr>
|
||||
<p>See also the launch-blocking items to confirm with counsel / providers: <a href="../research/go-to-market.html">research open questions</a> and <a href="../data-model/index.html">data-model open items</a>.</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>
|
||||
|
||||
</body>
|
||||
</html>
|
||||
@@ -0,0 +1,47 @@
|
||||
# Open Questions & To-Do Backlog
|
||||
|
||||
[← Product docs home](../index.md)
|
||||
|
||||
From `whatsInYourMind.txt` — things to build, research, or decide. Some are now resolved in the
|
||||
refined data model; marked below.
|
||||
|
||||
---
|
||||
|
||||
## Build / surface backlog
|
||||
|
||||
- **Ticket page** — the admin-readable messaging surface; modeled in
|
||||
[Messaging (ticket system)](../data-model/09-messaging.md) and required by
|
||||
[Messaging & On-Site Emergencies](../business/12-messaging-and-emergencies.md).
|
||||
- **Backoffice / admin** — see [Notifications & Admin / Backoffice](../business/14-notifications-and-admin.md).
|
||||
- **Verify the registration code** — OTP confirmation step in onboarding.
|
||||
- **Rate limiting** — abuse protection on auth/OTP and API.
|
||||
- **Workbox for cache** (maybe) — PWA/offline caching, client-side.
|
||||
|
||||
## Needs research
|
||||
|
||||
- **Terms of Service page** — *(needs research)*.
|
||||
- **Privacy & Policy page** — *(needs research)*.
|
||||
|
||||
---
|
||||
|
||||
## Resolved questions (kept for the record)
|
||||
|
||||
These were the two hardest open questions; both are now **answered** against verified payment
|
||||
research and built into the model.
|
||||
|
||||
- ~~اگر پرداخت قسطی داشته باشیم و طرف اون وسط بخواد کنسل کنه چی میشه؟~~
|
||||
**(BNPL booking cancelled mid-plan — what happens?)** → Resolved. Money always flows
|
||||
`customer ↔ provider ↔ Balinyaar`; Balinyaar calls the provider's revert/cancel/update API and the
|
||||
provider unwinds the customer's installments. See
|
||||
[Q1 — cancellation/refund](../payments/cancellation-and-payout.md) and
|
||||
[the two questions](../data-model/index.md).
|
||||
- ~~BNPL اگر باشه خب پول پرستار رو کی میده؟~~
|
||||
**(Under BNPL, who pays the nurse?)** → Resolved. **Balinyaar** pays the nurse, on its own weekly
|
||||
schedule, from `gross − balinyaar_commission` — identical to a card booking; the BNPL commission is
|
||||
a platform expense, never the nurse's. See [Q2 — who pays the nurse & when](../payments/cancellation-and-payout.md).
|
||||
|
||||
---
|
||||
|
||||
See also the launch-blocking items to confirm with counsel / providers:
|
||||
[research open questions](../research/go-to-market.md) and
|
||||
[data-model open items](../data-model/index.md).
|
||||
Reference in New Issue
Block a user