Skip to content

Add concept docs for all Care domains, with real permission model#2

Merged
bodhish merged 2 commits into
mainfrom
docs/care-3-concepts
Jun 16, 2026
Merged

Add concept docs for all Care domains, with real permission model#2
bodhish merged 2 commits into
mainfrom
docs/care-3-concepts

Conversation

@bodhish

@bodhish bodhish commented Jun 16, 2026

Copy link
Copy Markdown
Member

Build the Concepts layer ("What is…?") to match the References layer: 23 plain-language concept docs across 8 domains (clinical, medications, scheduling, billing, supply, facility, forms, access), each distilled from its technical reference doc.

  • Every concept has a Permissions section grounded in the real care/security/permissions/* enums and roles (care/security/roles).
  • A dedicated "Roles & Permissions" concept documents the full RBAC model: roles, permission contexts, org-tree cascade, memberships.
  • Concepts sidebar switched to autogenerated via per-domain category.json (positioned, generated-index landing pages).
  • Links follow the repo convention: .mdx for siblings/references, extensionless for the translated patient/create-patient docs (keeps the Malayalam locale build green).
  • Mirrored to 3.0 & 3.1; full npm run build (en + ml) passes clean.

bodhish and others added 2 commits June 17, 2026 02:47
Build the Concepts layer ("What is…?") to match the References layer:
23 plain-language concept docs across 8 domains (clinical, medications,
scheduling, billing, supply, facility, forms, access), each distilled
from its technical reference doc.

- Every concept has a Permissions section grounded in the real
  care/security/permissions/* enums and roles (care/security/roles).
- A dedicated "Roles & Permissions" concept documents the full RBAC
  model: roles, permission contexts, org-tree cascade, memberships.
- Concepts sidebar switched to autogenerated via per-domain
  _category_.json (positioned, generated-index landing pages).
- Links follow the repo convention: .mdx for siblings/references,
  extensionless for the translated patient/create-patient docs (keeps
  the Malayalam locale build green).
- Mirrored to 3.0 & 3.1; full `npm run build` (en + ml) passes clean.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
… Roles

The previous tables were cherry-picked 2-column (Permission | Roles) lists.
Replace each concept's table with the complete set, sourced from
care/security/permissions/<resource>.py:

- Every permission in the resource's enum is listed (no cherry-picking).
- New Description column: code description where meaningful, otherwise a
  concise authored explanation of what the permission allows.
- System Roles column expands role constants (e.g. CLINICAL_DATA_ACCESS_ROLES)
  to display names (Doctor, Nurse, Facility Admin, ...).
- Multi-resource concepts (billing, supply, organization, questionnaire,
  specimen, access-control) group rows under per-resource sub-headings.
- Surrounding access-model prose preserved. 154 permission rows total.

Mirrored to 3.0 & 3.1; full `npm run build` (en + ml) passes clean.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@bodhish bodhish merged commit 30158b1 into main Jun 16, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant