clean and refine product docs structure

This commit is contained in:
hamid
2026-06-24 01:32:46 +03:30
parent be07c703ec
commit 1df3cd9f64
113 changed files with 6078 additions and 4973 deletions
@@ -0,0 +1,56 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Domain 13 — Partner Centers (launch) &amp; Future — 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 &amp; ground truths</a></li></ul></div><div class="group"><div class="label">Business requirements</div><ul><li><a href="../business/index.html">Overview &amp; MVP scope</a></li><li><a href="../business/01-actors-and-onboarding.html">1. Actors &amp; 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 &amp; pricing</a></li><li><a href="../business/04-search-and-matching.html">4. Search &amp; matching</a></li><li><a href="../business/05-booking-and-scheduling.html">5. Booking &amp; 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 &amp; refunds</a></li><li><a href="../business/08-payments-and-escrow.html">8. Payments &amp; 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 &amp; safety</a></li><li><a href="../business/12-messaging-and-emergencies.html">12. Messaging &amp; emergencies</a></li><li><a href="../business/13-tax-invoicing-and-legal.html">13. Tax, invoicing &amp; legal</a></li><li><a href="../business/14-notifications-and-admin.html">14. Notifications &amp; admin</a></li></ul></div><div class="group"><div class="label">Database model</div><ul><li><a href="index.html">Overview &amp; decisions</a></li><li><a href="diagrams.html">Diagrams</a></li><li><a href="01-identity-and-access.html">1. Identity &amp; access</a></li><li><a href="02-geography.html">2. Geography</a></li><li><a href="03-services-and-pricing.html">3. Services &amp; pricing</a></li><li><a href="04-verification-and-credentials.html">4. Verification &amp; credentials</a></li><li><a href="05-booking-and-scheduling.html">5. Booking &amp; scheduling</a></li><li><a href="06-payments-ledger-and-refunds.html">6. Payments, ledger &amp; refunds</a></li><li><a href="07-payouts.html">7. Payouts</a></li><li><a href="08-bnpl.html">8. BNPL / installments</a></li><li><a href="09-messaging.html">9. Messaging</a></li><li><a href="10-reviews-and-records.html">10. Reviews &amp; records</a></li><li><a href="11-notifications.html">11. Notifications</a></li><li><a href="12-audit-config-and-reference.html">12. Audit, config &amp; reference</a></li><li><a class="active" href="13-partner-centers-and-future.html">13. Partner centers &amp; future</a></li></ul></div><div class="group"><div class="label">Payments deep-dive</div><ul><li><a href="../payments/index.html">Overview &amp; 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 &amp; finding</a></li><li><a href="../payments/cancellation-and-payout.html">Cancellation &amp; nurse payout</a></li><li><a href="../payments/integration-notes.html">Integration &amp; schema touchpoints</a></li><li><a href="../payments/sources.html">Recommendations &amp; sources</a></li></ul></div><div class="group"><div class="label">Research &amp; strategy</div><ul><li><a href="../research/index.html">Overview &amp; exec summary</a></li><li><a href="../research/market-and-competitors.html">Market &amp; competitors</a></li><li><a href="../research/problems-and-risks.html">Problems &amp; 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 &amp; sources</a></li></ul></div><div class="group"><div class="label">Notes &amp; 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="domain-13-partner-centers-launch-future">Domain 13 — Partner Centers (launch) &amp; Future</h1>
<p><a href="index.html">← Database Model</a></p>
<p><strong>Related:</strong> business requirements — <a href="../business/13-tax-invoicing-and-legal.html">Tax, invoicing &amp; legal</a>.</p>
<h3 id="partner_centers-mvp-new"><code>partner_centers</code> [MVP] — <strong>NEW</strong> <a class="anchor" href="#partner_centers-mvp-new" aria-hidden="true">#</a></h3>
<p><strong>Role:</strong> A licensed home-nursing center (مرکز مشاوره و ارائه مراقبت‌های پرستاری در منزل) that <strong>sponsors</strong> nurses and is plausibly the <strong>merchant-of-record</strong> and invoice issuer at launch. <strong>Why this is the single most launch-critical addition:</strong> the research's #1 go-to-market recommendation is to operate by subcontracting to an already-licensed center (the Asanism model) while Balinyaar's own MoH permit is pending — the center is what makes the operation legal, may be who the IPG settles to, and clears the BNPL onboarding gate (which needs a جواز کسب + eNamad the company/center holds, not each nurse). Distinct from the future <code>organizations</code> (employer) table — this is the <strong>licensing/launch sponsor</strong>.</p>
<div class="table-wrap"><table><thead><tr><th>Field</th><th>Type</th><th>Notes</th></tr></thead><tbody>
<tr><td><code>id</code></td><td>BIGINT PK</td><td></td></tr>
<tr><td><code>name</code></td><td>NVARCHAR(300)</td><td></td></tr>
<tr><td><code>legal_entity_type</code></td><td>NVARCHAR(30)</td><td></td></tr>
<tr><td><code>moh_establishment_permit_no</code></td><td>NVARCHAR(100)</td><td>پروانه تأسیس</td></tr>
<tr><td><code>technical_director_nurse_user_id</code></td><td>BIGINT FK → users NULL</td><td>مسئول فنی</td></tr>
<tr><td><code>technical_director_license_no</code></td><td>NVARCHAR(100) NULL</td><td></td></tr>
<tr><td><code>enamad_code</code></td><td>NVARCHAR(100) NULL</td><td></td></tr>
<tr><td><code>settlement_iban</code></td><td>NVARCHAR(34) (enc) NULL</td><td>If merchant-of-record</td></tr>
<tr><td><code>is_merchant_of_record</code></td><td>BIT</td><td></td></tr>
<tr><td><code>commission_rate</code></td><td>DECIMAL(5,4) NULL</td><td>Center's cut, if any</td></tr>
<tr><td><code>admin_user_id</code></td><td>BIGINT FK → users</td><td>Center's dashboard account</td></tr>
<tr><td><code>is_active</code>, <code>verified_at</code>, timestamps</td><td></td><td></td></tr>
</tbody></table></div>
<p><strong>Relations:</strong> 1:N → <code>nurse_profiles</code> (sponsors), <code>bookings</code> (legally covered by), <code>invoices</code> (issuer).</p>
<h3 id="organizations-organization_nurses-deferred"><code>organizations</code> / <code>organization_nurses</code> [DEFERRED] <a class="anchor" href="#organizations-organization_nurses-deferred" aria-hidden="true">#</a></h3>
<p><strong>Role/Why:</strong> The future <strong>employer</strong> model (nursing companies adding their employed nurses). Modeled-but-inactive — no launch table references them, so adding them later is a pure additive migration. Kept distinct from <code>partner_centers</code> (launch licensing) to avoid conflating "sponsor for legality" with "employer."</p>
<h3 id="fraud_flags-deferred"><code>fraud_flags</code> [DEFERRED] <a class="anchor" href="#fraud_flags-deferred" aria-hidden="true">#</a></h3>
<p><strong>Role/Why:</strong> Output of a future ML fraud service. Premature for a no-traffic MVP; <code>support_alerts</code> (<code>fraud_signal</code> type) covers rule-based signals manually. Inactive stub.</p>
<h3 id="recurring_booking_schedules-deferred"><code>recurring_booking_schedules</code> [DEFERRED] <a class="anchor" href="#recurring_booking_schedules-deferred" aria-hidden="true">#</a></h3>
<p><strong>Role/Why:</strong> RFC-5545 recurrence for repeating care patterns. Note: the concrete multi-day need is now met by <code>booking_sessions</code>; this remains deferred for true open-ended recurrence. Inactive stub.</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>