SMH App

Share My Health app is a front-facing application designed for use by Community Based Organizations (CBOs), care coordinators, and community members. Its primary purpose is to improve care coordination by sharing health information with relevant parties.

• Allow a member(patient) to connect to their health information from one or more data source.
• Allow a member(patient) view the health information information.
• Allow a member to share access to the information with one or more Organizations.
• Allow an agent of a community-based organization (CBO) to view the health information.

The Share My Health App is a relying party to Verify My Identity, an OpenID Connect Identity Provider. As a prerequisite to a Member gaining access to health information, and identity assurance level of 2 must first be established. While this can happen in multiple ways, the primary method for this application is an Organization's agent functions as a trusted referee and corroborates the claimed identity with some real-world evidence. This will most often occur upon the initial organization-assisted member enrollment.

The Share My Health App functions as an OAuth2 client for each data source a member connects. Data sources typically expose health information in FHIR format. This application will launch in the Capital region of New York. The first data source will be the Health Information Exchange of New York (HIXNY).

For more background information, please see the following links:

• https://www.hl7.org/fhir/overview.html
• https://pages.nist.gov/800-63-3/
• https://openid.net/connect/
• https://www.carinalliance.com/

Dependency Versions

• Python 3.7.x
• Django 2.1.7
• pip >= 18.0
• virtualenv >= 16.0.0
• virtualenvwrapper >= 4.8.2
• Postgres >= 10.4 (latest for AWS RDS right now)
• git >= 2.19.0

Getting Started

First clone the repository from Github and switch to the new directory:

$ git clone [email protected]:TransparentHealth/smh_app
$ cd smh_app

To setup your local environment you can use the quickstart make target setup, which will install Python (via pip) into a virtualenv named "smh_app", and create a database via Postgres named "smh_app" with all migrations run:

$ mkvirtualenv smh_app
$ workon smh_app
$ cd .assets
$ make build
$ python manage.py migrate
$ python manage.oy runserver

Development

to setup a watcher on all sass files and compile sass (from main directory):

$ npm run sass --prefix style

VMI and ShareMyHealth

This project also communicates with several other apps (VMI and ShareMyHealth). You will need to set up a way for smh_app to communicate with these apps by:

• going to the VMI and ShareMyHealth servers, creating an account on each, and registering an application on each server
• adding the appropriate values for each application to your .env file. A sample .env file is provided in .env-sample.