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>
3.2 KiB
3.2 KiB
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.activatedwith commercial payload shape matching../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.