# kiru6006/cardio-discharge-summary-ai-agent architecture

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

- Interactive diagram: https://gitdiagram.com/kiru6006/cardio-discharge-summary-ai-agent
- Repository: https://github.com/kiru6006/cardio-discharge-summary-ai-agent

## Overview

Cardio Discharge Summary AI Agent is a clinician-facing platform for turning patient records, lab reports, examinations, and telemetry into reviewed cardiology discharge or consultation summaries. The main workflow is document intake, clinical extraction and validation, summary generation, physician review/approval, then export; the product also supports longitudinal timelines and visit comparison, medication reconciliation, guideline checks, critical alerts, and audit history. The workflow wiring and several backend calls are visible in excerpts; other documented capabilities are represented at subsystem level where their implementation was not sampled.

Main entry points: [`frontend/src/pages/PatientDetailPage.tsx`](https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/frontend/src/pages/PatientDetailPage.tsx) (Patient workspace), [`backend/agents/nodes/node_03_extract.py`](https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/backend/agents/nodes/node_03_extract.py) (Clinical extraction), [`frontend/src/services/api.ts`](https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/frontend/src/services/api.ts) (API client), [`backend/app/services/summary_service.py`](https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/backend/app/services/summary_service.py) (Summary generation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clinical_ui["Clinical workspace"]
  node_web_app["Web application<br/>[App.tsx]"]
  node_patient_workspace["Patient workspace"]
  node_summary_review["Summary review<br/>[SummaryView.tsx]"]
  node_timeline["Clinical timeline<br/>[TimelineView.tsx]"]
  node_visit_comparison["Visit comparison"]
  node_medications["Medication reconciliation<br/>[MedTable.tsx]"]
  node_audit_ui["Audit history<br/>[AuditLog.tsx]"]
end

subgraph group_intake["Clinical intake"]
  node_document_intake["Document intake<br/>[UploadZone.tsx]"]
  node_extraction_review["Extraction review"]
  node_document_service["Document processing"]
end

subgraph group_summary["Summary workflow"]
  node_agent_workflow["Clinical workflow"]
  node_extraction["Clinical extraction<br/>[node_03_extract.py]"]
  node_lab_prompt["Lab extraction prompt"]
  node_validation["Clinical validation"]
  node_summary_service["Summary generation<br/>[summary_service.py]"]
end

subgraph group_backend["API and persistence"]
  node_api_client["API client<br/>[api.ts]"]
  node_api_app["FastAPI application<br/>[main.py]"]
  node_database[("Clinical database<br/>[database.py]")]
  node_pdf_export["PDF export"]
end

node_clinician(("Clinician"))

node_clinician -->|"uses"| node_web_app
node_web_app -.->|"presents"| node_patient_workspace
node_patient_workspace -.->|"uploads records"| node_document_intake
node_document_intake -.->|"submits documents"| node_api_client
node_extraction_review -->|"loads and accepts"| node_api_client
node_api_client -.->|"calls API"| node_api_app
node_api_app -->|"creates tables"| node_database
node_api_app -.->|"routes document requests"| node_document_service
node_document_service -->|"extracts clinical data"| node_extraction
node_agent_workflow -->|"dispatches"| node_extraction
node_agent_workflow -->|"dispatches"| node_validation
node_extraction -->|"uses prompt"| node_lab_prompt
node_extraction -->|"validates labs"| node_validation
node_summary_service -->|"runs workflow"| node_agent_workflow
node_summary_service -.->|"persists summary"| node_database
node_summary_service -->|"exports PDF"| node_pdf_export
node_patient_workspace -.->|"reviews summary"| node_summary_review
node_summary_review -.->|"saves review"| node_api_client
node_patient_workspace -.->|"views milestones"| node_timeline
node_patient_workspace -.->|"compares visits"| node_visit_comparison
node_patient_workspace -.->|"reconciles medications"| node_medications
node_patient_workspace -.->|"reviews audit"| node_audit_ui

click node_web_app "https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/frontend/src/App.tsx"
click node_patient_workspace "https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/frontend/src/pages/PatientDetailPage.tsx"
click node_document_intake "https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/frontend/src/components/documents/UploadZone.tsx"
click node_extraction_review "https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/frontend/src/components/documents/ExtractionReviewModal.tsx"
click node_document_service "https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/backend/app/services/document_service.py"
click node_agent_workflow "https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/backend/agents/workflows/discharge_workflow.py"
click node_extraction "https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/backend/agents/nodes/node_03_extract.py"
click node_lab_prompt "https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/backend/agents/prompts/extract_lab_report.py"
click node_validation "https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/backend/agents/nodes/node_03_5_validate.py"
click node_summary_service "https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/backend/app/services/summary_service.py"
click node_summary_review "https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/frontend/src/components/summary/SummaryView.tsx"
click node_timeline "https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/frontend/src/components/timeline/TimelineView.tsx"
click node_visit_comparison "https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/frontend/src/pages/CompareVisitsPage.tsx"
click node_medications "https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/frontend/src/components/medications/MedTable.tsx"
click node_audit_ui "https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/frontend/src/components/audit/AuditLog.tsx"
click node_api_client "https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/frontend/src/services/api.ts"
click node_api_app "https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/backend/app/main.py"
click node_database "https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/backend/app/database.py"
click node_pdf_export "https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/backend/app/services/pdf_export_service.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_web_app,node_patient_workspace,node_summary_review,node_timeline,node_visit_comparison,node_medications,node_audit_ui toneBlue
class node_document_intake,node_extraction_review,node_document_service toneAmber
class node_agent_workflow,node_extraction,node_lab_prompt,node_validation,node_summary_service toneMint
class node_api_client,node_api_app,node_database,node_pdf_export toneRose
class node_clinician toneIndigo
```

## Components

### Clinical workspace

- [Web application](https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Patient workspace](https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/frontend/src/pages/PatientDetailPage.tsx): `frontend/src/pages/PatientDetailPage.tsx`
- [Summary review](https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/frontend/src/components/summary/SummaryView.tsx): `frontend/src/components/summary/SummaryView.tsx`
- [Clinical timeline](https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/frontend/src/components/timeline/TimelineView.tsx): `frontend/src/components/timeline/TimelineView.tsx`
- [Visit comparison](https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/frontend/src/pages/CompareVisitsPage.tsx): `frontend/src/pages/CompareVisitsPage.tsx`
- [Medication reconciliation](https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/frontend/src/components/medications/MedTable.tsx): `frontend/src/components/medications/MedTable.tsx`
- [Audit history](https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/frontend/src/components/audit/AuditLog.tsx): `frontend/src/components/audit/AuditLog.tsx`

### Clinical intake

- [Document intake](https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/frontend/src/components/documents/UploadZone.tsx): `frontend/src/components/documents/UploadZone.tsx`
- [Extraction review](https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/frontend/src/components/documents/ExtractionReviewModal.tsx): `frontend/src/components/documents/ExtractionReviewModal.tsx`
- [Document processing](https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/backend/app/services/document_service.py): `backend/app/services/document_service.py`

### Summary workflow

- [Clinical workflow](https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/backend/agents/workflows/discharge_workflow.py): `backend/agents/workflows/discharge_workflow.py`
- [Clinical extraction](https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/backend/agents/nodes/node_03_extract.py): `backend/agents/nodes/node_03_extract.py`
- [Lab extraction prompt](https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/backend/agents/prompts/extract_lab_report.py): `backend/agents/prompts/extract_lab_report.py`
- [Clinical validation](https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/backend/agents/nodes/node_03_5_validate.py): `backend/agents/nodes/node_03_5_validate.py`
- [Summary generation](https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/backend/app/services/summary_service.py): `backend/app/services/summary_service.py`

### API and persistence

- [API client](https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`
- [FastAPI application](https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/backend/app/main.py): `backend/app/main.py`
- [Clinical database](https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/backend/app/database.py): `backend/app/database.py`
- [PDF export](https://github.com/kiru6006/cardio-discharge-summary-ai-agent/blob/main/backend/app/services/pdf_export_service.py): `backend/app/services/pdf_export_service.py`

### Other components

- **Clinician**

## Connections

- Clinician → Web application: uses (evidence: `README.md`)
- Web application → Patient workspace: presents
- Patient workspace → Document intake: uploads records
- Document intake → API client: submits documents
- Extraction review → API client: loads and accepts (evidence: `frontend/src/components/documents/ExtractionReviewModal.tsx`)
- API client → FastAPI application: calls API
- FastAPI application → Clinical database: creates tables (evidence: `backend/app/main.py`)
- FastAPI application → Document processing: routes document requests
- Document processing → Clinical extraction: extracts clinical data (evidence: `backend/app/services/document_service.py`)
- Clinical workflow → Clinical extraction: dispatches (evidence: `backend/agents/workflows/discharge_workflow.py`)
- Clinical workflow → Clinical validation: dispatches (evidence: `backend/agents/workflows/discharge_workflow.py`)
- Clinical extraction → Lab extraction prompt: uses prompt (evidence: `backend/agents/nodes/node_03_extract.py`)
- Clinical extraction → Clinical validation: validates labs (evidence: `backend/agents/nodes/node_03_extract.py`)
- Summary generation → Clinical workflow: runs workflow (evidence: `backend/app/services/summary_service.py`)
- Summary generation → Clinical database: persists summary
- Summary generation → PDF export: exports PDF (evidence: `backend/app/services/summary_service.py`)
- Patient workspace → Summary review: reviews summary
- Summary review → API client: saves review
- Patient workspace → Clinical timeline: views milestones
- Patient workspace → Visit comparison: compares visits
- Patient workspace → Medication reconciliation: reconciles medications
- Patient workspace → Audit history: reviews audit
