FAST National Directory for Healthcare Reference Implementation

Live Instance

Live demo instance: https://ndh-query-client.fast.hl7.org The HL7 FAST accelerator autobuilder and image repository: https://hub.docker.com/repository/docker/hlseven/fast-ndh-query-client

Installation and Deployment

The client reference implementation can installed and run locally on your machine. Install the following dependencies first:

• Ruby 2.6+
• Ruby Bundler
• PostgreSQL

And run the following commands from the terminal:

# MacOS or Linux
git clone https://github.com/HL7-FAST/ndh-query-client
cd ndh-query-client
bundle install

Start PostgreSQL

Create the zipcode database:

rake db:create
rake db:migrate

Initialize the zipcode database once:

ruby db/seed_zipcodes.rb

Install and start memcached

instructions

Now you are ready to start the client.

rails s

The client can then be accessed at http://localhost:3000 in a web browser.

If you would like to use a different port it can be specified when calling rails. For example, the following command would host the client on port 4000:

rails s -p 4000

Reference Implementation

While it is recommended that users install the client locally, an instance of the client is hosted at Stay Tuned.

Users that would like to try out the client before installing locally can use that reference implementation.

Docker Container

If you prefer, you can also build the client application within a Docker container. When you run the Docker container, it will indicate the local port that should be used to access the client.

git clone https://github.com/HL7-FAST/ndh-query-client
cd ndh-query-client
docker build -t ndh-query-client .
docker run -itP ndh-query-client

Supported Browsers

The client has been tested on the latest versions of Chrome and Safari.

License

Based on code with the following copyright: Copyright 2019 The MITRE Corporation

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Questions and Contributions

Questions about the project can be asked in the US National Directory stream on the FHIR Zulip Chat.

This project welcomes Pull Requests. Any issues identified with the RI should be submitted via the GitHub issue tracker.

As of October 1, 2022, The Lantana Consulting Group is responsible for the management and maintenance of this Reference Implementation. In addition to posting on FHIR Zulip Chat channel mentioned above you can contact Corey Spears for questions or requests.