Skip to content

Latest commit

 

History

History
 
 

configurablecare

README.md

Configurable Care

As an implementer it is easier to build and deploy configurable care delivery applications for different health programs that can leverage evidence based guidelines (e.g. SMART Guidelines). The Configurable Care application is a reference application that enables dynamic deployment of FHIR content to drive care delivery i.e. workflows. It uses the Android FHIR SDK (Engine, DataCapture and Workflow libraries) to execute workflow logic and provide basic support for managing CarePlan and Task resources.

Running the Application

1. Download the code

To download the code, clone the FHIR App Examples repo:
git clone https://github.com/google/fhir-app-examples.git

2. Import the configurablecare app into Android Studio

Open Android Studio, select Open... and choose the configurablecare folder from the source code that you downloaded earlier.

3. Set up a local HAPI FHIR server with test data

Run the following command in a terminal to get the latest image of HAPI FHIR:
docker pull hapiproject/hapi:latest

Create a HAPI FHIR container by either using Docker Desktop to run the previously downloaded image hapiproject/hapi, or by running the following command:
docker run -p 8080:8080 hapiproject/hapi:latest
Learn more.

You should see the HAPI FHIR web interface when you navigate to http://localhost:8080/ in a browser.

Test data

You may skip this step and use your own data instead of the sample FHIR resources provided in this application.

The configurablecare/app/src/main/assets directory contains a FHIR Bundle fhir-resources-example.json with some example resources for running the Configurable Care application:

To upload these FHIR resources to the local HAPI FHIR server, run the following command from the configurablecare directory:

curl -X POST -H "Content-Type: application/json" -d \
@./app/src/main/assets/fhir-resources-example.json \
http:/localhost:8080/fhir/

Care Config

You may skip this step if you are using the example resources provided in this application. However, if you are using your own data, you will need to modify assets/care-config.json.

care-confg.json is an application level JSON config that allows the user to configure:

  • PlanDefinition resources that the application is authorized to access
  • Request resources (e.g. Task) that may be created as a result of PlanDefinition $apply operation. An example of this is setting the default due date for any Task created as a result of running $apply on a particular PlanDefinition.

This config may be left unaltered when running the application using the sample FHIR resources provided.

4. Run the configurablecare app

Now that you have imported the project into Android Studio and set up the FHIR server with test data, you are ready to run the configurablecare app for the first time.

Start the Android Studio emulator, and click Run in the Android Studio toolbar.

Demo

Watch the video below for a demo of the Configurable Care application using the sample FHIR data provided:

configurable-care-demo.mov

Disclaimer

This product is not intended to be a medical device.

The FHIR resources provided in this application are intended to be examples that illustrate the utility of Configurable Care. They must NOT be used for any medical purpose under any circumstances.

HL7®, and FHIR® are the registered trademarks of Health Level Seven International and their use of these trademarks does not constitute an endorsement by HL7.