# fiston/openemrconnect architecture

> Architecture diagram of the GitHub repository fiston/openemrconnect, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/fiston/openemrconnect
- Repository: https://github.com/fiston/openemrconnect

## Overview

This repository is a Java-based OpenEMRConnect ecosystem: clinic-facing reception software and service adapters exchange person and visit information through a shared messaging runtime, with MPI matching as a core identity workflow. The tree also includes HDSS/CPAD integrations and a database synchronization tool. The README is empty, so the graph reflects the source index and shown excerpts; several subsystem connections are left unverified rather than inferred from names alone.

Main entry points: [`oeclib/src/ke/go/moh/oec/lib/Mediator.java`](https://github.com/fiston/openemrconnect/blob/master/oeclib/src/ke/go/moh/oec/lib/Mediator.java) (Message Mediator), [`reception/src/ke/go/moh/oec/reception/controller/OECReception.java`](https://github.com/fiston/openemrconnect/blob/master/reception/src/ke/go/moh/oec/reception/controller/OECReception.java) (Reception Controller), [`mpi/src/ke/go/moh/oec/mpi/SearchHistory.java`](https://github.com/fiston/openemrconnect/blob/master/mpi/src/ke/go/moh/oec/mpi/SearchHistory.java) (MPI Search), [`oeclib/src/ke/go/moh/oec/lib/HttpService.java`](https://github.com/fiston/openemrconnect/blob/master/oeclib/src/ke/go/moh/oec/lib/HttpService.java) (HTTP Transport)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Clinic Reception"]
  node_reception_ui["Reception UI"]
  node_reception_core["Reception Controller<br/>[OECReception.java]"]
  node_user_store[("User Persistence")]
  node_finger_reader["Fingerprint Reader<br/>[ReaderManager.java]"]
end

subgraph group_identity["Person Index"]
  node_mpi_service["MPI Service<br/>[Mpi.java]"]
  node_mpi_search["MPI Search<br/>[SearchHistory.java]"]
  node_mpi_matching["Identity Matching"]
  node_person_model["Person Data<br/>[Person.java]"]
end

subgraph group_messaging["Messaging Runtime"]
  node_mediator["Message Mediator<br/>[Mediator.java]"]
  node_http_transport["HTTP Transport<br/>[HttpService.java]"]
  node_message_queue["Message Queue<br/>[QueueManager.java]"]
  node_message_format["Message Format<br/>[Message.java]"]
  node_xml_packing["XML Packing<br/>[XmlPacker.java]"]
end

subgraph group_integrations["Service Integrations"]
  node_cds_service["CDS Service<br/>[Cds.java]"]
  node_esb_service["ESB Service<br/>[Esb.java]"]
  node_hdss_adapter["HDSS Adapter"]
  node_cpad_adapter["CPAD Extract"]
  node_patient_interface["Patient Interface"]
  node_logging_service["Logging Service<br/>[LoggingServer.java]"]
end

subgraph group_sync["Database Sync"]
  node_sync_daemon["Sync Daemon<br/>[DaemonManager.java]"]
  node_sync_engine["Data And Schema Sync"]
  node_database_bridge["Database Bridge"]
  node_schema_model["Schema Model<br/>[Table.java]"]
end

node_clinic_staff(("Clinic Staff"))
node_external_endpoint(("Configured Endpoint"))

node_clinic_staff -->|"uses"| node_reception_ui
node_reception_ui -->|"starts"| node_reception_core
node_reception_core -.->|"persists users"| node_user_store
node_reception_core -->|"uses"| node_mediator
node_finger_reader -.->|"captures fingerprint"| node_person_model
node_mpi_service -.->|"dispatches search"| node_mpi_search
node_mpi_search -.->|"evaluates candidates"| node_mpi_matching
node_mpi_search -->|"uses person data"| node_person_model
node_mpi_service -->|"registers service"| node_mediator
node_mediator -->|"creates messages"| node_message_format
node_mediator -->|"routes messages"| node_http_transport
node_mediator -->|"manages delivery"| node_message_queue
node_mediator -->|"packs messages"| node_xml_packing
node_http_transport -->|"delivers received"| node_mediator
node_message_queue -->|"sends queued"| node_http_transport
node_cds_service -->|"uses runtime"| node_mediator
node_esb_service -->|"uses runtime"| node_mediator
node_hdss_adapter -->|"maps person data"| node_person_model
node_patient_interface -->|"posts XML"| node_external_endpoint
node_sync_daemon -.->|"starts sync"| node_sync_engine
node_sync_engine -.->|"uses connections"| node_database_bridge
node_database_bridge -->|"customizes queries"| node_schema_model

click node_reception_ui "https://github.com/fiston/openemrconnect/tree/master/reception/src/ke/go/moh/oec/reception/gui"
click node_reception_core "https://github.com/fiston/openemrconnect/blob/master/reception/src/ke/go/moh/oec/reception/controller/OECReception.java"
click node_user_store "https://github.com/fiston/openemrconnect/blob/master/reception/src/ke/go/moh/oec/reception/controller/PersistenceManager.java"
click node_finger_reader "https://github.com/fiston/openemrconnect/blob/master/reception/src/ke/go/moh/oec/reception/reader/ReaderManager.java"
click node_mpi_service "https://github.com/fiston/openemrconnect/blob/master/mpi/src/ke/go/moh/oec/mpi/Mpi.java"
click node_mpi_search "https://github.com/fiston/openemrconnect/blob/master/mpi/src/ke/go/moh/oec/mpi/SearchHistory.java"
click node_mpi_matching "https://github.com/fiston/openemrconnect/blob/master/mpi/src/ke/go/moh/oec/mpi/match/FingerprintMatch.java"
click node_person_model "https://github.com/fiston/openemrconnect/blob/master/oeclib/src/ke/go/moh/oec/Person.java"
click node_mediator "https://github.com/fiston/openemrconnect/blob/master/oeclib/src/ke/go/moh/oec/lib/Mediator.java"
click node_http_transport "https://github.com/fiston/openemrconnect/blob/master/oeclib/src/ke/go/moh/oec/lib/HttpService.java"
click node_message_queue "https://github.com/fiston/openemrconnect/blob/master/oeclib/src/ke/go/moh/oec/lib/QueueManager.java"
click node_message_format "https://github.com/fiston/openemrconnect/blob/master/oeclib/src/ke/go/moh/oec/lib/Message.java"
click node_xml_packing "https://github.com/fiston/openemrconnect/blob/master/oeclib/src/ke/go/moh/oec/lib/XmlPacker.java"
click node_cds_service "https://github.com/fiston/openemrconnect/blob/master/cds/src/ke/go/moh/oec/cds/Cds.java"
click node_esb_service "https://github.com/fiston/openemrconnect/blob/master/esb/src/ke/go/moh/oec/esb/Esb.java"
click node_hdss_adapter "https://github.com/fiston/openemrconnect/blob/master/kisumuhdss/src/ke/go/moh/oec/kisumuhdss/HdssDataParser.java"
click node_cpad_adapter "https://github.com/fiston/openemrconnect/blob/master/cpad_companion/src/ke/go/moh/oec/cpad/CpadDataExtract.java"
click node_patient_interface "https://github.com/fiston/openemrconnect/blob/master/oec2Interface/src/main/java/ke/go/moh/oec/pisinterfaces/controller/CdaInterfaceController.java"
click node_logging_service "https://github.com/fiston/openemrconnect/blob/master/loggingserver/src/ke/go/moh/oec/loggingserver/LoggingServer.java"
click node_sync_daemon "https://github.com/fiston/openemrconnect/blob/master/oecsm/src/ke/go/moh/oec/oecsm/daemon/DaemonManager.java"
click node_sync_engine "https://github.com/fiston/openemrconnect/blob/master/oecsm/src/ke/go/moh/oec/oecsm/sync/data/DataSynchronizer.java"
click node_database_bridge "https://github.com/fiston/openemrconnect/blob/master/oecsm/src/ke/go/moh/oec/oecsm/bridge/DatabaseConnector.java"
click node_schema_model "https://github.com/fiston/openemrconnect/blob/master/oecsm/src/ke/go/moh/oec/oecsm/data/Table.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_reception_ui,node_reception_core,node_user_store,node_finger_reader toneBlue
class node_mpi_service,node_mpi_search,node_mpi_matching,node_person_model toneAmber
class node_mediator,node_http_transport,node_message_queue,node_message_format,node_xml_packing toneMint
class node_cds_service,node_esb_service,node_hdss_adapter,node_cpad_adapter,node_patient_interface,node_logging_service toneRose
class node_sync_daemon,node_sync_engine,node_database_bridge,node_schema_model,node_clinic_staff,node_external_endpoint toneIndigo
```

## Components

### Clinic Reception

- [Reception UI](https://github.com/fiston/openemrconnect/tree/master/reception/src/ke/go/moh/oec/reception/gui): `reception/src/ke/go/moh/oec/reception/gui`
- [Reception Controller](https://github.com/fiston/openemrconnect/blob/master/reception/src/ke/go/moh/oec/reception/controller/OECReception.java): `reception/src/ke/go/moh/oec/reception/controller/OECReception.java`
- [User Persistence](https://github.com/fiston/openemrconnect/blob/master/reception/src/ke/go/moh/oec/reception/controller/PersistenceManager.java): `reception/src/ke/go/moh/oec/reception/controller/PersistenceManager.java`
- [Fingerprint Reader](https://github.com/fiston/openemrconnect/blob/master/reception/src/ke/go/moh/oec/reception/reader/ReaderManager.java): `reception/src/ke/go/moh/oec/reception/reader/ReaderManager.java`

### Person Index

- [MPI Service](https://github.com/fiston/openemrconnect/blob/master/mpi/src/ke/go/moh/oec/mpi/Mpi.java): `mpi/src/ke/go/moh/oec/mpi/Mpi.java`
- [MPI Search](https://github.com/fiston/openemrconnect/blob/master/mpi/src/ke/go/moh/oec/mpi/SearchHistory.java): `mpi/src/ke/go/moh/oec/mpi/SearchHistory.java`
- [Identity Matching](https://github.com/fiston/openemrconnect/blob/master/mpi/src/ke/go/moh/oec/mpi/match/FingerprintMatch.java): `mpi/src/ke/go/moh/oec/mpi/match/FingerprintMatch.java`
- [Person Data](https://github.com/fiston/openemrconnect/blob/master/oeclib/src/ke/go/moh/oec/Person.java): `oeclib/src/ke/go/moh/oec/Person.java`

### Messaging Runtime

- [Message Mediator](https://github.com/fiston/openemrconnect/blob/master/oeclib/src/ke/go/moh/oec/lib/Mediator.java): `oeclib/src/ke/go/moh/oec/lib/Mediator.java`
- [HTTP Transport](https://github.com/fiston/openemrconnect/blob/master/oeclib/src/ke/go/moh/oec/lib/HttpService.java): `oeclib/src/ke/go/moh/oec/lib/HttpService.java`
- [Message Queue](https://github.com/fiston/openemrconnect/blob/master/oeclib/src/ke/go/moh/oec/lib/QueueManager.java): `oeclib/src/ke/go/moh/oec/lib/QueueManager.java`
- [Message Format](https://github.com/fiston/openemrconnect/blob/master/oeclib/src/ke/go/moh/oec/lib/Message.java): `oeclib/src/ke/go/moh/oec/lib/Message.java`
- [XML Packing](https://github.com/fiston/openemrconnect/blob/master/oeclib/src/ke/go/moh/oec/lib/XmlPacker.java): `oeclib/src/ke/go/moh/oec/lib/XmlPacker.java`

### Service Integrations

- [CDS Service](https://github.com/fiston/openemrconnect/blob/master/cds/src/ke/go/moh/oec/cds/Cds.java): `cds/src/ke/go/moh/oec/cds/Cds.java`
- [ESB Service](https://github.com/fiston/openemrconnect/blob/master/esb/src/ke/go/moh/oec/esb/Esb.java): `esb/src/ke/go/moh/oec/esb/Esb.java`
- [HDSS Adapter](https://github.com/fiston/openemrconnect/blob/master/kisumuhdss/src/ke/go/moh/oec/kisumuhdss/HdssDataParser.java): `kisumuhdss/src/ke/go/moh/oec/kisumuhdss/HdssDataParser.java`
- [CPAD Extract](https://github.com/fiston/openemrconnect/blob/master/cpad_companion/src/ke/go/moh/oec/cpad/CpadDataExtract.java): `cpad_companion/src/ke/go/moh/oec/cpad/CpadDataExtract.java`
- [Patient Interface](https://github.com/fiston/openemrconnect/blob/master/oec2Interface/src/main/java/ke/go/moh/oec/pisinterfaces/controller/CdaInterfaceController.java): `oec2Interface/src/main/java/ke/go/moh/oec/pisinterfaces/controller/CdaInterfaceController.java`
- [Logging Service](https://github.com/fiston/openemrconnect/blob/master/loggingserver/src/ke/go/moh/oec/loggingserver/LoggingServer.java): `loggingserver/src/ke/go/moh/oec/loggingserver/LoggingServer.java`

### Database Sync

- [Sync Daemon](https://github.com/fiston/openemrconnect/blob/master/oecsm/src/ke/go/moh/oec/oecsm/daemon/DaemonManager.java): `oecsm/src/ke/go/moh/oec/oecsm/daemon/DaemonManager.java`
- [Data And Schema Sync](https://github.com/fiston/openemrconnect/blob/master/oecsm/src/ke/go/moh/oec/oecsm/sync/data/DataSynchronizer.java): `oecsm/src/ke/go/moh/oec/oecsm/sync/data/DataSynchronizer.java`
- [Database Bridge](https://github.com/fiston/openemrconnect/blob/master/oecsm/src/ke/go/moh/oec/oecsm/bridge/DatabaseConnector.java): `oecsm/src/ke/go/moh/oec/oecsm/bridge/DatabaseConnector.java`
- [Schema Model](https://github.com/fiston/openemrconnect/blob/master/oecsm/src/ke/go/moh/oec/oecsm/data/Table.java): `oecsm/src/ke/go/moh/oec/oecsm/data/Table.java`

### Other components

- **Clinic Staff**
- **Configured Endpoint**

## Connections

- Clinic Staff → Reception UI: uses (evidence: `reception/src/ke/go/moh/oec/reception/gui/App.java`)
- Reception UI → Reception Controller: starts (evidence: `reception/src/ke/go/moh/oec/reception/gui/App.java`)
- Reception Controller → User Persistence: persists users (evidence: `reception/src/ke/go/moh/oec/reception/controller/PersistenceManager.java`)
- Reception Controller → Message Mediator: uses (evidence: `reception/src/ke/go/moh/oec/reception/controller/OECReception.java`)
- Fingerprint Reader → Person Data: captures fingerprint
- MPI Service → MPI Search: dispatches search
- MPI Search → Identity Matching: evaluates candidates
- MPI Search → Person Data: uses person data (evidence: `mpi/src/ke/go/moh/oec/mpi/SearchHistory.java`)
- MPI Service → Message Mediator: registers service (evidence: `mpi/src/ke/go/moh/oec/mpi/Main.java`)
- Message Mediator → Message Format: creates messages (evidence: `oeclib/src/ke/go/moh/oec/lib/Mediator.java`)
- Message Mediator → HTTP Transport: routes messages (evidence: `oeclib/src/ke/go/moh/oec/lib/Mediator.java`)
- Message Mediator → Message Queue: manages delivery (evidence: `oeclib/src/ke/go/moh/oec/lib/Mediator.java`)
- Message Mediator → XML Packing: packs messages (evidence: `oeclib/src/ke/go/moh/oec/lib/Mediator.java`)
- HTTP Transport → Message Mediator: delivers received (evidence: `oeclib/src/ke/go/moh/oec/lib/HttpService.java`)
- Message Queue → HTTP Transport: sends queued (evidence: `oeclib/src/ke/go/moh/oec/lib/QueueManager.java`)
- CDS Service → Message Mediator: uses runtime (evidence: `cds/src/ke/go/moh/oec/cds/Main.java`)
- ESB Service → Message Mediator: uses runtime (evidence: `esb/src/ke/go/moh/oec/esb/Esb.java`)
- HDSS Adapter → Person Data: maps person data (evidence: `kisumuhdss/src/ke/go/moh/oec/kisumuhdss/HdssDataParser.java`)
- Patient Interface → Configured Endpoint: posts XML (evidence: `oec2Interface/src/main/java/ke/go/moh/oec/pisinterfaces/controller/CdaInterfaceController.java`)
- Sync Daemon → Data And Schema Sync: starts sync
- Data And Schema Sync → Database Bridge: uses connections
- Database Bridge → Schema Model: customizes queries (evidence: `oecsm/src/ke/go/moh/oec/oecsm/bridge/DatabaseConnector.java`)
