/node-s2i-openshift

Example Health is a pretend/conceptual healthcare/insurance type company. It has been around a long time, and has 100s of thousands of patient records in an SQL database connected to a mainframe. This repo houses the UI/Service a client/patient would interact with.

Primary LanguageJavaScriptApache License 2.0Apache-2.0

Patient Health Records - App Modernization with RedHat OpenShift

A variation of this repo with a Dockerfile is available here: https://github.com/IBM/node-build-config-openshift

This project is a patient records user interface for a conceptual health records system. The UI is programmed with open standards JavaScript and modern, universal CSS, and HTML5 Canvas for layout.

The UI is served by a simple Node.js Express server, and the overall project goals are:

  • to use the project to show a step by step guide of deploying the app on OpenShift Source-to-Image (S2I)
  • to illustrate the versatility of Kubernetes based micro services for modernizing traditional applications - for instance mainframe based applications, or classic Java app server applications
  • to experiment and explore open standards front end technologies for rendering custom charts, and for responsive design

This project stands alone in test mode, or integrates with associated code patterns:

architecture

Example Health Background Story

Example Health is a pretend, conceptual healthcare/insurance type company. It is imagined to have been around a long time, and has 100s of thousands of patient records in an SQL database connected to a either a mainframe, or a monolithic Java backend.

The business rules for the system are written in COBOL or Java. It has some entitlement rules, prescription rules, and coverage rules coded in there.

Example's health records look very similar to the health records of most insurance companies.

Here's a view a client might see when they log in:

screenshot

Example Health business leaders have recently started understanding how machine learning, using some of the patient records, might surface interesting insights that would benefit patients. There is lots of talk about this among some of the big data companies:

Example has also heard a lot about cloud computing. There is a lot of traditional code in the mainframe and in classic Java app servers. It works well for now ... but some of the software architects think it may be complimentary to explore some machine learning, and to accelerate development of new user interfaces in the cloud (either public or private).

Project aims

In this repo there is a patient user interface. It is written using plain HTML, CSS and JavaScript served from a Node.js microservice. The code runs by default with test/demo data, that doesn't rely on a more sophisticated server. The following installation steps can help you easily deploy this using OpenShift S2I.

Installation

First, you'll need a cluster. Follow the directions to create a Red Hat OpenShift on IBM Cloud cluster.

Next, you will need a fork of this repository. Scroll back up to the top of this page and click on the Fork button.

fork

Select your github user name from the pop-up window.

To deploy your just-forked repository, go to the Web Console for your OpenShift cluster and create a project by clicking on the blue Create Project on the upper left from the Home --> Projects screen available from the navigation menu on the left:

create project

Now use the very top dropdown from the navigation menu on the left to switch from the Administrator view to Developer. From the +Add screen, select the From Git tile.

add

Use the URL of your forked repository in the Git Repo URL text imput. Click the Show Advanced Git Options bar to reveal those options, and specify /site as the Context Dir. Choose the Node.js tile from the list of Builder Images.

import

Scroll to the bottom of the screen and click the blue Create button at the bottom. OpenShift will take you to the Topology and once the deployment is finished, a green check will appear on the lower left of the Node icon.

build

When the build is complete, click on Open URL on the upper right of the Node icon. You should see the login screen:

login

You can enter any strings for username and password, for instance test/test... because the app is just running in demo mode.

And you've deployed a Node.js app to Kubernetes using OpenShift S2I.

License

This code pattern is licensed under the Apache License, Version 2. Separate third-party code objects invoked within this code pattern are licensed by their respective providers pursuant to their own separate licenses. Contributions are subject to the Developer Certificate of Origin, Version 1.1 and the Apache License, Version 2.

Apache License FAQ