# sumityesane/intelligent-clinical-document-assistant architecture

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

- Interactive diagram: https://gitdiagram.com/sumityesane/intelligent-clinical-document-assistant
- Repository: https://github.com/sumityesane/intelligent-clinical-document-assistant

## Overview

MedDoc AI is a clinical-document workspace: users upload PDFs or TXT files, browse and manage indexed records, then ask citation-backed questions with conversation continuity and optional SSE streaming. The backend coordinates document ingestion, metadata, retrieval, and response generation; the frontend provides the dashboard, upload, library, and chat experience. The README documents ChromaDB and Gemini integrations. Some subsystem links below rely on explicit README statements or SOURCE INDEX references because their implementation excerpts were not provided.

Main entry points: [`backend/services/__init__.py`](https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/backend/services/__init__.py) (Service coordinator), [`backend/main.py`](https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/backend/main.py) (FastAPI application), [`frontend/src/App.tsx`](https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/frontend/src/App.tsx) (Workspace dashboard), [`frontend/src/components/ChatInterface.tsx`](https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/frontend/src/components/ChatInterface.tsx) (Clinical chat)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["Workspace UI"]
  node_app["Workspace dashboard<br/>[App.tsx]"]
  node_upload_ui["File upload<br/>[FileUpload.tsx]"]
  node_library_ui["Document library<br/>[DocumentList.tsx]"]
  node_chat_ui["Clinical chat<br/>[ChatInterface.tsx]"]
  node_citations_ui["Source citations"]
end

subgraph group_api["API Layer"]
  node_doc_api["Document API client<br/>[documents.ts]"]
  node_query_api["Query API client<br/>[query.ts]"]
  node_backend["FastAPI application<br/>[main.py]"]
  node_upload_route["Upload endpoint<br/>[upload.py]"]
  node_documents_route["Document endpoints<br/>[documents.py]"]
  node_query_route["Query endpoints<br/>[query.py]"]
  node_health_route["Health endpoint<br/>[health.py]"]
end

subgraph group_processing["Document and AI Processing"]
  node_service["Service coordinator<br/>[__init__.py]"]
  node_ingestion["Document ingestion<br/>[ingestion.py]"]
  node_rag["RAG pipeline<br/>[rag.py]"]
end

subgraph group_state["Application State"]
  node_metadata[("Document metadata<br/>[document_store.py]")]
  node_conversations[("Conversation history")]
end

subgraph group_integrations["External Services"]
  node_chroma[("ChromaDB vectors")]
  node_gemini["Gemini generation"]
end

node_user(("Clinical user"))

node_user -->|"uses"| node_app
node_app -->|"renders"| node_upload_ui
node_app -->|"renders"| node_library_ui
node_app -->|"renders"| node_chat_ui
node_app -->|"loads, deletes"| node_doc_api
node_upload_ui -->|"uploads"| node_doc_api
node_chat_ui -->|"sends queries"| node_query_api
node_chat_ui -->|"renders"| node_citations_ui
node_doc_api -.->|"HTTP requests"| node_backend
node_query_api -->|"HTTP and SSE"| node_backend
node_backend -->|"registers"| node_upload_route
node_backend -->|"registers"| node_documents_route
node_backend -->|"registers"| node_query_route
node_backend -->|"registers"| node_health_route
node_backend -->|"initializes"| node_service
node_upload_route -->|"delegates"| node_service
node_documents_route -->|"delegates"| node_service
node_query_route -->|"delegates"| node_service
node_health_route -.->|"checks status"| node_service
node_service -->|"ingests files"| node_ingestion
node_service -->|"runs queries"| node_rag
node_service -->|"reads, updates"| node_metadata
node_service -->|"stores turns"| node_conversations
node_ingestion -->|"writes chunks"| node_chroma
node_rag -->|"retrieves chunks"| node_chroma
node_rag -->|"generates answers"| node_gemini

click node_app "https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/frontend/src/App.tsx"
click node_upload_ui "https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/frontend/src/components/FileUpload.tsx"
click node_library_ui "https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/frontend/src/components/DocumentList.tsx"
click node_chat_ui "https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/frontend/src/components/ChatInterface.tsx"
click node_citations_ui "https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/frontend/src/components/SourceCitations.tsx"
click node_doc_api "https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/frontend/src/api/documents.ts"
click node_query_api "https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/frontend/src/api/query.ts"
click node_backend "https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/backend/main.py"
click node_upload_route "https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/backend/routers/upload.py"
click node_documents_route "https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/backend/routers/documents.py"
click node_query_route "https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/backend/routers/query.py"
click node_health_route "https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/backend/routers/health.py"
click node_service "https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/backend/services/__init__.py"
click node_ingestion "https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/backend/services/ingestion.py"
click node_rag "https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/backend/services/rag.py"
click node_metadata "https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/backend/services/document_store.py"
click node_conversations "https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/backend/services/conversation_store.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_app,node_upload_ui,node_library_ui,node_chat_ui,node_citations_ui,node_user toneBlue
class node_doc_api,node_query_api,node_backend,node_upload_route,node_documents_route,node_query_route,node_health_route toneAmber
class node_service,node_ingestion,node_rag toneMint
class node_metadata,node_conversations toneRose
class node_chroma,node_gemini toneIndigo
```

## Components

### Workspace UI

- [Workspace dashboard](https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [File upload](https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/frontend/src/components/FileUpload.tsx): `frontend/src/components/FileUpload.tsx`
- [Document library](https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/frontend/src/components/DocumentList.tsx): `frontend/src/components/DocumentList.tsx`
- [Clinical chat](https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/frontend/src/components/ChatInterface.tsx): `frontend/src/components/ChatInterface.tsx`
- [Source citations](https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/frontend/src/components/SourceCitations.tsx): `frontend/src/components/SourceCitations.tsx`

### API Layer

- [Document API client](https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/frontend/src/api/documents.ts): `frontend/src/api/documents.ts`
- [Query API client](https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/frontend/src/api/query.ts): `frontend/src/api/query.ts`
- [FastAPI application](https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/backend/main.py): `backend/main.py`
- [Upload endpoint](https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/backend/routers/upload.py): `backend/routers/upload.py`
- [Document endpoints](https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/backend/routers/documents.py): `backend/routers/documents.py`
- [Query endpoints](https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/backend/routers/query.py): `backend/routers/query.py`
- [Health endpoint](https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/backend/routers/health.py): `backend/routers/health.py`

### Document and AI Processing

- [Service coordinator](https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/backend/services/__init__.py): `backend/services/__init__.py`
- [Document ingestion](https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/backend/services/ingestion.py): `backend/services/ingestion.py`
- [RAG pipeline](https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/backend/services/rag.py): `backend/services/rag.py`

### Application State

- [Document metadata](https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/backend/services/document_store.py): `backend/services/document_store.py`
- [Conversation history](https://github.com/sumityesane/intelligent-clinical-document-assistant/blob/main/backend/services/conversation_store.py): `backend/services/conversation_store.py`

### External Services

- **ChromaDB vectors**
- **Gemini generation**

### Other components

- **Clinical user**

## Connections

- Clinical user → Workspace dashboard: uses (evidence: `README.md`)
- Workspace dashboard → File upload: renders (evidence: `frontend/src/App.tsx`)
- Workspace dashboard → Document library: renders (evidence: `frontend/src/App.tsx`)
- Workspace dashboard → Clinical chat: renders (evidence: `frontend/src/App.tsx`)
- Workspace dashboard → Document API client: loads, deletes (evidence: `frontend/src/App.tsx`)
- File upload → Document API client: uploads (evidence: `frontend/src/components/FileUpload.tsx`)
- Clinical chat → Query API client: sends queries (evidence: `frontend/src/components/ChatInterface.tsx`)
- Clinical chat → Source citations: renders (evidence: `frontend/src/components/ChatInterface.tsx`)
- Document API client → FastAPI application: HTTP requests (evidence: `README.md`)
- Query API client → FastAPI application: HTTP and SSE (evidence: `frontend/src/api/query.ts`)
- FastAPI application → Upload endpoint: registers (evidence: `backend/main.py`)
- FastAPI application → Document endpoints: registers (evidence: `backend/main.py`)
- FastAPI application → Query endpoints: registers (evidence: `backend/main.py`)
- FastAPI application → Health endpoint: registers (evidence: `backend/main.py`)
- FastAPI application → Service coordinator: initializes (evidence: `backend/main.py`)
- Upload endpoint → Service coordinator: delegates (evidence: `backend/routers/upload.py`)
- Document endpoints → Service coordinator: delegates (evidence: `backend/routers/documents.py`)
- Query endpoints → Service coordinator: delegates (evidence: `backend/routers/query.py`)
- Health endpoint → Service coordinator: checks status (evidence: `backend/routers/health.py`)
- Service coordinator → Document ingestion: ingests files (evidence: `backend/services/__init__.py`)
- Service coordinator → RAG pipeline: runs queries (evidence: `backend/services/__init__.py`)
- Service coordinator → Document metadata: reads, updates (evidence: `backend/services/__init__.py`)
- Service coordinator → Conversation history: stores turns (evidence: `backend/services/__init__.py`)
- Document ingestion → ChromaDB vectors: writes chunks (evidence: `backend/services/ingestion.py`)
- RAG pipeline → ChromaDB vectors: retrieves chunks (evidence: `backend/services/rag.py`)
- RAG pipeline → Gemini generation: generates answers (evidence: `README.md`)
