Enhanced Version - This project extends the original openFHIR Converge & Collaborate Dublin 2026 tutorial with a user-friendly web interface featuring animated architecture visualizations.
A complete FHIR facade implementation on top of openEHR CDR, demonstrating International Patient Summary (IPS) interoperability. Features include:
- ✅ FHIR-to-openEHR bidirectional translation using FHIRConnect mappings
- ✅ Interactive Web UI built with Astro and React
- ✅ Animated architecture diagrams showing real-time data flow
- ✅ Patient management with search and bundle upload
- ✅ IPS summary viewer with structured sections
- ✅ Non-technical user friendly interface
- Get a Firely Server trial license
- Place
firely-license.jsonin theconfig/folder - Run
docker compose up -d - Access the UI at http://localhost:3000
- Access FHIR API at http://localhost:4080
The web interface provides:
- Dashboard: System overview with animated architecture
- Patient Management: Create, search, and view patients
- Bundle Upload: Submit IPS Bundles with preview and validation
- Summary Viewer: Display patient IPS with sections for allergies, conditions, medications, and devices
- Visual Flow Diagrams: Real-time animated visualizations of FHIR query, store, and summary operations
The openFHIR engine (v2.2.3) includes mappings for MedicationAdministration resources but not for MedicationStatement resources used in IPS Bundles.
Workaround Implemented: The UI automatically transforms MedicationStatement resources to MedicationAdministration during bundle submission. This transformation:
- Maps status values between the two resource types
- Preserves medication details, dosage, and clinical context
- Maintains reference integrity within the bundle
Supported Clinical Sections:
- Allergies and Intolerances (EVALUATION archetype)
- Problem List / Conditions (EVALUATION archetype)
- Medical Devices (EVALUATION archetype)
- Medications (ACTION archetype with transformation)
Note: This is a temporary workaround. A GitHub issue has been filed with the openFHIR project to request native MedicationStatement support for IPS use cases.
This session walks through building a working FHIR facade on top of an openEHR CDR, using the International Patient Summary (IPS) as the target use case.
The facade sits between FHIR clients and an openEHR CDR, translating FHIR requests into AQL queries and openEHR compositions into FHIR resources on the fly, using FHIRConnect mappings as the translation layer.
| Flow | Diagram |
|---|---|
Querying FHIR resources (e.g. GET /AllergyIntolerance) |
 |
Storing FHIR resources (e.g. POST IPS Bundle) |
 |
Fetching the IPS summary document ($summary) |
 |
Each step builds on the previous one, incrementally adding services to a single docker-compose.yml that is fully
runnable at the end of each step. Follow the README in each subfolder.
| Step | What you build | Folder |
|---|---|---|
| 1 | Firely Server + MongoDB running locally | tutorial/step1 |
| 2 | openFHIR Firely Plugin installed into Firely Server | tutorial/step2 |
| 3 | openFHIR running locally | tutorial/step3 |
| 4 | All services wired together — Firely → openFHIR → openEHR CDR | tutorial/step4 |
| 5 | Existing IPS FHIRConnect mappings bootstrapped into openFHIR | tutorial/step5 |
| 6 | Create a patient, ingest an IPS Bundle, test existing mappings end-to-end | tutorial/step6 |
| 7 | New FHIRConnect mappings for the IPS Medical Devices section | tutorial/step7 |
fhirconnect/ips/ — FHIRConnect mapping files for the IPS (problems, allergies, medications stub)
tutorial/step*/ — Step-by-step instructions, docker-compose.yml, and config files for each step
- Docker and Docker Compose
- A Firely Server trial license — request one at https://fire.ly/firely-server-trial/
- A REST client (Postman, Bruno, or curl)
- openFHIR Firely Plugin
- openFHIR Enterprise documentation
- FHIRConnect specification
- IPS Implementation Guide
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
This is a derivative work based on the openFHIR Converge & Collaborate Dublin Hackathon 2026 tutorial project, originally created by the openFHIR team.
Original Repository: https://github.com/openFHIR/converge-and-collaborate-dublin-hackaton
This repository adds the following enhancements to the original project:
- Web User Interface: Complete Astro-based UI with React components
- Animated Architecture Diagrams: SVG visualizations showing FHIR-to-openEHR data flows
- Patient Management UI: Create, search, and view patients through a web interface
- Bundle Upload Interface: Drag-and-drop IPS Bundle submission with preview
- IPS Summary Viewer: Structured display of patient summaries with collapsible sections
- Security Enhancements: Rate limiting, input validation, and secure file handling
- Docker Integration: Seamless deployment of the entire stack including UI
Original Work Copyright 2026 openFHIR Contributors
Enhancements Copyright 2026 Duncan Falconer
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.
- openFHIR Team for the original integration tutorial and FHIRConnect mappings
- Firely for the FHIR Server and plugin architecture
- HL7 International for the IPS specification
- openEHR Foundation for the openEHR specifications and EHRBase CDR
- Converge & Collaborate Dublin 2026 conference for inspiring this work