Doc on Org-Suppliers

[john-d03]

/document Access & Governance/Supplier

[github-actions]

✅ Ezhuthachan completed successfully!

[github-actions]

Ezhuthachan

Documented Supplier and opened a pull request from branch docs/supplier-org.

A supplier is not its own model. Care stores it as an Organization with org_type = product_supplier, so the docs are written around that, in the access-governance domain.

Written (in version-3.0, mirrored to version-3.1):

• Concept concepts/access-governance/supplier.mdx
• Reference references/access-governance/supplier.mdx
• Flows flows/access-governance/add-a-supplier.mdx and update-a-supplier.mdx — the slug names a resource, so one flow per user task; the supplier admin screen supports exactly create and edit.
• New flows/access-governance/ category, plus the two flow ids appended to both version sidebars (the flow sidebar is manual).

Build is green for en and ml.

Bugs and inconsistencies

1. The supplier form shows department wording. AdminOrganizationFormSheet.tsx branches only on the role organization type, so the supplier sheet falls through to create_department_team / edit_department_team / enter_department_team_name. A user adding a supplier sees the title "Create Department/Team". The flow docs record the labels as they are today. Confidence: high.
2. Supplier type validation differs between the two order specs. SupplyRequestOrderWriteSpec (resources/inventory/supply_request/request_order.py) fetches by id and then raises ValidationError on a wrong org_type. SupplyDeliveryOrderWriteSpec (resources/inventory/supply_delivery/delivery_order.py) filters on org_type inside get_object_or_404, so the same mistake returns 404 instead of a validation error. Confidence: high that the behaviours differ; medium on which is intended.
3. The frontend organization type enum has an other member the backend does not. OrgType.OTHER = "other" in src/types/organization/organization.ts has no counterpart in OrganizationTypeChoices in care/emr/resources/organization/spec.py, and the admin form binds org_type to that enum. Confidence: high.
4. Suppliers can be deleted by permission but not from the UI. authorize_destroy blocks only govt and role, so can_manage_organization allows deleting a supplier. The supplier detail panel in AdminOrganizationList.tsx renders only the edit sheet, with no delete control. No delete flow is documented for that reason. Confidence: medium.

No blocking questions.

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

[github-actions]

Comment Memory

# Supplier docs (issue #64)

- A supplier is NOT its own Care model. It is `Organization` with `org_type = "product_supplier"`.
  Defined in `care/emr/resources/organization/spec.py` (`OrganizationTypeChoices`).
- Documented under the `access-governance` domain: concept, reference, and two flows
  (`add-a-supplier`, `update-a-supplier`) in `flows/access-governance/` (new folder + `_category_.json`).
- The flow sidebar is manual: both `versioned_sidebars/version-3.0-sidebars.json` and `-3.1-` now
  carry an "Access & Governance" flow category.
- Permissions come from `OrganizationPermissions` (`care/security/permissions/organization.py`):
  view / create / manage organization. `get_accessible_organizations` lets EVERY user list
  `govt` and `product_supplier` orgs without membership.
- The supplier admin UI is `src/pages/Admin/organizations/AdminOrganizationList.tsx`
  (flat list) + `components/AdminOrganizationFormSheet.tsx` (Name, Description only).
  The form reuses the Department/Team labels for suppliers — known wording bug, reported.
- No delete control in the supplier UI, though the backend allows delete. No delete flow written.

Note

This comment is managed by comment memory.

It stores persistent context for this thread in the code block at the top of this comment.
Edit only the text inside the backtick fences; workflow metadata and the footer are regenerated automatically.

Learn more about comment memory

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