# kaxarovv/rt-queue architecture

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

- Interactive diagram: https://gitdiagram.com/kaxarovv/rt-queue
- Repository: https://github.com/kaxarovv/rt-queue

## Overview

RT Queue supports clinical staff managing radiotherapy intake, prioritization, and scheduling. The main workflow is document upload and extraction, clinician review, case/queue management, then proposed start dates or machine-slot booking. Patient CRUD and dashboard reporting are additional capabilities. The graph includes the available frontend as well as the documented backend; some service relationships rely on the SOURCE INDEX or README rather than inspected implementation excerpts. README notes that several scheduling capabilities are demo-stage, and OCR for scanned PDFs is not implemented.

Main entry points: [`backend/app/domains/documents/router.py`](https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/documents/router.py) (Document endpoints), [`frontend/src/App.tsx`](https://github.com/kaxarovv/rt-queue/blob/main/frontend/src/App.tsx) (Screen navigation), [`backend/app/domains/treatment_cases/models.py`](https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/treatment_cases/models.py) (Treatment cases), [`frontend/src/shared/api/client.ts`](https://github.com/kaxarovv/rt-queue/blob/main/frontend/src/shared/api/client.ts) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Clinical interface"]
  node_app["Screen navigation<br/>[App.tsx]"]
  node_documents_ui["Document review<br/>[ReviewPanel.tsx]"]
  node_patients_ui["Patient management<br/>[PatientsScreen.tsx]"]
  node_queue_ui["Queue view<br/>[QueueScreen.tsx]"]
  node_schedule_ui["Schedule view"]
  node_dashboard_ui["Dashboard"]
  node_api["API client<br/>[client.ts]"]
end

subgraph group_intake["Document intake"]
  node_documents_api["Document endpoints<br/>[router.py]"]
  node_text_extract["PDF text extraction"]
  node_regex_extract["Regex extraction"]
  node_llm_extract["Clinical extraction"]
  node_conflict["Signal conflict detection"]
  node_storage["Document storage<br/>[storage_service.py]"]
end

subgraph group_clinical["Patients and queue"]
  node_patients_api["Patient endpoints<br/>[router.py]"]
  node_case_api["Treatment case endpoints<br/>[router.py]"]
  node_queue_service["Queue operations<br/>[queue_service.py]"]
  node_priority["Priority scoring<br/>[priority_engine.py]"]
  node_patient_model["Patient records<br/>[models.py]"]
  node_case_model["Treatment cases<br/>[models.py]"]
end

subgraph group_schedule["Scheduling"]
  node_schedule_api["Scheduling endpoints<br/>[router.py]"]
  node_booking["Slot booking<br/>[booking_service.py]"]
  node_capacity["Capacity service"]
  node_displacement["Displacement candidates"]
  node_schedule_model["Slots and sessions<br/>[models.py]"]
end

subgraph group_platform["Application platform"]
  node_backend["HTTP application<br/>[main.py]"]
  node_database[("Database sessions<br/>[database.py]")]
end

node_staff(("Clinical staff"))
node_llm_service["LLM service"]
node_object_store[("S3-compatible store")]
node_postgres[("PostgreSQL")]

node_staff -->|"uses"| node_app
node_app -->|"opens"| node_documents_ui
node_app -->|"opens"| node_patients_ui
node_app -->|"opens"| node_queue_ui
node_app -->|"opens"| node_schedule_ui
node_app -->|"opens"| node_dashboard_ui
node_documents_ui -->|"requests"| node_api
node_patients_ui -->|"requests"| node_api
node_queue_ui -->|"requests"| node_api
node_schedule_ui -->|"requests"| node_api
node_dashboard_ui -->|"requests"| node_api
node_api -->|"calls endpoints"| node_backend
node_backend -->|"registers"| node_documents_api
node_backend -->|"registers"| node_patients_api
node_backend -->|"registers"| node_case_api
node_backend -->|"registers"| node_schedule_api
node_documents_api -->|"extracts text"| node_text_extract
node_documents_api -->|"extracts entities"| node_regex_extract
node_documents_api -->|"extracts fields"| node_llm_extract
node_documents_api -->|"checks conflicts"| node_conflict
node_documents_api -->|"stores files"| node_storage
node_storage -->|"reads and writes"| node_object_store
node_llm_extract -.->|"calls extraction"| node_llm_service
node_patients_api -->|"queries"| node_patient_model
node_case_api -->|"delegates"| node_queue_service
node_case_api -->|"computes score"| node_priority
node_queue_service -->|"scores cases"| node_priority
node_queue_service -->|"queries"| node_case_model
node_patient_model -->|"relates cases"| node_case_model
node_schedule_api -->|"delegates booking"| node_booking
node_schedule_api -->|"checks capacity"| node_capacity
node_schedule_api -->|"finds candidates"| node_displacement
node_booking -->|"checks capacity"| node_capacity
node_booking -->|"books slots"| node_schedule_model
node_displacement -->|"queries sessions"| node_schedule_model
node_displacement -->|"compares priority"| node_case_model
node_schedule_api -->|"queries cases"| node_case_model
node_case_model -->|"relates patient"| node_patient_model
node_case_model -->|"relates sessions"| node_schedule_model
node_documents_api -->|"uses sessions"| node_database
node_patients_api -->|"uses sessions"| node_database
node_database -->|"connects"| node_postgres

click node_app "https://github.com/kaxarovv/rt-queue/blob/main/frontend/src/App.tsx"
click node_documents_ui "https://github.com/kaxarovv/rt-queue/blob/main/frontend/src/features/document-upload/ReviewPanel.tsx"
click node_patients_ui "https://github.com/kaxarovv/rt-queue/blob/main/frontend/src/features/patients/PatientsScreen.tsx"
click node_queue_ui "https://github.com/kaxarovv/rt-queue/blob/main/frontend/src/features/queue/QueueScreen.tsx"
click node_schedule_ui "https://github.com/kaxarovv/rt-queue/blob/main/frontend/src/features/scheduling/SchedulingScreen.tsx"
click node_dashboard_ui "https://github.com/kaxarovv/rt-queue/blob/main/frontend/src/features/dashboard/DashboardScreen.tsx"
click node_api "https://github.com/kaxarovv/rt-queue/blob/main/frontend/src/shared/api/client.ts"
click node_backend "https://github.com/kaxarovv/rt-queue/blob/main/backend/app/main.py"
click node_documents_api "https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/documents/router.py"
click node_text_extract "https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/documents/text_extraction_service.py"
click node_regex_extract "https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/documents/regex_extraction_service.py"
click node_llm_extract "https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/documents/llm_extraction_service.py"
click node_conflict "https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/documents/conflict_detection.py"
click node_storage "https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/documents/storage_service.py"
click node_patients_api "https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/patients/router.py"
click node_case_api "https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/treatment_cases/router.py"
click node_queue_service "https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/treatment_cases/queue_service.py"
click node_priority "https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/treatment_cases/priority_engine.py"
click node_patient_model "https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/patients/models.py"
click node_case_model "https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/treatment_cases/models.py"
click node_schedule_api "https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/scheduling/router.py"
click node_booking "https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/scheduling/booking_service.py"
click node_capacity "https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/scheduling/capacity_service.py"
click node_displacement "https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/scheduling/displacement_engine.py"
click node_schedule_model "https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/scheduling/models.py"
click node_database "https://github.com/kaxarovv/rt-queue/blob/main/backend/app/core/database.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_documents_ui,node_patients_ui,node_queue_ui,node_schedule_ui,node_dashboard_ui,node_api toneBlue
class node_documents_api,node_text_extract,node_regex_extract,node_llm_extract,node_conflict,node_storage,node_object_store,node_postgres toneAmber
class node_patients_api,node_case_api,node_queue_service,node_priority,node_patient_model,node_case_model toneMint
class node_schedule_api,node_booking,node_capacity,node_displacement,node_schedule_model toneRose
class node_backend,node_database,node_staff,node_llm_service toneIndigo
```

## Components

### Clinical interface

- [Screen navigation](https://github.com/kaxarovv/rt-queue/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Document review](https://github.com/kaxarovv/rt-queue/blob/main/frontend/src/features/document-upload/ReviewPanel.tsx): `frontend/src/features/document-upload/ReviewPanel.tsx`
- [Patient management](https://github.com/kaxarovv/rt-queue/blob/main/frontend/src/features/patients/PatientsScreen.tsx): `frontend/src/features/patients/PatientsScreen.tsx`
- [Queue view](https://github.com/kaxarovv/rt-queue/blob/main/frontend/src/features/queue/QueueScreen.tsx): `frontend/src/features/queue/QueueScreen.tsx`
- [Schedule view](https://github.com/kaxarovv/rt-queue/blob/main/frontend/src/features/scheduling/SchedulingScreen.tsx): `frontend/src/features/scheduling/SchedulingScreen.tsx`
- [Dashboard](https://github.com/kaxarovv/rt-queue/blob/main/frontend/src/features/dashboard/DashboardScreen.tsx): `frontend/src/features/dashboard/DashboardScreen.tsx`
- [API client](https://github.com/kaxarovv/rt-queue/blob/main/frontend/src/shared/api/client.ts): `frontend/src/shared/api/client.ts`

### Document intake

- [Document endpoints](https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/documents/router.py): `backend/app/domains/documents/router.py`
- [PDF text extraction](https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/documents/text_extraction_service.py): `backend/app/domains/documents/text_extraction_service.py`
- [Regex extraction](https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/documents/regex_extraction_service.py): `backend/app/domains/documents/regex_extraction_service.py`
- [Clinical extraction](https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/documents/llm_extraction_service.py): `backend/app/domains/documents/llm_extraction_service.py`
- [Signal conflict detection](https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/documents/conflict_detection.py): `backend/app/domains/documents/conflict_detection.py`
- [Document storage](https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/documents/storage_service.py): `backend/app/domains/documents/storage_service.py`

### Patients and queue

- [Patient endpoints](https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/patients/router.py): `backend/app/domains/patients/router.py`
- [Treatment case endpoints](https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/treatment_cases/router.py): `backend/app/domains/treatment_cases/router.py`
- [Queue operations](https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/treatment_cases/queue_service.py): `backend/app/domains/treatment_cases/queue_service.py`
- [Priority scoring](https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/treatment_cases/priority_engine.py): `backend/app/domains/treatment_cases/priority_engine.py`
- [Patient records](https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/patients/models.py): `backend/app/domains/patients/models.py`
- [Treatment cases](https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/treatment_cases/models.py): `backend/app/domains/treatment_cases/models.py`

### Scheduling

- [Scheduling endpoints](https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/scheduling/router.py): `backend/app/domains/scheduling/router.py`
- [Slot booking](https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/scheduling/booking_service.py): `backend/app/domains/scheduling/booking_service.py`
- [Capacity service](https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/scheduling/capacity_service.py): `backend/app/domains/scheduling/capacity_service.py`
- [Displacement candidates](https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/scheduling/displacement_engine.py): `backend/app/domains/scheduling/displacement_engine.py`
- [Slots and sessions](https://github.com/kaxarovv/rt-queue/blob/main/backend/app/domains/scheduling/models.py): `backend/app/domains/scheduling/models.py`

### Application platform

- [HTTP application](https://github.com/kaxarovv/rt-queue/blob/main/backend/app/main.py): `backend/app/main.py`
- [Database sessions](https://github.com/kaxarovv/rt-queue/blob/main/backend/app/core/database.py): `backend/app/core/database.py`

### Other components

- **Clinical staff**
- **LLM service**
- **S3-compatible store**
- **PostgreSQL**

## Connections

- Clinical staff → Screen navigation: uses (evidence: `frontend/src/App.tsx`)
- Screen navigation → Document review: opens (evidence: `frontend/src/App.tsx`)
- Screen navigation → Patient management: opens (evidence: `frontend/src/App.tsx`)
- Screen navigation → Queue view: opens (evidence: `frontend/src/App.tsx`)
- Screen navigation → Schedule view: opens (evidence: `frontend/src/App.tsx`)
- Screen navigation → Dashboard: opens (evidence: `frontend/src/App.tsx`)
- Document review → API client: requests (evidence: `frontend/src/features/document-upload/ReviewPanel.tsx`)
- Patient management → API client: requests (evidence: `frontend/src/features/patients/PatientsScreen.tsx`)
- Queue view → API client: requests (evidence: `frontend/src/features/queue/QueueScreen.tsx`)
- Schedule view → API client: requests (evidence: `frontend/src/features/scheduling/SchedulingScreen.tsx`)
- Dashboard → API client: requests (evidence: `frontend/src/features/dashboard/DashboardScreen.tsx`)
- API client → HTTP application: calls endpoints (evidence: `frontend/src/shared/api/client.ts`)
- HTTP application → Document endpoints: registers (evidence: `backend/app/main.py`)
- HTTP application → Patient endpoints: registers (evidence: `backend/app/main.py`)
- HTTP application → Treatment case endpoints: registers (evidence: `backend/app/main.py`)
- HTTP application → Scheduling endpoints: registers (evidence: `backend/app/main.py`)
- Document endpoints → PDF text extraction: extracts text (evidence: `backend/app/domains/documents/router.py`)
- Document endpoints → Regex extraction: extracts entities (evidence: `backend/app/domains/documents/router.py`)
- Document endpoints → Clinical extraction: extracts fields (evidence: `backend/app/domains/documents/router.py`)
- Document endpoints → Signal conflict detection: checks conflicts (evidence: `backend/app/domains/documents/router.py`)
- Document endpoints → Document storage: stores files (evidence: `backend/app/domains/documents/router.py`)
- Document storage → S3-compatible store: reads and writes (evidence: `backend/app/domains/documents/storage_service.py`)
- Clinical extraction → LLM service: calls extraction (evidence: `README.md`)
- Patient endpoints → Patient records: queries (evidence: `backend/app/domains/patients/router.py`)
- Treatment case endpoints → Queue operations: delegates (evidence: `backend/app/domains/treatment_cases/router.py`)
- Treatment case endpoints → Priority scoring: computes score (evidence: `backend/app/domains/treatment_cases/router.py`)
- Queue operations → Priority scoring: scores cases (evidence: `backend/app/domains/treatment_cases/queue_service.py`)
- Queue operations → Treatment cases: queries (evidence: `backend/app/domains/treatment_cases/queue_service.py`)
- Patient records → Treatment cases: relates cases (evidence: `backend/app/domains/patients/models.py`)
- Scheduling endpoints → Slot booking: delegates booking (evidence: `backend/app/domains/scheduling/router.py`)
- Scheduling endpoints → Capacity service: checks capacity (evidence: `backend/app/domains/scheduling/router.py`)
- Scheduling endpoints → Displacement candidates: finds candidates (evidence: `backend/app/domains/scheduling/router.py`)
- Slot booking → Capacity service: checks capacity (evidence: `backend/app/domains/scheduling/booking_service.py`)
- Slot booking → Slots and sessions: books slots (evidence: `backend/app/domains/scheduling/booking_service.py`)
- Displacement candidates → Slots and sessions: queries sessions (evidence: `backend/app/domains/scheduling/displacement_engine.py`)
- Displacement candidates → Treatment cases: compares priority (evidence: `backend/app/domains/scheduling/displacement_engine.py`)
- Scheduling endpoints → Treatment cases: queries cases (evidence: `backend/app/domains/scheduling/router.py`)
- Treatment cases → Patient records: relates patient (evidence: `backend/app/domains/treatment_cases/models.py`)
- Treatment cases → Slots and sessions: relates sessions (evidence: `backend/app/domains/treatment_cases/models.py`)
- Document endpoints → Database sessions: uses sessions (evidence: `backend/app/domains/documents/router.py`)
- Patient endpoints → Database sessions: uses sessions (evidence: `backend/app/domains/patients/router.py`)
- Database sessions → PostgreSQL: connects (evidence: `backend/app/core/database.py`)
