# jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis architecture

> Architecture diagram of the GitHub repository jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis
- Repository: https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis

## Overview

This is a clinician-and-student brain-tumor diagnosis and education platform. Clinicians manage patients and scans, receive classification, segmentation, Grad-CAM and symbolic explanations, then review longitudinal studies and reports; students learn anatomy, practice diagnosis, and use an AI tutor. The graph keeps the documented federated-learning capability distinct. Some feature routes and integrations are documented but not fully sampled, so their links are marked unverified rather than asserting implementation details.

Main entry points: [`frontend_simple/visualizer/src/App.js`](https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/frontend_simple/visualizer/src/App.js) (Web app routing), [`frontend_simple/visualizer/src/utils/api.js`](https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/frontend_simple/visualizer/src/utils/api.js) (API client), [`frontend_simple/visualizer/src/pages/PatientDetail.js`](https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/frontend_simple/visualizer/src/pages/PatientDetail.js) (Patient studies), [`backend_simple/main.py`](https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/backend_simple/main.py) (FastAPI application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_app["Web app routing<br/>[App.js]"]
  node_login["Role login<br/>[LoginPage.js]"]
  node_api["API client<br/>[api.js]"]
end

subgraph group_clinical["Clinical workflow"]
  node_dashboard["Patient dashboard<br/>[DoctorDashboard.js]"]
  node_patient["Patient studies<br/>[PatientDetail.js]"]
  node_analysis["Scan analysis view<br/>[AnalysisPage.js]"]
  node_mask["Mask correction<br/>[MaskEditor.js]"]
  node_genomics["Genomic context<br/>[GenomicPanel.js]"]
  node_report["Clinical report"]
  node_federated["Federated learning"]
end

subgraph group_intelligence["AI analysis"]
  node_pipeline["Image AI pipeline"]
  node_reasoner["Symbolic reasoning<br/>[reasoner_simple.py]"]
  node_xai["Visual explanations<br/>[xai_simple.py]"]
end

subgraph group_education["Education"]
  node_learning["Learning lab<br/>[LearningLabPage.js]"]
  node_anatomy["Brain anatomy"]
  node_challenge["Diagnosis challenge"]
  node_quiz_api["Quiz API<br/>[quiz_routes.py]"]
  node_tutor["NeuroEdu tutor<br/>[NeuroEduBot.js]"]
  node_chat_api["Tutor API<br/>[chatbot_routes.py]"]
end

subgraph group_platform["Platform services"]
  node_patient_routes["Patient and study API<br/>[patient_routes.py]"]
  node_database[("MongoDB records<br/>[database.py]")]
  node_auth["Authentication<br/>[auth.py]"]
  node_server["FastAPI application<br/>[main.py]"]
end

node_clinician(("Clinician"))
node_student(("Student"))
node_gemini{{"Google Gemini"}}

node_clinician -->|"uses"| node_app
node_student -->|"uses"| node_app
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_patient
node_app -->|"routes to"| node_analysis
node_app -->|"routes to"| node_learning
node_app -->|"routes to"| node_federated
node_login -->|"requests through"| node_api
node_dashboard -->|"requests through"| node_api
node_patient -->|"requests through"| node_api
node_analysis -->|"requests through"| node_api
node_patient -->|"renders"| node_mask
node_patient -->|"renders"| node_genomics
node_patient -->|"renders"| node_report
node_api -.->|"calls API"| node_server
node_server -->|"registers"| node_auth
node_server -->|"registers"| node_patient_routes
node_server -->|"registers"| node_quiz_api
node_server -->|"registers"| node_chat_api
node_auth -->|"reads users"| node_database
node_patient_routes -->|"reads and writes"| node_database
node_patient_routes -->|"runs analysis"| node_pipeline
node_pipeline -->|"requests reasoning"| node_reasoner
node_pipeline -->|"requests visualizations"| node_xai
node_learning -.->|"offers anatomy"| node_anatomy
node_learning -->|"renders"| node_challenge
node_challenge -->|"requests through"| node_api
node_quiz_api -->|"runs case analysis"| node_pipeline
node_app -->|"renders"| node_tutor
node_tutor -->|"requests through"| node_api
node_chat_api -->|"generates responses"| node_gemini
node_federated -.->|"requests through"| node_api

click node_app "https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/frontend_simple/visualizer/src/App.js"
click node_login "https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/frontend_simple/visualizer/src/pages/LoginPage.js"
click node_api "https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/frontend_simple/visualizer/src/utils/api.js"
click node_dashboard "https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/frontend_simple/visualizer/src/pages/DoctorDashboard.js"
click node_patient "https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/frontend_simple/visualizer/src/pages/PatientDetail.js"
click node_analysis "https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/frontend_simple/visualizer/src/pages/AnalysisPage.js"
click node_mask "https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/frontend_simple/visualizer/src/components/MaskEditor.js"
click node_genomics "https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/frontend_simple/visualizer/src/components/GenomicPanel.js"
click node_report "https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/frontend_simple/visualizer/src/components/MedicalReportTemplate.js"
click node_patient_routes "https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/backend_simple/patient_routes.py"
click node_database "https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/backend_simple/database.py"
click node_auth "https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/backend_simple/auth.py"
click node_pipeline "https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/backend_simple/app_simple/ai_pipeline_simple.py"
click node_reasoner "https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/backend_simple/app_simple/reasoner_simple.py"
click node_xai "https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/backend_simple/app_simple/xai_simple.py"
click node_learning "https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/frontend_simple/visualizer/src/pages/LearningLabPage.js"
click node_anatomy "https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/frontend_simple/visualizer/src/pages/BrainAnatomyPage.js"
click node_challenge "https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/frontend_simple/visualizer/src/components/InteractiveDiagnosis.js"
click node_quiz_api "https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/backend_simple/quiz_routes.py"
click node_tutor "https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/frontend_simple/visualizer/src/components/NeuroEduBot.js"
click node_chat_api "https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/backend_simple/chatbot_routes.py"
click node_federated "https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/frontend_simple/visualizer/src/pages/FederatedDashboard.js"
click node_server "https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/backend_simple/main.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_login,node_api toneBlue
class node_dashboard,node_patient,node_analysis,node_mask,node_genomics,node_report,node_federated toneAmber
class node_pipeline,node_reasoner,node_xai toneMint
class node_learning,node_anatomy,node_challenge,node_quiz_api,node_tutor,node_chat_api toneRose
class node_patient_routes,node_database,node_auth,node_server,node_clinician,node_student,node_gemini toneIndigo
```

## Components

### User experience

- [Web app routing](https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/frontend_simple/visualizer/src/App.js): `frontend_simple/visualizer/src/App.js`
- [Role login](https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/frontend_simple/visualizer/src/pages/LoginPage.js): `frontend_simple/visualizer/src/pages/LoginPage.js`
- [API client](https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/frontend_simple/visualizer/src/utils/api.js): `frontend_simple/visualizer/src/utils/api.js`

### Clinical workflow

- [Patient dashboard](https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/frontend_simple/visualizer/src/pages/DoctorDashboard.js): `frontend_simple/visualizer/src/pages/DoctorDashboard.js`
- [Patient studies](https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/frontend_simple/visualizer/src/pages/PatientDetail.js): `frontend_simple/visualizer/src/pages/PatientDetail.js`
- [Scan analysis view](https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/frontend_simple/visualizer/src/pages/AnalysisPage.js): `frontend_simple/visualizer/src/pages/AnalysisPage.js`
- [Mask correction](https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/frontend_simple/visualizer/src/components/MaskEditor.js): `frontend_simple/visualizer/src/components/MaskEditor.js`
- [Genomic context](https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/frontend_simple/visualizer/src/components/GenomicPanel.js): `frontend_simple/visualizer/src/components/GenomicPanel.js`
- [Clinical report](https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/frontend_simple/visualizer/src/components/MedicalReportTemplate.js): `frontend_simple/visualizer/src/components/MedicalReportTemplate.js`
- [Federated learning](https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/frontend_simple/visualizer/src/pages/FederatedDashboard.js): `frontend_simple/visualizer/src/pages/FederatedDashboard.js`

### AI analysis

- [Image AI pipeline](https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/backend_simple/app_simple/ai_pipeline_simple.py): `backend_simple/app_simple/ai_pipeline_simple.py`
- [Symbolic reasoning](https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/backend_simple/app_simple/reasoner_simple.py): `backend_simple/app_simple/reasoner_simple.py`
- [Visual explanations](https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/backend_simple/app_simple/xai_simple.py): `backend_simple/app_simple/xai_simple.py`

### Education

- [Learning lab](https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/frontend_simple/visualizer/src/pages/LearningLabPage.js): `frontend_simple/visualizer/src/pages/LearningLabPage.js`
- [Brain anatomy](https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/frontend_simple/visualizer/src/pages/BrainAnatomyPage.js): `frontend_simple/visualizer/src/pages/BrainAnatomyPage.js`
- [Diagnosis challenge](https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/frontend_simple/visualizer/src/components/InteractiveDiagnosis.js): `frontend_simple/visualizer/src/components/InteractiveDiagnosis.js`
- [Quiz API](https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/backend_simple/quiz_routes.py): `backend_simple/quiz_routes.py`
- [NeuroEdu tutor](https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/frontend_simple/visualizer/src/components/NeuroEduBot.js): `frontend_simple/visualizer/src/components/NeuroEduBot.js`
- [Tutor API](https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/backend_simple/chatbot_routes.py): `backend_simple/chatbot_routes.py`

### Platform services

- [Patient and study API](https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/backend_simple/patient_routes.py): `backend_simple/patient_routes.py`
- [MongoDB records](https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/backend_simple/database.py): `backend_simple/database.py`
- [Authentication](https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/backend_simple/auth.py): `backend_simple/auth.py`
- [FastAPI application](https://github.com/jayanthc6/neurosymbolic-ai-system-for-explainable-brain-tumour-analysis/blob/main/backend_simple/main.py): `backend_simple/main.py`

### Other components

- **Clinician**
- **Student**
- **Google Gemini**

## Connections

- Clinician → Web app routing: uses
- Student → Web app routing: uses
- Web app routing → Role login: routes to (evidence: `frontend_simple/visualizer/src/App.js`)
- Web app routing → Patient dashboard: routes to (evidence: `frontend_simple/visualizer/src/App.js`)
- Web app routing → Patient studies: routes to (evidence: `frontend_simple/visualizer/src/App.js`)
- Web app routing → Scan analysis view: routes to (evidence: `frontend_simple/visualizer/src/App.js`)
- Web app routing → Learning lab: routes to (evidence: `frontend_simple/visualizer/src/App.js`)
- Web app routing → Federated learning: routes to (evidence: `frontend_simple/visualizer/src/App.js`)
- Role login → API client: requests through (evidence: `frontend_simple/visualizer/src/pages/LoginPage.js`)
- Patient dashboard → API client: requests through (evidence: `frontend_simple/visualizer/src/pages/DoctorDashboard.js`)
- Patient studies → API client: requests through (evidence: `frontend_simple/visualizer/src/pages/PatientDetail.js`)
- Scan analysis view → API client: requests through (evidence: `frontend_simple/visualizer/src/pages/AnalysisPage.js`)
- Patient studies → Mask correction: renders (evidence: `frontend_simple/visualizer/src/pages/PatientDetail.js`)
- Patient studies → Genomic context: renders (evidence: `frontend_simple/visualizer/src/pages/PatientDetail.js`)
- Patient studies → Clinical report: renders (evidence: `frontend_simple/visualizer/src/pages/PatientDetail.js`)
- API client → FastAPI application: calls API
- FastAPI application → Authentication: registers (evidence: `backend_simple/main.py`)
- FastAPI application → Patient and study API: registers (evidence: `backend_simple/main.py`)
- FastAPI application → Quiz API: registers (evidence: `backend_simple/main.py`)
- FastAPI application → Tutor API: registers (evidence: `backend_simple/main.py`)
- Authentication → MongoDB records: reads users (evidence: `backend_simple/auth.py`)
- Patient and study API → MongoDB records: reads and writes (evidence: `backend_simple/patient_routes.py`)
- Patient and study API → Image AI pipeline: runs analysis (evidence: `backend_simple/patient_routes.py`)
- Image AI pipeline → Symbolic reasoning: requests reasoning (evidence: `backend_simple/app_simple/ai_pipeline_simple.py`)
- Image AI pipeline → Visual explanations: requests visualizations (evidence: `backend_simple/app_simple/ai_pipeline_simple.py`)
- Learning lab → Brain anatomy: offers anatomy
- Learning lab → Diagnosis challenge: renders (evidence: `frontend_simple/visualizer/src/pages/LearningLabPage.js`)
- Diagnosis challenge → API client: requests through (evidence: `frontend_simple/visualizer/src/components/InteractiveDiagnosis.js`)
- Quiz API → Image AI pipeline: runs case analysis (evidence: `backend_simple/quiz_routes.py`)
- Web app routing → NeuroEdu tutor: renders (evidence: `frontend_simple/visualizer/src/App.js`)
- NeuroEdu tutor → API client: requests through (evidence: `frontend_simple/visualizer/src/components/NeuroEduBot.js`)
- Tutor API → Google Gemini: generates responses (evidence: `backend_simple/chatbot_routes.py`)
- Federated learning → API client: requests through
