xShare Project CarePlan
0.1.0 - qa-preview 150

xShare Project CarePlan - Downloaded Version 0.1.0 See the Directory of published versions

## Care Plan Mapping

Logical to implementable Care Plan model map
Yellow row/cells: In this ballot publication, some row/cells of the mapping table have been left in yellow to indicate areas requiring further review or refinement; including feedback from the Xt-EHR joint action (see note above). These highlights will be addressed in subsequent updates to ensure accuracy and completeness of the mappings.

### Logical to implementable Care Plan model map

This page explains how conceptual elements from the CarePlanXShareModel logical model are expressed in the corresponding xShare Care Plan and Goal profiles used by this Implementation Guide.

The revised logical model now derives from `EHDSDataSet`. Header elements inherited from that parent remain mapped here where they are relevant to the xShare Care Plan profile, while newly introduced or renamed care plan elements are aligned with the current R4 representation used by this guide.

Mapping Context

- Source logical model: CarePlanXShareModel
- Target FHIR profiles: CarePlanXShare and GoalXShare

CarePlanXShareModel to xShare CarePlan map
CarePlanXShareModel (Logical Model) | Relationship | Target FHIR representation
--- | --- | ---
Element | Description | Relation | Resource | Element | Description | Notes
header | Basic metadata for this information. | related-to | CarePlan | . | Header-level metadata represented by native CarePlan resource metadata and elements. | The parent header is a grouping element; its child elements are mapped individually below.
header.identifier | Identifier for the care plan. | equivalent | CarePlan | identifier | External identifiers for the care plan. |
header.subject | The patient whose intended care is described in the plan. | equivalent | CarePlan | subject | Who the care plan is for. |
header.author[x] | The responsible party (custodian) for the care plan. | equivalent | CarePlan | author | Who authored or is responsible for the care plan. |
header.status | Indicates whether the plan is currently being acted upon, represents future intentions, or is now a historical record. | equivalent | CarePlan | status | Current status of the care plan. |
header.date | Date and optionally time of authoring/issuing. | equivalent | CarePlan | created | Date the plan was created. |
header.source | Source of information, e.g. patient, patient's representative, or health professional. | narrower | CarePlan | contributor | Who provided the content of the care plan. |
header.language | Language in which the resource is written. | equivalent | CarePlan | language | Language of the resource content. |
title | Human-friendly title of the care plan. | equivalent | CarePlan | title | Title of the care plan. |
description | Narrative description of the care plan. | equivalent | CarePlan | description | Description of the care plan. |
period | Time period the care plan covers. | equivalent | CarePlan | period | Period over which the care plan is in effect. |
realizeUri | Identifier or reference to the guidelines that this care plan realizes. | related-to | CarePlan | instantiatesUri | URI identifying an external protocol, guideline, or definition instantiated by the plan. |
realizeReference | Identifier or reference to the guidelines that this care plan realizes. | related-to | CarePlan | instantiatesCanonical | Canonical identifier for the guideline instantiated by the plan. | Use when the referenced guideline or definition can be represented by a canonical URL.
category | Categorization of the care plan. | equivalent | CarePlan | category | Type/category of the care plan. |
careTeam | Care team/organization in charge of the plan. | equivalent | CarePlan | careTeam | CareTeam(s) responsible for the plan. | References the CareTeam resource(s) carrying the participants.
careTeam.member[x] | References to practitioners, organizations, or related persons involved in the care plan. | related-to | CareTeam | participant.member | Member of the care team. | Reached through CarePlan.careTeam.
addresses[x] | Problems/health concerns prompting the care plan. | equivalent | CarePlan | addresses | Conditions/concerns addressed by the plan. |
activity | Planned or performed activities as part of the care plan. | related-to | CarePlan | activity | Activities that are part of the plan. | Acts as the logical grouping for the mapped activity components below.
activity.activityCodeableConcept | The details of the proposed activity represented as a code. | related-to | Referenced activity resource | code | Code describing the requested, scheduled or performed activity. | The xShare R4 CarePlan profile constrains `CarePlan.activity.detail` to `0..0`; coded activity details should therefore be carried by the referenced activity resource where applicable.
activity.activityReference | The details of the proposed activity represented in a specific resource. | equivalent | CarePlan | activity.reference | Reference to the activity resource. |
activity.workflowStatus | Workflow status of the activity. | related-to | CarePlan | activity.reference | Reference to the activity resource. | The activity status is captured in the referenced resource, e.g. ServiceRequest.status.
activity.description | Human-readable description of the activity. | related-to | CarePlan | activity |  | Activity-specific description may also be represented in the referenced resource narrative.
activity.progress | Outcome(s) or progress notes captured for the activity. | equivalent | CarePlan | activity.progress | Annotation(s) describing progress or outcome. | The revised logical model expresses outcome/progress as `Annotation` rather than separate summary/evidence sub-elements.
activity.performed | References to the performed activities. | related-to | CarePlan | activity.outcomeReference | References to resources documenting performed outcomes or events. | Used when the plan links to the activity that was actually performed, such as a Procedure or Encounter.
goal | Goals defined for the care plan, including treatment goals and patient goals. | related-to | CarePlan | goal | Goals addressed by the plan. | `CarePlan.goal` references Goal resources; the logical-model goal details are represented in the referenced Goal.
goal.description | Describes the intended objective(s) of carrying out the care plan. | related-to | Goal | description | Human-readable or coded description of the goal. | Reached through `CarePlan.goal`. FHIR R4 `Goal.description` is mandatory and is the closest representation for the logical goal code.
goal.category | Categorization of the goal, e.g. treatment goal or patient goal. | equivalent | Goal | category | Category of the goal. | Reached through CarePlan.goal.
goal.target | Target of the goal. | equivalent | Goal | target | Target value, measure, or state to be achieved. | Use the appropriate `Goal.target` parts, including `detail[x]`, depending on how the target is represented.
goal.due | Date by which the goal should be met or reviewed. | related-to | Goal | target.dueDate | Date by which the goal should be met. | Use Goal.statusDate instead if a future refinement needs to record when an achieved/improving status took effect.
goal.outcome | Outcome of the goal represented as an observation or other outcome evidence. | equivalent | Goal | outcomeReference | Reference to information that documents whether or how the goal was achieved. | Use an Observation profile, such as an EHDS observation representation, when the outcome is captured as a clinical observation.
supportingInfo | Evidence/supporting information used as the basis for this care plan. | equivalent | CarePlan | supportingInfo | Supporting information for the plan. |