# raj-shukla-05/neuroguard-ai architecture

> Architecture diagram of the GitHub repository raj-shukla-05/neuroguard-ai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/raj-shukla-05/neuroguard-ai
- Repository: https://github.com/raj-shukla-05/neuroguard-ai

## Overview

NeuroGuard AI is a privacy-first stroke-recovery monitoring prototype: patients perform browser-based movement checks, the API records aggregate metrics and derives personal-baseline trends and alerts, and clinicians review triage, assignments, appointments, and consent-shared reports. The map includes README-documented capabilities whose exact implementation files were not sampled, using existing tree paths. Edges are limited to relationships shown in excerpts, the source index, or README; unsampled details are not inferred.

Main entry points: [`backend/src/server.js`](https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/server.js) (REST API), [`frontend/src/App.jsx`](https://github.com/raj-shukla-05/neuroguard-ai/blob/main/frontend/src/App.jsx) (Role-based app), [`frontend/src/components/CameraAssessment.jsx`](https://github.com/raj-shukla-05/neuroguard-ai/blob/main/frontend/src/components/CameraAssessment.jsx) (Camera assessment), [`backend/src/trendEngine.js`](https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/trendEngine.js) (Baseline and alerts)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Patient and clinician app"]
  node_app["Role-based app<br/>[App.jsx]"]
  node_patient_views["Patient views"]
  node_doctor_views["Doctor triage<br/>[DoctorPage.jsx]"]
  node_assessment_page["Assessment page<br/>[AssessmentPage.jsx]"]
  node_appointments_ui["Appointment views"]
  node_doctor_appointments["Clinic scheduling"]
end

subgraph group_assessment["Movement assessment"]
  node_camera["Camera assessment"]
  node_pose["Browser pose tracking<br/>[pose.js]"]
  node_exercise_defs["Movement tests<br/>[exercises.js]"]
  node_motion_figure["Motion Lab figure<br/>[MotionFigure.jsx]"]
  node_scoring["Metric scoring<br/>[scoring.js]"]
end

subgraph group_clinical["Monitoring and triage"]
  node_trend_engine["Baseline and alerts<br/>[trendEngine.js]"]
  node_assignments[("Exercise assignments<br/>[Assignment.js]")]
  node_gemini["Optional Gemini text<br/>[geminiService.js]"]
end

subgraph group_care["Care coordination"]
  node_appointments["Appointment service"]
  node_appointment_routes["Appointment routes"]
  node_doctor_routes["Doctor and availability<br/>[doctorRoutes.js]"]
  node_notifications["Notifications"]
  node_notification_routes["Notification routes"]
  node_report_sharing["Consent report sharing"]
  node_report_routes["Report routes<br/>[reportRoutes.js]"]
end

subgraph group_platform["API and persistence"]
  node_api_client["REST client<br/>[api.js]"]
  node_api_server["REST API<br/>[server.js]"]
  node_auth["JWT access control<br/>[auth.js]"]
  node_exercise_validation["Exercise validation<br/>[exerciseTypes.js]"]
  node_assessment_records[("Assessment records<br/>[Assessment.js]")]
  node_store[("Memory store<br/>[store.js]")]
  node_mongo[("MongoDB option<br/>[db.js]")]
end

node_patient(("Patient"))
node_doctor(("Doctor"))

node_patient -->|"uses"| node_app
node_doctor -->|"uses"| node_app
node_app -->|"renders"| node_patient_views
node_app -->|"renders"| node_doctor_views
node_app -->|"renders"| node_assessment_page
node_app -->|"renders"| node_appointments_ui
node_app -->|"renders"| node_doctor_appointments
node_patient -->|"performs check"| node_camera
node_assessment_page -->|"hosts"| node_camera
node_camera -->|"tracks pose"| node_pose
node_camera -->|"uses tests"| node_exercise_defs
node_camera -->|"renders"| node_motion_figure
node_exercise_defs -->|"uses"| node_scoring
node_doctor_views -->|"reviews trends"| node_trend_engine
node_patient_views -->|"shows trends"| node_trend_engine
node_camera -->|"submits metrics"| node_api_client
node_app -->|"loads dashboard"| node_api_client
node_api_client -->|"calls API"| node_api_server
node_api_server -->|"protects routes"| node_auth
node_api_server -->|"builds trends"| node_trend_engine
node_api_server -->|"validates type"| node_exercise_validation
node_api_server -->|"uses records"| node_assessment_records
node_api_server -->|"reads and writes"| node_store
node_api_server -->|"manages"| node_assignments
node_trend_engine -->|"analyzes assessments"| node_store
node_trend_engine -.->|"explains findings"| node_gemini
node_api_server -->|"requests explanation"| node_gemini
node_api_server -.->|"connects optionally"| node_mongo
node_doctor -->|"reviews roster"| node_doctor_views
node_doctor_views -->|"prescribes"| node_assignments
node_patient -->|"books visits"| node_appointments_ui
node_doctor -->|"manages slots"| node_doctor_appointments
node_appointments_ui -->|"requests booking"| node_api_client
node_doctor_appointments -->|"requests updates"| node_api_client
node_api_server -->|"mounts routes"| node_appointment_routes
node_api_server -->|"mounts routes"| node_doctor_routes
node_appointment_routes -->|"delegates booking"| node_appointments
node_doctor_routes -->|"gets slots"| node_appointments
node_appointments -->|"creates notices"| node_notifications
node_api_server -->|"mounts routes"| node_notification_routes
node_notification_routes -->|"delegates"| node_notifications
node_patient -->|"controls sharing"| node_report_sharing
node_doctor -->|"views shared report"| node_report_sharing
node_api_server -->|"mounts routes"| node_report_routes
node_report_routes -->|"delegates"| node_report_sharing
node_report_sharing -->|"builds report trends"| node_trend_engine

click node_app "https://github.com/raj-shukla-05/neuroguard-ai/blob/main/frontend/src/App.jsx"
click node_patient_views "https://github.com/raj-shukla-05/neuroguard-ai/blob/main/frontend/src/pages/PatientDashboard.jsx"
click node_doctor_views "https://github.com/raj-shukla-05/neuroguard-ai/blob/main/frontend/src/pages/DoctorPage.jsx"
click node_assessment_page "https://github.com/raj-shukla-05/neuroguard-ai/blob/main/frontend/src/pages/AssessmentPage.jsx"
click node_appointments_ui "https://github.com/raj-shukla-05/neuroguard-ai/blob/main/frontend/src/pages/AppointmentsPage.jsx"
click node_doctor_appointments "https://github.com/raj-shukla-05/neuroguard-ai/blob/main/frontend/src/pages/DoctorAppointmentsPage.jsx"
click node_camera "https://github.com/raj-shukla-05/neuroguard-ai/blob/main/frontend/src/components/CameraAssessment.jsx"
click node_pose "https://github.com/raj-shukla-05/neuroguard-ai/blob/main/frontend/src/lib/pose.js"
click node_exercise_defs "https://github.com/raj-shukla-05/neuroguard-ai/blob/main/frontend/src/lib/exercises.js"
click node_motion_figure "https://github.com/raj-shukla-05/neuroguard-ai/blob/main/frontend/src/components/MotionFigure.jsx"
click node_scoring "https://github.com/raj-shukla-05/neuroguard-ai/blob/main/frontend/src/lib/scoring.js"
click node_api_client "https://github.com/raj-shukla-05/neuroguard-ai/blob/main/frontend/src/lib/api.js"
click node_api_server "https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/server.js"
click node_auth "https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/middleware/auth.js"
click node_exercise_validation "https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/exerciseTypes.js"
click node_assessment_records "https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/models/Assessment.js"
click node_store "https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/store.js"
click node_mongo "https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/db.js"
click node_trend_engine "https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/trendEngine.js"
click node_assignments "https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/models/Assignment.js"
click node_appointments "https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/services/appointmentService.js"
click node_appointment_routes "https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/routes/appointmentRoutes.js"
click node_doctor_routes "https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/routes/doctorRoutes.js"
click node_notifications "https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/services/notificationService.js"
click node_notification_routes "https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/routes/notificationRoutes.js"
click node_report_sharing "https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/services/reportSharingService.js"
click node_report_routes "https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/routes/reportRoutes.js"
click node_gemini "https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/services/geminiService.js"

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_patient_views,node_doctor_views,node_assessment_page,node_appointments_ui,node_doctor_appointments toneBlue
class node_camera,node_pose,node_exercise_defs,node_motion_figure,node_scoring toneAmber
class node_trend_engine,node_assignments,node_gemini toneMint
class node_appointments,node_appointment_routes,node_doctor_routes,node_notifications,node_notification_routes,node_report_sharing,node_report_routes toneRose
class node_api_client,node_api_server,node_auth,node_exercise_validation,node_assessment_records,node_store,node_mongo,node_patient,node_doctor toneIndigo
```

## Components

### Patient and clinician app

- [Role-based app](https://github.com/raj-shukla-05/neuroguard-ai/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Patient views](https://github.com/raj-shukla-05/neuroguard-ai/blob/main/frontend/src/pages/PatientDashboard.jsx): `frontend/src/pages/PatientDashboard.jsx`
- [Doctor triage](https://github.com/raj-shukla-05/neuroguard-ai/blob/main/frontend/src/pages/DoctorPage.jsx): `frontend/src/pages/DoctorPage.jsx`
- [Assessment page](https://github.com/raj-shukla-05/neuroguard-ai/blob/main/frontend/src/pages/AssessmentPage.jsx): `frontend/src/pages/AssessmentPage.jsx`
- [Appointment views](https://github.com/raj-shukla-05/neuroguard-ai/blob/main/frontend/src/pages/AppointmentsPage.jsx): `frontend/src/pages/AppointmentsPage.jsx`
- [Clinic scheduling](https://github.com/raj-shukla-05/neuroguard-ai/blob/main/frontend/src/pages/DoctorAppointmentsPage.jsx): `frontend/src/pages/DoctorAppointmentsPage.jsx`

### Movement assessment

- [Camera assessment](https://github.com/raj-shukla-05/neuroguard-ai/blob/main/frontend/src/components/CameraAssessment.jsx): `frontend/src/components/CameraAssessment.jsx`
- [Browser pose tracking](https://github.com/raj-shukla-05/neuroguard-ai/blob/main/frontend/src/lib/pose.js): `frontend/src/lib/pose.js`
- [Movement tests](https://github.com/raj-shukla-05/neuroguard-ai/blob/main/frontend/src/lib/exercises.js): `frontend/src/lib/exercises.js`
- [Motion Lab figure](https://github.com/raj-shukla-05/neuroguard-ai/blob/main/frontend/src/components/MotionFigure.jsx): `frontend/src/components/MotionFigure.jsx`
- [Metric scoring](https://github.com/raj-shukla-05/neuroguard-ai/blob/main/frontend/src/lib/scoring.js): `frontend/src/lib/scoring.js`

### Monitoring and triage

- [Baseline and alerts](https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/trendEngine.js): `backend/src/trendEngine.js`
- [Exercise assignments](https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/models/Assignment.js): `backend/src/models/Assignment.js`
- [Optional Gemini text](https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/services/geminiService.js): `backend/src/services/geminiService.js`

### Care coordination

- [Appointment service](https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/services/appointmentService.js): `backend/src/services/appointmentService.js`
- [Appointment routes](https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/routes/appointmentRoutes.js): `backend/src/routes/appointmentRoutes.js`
- [Doctor and availability](https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/routes/doctorRoutes.js): `backend/src/routes/doctorRoutes.js`
- [Notifications](https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/services/notificationService.js): `backend/src/services/notificationService.js`
- [Notification routes](https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/routes/notificationRoutes.js): `backend/src/routes/notificationRoutes.js`
- [Consent report sharing](https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/services/reportSharingService.js): `backend/src/services/reportSharingService.js`
- [Report routes](https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/routes/reportRoutes.js): `backend/src/routes/reportRoutes.js`

### API and persistence

- [REST client](https://github.com/raj-shukla-05/neuroguard-ai/blob/main/frontend/src/lib/api.js): `frontend/src/lib/api.js`
- [REST API](https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/server.js): `backend/src/server.js`
- [JWT access control](https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/middleware/auth.js): `backend/src/middleware/auth.js`
- [Exercise validation](https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/exerciseTypes.js): `backend/src/exerciseTypes.js`
- [Assessment records](https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/models/Assessment.js): `backend/src/models/Assessment.js`
- [Memory store](https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/store.js): `backend/src/store.js`
- [MongoDB option](https://github.com/raj-shukla-05/neuroguard-ai/blob/main/backend/src/db.js): `backend/src/db.js`

### Other components

- **Patient**
- **Doctor**

## Connections

- Patient → Role-based app: uses (evidence: `README.md`)
- Doctor → Role-based app: uses (evidence: `README.md`)
- Role-based app → Patient views: renders (evidence: `frontend/src/App.jsx`)
- Role-based app → Doctor triage: renders (evidence: `frontend/src/App.jsx`)
- Role-based app → Assessment page: renders (evidence: `frontend/src/App.jsx`)
- Role-based app → Appointment views: renders (evidence: `frontend/src/App.jsx`)
- Role-based app → Clinic scheduling: renders (evidence: `frontend/src/App.jsx`)
- Patient → Camera assessment: performs check (evidence: `README.md`)
- Assessment page → Camera assessment: hosts
- Camera assessment → Browser pose tracking: tracks pose (evidence: `frontend/src/components/CameraAssessment.jsx`)
- Camera assessment → Movement tests: uses tests (evidence: `frontend/src/components/CameraAssessment.jsx`)
- Camera assessment → Motion Lab figure: renders (evidence: `frontend/src/components/CameraAssessment.jsx`)
- Movement tests → Metric scoring: uses (evidence: `frontend/src/lib/exercises.js`)
- Doctor triage → Baseline and alerts: reviews trends (evidence: `README.md`)
- Patient views → Baseline and alerts: shows trends (evidence: `README.md`)
- Camera assessment → REST client: submits metrics (evidence: `README.md`)
- Role-based app → REST client: loads dashboard (evidence: `frontend/src/App.jsx`)
- REST client → REST API: calls API (evidence: `README.md`)
- REST API → JWT access control: protects routes (evidence: `backend/src/server.js`)
- REST API → Baseline and alerts: builds trends (evidence: `backend/src/server.js`)
- REST API → Exercise validation: validates type (evidence: `backend/src/server.js`)
- REST API → Assessment records: uses records (evidence: `backend/src/server.js`)
- REST API → Memory store: reads and writes (evidence: `backend/src/server.js`)
- REST API → Exercise assignments: manages (evidence: `README.md`)
- Baseline and alerts → Memory store: analyzes assessments (evidence: `README.md`)
- Baseline and alerts → Optional Gemini text: explains findings (evidence: `README.md`)
- REST API → Optional Gemini text: requests explanation (evidence: `backend/src/server.js`)
- REST API → MongoDB option: connects optionally (evidence: `backend/src/db.js`)
- Doctor → Doctor triage: reviews roster (evidence: `README.md`)
- Doctor triage → Exercise assignments: prescribes (evidence: `README.md`)
- Patient → Appointment views: books visits (evidence: `README.md`)
- Doctor → Clinic scheduling: manages slots (evidence: `README.md`)
- Appointment views → REST client: requests booking (evidence: `frontend/src/pages/AppointmentsPage.jsx`)
- Clinic scheduling → REST client: requests updates (evidence: `frontend/src/pages/DoctorAppointmentsPage.jsx`)
- REST API → Appointment routes: mounts routes (evidence: `backend/src/server.js`)
- REST API → Doctor and availability: mounts routes (evidence: `backend/src/server.js`)
- Appointment routes → Appointment service: delegates booking (evidence: `backend/src/routes/appointmentRoutes.js`)
- Doctor and availability → Appointment service: gets slots (evidence: `backend/src/routes/doctorRoutes.js`)
- Appointment service → Notifications: creates notices (evidence: `backend/src/services/appointmentService.js`)
- REST API → Notification routes: mounts routes (evidence: `backend/src/server.js`)
- Notification routes → Notifications: delegates (evidence: `backend/src/routes/notificationRoutes.js`)
- Patient → Consent report sharing: controls sharing (evidence: `README.md`)
- Doctor → Consent report sharing: views shared report (evidence: `README.md`)
- REST API → Report routes: mounts routes (evidence: `backend/src/server.js`)
- Report routes → Consent report sharing: delegates (evidence: `backend/src/routes/reportRoutes.js`)
- Consent report sharing → Baseline and alerts: builds report trends (evidence: `backend/src/services/reportSharingService.js`)
