Newborn Screening Data on FHIR

Background

The Utah Newborn Screening Program collects a variety of demographic data from the screening specimen that is sent in for a newborn. Often the data collected is missing or inaccurate. In order to complete the data and/or ensure accuracy, the Utah Newborn Screening Program compares this data against the Utah Office of Vital Records and Statistics data from birth and death certificates. The current process is antiquated and would benefit from the usage of a newer technology like FHIR. The full specification can be retrieved here.

This application provides an FHIR interface to compare the data between the Utah Newborn Screening Program and the Utah Office of Vital Records and Statistics.

How To Run

1. Ensure the correct versions of Docker and Docker Compose are installed per the dependencies.
2. Run docker-compose up.
3. The application is at http://localhost:3000
4. The associated FHIR instance is available at http://localhost:8080

How To Deploy

The main Rails application can be deployed as a containerized application. The application can be configured with the following environment variables:

Variable	Description
DATABASE_URL	URL to PostgreSQL database. See: database.yml
FHIR_URL	URL to FHIR server.
RAILS_ENV	Environment. Recommended: production
RAILS_RELATIVE_URL_ROOT	Deploy to a relative root. Example: /app

How To Set Up For Native (Local) Development

1. Ensure all the dependencies are installed.
2. Run bin/setup.
3. Run bin/rails server.

How To Test

1. Ensure all the dependencies are installed.
2. Run bin/test.

How To Upgrade Packages

• For JavaScript packages, run yarn add [email protected].
• For Ruby gems, run bundle update some_package.
• Ensure that the respective .lock files are updated and added to source control.

Dependencies

This is a Rails v5.1.4 application that requires:

• Docker ~> 17.09
• Docker Compose ~> 1.17
• Ruby ~> 2.4
• Bundler -> 1.15
• Node.js ~> 8.7
• Yarn ~> 1.2
• PostgreSQL ~> 9.6