# suriya1230/3d-brain-tumor-detection-and-visualization architecture

> Architecture diagram of the GitHub repository suriya1230/3d-brain-tumor-detection-and-visualization, 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/suriya1230/3d-brain-tumor-detection-and-visualization
- Repository: https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization

## Overview

NeuroEvidence is a local glioma MRI segmentation and evidence-grounded explanation application. Its main workflow uploads four MRI volumes, segments the tumour, serves 3D assets, then lets users request a clinical explanation or ask follow-up questions against retrieved evidence. The evidence subsystem also ingests and indexes reference material and supports restricted live search. The graph reflects documented routes and SOURCE INDEX references; unsampled implementation details are omitted where call ownership is uncertain.

Main entry points: [`backend/app/knowledge_routes.py`](https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/knowledge_routes.py) (Case knowledge routes), [`backend/app/main.py`](https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/main.py) (FastAPI application), [`backend/app/knowledge/cli.py`](https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/knowledge/cli.py) (Corpus builder), [`frontend/components/EvidencePanel.jsx`](https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/frontend/components/EvidencePanel.jsx) (Evidence panel)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Browser experience"]
  node_upload["MRI upload<br/>[UploadPanel.jsx]"]
  node_case_page["Case page<br/>[page.js]"]
  node_viewer["3D viewer<br/>[BrainViewer.jsx]"]
  node_visuals["Brain visuals<br/>[brainVisuals.jsx]"]
  node_evidence_ui["Evidence panel<br/>[EvidencePanel.jsx]"]
  node_streaming["Streaming text<br/>[StreamingText.jsx]"]
end

subgraph group_imaging["MRI segmentation"]
  node_api["FastAPI application<br/>[main.py]"]
  node_segmenter["MRI segmenter<br/>[inference.py]"]
  node_meshing["Mesh generation<br/>[meshing.py]"]
end

subgraph group_evidence["Evidence answering"]
  node_knowledge_routes["Case knowledge routes"]
  node_planner["Question planner<br/>[planner.py]"]
  node_clinical["Clinical agent<br/>[clinical_agent.py]"]
  node_imaging_agent["Imaging agent<br/>[imaging_agent.py]"]
  node_hybrid["Hybrid retrieval<br/>[fuse.py]"]
  node_bm25["BM25 search<br/>[bm25.py]"]
  node_dense["Dense search<br/>[dense.py]"]
  node_web["Restricted web search<br/>[web_search.py]"]
  node_answering["Citation-gated answer<br/>[answering.py]"]
  node_validator["Evidence validator<br/>[validator.py]"]
  node_schema["Evidence contracts<br/>[schema.py]"]
end

subgraph group_corpus["Evidence corpus"]
  node_cli["Corpus builder<br/>[cli.py]"]
  node_nci["NCI PDQ ingest<br/>[nci_pdq.py]"]
  node_pubmed["PubMed ingest<br/>[pubmed.py]"]
  node_chunking["Chunk preparation<br/>[chunking.py]"]
end

node_user(("User"))
node_llm["LLM providers"]

node_user -->|"selects scans"| node_upload
node_upload -->|"uploads volumes"| node_api
node_api -->|"runs inference"| node_segmenter
node_api -->|"creates meshes"| node_meshing
node_api -->|"returns assets"| node_case_page
node_case_page -->|"shows case"| node_viewer
node_viewer -->|"uses primitives"| node_visuals
node_user -->|"asks question"| node_evidence_ui
node_evidence_ui -->|"requests explanation"| node_knowledge_routes
node_evidence_ui -->|"renders text"| node_streaming
node_api -->|"mounts routes"| node_knowledge_routes
node_knowledge_routes -->|"routes question"| node_planner
node_knowledge_routes -->|"builds explanation"| node_clinical
node_knowledge_routes -->|"dispatches imaging"| node_imaging_agent
node_knowledge_routes -->|"retrieves evidence"| node_hybrid
node_knowledge_routes -.->|"searches optionally"| node_web
node_knowledge_routes -->|"generates answer"| node_answering
node_knowledge_routes -->|"checks claims"| node_validator
node_clinical -->|"requests explanation"| node_llm
node_answering -->|"generates claims"| node_llm
node_answering -->|"uses contracts"| node_schema
node_validator -->|"validates claims"| node_schema
node_hybrid -->|"runs lexical search"| node_bm25
node_hybrid -->|"runs vector search"| node_dense
node_cli -->|"ingests documents"| node_nci
node_cli -->|"ingests articles"| node_pubmed
node_cli -->|"chunks sources"| node_chunking
node_chunking -->|"produces chunks"| node_schema

click node_upload "https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/frontend/components/UploadPanel.jsx"
click node_case_page "https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/frontend/app/page.js"
click node_viewer "https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/frontend/components/BrainViewer.jsx"
click node_visuals "https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/frontend/components/brainVisuals.jsx"
click node_evidence_ui "https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/frontend/components/EvidencePanel.jsx"
click node_streaming "https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/frontend/components/StreamingText.jsx"
click node_api "https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/main.py"
click node_segmenter "https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/inference.py"
click node_meshing "https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/meshing.py"
click node_knowledge_routes "https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/knowledge_routes.py"
click node_planner "https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/knowledge/agents/planner.py"
click node_clinical "https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/knowledge/agents/clinical_agent.py"
click node_imaging_agent "https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/knowledge/agents/imaging_agent.py"
click node_hybrid "https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/knowledge/index/fuse.py"
click node_bm25 "https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/knowledge/index/bm25.py"
click node_dense "https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/knowledge/index/dense.py"
click node_web "https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/knowledge/web_search.py"
click node_answering "https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/knowledge/answering.py"
click node_validator "https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/knowledge/validator.py"
click node_schema "https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/knowledge/schema.py"
click node_cli "https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/knowledge/cli.py"
click node_nci "https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/knowledge/ingest/nci_pdq.py"
click node_pubmed "https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/knowledge/ingest/pubmed.py"
click node_chunking "https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/knowledge/chunking.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_upload,node_case_page,node_viewer,node_visuals,node_evidence_ui,node_streaming,node_user toneBlue
class node_api,node_segmenter,node_meshing toneAmber
class node_knowledge_routes,node_planner,node_clinical,node_imaging_agent,node_hybrid,node_bm25,node_dense,node_web,node_answering,node_validator,node_schema toneMint
class node_cli,node_nci,node_pubmed,node_chunking toneRose
class node_llm toneIndigo
```

## Components

### Browser experience

- [MRI upload](https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/frontend/components/UploadPanel.jsx): `frontend/components/UploadPanel.jsx`
- [Case page](https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/frontend/app/page.js): `frontend/app/page.js`
- [3D viewer](https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/frontend/components/BrainViewer.jsx): `frontend/components/BrainViewer.jsx`
- [Brain visuals](https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/frontend/components/brainVisuals.jsx): `frontend/components/brainVisuals.jsx`
- [Evidence panel](https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/frontend/components/EvidencePanel.jsx): `frontend/components/EvidencePanel.jsx`
- [Streaming text](https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/frontend/components/StreamingText.jsx): `frontend/components/StreamingText.jsx`

### MRI segmentation

- [FastAPI application](https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/main.py): `backend/app/main.py`
- [MRI segmenter](https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/inference.py): `backend/app/inference.py`
- [Mesh generation](https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/meshing.py): `backend/app/meshing.py`

### Evidence answering

- [Case knowledge routes](https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/knowledge_routes.py): `backend/app/knowledge_routes.py`
- [Question planner](https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/knowledge/agents/planner.py): `backend/app/knowledge/agents/planner.py`
- [Clinical agent](https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/knowledge/agents/clinical_agent.py): `backend/app/knowledge/agents/clinical_agent.py`
- [Imaging agent](https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/knowledge/agents/imaging_agent.py): `backend/app/knowledge/agents/imaging_agent.py`
- [Hybrid retrieval](https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/knowledge/index/fuse.py): `backend/app/knowledge/index/fuse.py`
- [BM25 search](https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/knowledge/index/bm25.py): `backend/app/knowledge/index/bm25.py`
- [Dense search](https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/knowledge/index/dense.py): `backend/app/knowledge/index/dense.py`
- [Restricted web search](https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/knowledge/web_search.py): `backend/app/knowledge/web_search.py`
- [Citation-gated answer](https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/knowledge/answering.py): `backend/app/knowledge/answering.py`
- [Evidence validator](https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/knowledge/validator.py): `backend/app/knowledge/validator.py`
- [Evidence contracts](https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/knowledge/schema.py): `backend/app/knowledge/schema.py`

### Evidence corpus

- [Corpus builder](https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/knowledge/cli.py): `backend/app/knowledge/cli.py`
- [NCI PDQ ingest](https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/knowledge/ingest/nci_pdq.py): `backend/app/knowledge/ingest/nci_pdq.py`
- [PubMed ingest](https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/knowledge/ingest/pubmed.py): `backend/app/knowledge/ingest/pubmed.py`
- [Chunk preparation](https://github.com/suriya1230/3d-brain-tumor-detection-and-visualization/blob/main/backend/app/knowledge/chunking.py): `backend/app/knowledge/chunking.py`

### Other components

- **User**
- **LLM providers**

## Connections

- User → MRI upload: selects scans
- MRI upload → FastAPI application: uploads volumes
- FastAPI application → MRI segmenter: runs inference (evidence: `backend/app/main.py`)
- FastAPI application → Mesh generation: creates meshes (evidence: `backend/app/main.py`)
- FastAPI application → Case page: returns assets
- Case page → 3D viewer: shows case
- 3D viewer → Brain visuals: uses primitives (evidence: `frontend/components/BrainViewer.jsx`)
- User → Evidence panel: asks question
- Evidence panel → Case knowledge routes: requests explanation
- Evidence panel → Streaming text: renders text (evidence: `frontend/components/EvidencePanel.jsx`)
- FastAPI application → Case knowledge routes: mounts routes (evidence: `backend/app/main.py`)
- Case knowledge routes → Question planner: routes question (evidence: `backend/app/knowledge_routes.py`)
- Case knowledge routes → Clinical agent: builds explanation (evidence: `backend/app/knowledge_routes.py`)
- Case knowledge routes → Imaging agent: dispatches imaging (evidence: `backend/app/knowledge_routes.py`)
- Case knowledge routes → Hybrid retrieval: retrieves evidence (evidence: `backend/app/knowledge_routes.py`)
- Case knowledge routes → Restricted web search: searches optionally (evidence: `backend/app/knowledge_routes.py`)
- Case knowledge routes → Citation-gated answer: generates answer (evidence: `backend/app/knowledge_routes.py`)
- Case knowledge routes → Evidence validator: checks claims (evidence: `backend/app/knowledge_routes.py`)
- Clinical agent → LLM providers: requests explanation (evidence: `backend/app/knowledge/agents/clinical_agent.py`)
- Citation-gated answer → LLM providers: generates claims
- Citation-gated answer → Evidence contracts: uses contracts (evidence: `backend/app/knowledge/answering.py`)
- Evidence validator → Evidence contracts: validates claims (evidence: `backend/app/knowledge/validator.py`)
- Hybrid retrieval → BM25 search: runs lexical search (evidence: `backend/app/knowledge/index/fuse.py`)
- Hybrid retrieval → Dense search: runs vector search (evidence: `backend/app/knowledge/index/fuse.py`)
- Corpus builder → NCI PDQ ingest: ingests documents (evidence: `backend/app/knowledge/cli.py`)
- Corpus builder → PubMed ingest: ingests articles (evidence: `backend/app/knowledge/cli.py`)
- Corpus builder → Chunk preparation: chunks sources (evidence: `backend/app/knowledge/cli.py`)
- Chunk preparation → Evidence contracts: produces chunks (evidence: `backend/app/knowledge/chunking.py`)
