Skip to content

Add spec-enriched model reference docs for Care 3.0 & 3.1#1

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

Add spec-enriched model reference docs for Care 3.0 & 3.1#1
bodhish merged 2 commits into
mainfrom
docs/care-3-model-references

Conversation

@bodhish

@bodhish bodhish commented Jun 16, 2026

Copy link
Copy Markdown
Member

Generate technical reference documentation for all ~50 Care EMR models, organized into 10 domains (foundation, clinical, medications, supply, scheduling, billing, facility, forms, access, platform).

Each doc cross-references both layers of the backend:

  • the Django model (storage) in care/emr/models, and

  • the Pydantic resource specs in care/emr/resources — enums, the structured shape of JSON fields, Create/Update/List/Retrieve API schemas, validation, and server-maintained behaviour.

  • References sidebar switched to autogenerated via per-domain category.json (positioned, with generated-index landing pages)

  • version-3.0 and version-3.1 kept byte-identical

  • Validated with npm run build (onBrokenLinks: throw) — passes clean, no broken links or anchors

bodhish and others added 2 commits June 17, 2026 02:06
Generate technical reference documentation for all ~50 Care EMR models,
organized into 10 domains (foundation, clinical, medications, supply,
scheduling, billing, facility, forms, access, platform).

Each doc cross-references both layers of the backend:
- the Django model (storage) in care/emr/models, and
- the Pydantic resource specs in care/emr/resources — enums, the
  structured shape of JSON fields, Create/Update/List/Retrieve API
  schemas, validation, and server-maintained behaviour.

- References sidebar switched to autogenerated via per-domain
  _category_.json (positioned, with generated-index landing pages)
- version-3.0 and version-3.1 kept byte-identical
- Validated with `npm run build` (onBrokenLinks: throw) — passes clean,
  no broken links or anchors

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

questionnaire.py defines six models; split the three distinct resources
that have their own Pydantic specs into dedicated reference docs:

- forms/questionnaire-response — QuestionnaireResponse + FormSubmission
  (submit payload, status enums, structured responses, read/write specs)
- forms/questionnaire-response-template — QuestionnaireResponseTemplate
  (TemplateData shape: pre-filled questionnaire answers, medication
  requests, activity definitions; create/update/read/retrieve specs)

Cross-linked from the questionnaire doc; valueset repositioned to 4.
Mirrored to 3.0 & 3.1; `npm run build` passes clean.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@bodhish bodhish merged commit a017dee into main Jun 16, 2026
1 check failed
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