A testing suite for validating FHIR servers against the Smart Health Checks Implementation Guide. This project is built on the Inferno testing framework and provides automated tests to ensure compliance with the Smart Health Checks IG.

Smart Health Checks Inferno is designed to validate FHIR servers that implement the Smart Health Checks Implementation Guide. It tests various FHIR resources including:

• Patient
• Practitioner
• Encounter
• Observations (e.g., Blood Pressure, Body Height, Body Weight, Heart Rate, Heart Rhythm, Head Circumference, Waist Circumference, Pathology Result, Smoking Status)
• Questionnaire Responses
• Conditions
• Immunizations
• Medication Statements
• Allergy Intolerances

The test suite validates resource conformance, search capabilities, and reference resolution according to the implementation guide specifications.

1. Install Docker and Docker Compose.
2. From the project root, run:

   make setup
   make run

3. Open http://localhost/ in your browser.

• Docker
• Docker Compose v2

1. Clone the repository:

   git clone https://github.com/aehrc/smart-health-checks-inferno.git
   cd smart-health-checks-inferno

2. Set up the project:

   make setup

   This command will:

   • Pull the necessary Docker images
   • Build the project
   • Run database migrations

Start the application:

make run

This will build and start all the necessary services. Once running, you can access the application at http://localhost.

To stop services:

make stop

To remove containers:

make down

To generate or regenerate test files from the implementation guide (for local development):

make generate_local

Note: The Docker-based target make generate is intended for maintainers and may rely on internal tooling. For most contributors, use make generate_local.

To run the test suite:

make tests

To check code style:

make rubocop

To automatically fix code style issues:

make rubocop-fix

To stop, rebuild, and restart the application with freshly generated files for local development, run:

make stop
make down
make generate_local
make setup
make run

Note: The convenience target make full_develop_restart uses the Docker-based generator and may rely on maintainer-only tooling. If it fails, use the sequence above.

The project configuration is stored in config.json. Key configuration options include:

• Implementation Guide (IG) details
• Terminology server URL
• Profile configurations
• Resource configurations

At runtime, the terminology server URL is also configurable via the TX_SERVER_URL environment variable in compose.yaml (defaults to https://tx.dev.hl7.org.au/fhir). You can override it by creating a Docker Compose override file or by editing compose.yaml.

• lib/smart_health_checks_test_kit/: Main test kit code
  • generated/: Generated test files based on the implementation guide
  • igs/: Implementation Guide packages and related files used by the validator

The project uses several Docker services:

• inferno: The main application
• inferno-worker: Background worker using Sidekiq
• validator-api: Dockerized official validator wrapper
• nginx: Web server that proxies requests
• redis: Used for caching and background job queuing
• postgres: Database for storing test results

This project is licensed under the Apache License, Version 2.0 - see the LICENSE file for details.

• Smart Health Checks Implementation Guide
• Report Issues