← Back to Learn

Roadmap

8 phases from FHIR basics to EHDS compliance. Each phase builds on the previous. Phase 1 is in progress.

1

Phase 1FHIR Foundations

In Progress

Core FHIR concepts, REST API fundamentals, and basic resource operations. The starting point for everything that follows.

  • Deploy HAPI FHIR R4 server locally via Docker Compose
  • Understand FHIR Resources as the basic unit of all FHIR data
  • Perform full CRUD operations on Patient resource via REST API
  • Read and interpret a CapabilityStatement
  • Create and POST a transaction Bundle with multiple resources
  • Understand transaction vs batch Bundle semantics
Deliverable: Working HAPI FHIR server + Postman collection with all CRUD operations verified
Related Lab Modules: Mock Server·Resource Builder
2

Phase 2Core Healthcare Resources

Planned

The clinical resources that form the backbone of any healthcare record. Patients, observations, conditions, medications.

  • Model a complete patient record using FHIR resources
  • Create Observation resources with LOINC and SNOMED CT codes
  • Work with Condition (diagnosis) resources
  • Model Medication and MedicationRequest
  • Create Encounter and link clinical data to it
Deliverable: Synthetic patient with full clinical record — demographics, vitals, diagnoses, medications, encounter
Related Lab Modules: Resource Builder·Synthetic Data·Mock Server
3

Phase 3Profiling and Validation

Planned

FHIR base resources define the minimum. Profiles constrain them for specific use cases. Learn to create, publish, and validate against profiles.

  • Understand FHIR Profiling — StructureDefinition, constraints, extensions
  • Create a simple Patient profile with custom constraints
  • Validate resources against profiles using HAPI validator
  • Use ImplementationGuide structure
  • Understand Must Support semantics
Deliverable: Custom FHIR Profile for a Slovak Patient with validation
Related Lab Modules: Validator·Profile Explorer·Resource Builder
4

Phase 4Terminology Services

Planned

FHIR uses structured vocabularies — LOINC, SNOMED CT, ICD-10, ATC. Learn to work with CodeSystem, ValueSet, and ConceptMap.

  • Understand CodeSystem, ValueSet, and ConceptMap resources
  • Load LOINC codes into HAPI FHIR
  • Use ValueSet $expand and $validate-code operations
  • Work with SNOMED CT expressions
  • Map between code systems using ConceptMap
Deliverable: Terminology server with LOINC + ICD-10 + custom CodeSystem, validated ValueSets
Related Lab Modules: Terminology Explorer·Validator
5

Phase 5Healthcare Integration Patterns

Planned

Real-world FHIR is about integration. Learn the patterns used in production systems: subscriptions, messaging, bulk data, and SMART on FHIR.

  • Implement FHIR Subscriptions for real-time notifications
  • FHIR Messaging — message Bundles and MessageHeader
  • FHIR Bulk Data ($export operation)
  • SMART on FHIR — OAuth2 authorization for FHIR APIs
  • CDS Hooks — clinical decision support integration pattern
Deliverable: Working Subscription + Bulk Export + SMART on FHIR authorization flow
Related Lab Modules: Mock Server
6

Phase 6EHDS and EHRxF

Planned

The European Health Data Space mandates FHIR-based data exchange. EHRxF is the FHIR implementation guide for EHDS. Build for EU compliance.

  • Understand EHDS regulation and its FHIR requirements
  • Study the EHRxF FHIR Implementation Guide
  • Implement Patient Summary (IPS — International Patient Summary)
  • Cross-border data exchange simulation
  • Map Slovak healthcare data to EHDS profiles
Deliverable: Synthetic IPS (International Patient Summary) conformant with EHRxF profiles
Related Lab Modules: Synthetic Data·Profile Explorer·Validator
7

Phase 7Interoperability Architecture

Planned

Design and implement a multi-system FHIR architecture. Integration engines, FHIR facades for legacy systems, and HIE patterns.

  • FHIR Facade pattern — wrapping non-FHIR systems
  • Integration engine patterns with FHIR
  • FHIR Repository vs. FHIR Facade design decisions
  • Multi-server FHIR architecture
  • Performance and scalability considerations
Deliverable: Architecture diagram + working FHIR Facade over a simulated legacy HL7 v2 system
Related Lab Modules: Mock Server
8

Phase 8Advanced Experiments

Planned

Advanced topics: clinical reasoning, care planning, clinical trials, genomics. Pushing FHIR to its limits.

  • Clinical Reasoning — PlanDefinition, ActivityDefinition, Measure
  • CarePlan and CareTeam resources
  • FHIR for clinical trial data (ResearchStudy, ResearchSubject)
  • Genomics in FHIR — MolecularSequence
  • CQL (Clinical Quality Language) basics
Deliverable: Working clinical quality measure (CQL + FHIR Measure) with synthetic population data
Related Lab Modules: Synthetic Data