kirukib
3778801ef5
Deliver role-aware shell (sidebar, breadcrumbs, quick search, tables, detail/create layouts), locale-ready pages, shared backend/feature docs, and Vercel project config so HR, finance, and members can demo against typed mocks. Co-authored-by: Cursor <cursoragent@cursor.com>
71 lines
3.2 KiB
Markdown
71 lines
3.2 KiB
Markdown
# Coordination: Gishen-Admin
|
|
|
|
How Gishen-B2B interacts with **Gishen-Admin** (pharmacy ops, commercial activation, Rx review).
|
|
|
|
**Workspace:** `/Users/kirukib/Desktop/Yaltopia Project/Gishen-B2B`
|
|
|
|
## Admin responsibilities (Admin repo owns UI)
|
|
|
|
| Domain | Admin action | B2B impact |
|
|
|--------|--------------|------------|
|
|
| Commercial activation | Set credit limit, payment terms, price list, contract dates | Org moves `pending_activation` → `active`; B2B unlocks members/packages/migration commit |
|
|
| Org creation (legacy) | Offline sales creates org + invites SUPER_USER | B2B receives invite link |
|
|
| Registration queue | Review `org.registration_submitted` / `org.registration_requested` | Admin contacts client, completes setup, activates |
|
|
| Pharmacist Rx queue | Review submitted prescriptions | B2B member sees status updates via `prescription.review_updated` |
|
|
| Credit / invoice oversight | Monthly billing, suspensions | B2B Finance sees statements; `org.suspended` blocks new orders |
|
|
| Price lists | Corporate pricing | Referenced by `organisation.commercial.price_list_id` — read-only in B2B |
|
|
|
|
## B2B responsibilities
|
|
|
|
| Action | Event emitted |
|
|
|--------|---------------|
|
|
| Self-register | `org.registration_submitted` |
|
|
| Request to register | `org.registration_requested` |
|
|
| Member submits Rx | `prescription.submitted` |
|
|
| Migration commit | `migration.job_*` (audit) |
|
|
|
|
## Events: Admin → B2B
|
|
|
|
| Event | B2B handler |
|
|
|-------|-------------|
|
|
| `org.activated` | Update org status; show commercial fields; unlock HR workflows |
|
|
| `org.suspended` | Show banner; block mutations |
|
|
| `prescription.review_updated` | Refresh prescription status in member portal |
|
|
|
|
## Events: B2B → Admin
|
|
|
|
| Event | Admin handler |
|
|
|-------|---------------|
|
|
| `org.registration_submitted` | Registration review queue |
|
|
| `org.registration_requested` | CRM / sales follow-up |
|
|
| `prescription.submitted` | Pharmacist review queue |
|
|
| `migration.job_completed` | Optional audit log |
|
|
|
|
## Data ownership
|
|
|
|
| Field / entity | Writer | Reader (B2B) |
|
|
|----------------|--------|--------------|
|
|
| `Organisation.commercial` | Admin | HR, Finance, SUPER_USER (read) |
|
|
| `Organisation.status` | Admin | All authenticated |
|
|
| `Prescription` review fields | Admin | Member, SUPER_USER |
|
|
| `Member`, `Department`, `Package` | B2B (HR) | B2B |
|
|
| `Statement` | Admin/billing engine | B2B Finance |
|
|
|
|
## Clinical withhold alignment
|
|
|
|
Admin pharmacists see full Rx detail. B2B HR/Finance never receive clinical payloads — enforced in B2B API layer and documented in entity/endpoint specs.
|
|
|
|
SUPER_USER in B2B may view member Rx for support; does not replace Admin review workflow.
|
|
|
|
## Integration checklist
|
|
|
|
- [ ] Admin registration queue consumes `org.registration_*`
|
|
- [ ] Admin activation emits `org.activated` with commercial payload shape matching [`../backend/entities/organisation.md`](../backend/entities/organisation.md)
|
|
- [ ] Pharmacist queue consumes `prescription.submitted`
|
|
- [ ] Admin review emits `prescription.review_updated`
|
|
- [ ] Statement PDF generation exposes URLs consumed by B2B `/statements`
|
|
|
|
## Contact / escalation
|
|
|
|
Cross-repo contract changes must update both Admin spec sheet and this repo's `docs/backend/` in the same release cycle.
|