Scenario 4 - Patient Works with Personal Trainer - Physical Activity Implementation Guide v1.0.1

Physical Activity Implementation Guide
1.0.1 - STU Release 1 United States of America flag

Physical Activity Implementation Guide, published by HL7 International / Patient Care. This guide is not an authorized publication; it is the continuous build for version 1.0.1 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/HL7/physical-activity/ and changes regularly. See the Directory of published versions

ExampleScenario: Scenario 4 - Patient Works with Personal Trainer

Official URL: http://hl7.org/fhir/us/physical-activity/ExampleScenario/Scen4PhysicalActivityPlan				Version: 1.0.1
Standards status: Informative				Computable Name: PatientWorksWithPersonalTrainer

This scenario provides an example of the types of data exchanges that are described in the Patient Works with Personal Trainer scenario from the Scenarios page.

The scenario shows the flows of information between the different systems and the various FHIR calls involved, as well as what the data might have looked like in each of the exchanges. There are detailed tables below that provide details on each of the steps in the exchange as well as the types of data being shared. From the instances table, it's possible to navigate to sample XML and JSON instances.

Actors

Name	Type	Description
Patient Application	System	A phone or web-based app used by Ms. Scarborough to track her physical activity
Provider Application	System	A phone or web-based app used by Ms. Rocha to manage her clients' data

Diagram

Processes

Process: Physical Activity Plan Establishment and Observations

Pre-conditions:

CarePlan and initial Goal are created, Patient and Provider apps are operational

Post-conditions:

CarePlan and Goal successfully retrieved

Step	Name	Description	Initator	Receiver	Request	Response
1	Query CarePlan - search-type	Patient app queries exercise CarePlan describing proposed exercise regime.	Patient Application	Provider Application	Query for patient physical activity care plans	Search-set of Care Plans
2	Query Goals - search-type	Patient app queries Goals.	Patient Application	Provider Application	Query for patient physical activity goals	Search-set of Goals

Process: Post Observations, CarePlan adjustment and new Goals

Pre-conditions:

Initial care plan and goal retrieved

Post-conditions:

Care plan followed, various observations are posted by the patient and initial goal accomplished (along with filling survey). Care plan is adjusted, new goal is set, and observations are posted

Step	Name	Description	Initator	Receiver	Request	Response
3	Post activity type - create	Patient app posts an observation indicating type of physical activity. `POST https://ufit.example.org/fhir/Observation`	Patient Application	Provider Application	Example physical activity type record
4	Post min/day - create	Patient app posts an observation indicating number of minutes/day of moderate to vigorous physical activity. `POST https://ufit.example.org/fhir/Observation`	Patient Application	Provider Application	Initial minutes/day of cardio
5	Post peak daily heart rate - create	Patient app posts an observation indicating their peak daily heart rate. `POST https://ufit.example.org/fhir/Observation`	Patient Application	Provider Application	Example peak daily heart rate
6	Post min/day #2 - create	Patient app posts another observation indicating number of minutes/day of moderate to vigorous physical activity. `POST https://ufit.example.org/fhir/Observation`	Patient Application	Provider Application	Updated minutes/day of cardio
7	Post daily steps - create	Patient app posts an observation indicating their peak daily heart rate. `POST https://ufit.example.org/fhir/Observation`	Patient Application	Provider Application	Example daily step count
8	Post peak daily calories - create	Patient app posts an observation indicating their peak daily heart rate. `POST https://ufit.example.org/fhir/Observation`	Patient Application	Provider Application	Example daily calories
9	Update goal - update	Patient updates their initial goal to indicate it's achieved. `PUT https://ufit.example.org/fhir/Observation/Scen4Goal1`	Patient Application	Provider Application	Initial goal
10	Retrieve patient tasks#1 - search-type	Based on an SMS prompt from an 'internal' subscription, the patient app checks for new tasks assigned by their trainer and receives request to fill out a survey.	Patient Application	Provider Application	Query for patient uncomplete tasks	Search-set of active patient Tasks#1
11	Update task#1 - update	Patient updates the task with the completed survey. `PUT https://ufit.example.org/fhir/Task/Scen4TaskFillSurvey`	Patient Application	Provider Application	Completed request
12	Retrieve patient tasks#2 - search-type	Based on an SMS prompt from an 'internal' subscription, the patient app checks for new tasks assigned by their trainer and receives request to reivew a video.	Patient Application	Provider Application	Query for patient uncomplete tasks	Search-set of active patient Tasks#2
13	Update task#2 - update	Patient updates the task indicating they've watched the video. `PUT https://ufit.example.org/fhir/Task/Scen4TaskReviewVideo`	Patient Application	Provider Application	Completed request
14	Query CarePlan#2 - search-type	After a phone call, patient uses app to retrieve updated CarePlan describing revised exercise regime.	Patient Application	Provider Application	Query for patient physical activity care plans	Search-set of Care Plans#2
15	Query Goals#2 - search-type	After a phone call, patient uses app to retrieve updated Goals.	Patient Application	Provider Application	Query for patient physical activity goals	Search-set of Goals
16	Post min/day #3 - create	Patient app posts a third observation indicating number of minutes/day of moderate to vigorous physical activity. `POST https://ufit.example.org/fhir/Observation`	Patient Application	Provider Application	Final minutes/day of cardio
17	Update goal - update	Patient updates their second goal to indicate it's achieved, but they want to stay where they are. `PUT https://ufit.example.org/fhir/Observation/Scen4Goal2`	Patient Application	Provider Application	Initial goal
18	Retrieve patient tasks#3 - search-type	Based on an SMS prompt from an 'internal' subscription, the patient app checks for new tasks assigned by their trainer and receives request to complete a second survey.	Patient Application	Provider Application	Query for patient uncomplete tasks	Search-set of active patient Tasks#3
19	Update task#3 - update	Patient updates the task indicating it's complete with the new completed survey. `PUT https://ufit.example.org/fhir/Task/Scen4TaskFillSurvey2`	Patient Application	Provider Application	Completed request

Instances

Name	Type	Content	Description
Query for patient physical activity care plans	Binary		Query for CarePlans for a patient: `GET https://ufit.example.org/fhir/CarePlan?patient=Patient/Scen4PatientScarborough&status=active,on-hold&category=http%3A//hl7.org/fhir/us/physical-activity/CodeSystem/pa-temporary-codes\|PhysicalActivity`
Query for patient physical activity goals	Binary		Query for Goals for a patient: `GET https://ufit.example.org/fhir/Goal?patient=Patient/Scen4PatientScarborough&status=active,on-hold,completed&category=http%3A//hl7.org/fhir/us/physical-activity/CodeSystem/pa-temporary-codes\|PhysicalActivity`
Query for patient uncomplete tasks	Binary		Query for uncomplete patient Tasks for a patient: `GET https://ufit.example.org/fhir/Task?owner=Patient/Scen4PatientScarborough&status=active,on-hold`
Patient physical activity care plan	CarePlan		CarePlan describing proposed exercise regime
Initial CarePlan		here	CarePlan describing proposed exercise regime
Updated CarePlan		here	CarePlan describing proposed exercise regime
Physical Activity weekly target	Goal		Goal indicating target number of minutes/day and days/week weight-lifting
Initial goal		here	Goal indicating target number of minutes/day and days/week weight-lifting
Initial goal		here	Goal indicating target number of minutes/day and days/week weight-lifting
Physical Activity weekly target	Goal		Increased goal indicating target number of minutes/day and days/week weight-lifting
Initial goal		here	Increased goal indicating target number of minutes/day and days/week weight-lifting
Initial goal		here	Increased goal indicating target number of minutes/day and days/week weight-lifting
Search-set of Care Plans	Bundle	here	Initial search results on Care plan for the patient Contains: Initial CarePlan
Search-set of Care Plans#2	Bundle	here	New search results on Care plan for the patient Contains: Updated CarePlan
Search-set of Goals	Bundle	here	Initial search results on Goal for the patient Contains: Initial goal
Search-set of Goals	Bundle	here	Initial search results on Goal for the patient Contains: Initial goal
Search-set of active patient Tasks#1	Bundle	here	Initial search results of uncomplete patient Tasks. (Triggered by notification from trainer's app.) Contains: Initial request
Search-set of active patient Tasks#2	Bundle	here	Second search results of uncomplete patient Tasks. (Triggered by notification from trainer's app.) Contains: Initial request
Search-set of active patient Tasks#3	Bundle	here	Third search results of uncomplete patient Tasks. (Triggered by notification from trainer's app.) Contains: Initial request
Example physical activity type record	Observation	here	A sample record indicating the type of physical activity performed by the patient
Initial minutes/day of cardio	Observation	here	A sample record of the minutes per day of cardio done by the patient
Example peak daily heart rate	Observation	here	A sample record of daily calories captured by the patient
Updated minutes/day of cardio	Observation	here	A second sample record of the minutes per day of cardio done by the patient
Example daily step count	Observation	here	A sample record of daily steps captured by the patient
Example daily calories	Observation	here	A sample record of daily calories captured by the patient
Final minutes/day of cardio	Observation	here	A third sample record of the minutes per day of cardio done by the patient
Request for patient to fill out survey	Task		Patient Task requesting patient to fill out a satisfaction survey
Initial request		here	Patient Task requesting patient to fill out a satisfaction survey
Completed request		here	Patient Task requesting patient to fill out a satisfaction survey
Second request for patient to fill out survey	Task		New patient Task requesting patient to fill out a satisfaction survey
Initial request		here	New patient Task requesting patient to fill out a satisfaction survey
Completed request		here	New patient Task requesting patient to fill out a satisfaction survey
Request for patient to view video	Task		New patient Task requesting patient to fill out a satisfaction survey
Initial request		here	New patient Task requesting patient to fill out a satisfaction survey
Completed request		here	New patient Task requesting patient to fill out a satisfaction survey

IG © 2022+ HL7 International / Patient Care. Package hl7.fhir.us.physical-activity#1.0.1 based on FHIR 4.0.1. Generated 2024-03-12
Links: Table of Contents | QA Report | Version History | | Propose a change