Skip to content

Murali-SpringAI/NHCX-Interoperability-Platform

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

10 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NHCX Interoperability Platform

AI-ready healthcare interoperability middleware that converts heterogeneous healthcare data (HL7, CSV, legacy systems) into standardized FHIR bundles across multiple workflows — Eligibility and Claims — without rewriting core logic.


📖 Read: Why healthcare interoperability is hard → docs/WHY_INTEROPERABILITY.md

🚀 30-Second Pitch

Healthcare interoperability fails not because standards don’t exist, but because real hospital systems cannot easily speak those standards.

  • Hospitals → HL7 v2 messages
  • Insurers → CSV / flat files
  • National Exchanges (NHCX/ABDM) → FHIR APIs

Every new connection becomes a custom integration project.

We built a reusable adapter layer instead of another point-to-point integration.

The platform:

  • Accepts legacy healthcare data
  • Normalizes it into a canonical healthcare model
  • Enriches semantics using an AI layer
  • Produces standards-compliant FHIR bundles

Instead of every hospital implementing FHIR, the platform bridges existing systems into the national health ecosystem.

🎥 Demo Video

🧠 Why This Is Different (Not Just a Converter)

Most projects:

HL7 → FHIR mapping

Our approach:

Source-agnostic ingestion → Canonical healthcare model → AI semantic enrichment → Multi-workflow FHIR transformation

Meaning:

  • Add a new source → plug an adapter
  • Add a new workflow → plug a builder
  • No core rewrite

Supported Workflows

🟢 Coverage Eligibility — Implemented HL7 ingestion → Canonical normalization → AI enrichment → FHIR Patient & Coverage bundle

🟢 Claims Processing — Implemented CSV ingestion → Canonical claim model → AI anomaly detection → FHIR Claim resource

🟡 Prior Authorization — Architecture Ready Requires only a new DTO and FHIR builder

🟡 Clinical Exchange — Architecture Ready Can generate Encounter, Observation, Condition resources


Supported Inputs

  • HL7 v2 ADT Messages
  • CSV / Flat Files
  • (Architected for APIs, Kafka streams, and DB exports)

Standards Produced

  • FHIR R4 Bundles
  • SNOMED Clinical Coding
  • Patient, Coverage, Claim, and Condition Resources

🏗️ Architecture Overview

Pipeline:

Source → Adapter → Canonical Model → AI Layer → FHIR Builder → FHIR Bundle
graph TD
Sources[Source Systems: HL7 / CSV / APIs] --> Ingestion[Ingestion Layer: Strategy Adapters]
Ingestion --> Canonical[Canonical Domain Model: EligibilityDTO / ClaimDTO]
Canonical --> AI[AI Intelligence Layer: Semantic Normalization & Risk Detection]
AI --> Builders[FHIR Use Case Builders: Eligibility / Claim]
Builders --> Output[FHIR Bundle Output: Patient, Coverage, Claim, Condition]

    style AI fill:#f96,stroke:#333,stroke-width:2px
    style Canonical fill:#bbf,stroke:#333,stroke-width:2px
Loading

Layer Responsibilities

Ingestion Layer

  • Strategy Pattern
  • Parses HL7/CSV without business assumptions

Canonical Layer

  • Normalizes healthcare meaning
  • Decouples format from semantics

AI Intelligence Layer

  • Cleans messy real-world data
  • Normalizes demographics
  • Flags abnormal claims

FHIR Builder Layer

  • Converts canonical meaning into FHIR resources
  • Workflow-specific (Eligibility vs Claim)

graph TD
Controller[TransformController API] --> AdapterFactory[Adapter Factory]
Controller --> AIService[AI Intelligence Service]
Controller --> UseCaseFactory[UseCase Factory]

    AdapterFactory --> HL7[HL7 Adapter]
    AdapterFactory --> CSV_E[Csv Eligibility Adapter]
    AdapterFactory --> CSV_C[Claim Csv Adapter]

    HL7 & CSV_E & CSV_C --> Model[Canonical Models]

    Model --> AIService
    AIService --> Builders[FHIR Builders]

    UseCaseFactory --> EBuilder[Eligibility Builder]
    UseCaseFactory --> CBuilder[Claim Builder]

    EBuilder & CBuilder --> Output[FHIR Bundle Output]
Loading

🤖 Where AI Fits

AI operates after normalization but before FHIR generation.

It does NOT:

  • parse HL7
  • generate FHIR

It DOES:

  • normalize demographics
  • interpret free-text diagnoses
  • detect suspicious claims

AI enhances healthcare meaning, not replace standards.


🧩 Extensibility

Add a new source:

Create a new IngestionAdapter

Add a new workflow:

Create a new FhirUseCaseBuilder

Add real AI:

Replace MockAiIntelligenceService with NLP/LLM/Terminology service

No core logic changes required.


⚙️ Running the Project

Prerequisites

  • Java 17+
  • Maven

Start Application

mvn spring-boot:run

Open:

http://localhost:8080

🧪 Demo Scenarios

1) Eligibility (HL7)

Paste an HL7 ADT message.

Output:

  • FHIR Patient
  • FHIR Coverage
  • FHIR Condition (SNOMED coded)

2) Claims (CSV)

Input:

CLM9999,12345,PROV001,HMO123,2024-03-01,E11.9,99213,25000.00

Output:

  • FHIR Claim resource
  • AI anomaly detection

📈 Scalability Vision

Current:

Modular monolith for fast iteration

Future:

  • Ingestion Service
  • Terminology Service
  • Eligibility Service
  • Claims Service

Then:

Event-driven architecture using messaging

Stateless design enables:

  • Horizontal scaling
  • Kubernetes autoscaling
  • Load balancing

timeline
title NHCX Platform Roadmap
Phase 1 : Modular Monolith : Strategy & Factory Patterns : Fast Iteration
Phase 2 : Domain-Based Services : Ingestion Service : Terminology Service : Workflow Services
Phase 3 : Event-Driven Architecture : Kafka Streams : Async Transformation : Kubernetes Scaling
Loading

🎯 Why This Matters for NHCX / ABDM

A national health exchange cannot depend on:

  • One vendor
  • One message format
  • One workflow

This platform acts as a universal adapter layer between legacy hospital systems and modern FHIR ecosystems, reducing onboarding effort for providers and insurers.


Key Takeaway

We did not build a point solution.

We built a foundation interoperability layer that allows heterogeneous healthcare systems to participate in standardized digital health ecosystems — the missing middle layer in interoperability.

About

A pluggable, AI-ready engine bridging legacy healthcare (HL7/CSV) to FHIR R4. Uses Strategy & Factory patterns for zero-rewrite extensibility. Features a Canonical Model and AI layer for semantic enrichment and risk detection. Scalable, stateless, and NHCX-ready.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors