How karthikaiyasamy/seymour-sandbox works
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: main.ts SMART portal · controller FHIR APIs · Hl7IngestController.cs General HL7 ingest · PatientMatchReviewController.java EMPI review
Components 20
Clinical portal
- SMART portal
smart-app/src/main.ts
Seymour EHR
- FHIR APIs
SeymorFHIR/src/main/java/com/healthcare/sandbox/controller - Patient records
SeymorFHIR/src/main/java/com/healthcare/sandbox/model/Patient.java - HL7 ADT service
SeymorFHIR/src/main/java/com/healthcare/sandbox/service/Hl7Service.java - EMPI review
SeymorFHIR/src/main/java/com/healthcare/sandbox/controller/PatientMatchReviewController.java
Regional hospitals
- Oncology FHIR
TerryFoxMemorial/src/main/java/com/terryfox/hospital/provider - mCODE data
TerryFoxMemorial/src/main/java/com/terryfox/hospital/model - Regional sync
TerryFoxMemorial/src/main/java/com/terryfox/hospital/service/RegionalSyncService.java - Oncology HL7 ingest
TerryFoxMemorial/src/main/java/com/terryfox/hospital/controller/Hl7OncologyIngestController.java
Integration gateways
- General FHIR APIs
LangleyGeneralGateway/Controllers - General HL7 ingest
LangleyGeneralGateway/Controllers/Hl7IngestController.cs - HL7 parser
LangleyGeneralGateway/Utils/Hl7Parser.cs - General clinical store
LangleyGeneralGateway/Data/LangleyGeneralDbContext.cs - Pediatric sync
LangleyChildrensHospital/langley-backend/src/main/java/com/langley/hospital/controller/WebhookController.java - Pediatric records
LangleyChildrensHospital/langley-backend/src/main/java/com/langley/hospital/model
Federated security
- SMART OAuth
SeymorFHIR/src/main/java/com/healthcare/sandbox/controller/OAuth2TokenController.java - RSA key service
SeymorFHIR/src/main/java/com/healthcare/sandbox/service/JwtKeyService.java - RSA key store
SeymorFHIR/src/main/java/com/healthcare/sandbox/model/OAuthKey.java
Other components
- Clinician
- HL7 sender
Connections 21
- Clinician → SMART portal: searches
README.md - SMART portal → FHIR APIs: searches first
README.md - SMART portal → Oncology FHIR: fallback searches
README.md - SMART portal → SMART OAuth: authorizes via
README.md - SMART portal → EMPI review: flags conflicts
README.md - FHIR APIs → Patient records: serves records
README.md - HL7 ADT service → Patient records: matches and registers
SeymorFHIR/src/main/java/com/healthcare/sandbox/service/Hl7Service.java - HL7 ADT service → EMPI review: queues conflicts
SeymorFHIR/src/main/java/com/healthcare/sandbox/service/Hl7Service.java - EMPI review → Patient records: approves into
SeymorFHIR/src/main/java/com/healthcare/sandbox/controller/PatientMatchReviewController.java - SMART OAuth → RSA key service: signs with
SeymorFHIR/src/main/java/com/healthcare/sandbox/controller/OAuth2TokenController.java - RSA key service → RSA key store: loads and persists
SeymorFHIR/src/main/java/com/healthcare/sandbox/service/JwtKeyService.java - Oncology FHIR → mCODE data: serves mCODE data
README.md - Oncology HL7 ingest → mCODE data: stores reports
TerryFoxMemorial/src/main/java/com/terryfox/hospital/controller/Hl7OncologyIngestController.java - Regional sync → FHIR APIs: syncs patients
TerryFoxMemorial/src/main/java/com/terryfox/hospital/service/RegionalSyncService.java - Regional sync → General FHIR APIs: syncs patients
TerryFoxMemorial/src/main/java/com/terryfox/hospital/service/RegionalSyncService.java - HL7 sender → General HL7 ingest: submits messages
README.md - General HL7 ingest → HL7 parser: parses with
LangleyGeneralGateway/Controllers/Hl7IngestController.cs - General HL7 ingest → General clinical store: writes patients and observations
LangleyGeneralGateway/Controllers/Hl7IngestController.cs - General FHIR APIs → General clinical store: accesses records
LangleyGeneralGateway/Controllers/FhirPatientController.cs - Pediatric sync → Pediatric records: updates records
LangleyChildrensHospital/langley-backend/src/main/java/com/langley/hospital/controller/WebhookController.java - Pediatric sync → FHIR APIs: fetches patient data
LangleyChildrensHospital/langley-backend/src/main/java/com/langley/hospital/controller/WebhookController.java