Intro

This projects implements the Helix FHIR Server which is a highly scalable FHIR server implementation with real-time data streaming, change event tracking and modern APIs such as GraphQL.

For example:

1. Added support for every FHIR resource
2. Added support for merging data via $merge
3. Added support for $graph endpoint
4. Added support for authentication
5. Added support for checking user/x.x and access/x.x scopes
6. Provides a WebUI to explore the FHIR data using the web browser
7. Support GraphQL access to FHIR resources
8. Added support for all FHIR search parameters
9. Delayed processing for updating history table and creating audit logs to speed up the response to the client.
10. Change events are (optionally) sent to a Kafka queue to enable any client to respond to and also enables realtime streaming.

Cheat sheet

Cheatsheet

Security

Security

Optimizing Performance

Performance

FHIR GraphDefinition Support (We recommend using graphql below whenever possible instead)

Graph

GraphQL Support

GraphQL

GraphQLV2 Support

GraphQLV2

Merge functionality

Merge

$everything functionality

Everything

Streaming functionality

Streaming

Bulk Export functionality

Bulk Export

Optimistic Concurrency Support

Optimistic Concurrency

Contributing

Contributing

Status Codes

Status Codes

Continous Integration

This project has continuous integration set up so GitHub will automatically run tests on your Pull Requests.

Building the Docker image and pushing to DockerHub

To deploy this code:

1. Create a new release in GitHub and choose the next available version number as the release name. This builds the docker image and pushes it to two locations: DockerHub (public) and AWS ECR(private for b.well). https://hub.docker.com/repository/docker/imranq2/node-fhir-server-mongo
2. Once step 1 finishes, you can pull this docker image to wherever you're running the fhir server.

Deploying inside b.well

b.well has automated deployment set up. After the docker image is built and pushed:

1. Run the GitHub Action for the appropriate environment: https://github.com/icanbwell/helm.helix-service/actions and input the version number to deploy

To set environment variables for desired environment update the environment-name-ue1.values.yaml in https://github.com/icanbwell/helm.helix-service/tree/main/.helm/

Checking version of deployed fhir server

Go to /version to see what version you're running.

Health check

Use /health as the url for health check in Kubernetes or other systems

Change Events

The FHIR server can optionally send change events to a Kafka queue: Change Events