# kfprugger/hls-data-accelerator architecture

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

- Interactive diagram: https://gitdiagram.com/kfprugger/hls-data-accelerator
- Repository: https://github.com/kfprugger/hls-data-accelerator

## Overview

HLS Data Accelerator deploys and validates a connected healthcare data estate, then demonstrates its use through analytics and operational apps. The principal workflow runs from browser-based preflight and deployment through orchestration, domain data ingestion, Fabric lakehouse/real-time processing, and validation. The README documents major capabilities beyond the sampled excerpts; those branches are represented at their supported directory paths. Source-level edges are limited to shown imports or calls, with README evidence used for documented platform flows.

Main entry points: [`orchestrator/activities`](https://github.com/kfprugger/hls-data-accelerator/tree/main/orchestrator/activities) (Deployment activities), [`orchestrator-ui/src/api.ts`](https://github.com/kfprugger/hls-data-accelerator/blob/main/orchestrator-ui/src/api.ts) (UI API client), [`orchestrator/local_server.py`](https://github.com/kfprugger/hls-data-accelerator/blob/main/orchestrator/local_server.py) (Local orchestrator), [`azure-databricks/implementation/bundle/src/gold_products.py`](https://github.com/kfprugger/hls-data-accelerator/blob/main/azure-databricks/implementation/bundle/src/gold_products.py) (Gold products)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Deployment control"]
  node_deploy_ui["Deploy wizard<br/>[DeployWizard.tsx]"]
  node_ui_api["UI API client<br/>[api.ts]"]
  node_ui_state["Shared UI state<br/>[AppState.tsx]"]
  node_monitor["Phase monitor<br/>[PhaseMonitor.tsx]"]
  node_history["Deployment history"]
  node_teardown["Teardown controls<br/>[TeardownView.tsx]"]
  node_mockdata["UI mock data<br/>[mockDeployment.ts]"]
  node_backend["Local orchestrator<br/>[local_server.py]"]
  node_durable["Durable Functions<br/>[function_app.py]"]
  node_activities["Deployment activities"]
  node_powershell["PowerShell invocation"]
  node_validation["Deployment validation"]
end

subgraph group_ingest["Healthcare data"]
  node_fhir["FHIR ingestion<br/>[load_fhir.py]"]
  node_dicom["DICOM ingestion<br/>[load_dicom.py]"]
  node_telemetry["Device telemetry<br/>[emulator.py]"]
  node_claims["Claims processing"]
end

subgraph group_platform["Fabric platform"]
  node_hds["HDS pipelines"]
  node_fabric["Fabric API client<br/>[fabric_client.py]"]
  node_gold["Gold products<br/>[gold_products.py]"]
  node_realtime["Real-time analytics<br/>[gates_streams.py]"]
  node_agents["Data agents"]
end

subgraph group_experience["Analytics and action"]
  node_rayfin["Health command center<br/>[App.tsx]"]
  node_triage["Clinical triage app<br/>[App.tsx]"]
  node_eval["Deployment evaluation"]
end

node_operator(("Operator"))
node_fabric_service{{"Azure and Fabric"}}

node_operator -->|"configures deployment"| node_deploy_ui
node_deploy_ui -->|"starts deployment"| node_ui_api
node_ui_api -->|"calls backend"| node_backend
node_backend -->|"runs activities"| node_activities
node_durable -.->|"orchestrates"| node_activities
node_backend -->|"invokes"| node_powershell
node_backend -->|"validates deployment"| node_validation
node_ui_state -->|"loads status"| node_ui_api
node_monitor -->|"requests progress"| node_ui_api
node_history -->|"requests history"| node_ui_api
node_teardown -->|"requests teardown"| node_ui_api
node_monitor -->|"uses fallback data"| node_mockdata
node_activities -.->|"deploys ingestion"| node_fhir
node_activities -.->|"deploys imaging"| node_dicom
node_activities -.->|"deploys emulator"| node_telemetry
node_activities -.->|"deploys claims"| node_claims
node_activities -->|"triggers pipelines"| node_hds
node_hds -->|"uses API client"| node_fabric
node_activities -.->|"configures Fabric"| node_fabric
node_fhir -->|"loads clinical data"| node_fabric_service
node_dicom -->|"stages imaging data"| node_fabric_service
node_telemetry -->|"sends device events"| node_fabric_service
node_claims -.->|"materializes claims"| node_gold
node_hds -.->|"feeds lakehouse products"| node_gold
node_fabric_service -->|"routes event streams"| node_realtime
node_gold -->|"supplies Gold analytics"| node_rayfin
node_gold -->|"supports agent data"| node_agents
node_fabric_service -.->|"hosts triage app"| node_triage
node_validation -.->|"checks deployment"| node_eval

click node_deploy_ui "https://github.com/kfprugger/hls-data-accelerator/blob/main/orchestrator-ui/src/pages/DeployWizard.tsx"
click node_ui_api "https://github.com/kfprugger/hls-data-accelerator/blob/main/orchestrator-ui/src/api.ts"
click node_ui_state "https://github.com/kfprugger/hls-data-accelerator/blob/main/orchestrator-ui/src/AppState.tsx"
click node_monitor "https://github.com/kfprugger/hls-data-accelerator/blob/main/orchestrator-ui/src/pages/PhaseMonitor.tsx"
click node_history "https://github.com/kfprugger/hls-data-accelerator/blob/main/orchestrator-ui/src/pages/DeploymentHistory.tsx"
click node_teardown "https://github.com/kfprugger/hls-data-accelerator/blob/main/orchestrator-ui/src/pages/TeardownView.tsx"
click node_mockdata "https://github.com/kfprugger/hls-data-accelerator/blob/main/orchestrator-ui/src/mockDeployment.ts"
click node_backend "https://github.com/kfprugger/hls-data-accelerator/blob/main/orchestrator/local_server.py"
click node_durable "https://github.com/kfprugger/hls-data-accelerator/blob/main/orchestrator/function_app.py"
click node_activities "https://github.com/kfprugger/hls-data-accelerator/tree/main/orchestrator/activities"
click node_powershell "https://github.com/kfprugger/hls-data-accelerator/blob/main/orchestrator/activities/invoke_powershell.py"
click node_validation "https://github.com/kfprugger/hls-data-accelerator/blob/main/orchestrator/shared/deployment_validation.py"
click node_fhir "https://github.com/kfprugger/hls-data-accelerator/blob/main/fhir-loader/load_fhir.py"
click node_dicom "https://github.com/kfprugger/hls-data-accelerator/blob/main/dicom-loader/load_dicom.py"
click node_telemetry "https://github.com/kfprugger/hls-data-accelerator/blob/main/emulator.py"
click node_claims "https://github.com/kfprugger/hls-data-accelerator/blob/main/phase-5/materialize_claims_quality.py"
click node_hds "https://github.com/kfprugger/hls-data-accelerator/blob/main/orchestrator/activities/deploy_hds_pipelines.py"
click node_fabric "https://github.com/kfprugger/hls-data-accelerator/blob/main/orchestrator/shared/fabric_client.py"
click node_gold "https://github.com/kfprugger/hls-data-accelerator/blob/main/azure-databricks/implementation/bundle/src/gold_products.py"
click node_realtime "https://github.com/kfprugger/hls-data-accelerator/blob/main/azure-databricks/implementation/bundle/src/gates_streams.py"
click node_agents "https://github.com/kfprugger/hls-data-accelerator/blob/main/orchestrator/activities/deploy_data_agents.py"
click node_rayfin "https://github.com/kfprugger/hls-data-accelerator/blob/main/rayfin-health-command-center/src/App.tsx"
click node_triage "https://github.com/kfprugger/hls-data-accelerator/blob/main/rayfin-clinical-triage-app/src/App.tsx"
click node_eval "https://github.com/kfprugger/hls-data-accelerator/blob/main/eval/deployment_eval_harness.py"

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_deploy_ui,node_ui_api,node_ui_state,node_monitor,node_history,node_teardown,node_mockdata,node_backend,node_durable,node_activities,node_powershell,node_validation toneBlue
class node_fhir,node_dicom,node_telemetry,node_claims toneAmber
class node_hds,node_fabric,node_gold,node_realtime,node_agents toneMint
class node_rayfin,node_triage,node_eval toneRose
class node_operator,node_fabric_service toneIndigo
```

## Components

### Deployment control

- [Deploy wizard](https://github.com/kfprugger/hls-data-accelerator/blob/main/orchestrator-ui/src/pages/DeployWizard.tsx): `orchestrator-ui/src/pages/DeployWizard.tsx`
- [UI API client](https://github.com/kfprugger/hls-data-accelerator/blob/main/orchestrator-ui/src/api.ts): `orchestrator-ui/src/api.ts`
- [Shared UI state](https://github.com/kfprugger/hls-data-accelerator/blob/main/orchestrator-ui/src/AppState.tsx): `orchestrator-ui/src/AppState.tsx`
- [Phase monitor](https://github.com/kfprugger/hls-data-accelerator/blob/main/orchestrator-ui/src/pages/PhaseMonitor.tsx): `orchestrator-ui/src/pages/PhaseMonitor.tsx`
- [Deployment history](https://github.com/kfprugger/hls-data-accelerator/blob/main/orchestrator-ui/src/pages/DeploymentHistory.tsx): `orchestrator-ui/src/pages/DeploymentHistory.tsx`
- [Teardown controls](https://github.com/kfprugger/hls-data-accelerator/blob/main/orchestrator-ui/src/pages/TeardownView.tsx): `orchestrator-ui/src/pages/TeardownView.tsx`
- [UI mock data](https://github.com/kfprugger/hls-data-accelerator/blob/main/orchestrator-ui/src/mockDeployment.ts): `orchestrator-ui/src/mockDeployment.ts`
- [Local orchestrator](https://github.com/kfprugger/hls-data-accelerator/blob/main/orchestrator/local_server.py): `orchestrator/local_server.py`
- [Durable Functions](https://github.com/kfprugger/hls-data-accelerator/blob/main/orchestrator/function_app.py): `orchestrator/function_app.py`
- [Deployment activities](https://github.com/kfprugger/hls-data-accelerator/tree/main/orchestrator/activities): `orchestrator/activities`
- [PowerShell invocation](https://github.com/kfprugger/hls-data-accelerator/blob/main/orchestrator/activities/invoke_powershell.py): `orchestrator/activities/invoke_powershell.py`
- [Deployment validation](https://github.com/kfprugger/hls-data-accelerator/blob/main/orchestrator/shared/deployment_validation.py): `orchestrator/shared/deployment_validation.py`

### Healthcare data

- [FHIR ingestion](https://github.com/kfprugger/hls-data-accelerator/blob/main/fhir-loader/load_fhir.py): `fhir-loader/load_fhir.py`
- [DICOM ingestion](https://github.com/kfprugger/hls-data-accelerator/blob/main/dicom-loader/load_dicom.py): `dicom-loader/load_dicom.py`
- [Device telemetry](https://github.com/kfprugger/hls-data-accelerator/blob/main/emulator.py): `emulator.py`
- [Claims processing](https://github.com/kfprugger/hls-data-accelerator/blob/main/phase-5/materialize_claims_quality.py): `phase-5/materialize_claims_quality.py`

### Fabric platform

- [HDS pipelines](https://github.com/kfprugger/hls-data-accelerator/blob/main/orchestrator/activities/deploy_hds_pipelines.py): `orchestrator/activities/deploy_hds_pipelines.py`
- [Fabric API client](https://github.com/kfprugger/hls-data-accelerator/blob/main/orchestrator/shared/fabric_client.py): `orchestrator/shared/fabric_client.py`
- [Gold products](https://github.com/kfprugger/hls-data-accelerator/blob/main/azure-databricks/implementation/bundle/src/gold_products.py): `azure-databricks/implementation/bundle/src/gold_products.py`
- [Real-time analytics](https://github.com/kfprugger/hls-data-accelerator/blob/main/azure-databricks/implementation/bundle/src/gates_streams.py): `azure-databricks/implementation/bundle/src/gates_streams.py`
- [Data agents](https://github.com/kfprugger/hls-data-accelerator/blob/main/orchestrator/activities/deploy_data_agents.py): `orchestrator/activities/deploy_data_agents.py`

### Analytics and action

- [Health command center](https://github.com/kfprugger/hls-data-accelerator/blob/main/rayfin-health-command-center/src/App.tsx): `rayfin-health-command-center/src/App.tsx`
- [Clinical triage app](https://github.com/kfprugger/hls-data-accelerator/blob/main/rayfin-clinical-triage-app/src/App.tsx): `rayfin-clinical-triage-app/src/App.tsx`
- [Deployment evaluation](https://github.com/kfprugger/hls-data-accelerator/blob/main/eval/deployment_eval_harness.py): `eval/deployment_eval_harness.py`

### Other components

- **Operator**
- **Azure and Fabric**

## Connections

- Operator → Deploy wizard: configures deployment (evidence: `README.md`)
- Deploy wizard → UI API client: starts deployment (evidence: `orchestrator-ui/src/pages/DeployWizard.tsx`)
- UI API client → Local orchestrator: calls backend (evidence: `README.md`)
- Local orchestrator → Deployment activities: runs activities (evidence: `orchestrator/local_server.py`)
- Durable Functions → Deployment activities: orchestrates
- Local orchestrator → PowerShell invocation: invokes (evidence: `orchestrator/local_server.py`)
- Local orchestrator → Deployment validation: validates deployment (evidence: `orchestrator/local_server.py`)
- Shared UI state → UI API client: loads status (evidence: `orchestrator-ui/src/AppState.tsx`)
- Phase monitor → UI API client: requests progress (evidence: `orchestrator-ui/src/pages/PhaseMonitor.tsx`)
- Deployment history → UI API client: requests history (evidence: `orchestrator-ui/src/pages/DeploymentHistory.tsx`)
- Teardown controls → UI API client: requests teardown (evidence: `orchestrator-ui/src/pages/TeardownView.tsx`)
- Phase monitor → UI mock data: uses fallback data (evidence: `orchestrator-ui/src/pages/PhaseMonitor.tsx`)
- Deployment activities → FHIR ingestion: deploys ingestion
- Deployment activities → DICOM ingestion: deploys imaging
- Deployment activities → Device telemetry: deploys emulator
- Deployment activities → Claims processing: deploys claims
- Deployment activities → HDS pipelines: triggers pipelines (evidence: `README.md`)
- HDS pipelines → Fabric API client: uses API client (evidence: `orchestrator/activities/deploy_hds_pipelines.py`)
- Deployment activities → Fabric API client: configures Fabric (evidence: `orchestrator/activities/deploy_hds_pipelines.py`)
- FHIR ingestion → Azure and Fabric: loads clinical data (evidence: `README.md`)
- DICOM ingestion → Azure and Fabric: stages imaging data (evidence: `README.md`)
- Device telemetry → Azure and Fabric: sends device events (evidence: `README.md`)
- Claims processing → Gold products: materializes claims
- HDS pipelines → Gold products: feeds lakehouse products
- Azure and Fabric → Real-time analytics: routes event streams (evidence: `README.md`)
- Gold products → Health command center: supplies Gold analytics (evidence: `rayfin-health-command-center/src/App.tsx`)
- Gold products → Data agents: supports agent data (evidence: `README.md`)
- Azure and Fabric → Clinical triage app: hosts triage app
- Deployment validation → Deployment evaluation: checks deployment
