# karthikaiyasamy/seymour-sandbox architecture

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

- Interactive diagram: https://gitdiagram.com/karthikaiyasamy/seymour-sandbox
- Repository: https://github.com/karthikaiyasamy/seymour-sandbox

## Overview

This is a synthetic regional healthcare interoperability sandbox: clinicians search and reconcile patient identities in a SMART portal, then access Seymour’s primary EHR or a Terry Fox oncology node; hospital gateways ingest HL7 and synchronize records. Seymour supplies OAuth/JWKS authorization and EMPI review, while the regional nodes expose clinical data and exchange updates. The README documents the cross-node workflow and capabilities; sampled source confirms selected ingestion, review, key-store, and synchronization relationships, but not every controller or frontend call.

Main entry points: [`smart-app/src/main.ts`](https://github.com/karthikaiyasamy/seymour-sandbox/blob/main/smart-app/src/main.ts) (SMART portal), [`SeymorFHIR/src/main/java/com/healthcare/sandbox/controller`](https://github.com/karthikaiyasamy/seymour-sandbox/tree/main/SeymorFHIR/src/main/java/com/healthcare/sandbox/controller) (FHIR APIs), [`LangleyGeneralGateway/Controllers/Hl7IngestController.cs`](https://github.com/karthikaiyasamy/seymour-sandbox/blob/main/LangleyGeneralGateway/Controllers/Hl7IngestController.cs) (General HL7 ingest), [`SeymorFHIR/src/main/java/com/healthcare/sandbox/controller/PatientMatchReviewController.java`](https://github.com/karthikaiyasamy/seymour-sandbox/blob/main/SeymorFHIR/src/main/java/com/healthcare/sandbox/controller/PatientMatchReviewController.java) (EMPI review)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_portal["Clinical portal"]
  node_portal_app["SMART portal<br/>[main.ts]"]
end

subgraph group_seymour["Seymour EHR"]
  node_seymour_fhir["FHIR APIs"]
  node_seymour_patient[("Patient records<br/>[Patient.java]")]
  node_seymour_adt["HL7 ADT service<br/>[Hl7Service.java]"]
  node_empi_reviews["EMPI review"]
end

subgraph group_specialty["Regional hospitals"]
  node_terry_fhir["Oncology FHIR"]
  node_terry_oncology[("mCODE data")]
  node_regional_sync["Regional sync"]
  node_terry_hl7["Oncology HL7 ingest"]
end

subgraph group_integration["Integration gateways"]
  node_general_api["General FHIR APIs"]
  node_general_hl7["General HL7 ingest"]
  node_hl7_parser["HL7 parser<br/>[Hl7Parser.cs]"]
  node_general_store[("General clinical store")]
  node_pediatric_webhook["Pediatric sync"]
  node_pediatric_data[("Pediatric records")]
end

subgraph group_security["Federated security"]
  node_oauth["SMART OAuth"]
  node_key_service["RSA key service<br/>[JwtKeyService.java]"]
  node_key_store[("RSA key store<br/>[OAuthKey.java]")]
end

node_clinician(("Clinician"))
node_hl7_sender(("HL7 sender"))

node_clinician -->|"searches"| node_portal_app
node_portal_app -->|"searches first"| node_seymour_fhir
node_portal_app -->|"fallback searches"| node_terry_fhir
node_portal_app -->|"authorizes via"| node_oauth
node_portal_app -->|"flags conflicts"| node_empi_reviews
node_seymour_fhir -->|"serves records"| node_seymour_patient
node_seymour_adt -->|"matches and registers"| node_seymour_patient
node_seymour_adt -->|"queues conflicts"| node_empi_reviews
node_empi_reviews -->|"approves into"| node_seymour_patient
node_oauth -->|"signs with"| node_key_service
node_key_service -->|"loads and persists"| node_key_store
node_terry_fhir -->|"serves mCODE data"| node_terry_oncology
node_terry_hl7 -->|"stores reports"| node_terry_oncology
node_regional_sync -->|"syncs patients"| node_seymour_fhir
node_regional_sync -->|"syncs patients"| node_general_api
node_hl7_sender -->|"submits messages"| node_general_hl7
node_general_hl7 -->|"parses with"| node_hl7_parser
node_general_hl7 -->|"writes patients and observations"| node_general_store
node_general_api -->|"accesses records"| node_general_store
node_pediatric_webhook -->|"updates records"| node_pediatric_data
node_pediatric_webhook -->|"fetches patient data"| node_seymour_fhir

click node_portal_app "https://github.com/karthikaiyasamy/seymour-sandbox/blob/main/smart-app/src/main.ts"
click node_seymour_fhir "https://github.com/karthikaiyasamy/seymour-sandbox/tree/main/SeymorFHIR/src/main/java/com/healthcare/sandbox/controller"
click node_seymour_patient "https://github.com/karthikaiyasamy/seymour-sandbox/blob/main/SeymorFHIR/src/main/java/com/healthcare/sandbox/model/Patient.java"
click node_seymour_adt "https://github.com/karthikaiyasamy/seymour-sandbox/blob/main/SeymorFHIR/src/main/java/com/healthcare/sandbox/service/Hl7Service.java"
click node_empi_reviews "https://github.com/karthikaiyasamy/seymour-sandbox/blob/main/SeymorFHIR/src/main/java/com/healthcare/sandbox/controller/PatientMatchReviewController.java"
click node_oauth "https://github.com/karthikaiyasamy/seymour-sandbox/blob/main/SeymorFHIR/src/main/java/com/healthcare/sandbox/controller/OAuth2TokenController.java"
click node_key_service "https://github.com/karthikaiyasamy/seymour-sandbox/blob/main/SeymorFHIR/src/main/java/com/healthcare/sandbox/service/JwtKeyService.java"
click node_key_store "https://github.com/karthikaiyasamy/seymour-sandbox/blob/main/SeymorFHIR/src/main/java/com/healthcare/sandbox/model/OAuthKey.java"
click node_terry_fhir "https://github.com/karthikaiyasamy/seymour-sandbox/tree/main/TerryFoxMemorial/src/main/java/com/terryfox/hospital/provider"
click node_terry_oncology "https://github.com/karthikaiyasamy/seymour-sandbox/tree/main/TerryFoxMemorial/src/main/java/com/terryfox/hospital/model"
click node_regional_sync "https://github.com/karthikaiyasamy/seymour-sandbox/blob/main/TerryFoxMemorial/src/main/java/com/terryfox/hospital/service/RegionalSyncService.java"
click node_terry_hl7 "https://github.com/karthikaiyasamy/seymour-sandbox/blob/main/TerryFoxMemorial/src/main/java/com/terryfox/hospital/controller/Hl7OncologyIngestController.java"
click node_general_api "https://github.com/karthikaiyasamy/seymour-sandbox/tree/main/LangleyGeneralGateway/Controllers"
click node_general_hl7 "https://github.com/karthikaiyasamy/seymour-sandbox/blob/main/LangleyGeneralGateway/Controllers/Hl7IngestController.cs"
click node_hl7_parser "https://github.com/karthikaiyasamy/seymour-sandbox/blob/main/LangleyGeneralGateway/Utils/Hl7Parser.cs"
click node_general_store "https://github.com/karthikaiyasamy/seymour-sandbox/blob/main/LangleyGeneralGateway/Data/LangleyGeneralDbContext.cs"
click node_pediatric_webhook "https://github.com/karthikaiyasamy/seymour-sandbox/blob/main/LangleyChildrensHospital/langley-backend/src/main/java/com/langley/hospital/controller/WebhookController.java"
click node_pediatric_data "https://github.com/karthikaiyasamy/seymour-sandbox/tree/main/LangleyChildrensHospital/langley-backend/src/main/java/com/langley/hospital/model"

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_portal_app toneBlue
class node_seymour_fhir,node_seymour_patient,node_seymour_adt,node_empi_reviews toneAmber
class node_terry_fhir,node_terry_oncology,node_regional_sync,node_terry_hl7 toneMint
class node_general_api,node_general_hl7,node_hl7_parser,node_general_store,node_pediatric_webhook,node_pediatric_data toneRose
class node_oauth,node_key_service,node_key_store,node_clinician,node_hl7_sender toneIndigo
```

## Components

### Clinical portal

- [SMART portal](https://github.com/karthikaiyasamy/seymour-sandbox/blob/main/smart-app/src/main.ts): `smart-app/src/main.ts`

### Seymour EHR

- [FHIR APIs](https://github.com/karthikaiyasamy/seymour-sandbox/tree/main/SeymorFHIR/src/main/java/com/healthcare/sandbox/controller): `SeymorFHIR/src/main/java/com/healthcare/sandbox/controller`
- [Patient records](https://github.com/karthikaiyasamy/seymour-sandbox/blob/main/SeymorFHIR/src/main/java/com/healthcare/sandbox/model/Patient.java): `SeymorFHIR/src/main/java/com/healthcare/sandbox/model/Patient.java`
- [HL7 ADT service](https://github.com/karthikaiyasamy/seymour-sandbox/blob/main/SeymorFHIR/src/main/java/com/healthcare/sandbox/service/Hl7Service.java): `SeymorFHIR/src/main/java/com/healthcare/sandbox/service/Hl7Service.java`
- [EMPI review](https://github.com/karthikaiyasamy/seymour-sandbox/blob/main/SeymorFHIR/src/main/java/com/healthcare/sandbox/controller/PatientMatchReviewController.java): `SeymorFHIR/src/main/java/com/healthcare/sandbox/controller/PatientMatchReviewController.java`

### Regional hospitals

- [Oncology FHIR](https://github.com/karthikaiyasamy/seymour-sandbox/tree/main/TerryFoxMemorial/src/main/java/com/terryfox/hospital/provider): `TerryFoxMemorial/src/main/java/com/terryfox/hospital/provider`
- [mCODE data](https://github.com/karthikaiyasamy/seymour-sandbox/tree/main/TerryFoxMemorial/src/main/java/com/terryfox/hospital/model): `TerryFoxMemorial/src/main/java/com/terryfox/hospital/model`
- [Regional sync](https://github.com/karthikaiyasamy/seymour-sandbox/blob/main/TerryFoxMemorial/src/main/java/com/terryfox/hospital/service/RegionalSyncService.java): `TerryFoxMemorial/src/main/java/com/terryfox/hospital/service/RegionalSyncService.java`
- [Oncology HL7 ingest](https://github.com/karthikaiyasamy/seymour-sandbox/blob/main/TerryFoxMemorial/src/main/java/com/terryfox/hospital/controller/Hl7OncologyIngestController.java): `TerryFoxMemorial/src/main/java/com/terryfox/hospital/controller/Hl7OncologyIngestController.java`

### Integration gateways

- [General FHIR APIs](https://github.com/karthikaiyasamy/seymour-sandbox/tree/main/LangleyGeneralGateway/Controllers): `LangleyGeneralGateway/Controllers`
- [General HL7 ingest](https://github.com/karthikaiyasamy/seymour-sandbox/blob/main/LangleyGeneralGateway/Controllers/Hl7IngestController.cs): `LangleyGeneralGateway/Controllers/Hl7IngestController.cs`
- [HL7 parser](https://github.com/karthikaiyasamy/seymour-sandbox/blob/main/LangleyGeneralGateway/Utils/Hl7Parser.cs): `LangleyGeneralGateway/Utils/Hl7Parser.cs`
- [General clinical store](https://github.com/karthikaiyasamy/seymour-sandbox/blob/main/LangleyGeneralGateway/Data/LangleyGeneralDbContext.cs): `LangleyGeneralGateway/Data/LangleyGeneralDbContext.cs`
- [Pediatric sync](https://github.com/karthikaiyasamy/seymour-sandbox/blob/main/LangleyChildrensHospital/langley-backend/src/main/java/com/langley/hospital/controller/WebhookController.java): `LangleyChildrensHospital/langley-backend/src/main/java/com/langley/hospital/controller/WebhookController.java`
- [Pediatric records](https://github.com/karthikaiyasamy/seymour-sandbox/tree/main/LangleyChildrensHospital/langley-backend/src/main/java/com/langley/hospital/model): `LangleyChildrensHospital/langley-backend/src/main/java/com/langley/hospital/model`

### Federated security

- [SMART OAuth](https://github.com/karthikaiyasamy/seymour-sandbox/blob/main/SeymorFHIR/src/main/java/com/healthcare/sandbox/controller/OAuth2TokenController.java): `SeymorFHIR/src/main/java/com/healthcare/sandbox/controller/OAuth2TokenController.java`
- [RSA key service](https://github.com/karthikaiyasamy/seymour-sandbox/blob/main/SeymorFHIR/src/main/java/com/healthcare/sandbox/service/JwtKeyService.java): `SeymorFHIR/src/main/java/com/healthcare/sandbox/service/JwtKeyService.java`
- [RSA key store](https://github.com/karthikaiyasamy/seymour-sandbox/blob/main/SeymorFHIR/src/main/java/com/healthcare/sandbox/model/OAuthKey.java): `SeymorFHIR/src/main/java/com/healthcare/sandbox/model/OAuthKey.java`

### Other components

- **Clinician**
- **HL7 sender**

## Connections

- Clinician → SMART portal: searches (evidence: `README.md`)
- SMART portal → FHIR APIs: searches first (evidence: `README.md`)
- SMART portal → Oncology FHIR: fallback searches (evidence: `README.md`)
- SMART portal → SMART OAuth: authorizes via (evidence: `README.md`)
- SMART portal → EMPI review: flags conflicts (evidence: `README.md`)
- FHIR APIs → Patient records: serves records (evidence: `README.md`)
- HL7 ADT service → Patient records: matches and registers (evidence: `SeymorFHIR/src/main/java/com/healthcare/sandbox/service/Hl7Service.java`)
- HL7 ADT service → EMPI review: queues conflicts (evidence: `SeymorFHIR/src/main/java/com/healthcare/sandbox/service/Hl7Service.java`)
- EMPI review → Patient records: approves into (evidence: `SeymorFHIR/src/main/java/com/healthcare/sandbox/controller/PatientMatchReviewController.java`)
- SMART OAuth → RSA key service: signs with (evidence: `SeymorFHIR/src/main/java/com/healthcare/sandbox/controller/OAuth2TokenController.java`)
- RSA key service → RSA key store: loads and persists (evidence: `SeymorFHIR/src/main/java/com/healthcare/sandbox/service/JwtKeyService.java`)
- Oncology FHIR → mCODE data: serves mCODE data (evidence: `README.md`)
- Oncology HL7 ingest → mCODE data: stores reports (evidence: `TerryFoxMemorial/src/main/java/com/terryfox/hospital/controller/Hl7OncologyIngestController.java`)
- Regional sync → FHIR APIs: syncs patients (evidence: `TerryFoxMemorial/src/main/java/com/terryfox/hospital/service/RegionalSyncService.java`)
- Regional sync → General FHIR APIs: syncs patients (evidence: `TerryFoxMemorial/src/main/java/com/terryfox/hospital/service/RegionalSyncService.java`)
- HL7 sender → General HL7 ingest: submits messages (evidence: `README.md`)
- General HL7 ingest → HL7 parser: parses with (evidence: `LangleyGeneralGateway/Controllers/Hl7IngestController.cs`)
- General HL7 ingest → General clinical store: writes patients and observations (evidence: `LangleyGeneralGateway/Controllers/Hl7IngestController.cs`)
- General FHIR APIs → General clinical store: accesses records (evidence: `LangleyGeneralGateway/Controllers/FhirPatientController.cs`)
- Pediatric sync → Pediatric records: updates records (evidence: `LangleyChildrensHospital/langley-backend/src/main/java/com/langley/hospital/controller/WebhookController.java`)
- Pediatric sync → FHIR APIs: fetches patient data (evidence: `LangleyChildrensHospital/langley-backend/src/main/java/com/langley/hospital/controller/WebhookController.java`)
