awslabs/fhir-works-on-aws-routing

The routing implementation of the FHIR Works on AWS framework. Finding the correct component to handle the HTTP FHIR request

fhir-works-on-aws-routing

This GitHub repository has been migrated. You can now find FHIR Works on AWS at https://github.com/aws-solutions/fhir-works-on-aws.

Purpose

Please visit fhir-works-on-aws-deployment for overall vision of the project and for more context.

This package is an implementation of the routing of the FHIR Works interface. It is responsible for taking a FHIR based HTTP request and routing it to the correct sub-component. It also does all the resource validatation by way of JSON schemas. Finally, This component is responsible for generating the Capability Statement, which is used to describe what a FHRI API can do. To use and deploy this component (with the other 'out of the box' components) please follow the overall README

Infrastructure

This package assumes certain infrastructure:

• API Gateway - We expect all the routing to invoke the FHIR Works Lambda
  • Best Practices
• Lambda - We expect the input to be entering our function in a certain way

Usage

For usage please add this package to your package.json file and install as a dependency. For usage examples please see the deployment component's package.json

Dependency tree

This package is dependent on a type of each subcomponent:

• interface component
  • This package defines the interface we are trying to use
• An authorization component that is responsible for saying if the request is allowed or not
  • Example: fhir-works-on-aws-authz-rbac
• A persistence component that is responsible for handing CRUD based requests
  • Example: fhir-works-on-aws-persistence-ddb
• A bundle based component that is responsible for handling batches & transactions
  • Example: fhir-works-on-aws-persistence-ddb
• A search component that is responsible for handling the search based requests
  • Example: fhir-works-on-aws-search-es
• A history component that is responsible for handling the historical search requests
  • No example
• Finally a deployment component to deploy this to AWS
  • Example: fhir-works-on-aws-deployment

NOTE: if your use-case does not require one of the above features/components, please set the your configuration as such and the router will route accordingly

Known issues

For known issues please track the issues on the GitHub repository

Security

See CONTRIBUTING for more information.

License

This project is licensed under the Apache-2.0 License.