This repository has been archived on 2026-08-11. You can view files and clone it, but cannot push or open issues or pull requests.
Gishen-B2B/docs/coordination/gishen-admin.md
kirukib 3778801ef5 Ship Gishen B2B institutional portal with polished layout and mock-backed flows.
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>
2026-08-06 21:18:23 +03:00

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.activated with 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.