# openmrs/openmrs-core architecture

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

- Interactive diagram: https://gitdiagram.com/openmrs/openmrs-core
- Repository: https://github.com/openmrs/openmrs-core

## Overview

OpenMRS Core is a customizable, patient-based electronic medical record platform. Its main product workflow is managing patient and clinical records through domain services, with a web application as a user-facing deployment. The repository also includes terminology, scheduling, HL7 messaging, and file storage capabilities. The graph reflects the documented product and source-index references; unsampled implementation links are omitted rather than inferred.

Main entry points: [`api/src/main/java/org/openmrs/api/storage/LocalStorageService.java`](https://github.com/openmrs/openmrs-core/blob/master/api/src/main/java/org/openmrs/api/storage/LocalStorageService.java) (Local storage), [`api/src/main/java/org/openmrs/api/storage/S3StorageService.java`](https://github.com/openmrs/openmrs-core/blob/master/api/src/main/java/org/openmrs/api/storage/S3StorageService.java) (S3 storage), [`webapp/src/main/webapp`](https://github.com/openmrs/openmrs-core/tree/master/webapp/src/main/webapp) (OpenMRS web app), [`api/src/main/java/org/openmrs/api/StorageService.java`](https://github.com/openmrs/openmrs-core/blob/master/api/src/main/java/org/openmrs/api/StorageService.java) (File storage API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clinical["Clinical records"]
  node_person["People and patients<br/>[Person.java]"]
  node_concept["Clinical terminology<br/>[Concept.java]"]
  node_encounter["Encounters and visits<br/>[Encounter.java]"]
  node_observations["Clinical observations<br/>[Obs.java]"]
  node_orders["Care orders<br/>[Order.java]"]
  node_allergies["Allergy records<br/>[Allergy.java]"]
  node_programs["Care programs<br/>[Program.java]"]
end

subgraph group_platform["Platform services"]
  node_conceptservice["Concept service"]
  node_hl7["HL7 messaging<br/>[HL7Service.java]"]
  node_scheduler["Task scheduling"]
  node_storageapi["File storage API"]
end

subgraph group_interfaces["Application interfaces"]
  node_webapp["OpenMRS web app"]
  node_web["Web runtime"]
end

subgraph group_infrastructure["Runtime infrastructure"]
  node_jobrunr["JobRunr scheduler"]
  node_localstorage["Local storage"]
  node_s3storage["S3 storage"]
  node_streaming["Stream transfer"]
end

node_users(("Providers and staff"))

node_users -->|"use"| node_webapp
node_webapp -.->|"runs on"| node_web
node_conceptservice -->|"manages"| node_concept
node_hl7 -->|"uses"| node_person
node_scheduler -->|"implements"| node_jobrunr
node_localstorage -->|"implements"| node_storageapi
node_s3storage -->|"implements"| node_storageapi
node_localstorage -->|"streams data"| node_streaming
node_s3storage -->|"streams data"| node_streaming

click node_webapp "https://github.com/openmrs/openmrs-core/tree/master/webapp/src/main/webapp"
click node_web "https://github.com/openmrs/openmrs-core/tree/master/web/src/main/java/org/openmrs/web"
click node_person "https://github.com/openmrs/openmrs-core/blob/master/api/src/main/java/org/openmrs/Person.java"
click node_concept "https://github.com/openmrs/openmrs-core/blob/master/api/src/main/java/org/openmrs/Concept.java"
click node_encounter "https://github.com/openmrs/openmrs-core/blob/master/api/src/main/java/org/openmrs/Encounter.java"
click node_observations "https://github.com/openmrs/openmrs-core/blob/master/api/src/main/java/org/openmrs/Obs.java"
click node_orders "https://github.com/openmrs/openmrs-core/blob/master/api/src/main/java/org/openmrs/Order.java"
click node_allergies "https://github.com/openmrs/openmrs-core/blob/master/api/src/main/java/org/openmrs/Allergy.java"
click node_programs "https://github.com/openmrs/openmrs-core/blob/master/api/src/main/java/org/openmrs/Program.java"
click node_conceptservice "https://github.com/openmrs/openmrs-core/blob/master/api/src/main/java/org/openmrs/api/ConceptService.java"
click node_hl7 "https://github.com/openmrs/openmrs-core/blob/master/api/src/main/java/org/openmrs/hl7/HL7Service.java"
click node_scheduler "https://github.com/openmrs/openmrs-core/blob/master/api/src/main/java/org/openmrs/scheduler/SchedulerService.java"
click node_jobrunr "https://github.com/openmrs/openmrs-core/blob/master/api/src/main/java/org/openmrs/scheduler/jobrunr/JobRunrSchedulerService.java"
click node_storageapi "https://github.com/openmrs/openmrs-core/blob/master/api/src/main/java/org/openmrs/api/StorageService.java"
click node_localstorage "https://github.com/openmrs/openmrs-core/blob/master/api/src/main/java/org/openmrs/api/storage/LocalStorageService.java"
click node_s3storage "https://github.com/openmrs/openmrs-core/blob/master/api/src/main/java/org/openmrs/api/storage/S3StorageService.java"
click node_streaming "https://github.com/openmrs/openmrs-core/blob/master/api/src/main/java/org/openmrs/api/stream/StreamDataService.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_person,node_concept,node_encounter,node_observations,node_orders,node_allergies,node_programs toneBlue
class node_conceptservice,node_hl7,node_scheduler,node_storageapi toneAmber
class node_webapp,node_web toneMint
class node_jobrunr,node_localstorage,node_s3storage,node_streaming toneRose
class node_users toneIndigo
```

## Components

### Clinical records

- [People and patients](https://github.com/openmrs/openmrs-core/blob/master/api/src/main/java/org/openmrs/Person.java): `api/src/main/java/org/openmrs/Person.java`
- [Clinical terminology](https://github.com/openmrs/openmrs-core/blob/master/api/src/main/java/org/openmrs/Concept.java): `api/src/main/java/org/openmrs/Concept.java`
- [Encounters and visits](https://github.com/openmrs/openmrs-core/blob/master/api/src/main/java/org/openmrs/Encounter.java): `api/src/main/java/org/openmrs/Encounter.java`
- [Clinical observations](https://github.com/openmrs/openmrs-core/blob/master/api/src/main/java/org/openmrs/Obs.java): `api/src/main/java/org/openmrs/Obs.java`
- [Care orders](https://github.com/openmrs/openmrs-core/blob/master/api/src/main/java/org/openmrs/Order.java): `api/src/main/java/org/openmrs/Order.java`
- [Allergy records](https://github.com/openmrs/openmrs-core/blob/master/api/src/main/java/org/openmrs/Allergy.java): `api/src/main/java/org/openmrs/Allergy.java`
- [Care programs](https://github.com/openmrs/openmrs-core/blob/master/api/src/main/java/org/openmrs/Program.java): `api/src/main/java/org/openmrs/Program.java`

### Platform services

- [Concept service](https://github.com/openmrs/openmrs-core/blob/master/api/src/main/java/org/openmrs/api/ConceptService.java): `api/src/main/java/org/openmrs/api/ConceptService.java`
- [HL7 messaging](https://github.com/openmrs/openmrs-core/blob/master/api/src/main/java/org/openmrs/hl7/HL7Service.java): `api/src/main/java/org/openmrs/hl7/HL7Service.java`
- [Task scheduling](https://github.com/openmrs/openmrs-core/blob/master/api/src/main/java/org/openmrs/scheduler/SchedulerService.java): `api/src/main/java/org/openmrs/scheduler/SchedulerService.java`
- [File storage API](https://github.com/openmrs/openmrs-core/blob/master/api/src/main/java/org/openmrs/api/StorageService.java): `api/src/main/java/org/openmrs/api/StorageService.java`

### Application interfaces

- [OpenMRS web app](https://github.com/openmrs/openmrs-core/tree/master/webapp/src/main/webapp): `webapp/src/main/webapp`
- [Web runtime](https://github.com/openmrs/openmrs-core/tree/master/web/src/main/java/org/openmrs/web): `web/src/main/java/org/openmrs/web`

### Runtime infrastructure

- [JobRunr scheduler](https://github.com/openmrs/openmrs-core/blob/master/api/src/main/java/org/openmrs/scheduler/jobrunr/JobRunrSchedulerService.java): `api/src/main/java/org/openmrs/scheduler/jobrunr/JobRunrSchedulerService.java`
- [Local storage](https://github.com/openmrs/openmrs-core/blob/master/api/src/main/java/org/openmrs/api/storage/LocalStorageService.java): `api/src/main/java/org/openmrs/api/storage/LocalStorageService.java`
- [S3 storage](https://github.com/openmrs/openmrs-core/blob/master/api/src/main/java/org/openmrs/api/storage/S3StorageService.java): `api/src/main/java/org/openmrs/api/storage/S3StorageService.java`
- [Stream transfer](https://github.com/openmrs/openmrs-core/blob/master/api/src/main/java/org/openmrs/api/stream/StreamDataService.java): `api/src/main/java/org/openmrs/api/stream/StreamDataService.java`

### Other components

- **Providers and staff**

## Connections

- Providers and staff → OpenMRS web app: use (evidence: `README.md`)
- OpenMRS web app → Web runtime: runs on
- Concept service → Clinical terminology: manages (evidence: `api/src/main/java/org/openmrs/api/ConceptService.java`)
- HL7 messaging → People and patients: uses (evidence: `api/src/main/java/org/openmrs/hl7/HL7Service.java`)
- Task scheduling → JobRunr scheduler: implements (evidence: `api/src/main/java/org/openmrs/scheduler/jobrunr/JobRunrSchedulerService.java`)
- Local storage → File storage API: implements (evidence: `api/src/main/java/org/openmrs/api/storage/LocalStorageService.java`)
- S3 storage → File storage API: implements (evidence: `api/src/main/java/org/openmrs/api/storage/S3StorageService.java`)
- Local storage → Stream transfer: streams data (evidence: `api/src/main/java/org/openmrs/api/storage/LocalStorageService.java`)
- S3 storage → Stream transfer: streams data (evidence: `api/src/main/java/org/openmrs/api/storage/S3StorageService.java`)
