# kishorpatilaws-gith/clinical-assistance architecture

> Architecture diagram of the GitHub repository kishorpatilaws-gith/clinical-assistance, 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/kishorpatilaws-gith/clinical-assistance
- Repository: https://github.com/kishorpatilaws-gith/clinical-assistance

## Overview

ClinicalAI is a clinical records and document knowledge application. Clinicians use the web UI to manage patients and documents, then ask questions over indexed material; the API coordinates records, document storage and processing, and retrieval-grounded answers. The Python service extracts and indexes documents and serves search, while the API adds PII redaction and Bedrock generation. The README is empty, so capabilities are inferred from the supplied tree and excerpts; dashed links mark likely runtime connections not evidenced by an excerpt.

Main entry points: [`backend/ClinicalAI.Api/ClinicalAI.Api/Program.cs`](https://github.com/kishorpatilaws-gith/clinical-assistance/blob/main/backend/ClinicalAI.Api/ClinicalAI.Api/Program.cs) (API runtime), [`frontend/clinical-ai-ui/app`](https://github.com/kishorpatilaws-gith/clinical-assistance/tree/main/frontend/clinical-ai-ui/app) (Clinical UI), [`document-processor/main.py`](https://github.com/kishorpatilaws-gith/clinical-assistance/blob/main/document-processor/main.py) (Processing service), [`backend/ClinicalAI.Api/ClinicalAI.Api/Controllers/DocumentController.cs`](https://github.com/kishorpatilaws-gith/clinical-assistance/blob/main/backend/ClinicalAI.Api/ClinicalAI.Api/Controllers/DocumentController.cs) (Document endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Clinician UI"]
  node_ui["Clinical UI"]
  node_auth["Authentication<br/>[auth.ts]"]
end

subgraph group_api["Clinical API"]
  node_api_runtime["API runtime<br/>[Program.cs]"]
  node_patient_api["Patient endpoints"]
  node_document_api["Document endpoints"]
  node_rag_api["RAG endpoint<br/>[RagController.cs]"]
  node_records[("Clinical records")]
  node_summary["Patient summaries"]
  node_audit["Audit logging"]
end

subgraph group_ingestion["Document processing"]
  node_storage["Object storage"]
  node_index_queue["Indexing queue"]
  node_index_worker["Indexing worker"]
  node_indexer["Document indexer"]
  node_processor_client["Processor client"]
  node_processor["Processing service<br/>[main.py]"]
  node_chunking["Text chunking<br/>[chunking.py]"]
end

subgraph group_rag["RAG and AI"]
  node_embedding["Embeddings<br/>[embedding.py]"]
  node_vectorstore[("Vector search<br/>[vectorstore.py]")]
  node_rag_service["RAG orchestration"]
  node_redaction["PII redaction"]
  node_bedrock["Bedrock generation"]
end

node_clinician(("Clinician"))

node_clinician -.->|"uses"| node_ui
node_ui -.->|"authenticates"| node_auth
node_ui -.->|"requests records"| node_patient_api
node_ui -.->|"uploads documents"| node_document_api
node_ui -.->|"asks questions"| node_rag_api
node_api_runtime -->|"configures"| node_records
node_api_runtime -->|"registers"| node_storage
node_api_runtime -->|"configures"| node_processor_client
node_api_runtime -->|"registers"| node_index_queue
node_api_runtime -->|"registers"| node_indexer
node_api_runtime -->|"registers"| node_index_worker
node_api_runtime -->|"registers"| node_rag_service
node_api_runtime -->|"registers"| node_summary
node_api_runtime -->|"registers"| node_audit
node_index_worker -->|"updates status"| node_records
node_index_worker -.->|"dispatches"| node_indexer
node_indexer -->|"updates document"| node_records
node_indexer -.->|"requests indexing"| node_processor_client
node_processor_client -->|"calls over HTTP"| node_processor
node_processor -->|"chunks text"| node_chunking
node_processor -->|"creates vectors"| node_embedding
node_processor -->|"indexes and searches"| node_vectorstore
node_vectorstore -->|"embeds queries"| node_embedding
node_rag_service -->|"redacts question"| node_redaction
node_rag_service -->|"searches passages"| node_processor_client
node_rag_service -->|"generates answer"| node_bedrock
node_patient_api -->|"reads and writes"| node_records
node_document_api -->|"reads and writes"| node_records
node_document_api -.->|"uses storage"| node_storage
node_rag_api -.->|"invokes"| node_rag_service

click node_ui "https://github.com/kishorpatilaws-gith/clinical-assistance/tree/main/frontend/clinical-ai-ui/app"
click node_auth "https://github.com/kishorpatilaws-gith/clinical-assistance/blob/main/frontend/clinical-ai-ui/lib/auth.ts"
click node_api_runtime "https://github.com/kishorpatilaws-gith/clinical-assistance/blob/main/backend/ClinicalAI.Api/ClinicalAI.Api/Program.cs"
click node_patient_api "https://github.com/kishorpatilaws-gith/clinical-assistance/blob/main/backend/ClinicalAI.Api/ClinicalAI.Api/Controllers/PatientController.cs"
click node_document_api "https://github.com/kishorpatilaws-gith/clinical-assistance/blob/main/backend/ClinicalAI.Api/ClinicalAI.Api/Controllers/DocumentController.cs"
click node_rag_api "https://github.com/kishorpatilaws-gith/clinical-assistance/blob/main/backend/ClinicalAI.Api/ClinicalAI.Api/Controllers/RagController.cs"
click node_processor "https://github.com/kishorpatilaws-gith/clinical-assistance/blob/main/document-processor/main.py"
click node_chunking "https://github.com/kishorpatilaws-gith/clinical-assistance/blob/main/document-processor/chunking.py"
click node_embedding "https://github.com/kishorpatilaws-gith/clinical-assistance/blob/main/document-processor/embedding.py"
click node_vectorstore "https://github.com/kishorpatilaws-gith/clinical-assistance/blob/main/document-processor/vectorstore.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_ui,node_auth toneBlue
class node_api_runtime,node_patient_api,node_document_api,node_rag_api,node_records,node_summary,node_audit toneAmber
class node_storage,node_index_queue,node_index_worker,node_indexer,node_processor_client,node_processor,node_chunking toneMint
class node_embedding,node_vectorstore,node_rag_service,node_redaction,node_bedrock toneRose
class node_clinician toneIndigo
```

## Components

### Clinician UI

- [Clinical UI](https://github.com/kishorpatilaws-gith/clinical-assistance/tree/main/frontend/clinical-ai-ui/app): `frontend/clinical-ai-ui/app`
- [Authentication](https://github.com/kishorpatilaws-gith/clinical-assistance/blob/main/frontend/clinical-ai-ui/lib/auth.ts): `frontend/clinical-ai-ui/lib/auth.ts`

### Clinical API

- [API runtime](https://github.com/kishorpatilaws-gith/clinical-assistance/blob/main/backend/ClinicalAI.Api/ClinicalAI.Api/Program.cs): `backend/ClinicalAI.Api/ClinicalAI.Api/Program.cs`
- [Patient endpoints](https://github.com/kishorpatilaws-gith/clinical-assistance/blob/main/backend/ClinicalAI.Api/ClinicalAI.Api/Controllers/PatientController.cs): `backend/ClinicalAI.Api/ClinicalAI.Api/Controllers/PatientController.cs`
- [Document endpoints](https://github.com/kishorpatilaws-gith/clinical-assistance/blob/main/backend/ClinicalAI.Api/ClinicalAI.Api/Controllers/DocumentController.cs): `backend/ClinicalAI.Api/ClinicalAI.Api/Controllers/DocumentController.cs`
- [RAG endpoint](https://github.com/kishorpatilaws-gith/clinical-assistance/blob/main/backend/ClinicalAI.Api/ClinicalAI.Api/Controllers/RagController.cs): `backend/ClinicalAI.Api/ClinicalAI.Api/Controllers/RagController.cs`
- **Clinical records**
- **Patient summaries**
- **Audit logging**

### Document processing

- **Object storage**
- **Indexing queue**
- **Indexing worker**
- **Document indexer**
- **Processor client**
- [Processing service](https://github.com/kishorpatilaws-gith/clinical-assistance/blob/main/document-processor/main.py): `document-processor/main.py`
- [Text chunking](https://github.com/kishorpatilaws-gith/clinical-assistance/blob/main/document-processor/chunking.py): `document-processor/chunking.py`

### RAG and AI

- [Embeddings](https://github.com/kishorpatilaws-gith/clinical-assistance/blob/main/document-processor/embedding.py): `document-processor/embedding.py`
- [Vector search](https://github.com/kishorpatilaws-gith/clinical-assistance/blob/main/document-processor/vectorstore.py): `document-processor/vectorstore.py`
- **RAG orchestration**
- **PII redaction**
- **Bedrock generation**

### Other components

- **Clinician**

## Connections

- Clinician → Clinical UI: uses
- Clinical UI → Authentication: authenticates
- Clinical UI → Patient endpoints: requests records
- Clinical UI → Document endpoints: uploads documents
- Clinical UI → RAG endpoint: asks questions
- API runtime → Clinical records: configures (evidence: `backend/ClinicalAI.Api/ClinicalAI.Api/Program.cs`)
- API runtime → Object storage: registers (evidence: `backend/ClinicalAI.Api/ClinicalAI.Api/Program.cs`)
- API runtime → Processor client: configures (evidence: `backend/ClinicalAI.Api/ClinicalAI.Api/Program.cs`)
- API runtime → Indexing queue: registers (evidence: `backend/ClinicalAI.Api/ClinicalAI.Api/Program.cs`)
- API runtime → Document indexer: registers (evidence: `backend/ClinicalAI.Api/ClinicalAI.Api/Program.cs`)
- API runtime → Indexing worker: registers (evidence: `backend/ClinicalAI.Api/ClinicalAI.Api/Program.cs`)
- API runtime → RAG orchestration: registers
- API runtime → Patient summaries: registers (evidence: `backend/ClinicalAI.Api/ClinicalAI.Api/Program.cs`)
- API runtime → Audit logging: registers (evidence: `backend/ClinicalAI.Api/ClinicalAI.Api/Program.cs`)
- Indexing worker → Clinical records: updates status
- Indexing worker → Document indexer: dispatches
- Document indexer → Clinical records: updates document
- Document indexer → Processor client: requests indexing
- Processor client → Processing service: calls over HTTP (evidence: `document-processor/main.py`)
- Processing service → Text chunking: chunks text (evidence: `document-processor/main.py`)
- Processing service → Embeddings: creates vectors (evidence: `document-processor/main.py`)
- Processing service → Vector search: indexes and searches (evidence: `document-processor/main.py`)
- Vector search → Embeddings: embeds queries (evidence: `document-processor/vectorstore.py`)
- RAG orchestration → PII redaction: redacts question
- RAG orchestration → Processor client: searches passages
- RAG orchestration → Bedrock generation: generates answer
- Patient endpoints → Clinical records: reads and writes (evidence: `backend/ClinicalAI.Api/ClinicalAI.Api/Controllers/PatientController.cs`)
- Document endpoints → Clinical records: reads and writes (evidence: `backend/ClinicalAI.Api/ClinicalAI.Api/Controllers/DocumentController.cs`)
- Document endpoints → Object storage: uses storage
- RAG endpoint → RAG orchestration: invokes
