🌐 Universal Health Data Gateway (UHDG)

"To make critical health data portable, secure, and available anywhere."

---

🚀 LIVE INTERACTIVE SIMULATOR

🌐 Try AirCappy Demo: Emergency Health Data Routing Simulator (Simulates real-time encrypted routing, jurisdictional compliance blocks, and potential integrations with open platforms like OpenHospital or travel onboarding software).

---

🇮🇹 Leggi la documentazione in Italiano

---

💡 The Vision

In a highly interconnected global ecosystem, ensuring the continuity of life-saving health data remains a complex challenge—especially during international travel, cross-border emergencies, aeromedical retrievals, or missions in geographically isolated areas.

While existing public infrastructures (such as National EHR portals and cross-border interoperability networks) play a fundamental role, they often face technical or regulatory constraints when integrating real-time data from heterogeneous nodes: independent clinics, private diagnostic centers, third-country facilities, or temporary emergency stations.

UHDG is an open-source, neutral middleware designed to complement and enhance these systems, acting as a dynamic compliance orchestrator and personal consent manager. It enables the secure, encrypted flow of essential clinical data between diverse sources and global destinations, providing immediate technological and legal coverage wherever the citizen is located.

---

🌍 UPDATE: The compliance routing matrix now covers the entire globe, seamlessly integrating frameworks from the EU (GDPR/EHDS), Americas (HIPAA/PIPEDA), Africa (POPIA/Malabo), Asia (PDPA/APEC), and Oceania!

---

🗺️ Architectural Scenario: "Emergency & Cross-Border Anywhere"

                               ┌────────────────────────────────────────┐
                               │       CITIZEN / PATIENT (SOVEREIGN)    │
                               │  Zero-Knowledge Encryption (AES-256)   │
                               └───────────────────┬────────────────────┘
                                                   │
                                                   ▼
┌────────────────────────────────────────────────────────────────────────────────────────────────┐
│                                 UHDG COMPLIANCE & ROUTING ENGINE                               │
│  - Geo-Context Detection (GPS/Satellite)          - Dynamic Rule Checker (GDPR / HIPAA / EHDS) │
│  - Trust Handshake (CSA STAR / OID / eIDAS)       - Immutable Zero-Logging & Auditing          │
└───────┬──────────────────────────────────────────┬─────────────────────────────────────┬───────┘
        │                                          │                                     │
        ▼                                          ▼                                     ▼
┌───────────────────────┐              ┌─────────────────────────┐           ┌───────────────────────┐
│     DATA SOURCES      │              │     STORAGE VAULT       │           │     DESTINATIONS      │
├───────────────────────┤              ├─────────────────────────┤           ├───────────────────────┤
│ • Hospitals / FHIR    │              │ • Global/Regional/Nation│           │ • Volunteer Doctor /  │
│ • OpenMRS (NGOs)      │ ───────────► │   Clouds (Big5/Gaia-X/..│ ────────► │   On-board Air Crew   │
│ • Fitness Apps / IoT  │              │ • On-Prem/Regional/Local│           │ • Multi-Cloud Health /│
│ • PDF/OCR Import      │              │   (Hospital/USB Key/... │           │   EU Health Space /.. │
└───────────────────────┘              └─────────────────────────┘           │ • Status Update for   │
                                                                             │   Family / Next of Kin│
                                                                             └───────────────────────┘

💻 Included Simulator (CLI)

This repository includes a Python prototype (demo_sim.py) demonstrating the core pipeline: Raw lab result ingestion. Normalization to HL7 FHIR R4 (Observation). Symmetric AES-256 (Fernet) encryption using client-managed keys. Payload decryption verification for authorized endpoints.

🚀 Quickstart

Bash

Clone the repo

git clone https://github.com/beriox/Universal-Health-Data-Gateway.git cd Universal-Health-Data-Gateway

Install dependencies

pip install -r requirements.txt

Run simulation

python demo_sim.py

You can see the generated output here: 🔗 View demo_output.txt

🤝 Call for Maintainers & Contributors

Note from the Author: This repository serves as a conceptual framework and architectural blueprint. I am looking for developers, digital health experts, NGOs, and emergency response teams to take over active maintenance, build source adapters, expand compliance rules, and apply Green IT best practices.

📊 Data Sources & Global Health Node Registry

The simulator and routing matrix leverage real-world, open-access geographical and clinical datasets. To keep emergency routing fast and lightweight, the registry is structured into prioritized datasets:

1. Primary Emergency Nodes (High Priority)

Used for immediate emergency routing and critical payload delivery.

• OpenStreetMap Overpass Query (Global Hospitals):
  🔗 Query/Export Hospitals via Overpass Turbo
  (Filters global entities tagged with amenity=hospital or healthcare=hospital).

2. Specialized & Secondary Clinical Nodes (Modular Datasets)

For specialized diagnostics, blood testing, and ambulatory services (e.g., blood banks, private laboratories, specialist clinics).

• OpenStreetMap Healthcare Taxonomy:
  🔗 OSM Healthcare Tagging Guidelines
  (Allows filtering sub-categories like healthcare=laboratory, healthcare=blood_donation, or amenity=clinic).

• Public FHIR Endpoints & Directories:
  🔗 HL7 FHIR Official Registry Directory
  (Publicly indexed FHIR R4 server endpoints for direct API handshake).

---

💡 Want to contribute or register a new node?

Healthcare providers, developers, and NGOs can register their facility simply by adding or updating their location directly on OpenStreetMap (using amenity=hospital or healthcare=* tags), making it instantly available to the open network.

---

🦫 CAPPY

CAPPY

This repository includes CAPPY (Capybara Adaptive Payload Processing for You), the reusable routing and payload-processing foundation behind more focused scenarios. The current UHDG index.html acts as the illustrative AirCappy prototype for emergency, geographic, and compliance-aware routing, while the CAPPY simulator demonstrates the canonical FHIR and adapter layer. The simulator is conceptual and local: its API exchanges are illustrative and do not send live network requests.