[docs] Supplier docs (concept, reference, flows)

[github-actions]

Ezhuthachan

Closes the request in #64: /document Access & Governance/Supplier.

No <doc-types> was given, so all three layers are written.

Files added

Authored in version-3.0, mirrored byte-identical to version-3.1:

• concepts/access-governance/supplier.mdx
• references/access-governance/supplier.mdx
• flows/access-governance/add-a-supplier.mdx
• flows/access-governance/update-a-supplier.mdx
• flows/access-governance/_category_.json (new flow domain folder)

Changed: versioned_sidebars/version-3.0-sidebars.json and versioned_sidebars/version-3.1-sidebars.json — the flow sidebar is a manual list, so an Access & Governance category with the two new flow ids was appended. No existing document was rewritten.

Two flows were written because the slug was a resource, not a task: the frontend supplier admin screen supports exactly create and edit.

Sources traced

code/care:

• care/emr/resources/organization/spec.py — OrganizationTypeChoices.product_supplier, the base/write/update/read specs.
• care/emr/models/organization.py — OrganizationCommonBase fields and caches.
• care/emr/api/viewsets/organization.py — authorize_create / authorize_update / authorize_destroy, and the OTP queryset limit.
• care/security/authorization/organization.py — can_create_organization_obj, can_manage_organization_obj, and get_accessible_organizations (which makes every supplier readable by any user).
• care/security/permissions/organization.py — permission display names and role lists.
• care/emr/models/supply_request.py, care/emr/models/supply_delivery.py, and the two order write specs under care/emr/resources/inventory/ — the supplier FK and its type validation.

code/care_fe:

• src/components/ui/sidebar/admin-nav.tsx — Admin → Organizations → Suppliers.
• src/Routers/routes/adminRoutes.tsx, src/pages/Admin/organizations/AdminOrganizationList.tsx — the flat supplier list, search box, and mobile selector.
• src/pages/Admin/organizations/components/AdminOrganizationFormSheet.tsx — the Name and Description fields and the button labels.
• public/locale/en.json — every UI label used in the flows.

Left out (not verifiable)

• No keyboard shortcut is documented; src/config/keyboardShortcuts.json defines none for the supplier screens.
• Supplier deletion is not written as a flow: the backend permits it via can_manage_organization, but the supplier detail panel in AdminOrganizationList.tsx renders only the edit sheet, so there is no verified user path.

Validation

• Corruption scan clean.
• npm run build — [SUCCESS] for en and ml, exit code 0.

Generated by Ezhuthachan for #64 · opus50 · 310.4 AIC · ⌖ 13.9 AIC · ⊞ 14.4K · ◷
_{Comment /document to run again}

[cloudflare-workers-and-pages]

Deploying coredocs with    Cloudflare Pages

Latest commit:	797b7c8
Status:	✅  Deploy successful!
Preview URL:	https://2ac259ea.coredocs.pages.dev
Branch Preview URL:	https://docs-supplier-org-5ec6af7e47.coredocs.pages.dev

View logs