North West Genomic Medicine Service Alliance
0.0.7 - ci-build United Kingdom flag

North West Genomic Medicine Service Alliance, published by NHS North West GMSA. This guide is not an authorized publication; it is the continuous build for version 0.0.7 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/nw-gmsa/R4/ and changes regularly. See the Directory of published versions

Architecture

Introduction

The architecture generally follows Domain Driven Design [DDD], Domain Driven Design and Data Mesh

Data Mesh

Data Mesh


Enterprise Integration

The Intermediary, North West GMSA Regional Integration Engine (RIE) is an Enterprise Service Bus most commonly known in the NHS as a Trust Integration Engine (TIE).

This implement as series of Enterprise Integration Patterns based around messaging, the diagrams below follow conventions used for these patterns.

The ESB has a Canonical Data Model which is expressed in this Implementation Guide using HL7 FHIR. This model is common to all the exchange formats used in the ESB:

This canonical model is a mandatory extension to HL7 UK Core and includes requirements from

This canonical model is not specific to Genomics. It is focused on standard message construction patterns in particular CorrelationIdentifier such as Order Numbers and Episode/Stay Identifiers and use of Clinical Coding Systems such as UK SNOMED CT.

Genomic Specific modelling, which this model supports, can be found on NHS England FHIR Genomics Implementation Guide

To support genomics workflow, this guide is aligned to enterprise workflow processes described in IHE Laboratory Testing Workflow, terminology from this guide especially around Actors is used throughout this Implementation Guide.

Three types of messages are used within this workflow process:

Message Type HL7 Name IHE Name Description
Command Message Laboratory Order O21 LAB-1 To request a laboratory order
Document Message Laboratory Report R01 LAB-3 Used to transfer the report back to the order placer and othre interested parties
  Original Document T02 HL7 MDM_T02 Used to send a copy of the report to a HIE

Laboratory Order

Messaging with a copy sent to a FHIR Repository

Phase 1b

Messaging + FHIR Repository


  • Update Genomic Data Repository (Wire Tap)
  • Router (Message Router)
    • Routes messages based on order metadata.
  • Transform to HL7 v2 Message (Message Translator and v2 Canoncial Model)
    • Converts HL7 FHIR O21 messages into HL7 v2.5.1 OML_O21 format.
    • These transformed messages are sent to NW GMSA LIMS iGene.
  • Genomic Order Management Adaptor Service FHIR API (Messaging Gateway)
    • Targets NHS England Genomic Order Management Service FHIR API which is the interface to external GMSA.
    • This uses a FHIR RESTful API, similar to the Clinical Data Repository Adaptor, and like this service, the business logic (how to update the repository) is held within Regional Integrations Engine and this is not exposed externally.

Laboratory Report

Phase 2b

Phase 2 Detailed


  • Source System
    • NW GMSA LIMS (iGene) (Document Message)
      • Produces genomic test results in HL7 v2.3 ORU_R01 messages.
      • These are sent into the Enterprise Service Bus (ESB).
  • Transformation and Enrichment (inside ESB)
    • Transform to HL7 FHIR Message (Message Translator and FHIR Canoncial Model)
      • Converts HL7 v2.3 message into a modern HL7 FHIR R01 message.
    • Update Genomic Data Repository & Enrich Content (Content Enricher)
      • Stores and enhances the message with additional data elements.
      • Provides a consistent, enriched dataset for downstream use.
  • Routing
    • Router
      • Determines where the message should be delivered (e.g., hospital systems, care records, repositories).
      • Reports are sent to the NHS Trust which ordered the test (Message Router)
      • Reports are sent to NHS ICS Health Information Exchange (HIE) for sharing the reports within the ICS, this is based on the GP Surgery for the patient which is obtained via a PDS lookup. (Dynamic Router)
    • Transform to HL7 v2 Message (Message Translator and v2 Canoncial Model)
      • Converts enriched content back into a structured HL7 v2.x format for downstream systems that still rely on v2.
      • This ensures backward compatibility with existing hospital systems.
  • Output
    • Reports are sent as:
      • HL7 v2.5.1 ORU_R01 or MDM_T02 messages (for systems using HL7 v2).
      • HL7 over HTTP with OAuth2 (for secure API-based delivery).
  • Repository Service
    • A dedicated Repository Service captures and stores all enriched FHIR data. (Messaging Gateway)
      • FHIR Repository Adapter converts incoming HL7 FHIR messages into a format suitable for storage.
      • Data is stored in the Clinic Data Repository (IRIS FHIR Repository).
      • Access is available via HL7 FHIR RESTful API.

Security

http Authorisation

As we are using http RESTful for communication between the Trust Integration Engines, this security and authorisation can be solved in a number of ways such as:

  • TLA-MA
  • openid

These are practical for point-to-point connections, but as the solution grows it can become complicated, so it is preferred we move to enterprise level security such as OAuth2 Client Credentials Grant.

See Authorisation for more details.

Message Validation and Asynchronous Replies

Phase 1b

Laboratory Order Messaging


  • Accept Message The Order Placer (NHS trust) sends a FHIR Message (NW GMSA) Genomic Test Order O21 to the RIE via the $process-message endpoint
    • If the RIE doesn’t understand the message for technical reasons, it will respond immediately with an error message.
    • Validation The RIE performs FHIR Validation on the order against the requirements listed in this Implementation Guide. The validation contains no errors, it is accepted; any errors will cause the message to be rejected. The RIE responds to the order placer asynchronously via a message queue, this is accessed by the order placer via a Polling Consumer
  • Distribution List If the message is accepted, it is passed to a router, at present this router passes the message onto the next process. This router is for future use with the national broker.
  • Transform to HL7 v2 The RIE will convert the FHIR Message to a HL7 v 2.4 ORM O01 and send this to iGene.