An application to assist Utah CDC's Newborn Screening Program
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
app
bin
config
data
db
docs
lib
log
public
spec
tmp
vendor
.DS_Store
.babelrc
.env
.gitignore
.nvmrc
.postcssrc.yml
.rspec
.rubocop.yml
.ruby-version
DISCLAIMER.md
Dockerfile
Gemfile
Gemfile.lock
LICENSE.md
Procfile
Procfile.dev
README.md
Rakefile
config.ru
docker-compose.yml
package.json
yarn.lock

README.md

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 some_package@1.2.3.
  • 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: