Shared Medicines List : Update Composition and List profiles to allow multiple types of lists controlled by value set

[dbojicic-agency]

Prerequisites

• [x] I have searched open and closed issues to make sure it isn't already requested or reported
• [x] I have written a descriptive issue title

The issue / feature

Change description

Update Shared Medicine List Composition (StructureDefinition-composition-sml-prac-1) and List of Medicine Items with Change Information Authored by Practitioner (StructureDefinition-list-sml-pracchanges-1) profiles to allow multiple medication sections in the Composition with the section code being chosen from a value set. The alignment between the list and the section is enforced by an invariant that forced the list to carry the same code as the section.

Currently the value set allows the following concepts:

• 101.32009 Current Medicines, from NCTIS Data Components
• 10160–0 History of Medication use Narrative, from LOINC
• 101.32027 Ceased Medicines, from NCTIS Data Components

but can be extended in the future.

What it actually enables people to do

This is a flexible design, similar to the design in Prescription and Dispense List Composition, that allows controlling the types of allowed lists (current, ceased etc) via value set.

Mockups

Shared Medicine List Composition (StructureDefinition-composition-sml-prac-1) - Medicines list section changes

• 1..* section slice "Medicines list" with must support:
  • invariant: If a list entry is referenced its code shall be the same as the section code
  • invariant: The section shall at least have one entry or an empty reason, but not both
  • invariant: If present, the assertion of no relevant finding entry shall assert no known current medications
    • 1..1 title with must support
    • 1..1 code with binding: https://healthterminologies.gov.au/fhir/ValueSet/medicines-list-type-1 (required)
    • 1..1 text with must support
    • entry Reference(List of Medicine Items with Change Information Authored by Practitioner | Assertion of No Relevant Finding) with must support
  • inv: The entry shall at least have a reference
    • emptyReason with must support - binding: https://healthterminologies.gov.au/fhir/ValueSet/health-summary-non-clinical-empty-reason-1(required)

Medicine Items with Change Information Authored by Practitioner (StructureDefinition-list-sml-pracchanges-1) changes

• 1..1 code with binding: https://healthterminologies.gov.au/fhir/ValueSet/medicines-list-type-1 (required)

How awesome would it be?

Very awesome - a robust but very flexible solution is required for forthcoming shared medicines list work. This change helps support that work.

Workarounds

N/A

Additional context

Backlog story: https://jira.digitalhealth.gov.au/browse/CIFMM-2680