TECHNICAL OVERVIEW

The Architecture of Interoperability

A transparent look at how PPUSSH Health moves an authorized clinical summary between two facilities — illustrated with our early emergency-exchange flow.

Patient journey across connected facilities
Illustrative exchange flow
01 / INITIALIZATION

Connect (The Adapter)

Each facility connects through an adapter that speaks its local format — no rip-and-replace. Below is an illustrative example, not live telemetry.

ADAPTER_STATUSCONNECTED
ProtocolCanonical JSON (FHIR-shaped)
Auth SchemeSession + scoped authorization
StatusIllustrative
02 / ROUTING

Discover (Network Registry)

Search connected facilities for a patient match — name plus date of birth — before any record is requested.

QUERY_RESULT2 NODES FOUND
Node A: EkitiCare

ID: eki_0184_x

Node B: LagosMed

ID: lag_8821_y

03 / SECURITY

Authorize (Consent & Policy)

Recorded patient consent (or documented emergency break-glass reason) and organizational data-sharing policies checked before transmission.

POLICY_ENGINEVERIFIED

Patient Consent Recorded

Method + consenter stored with request

Organization Policy Check

Source authorization + audit trail

04 / EXECUTION

Exchange (Secure Payload Transport)

The requested payload is structured, encrypted, and delivered horizontally to the requesting application.

PAYLOAD_STREAMIN_PROGRESS
{
  "patient": { "name": "Ibrahim Yusuf" },
  "allergies": [{ "substance": "Penicillin" }],
  "medications": [{ "name": "Amlodipine" }],
  "source": { "organizationName": "Teaching Hospital Ekiti" },
  "metadata": { "scope": "emergency-summary" }
}