# bharathrajgit/zerith-v1 architecture

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

- Interactive diagram: https://gitdiagram.com/bharathrajgit/zerith-v1
- Repository: https://github.com/bharathrajgit/zerith-v1

## Overview

Zerith (BehaviourLearn) is an AI-assisted DSA learning platform. Students register, take an adaptive diagnostic, receive a learning roadmap, and continue through lessons, assessments, and coding practice; institutions manage cohorts and review analytics and malpractice reports. Monitoring spans browser and vision signals, with ML-backed analysis and a heuristic fallback. The graph emphasizes documented routing and sampled calls; other README-listed screens are grouped by capability where their implementation was not sampled.

Main entry points: [`server/index.js`](https://github.com/bharathrajgit/zerith-v1/blob/main/server/index.js) (API server), [`server/controllers/diagnosticController.js`](https://github.com/bharathrajgit/zerith-v1/blob/main/server/controllers/diagnosticController.js) (Adaptive diagnostic), [`server/controllers/coding.controller.js`](https://github.com/bharathrajgit/zerith-v1/blob/main/server/controllers/coding.controller.js) (Coding practice), [`server/services/monitoringService.js`](https://github.com/bharathrajgit/zerith-v1/blob/main/server/services/monitoringService.js) (Monitoring orchestration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Learning client"]
  node_web_app["Web application<br/>[App.jsx]"]
  node_student_learning["Student learning"]
  node_institution_portal["Institution portal"]
  node_practice_monitoring["Practice monitoring UI"]
  node_monitoring_client["Monitoring API client"]
end

subgraph group_api["Platform API"]
  node_api_server["API server<br/>[index.js]"]
  node_auth["Student authentication<br/>[auth.middleware.js]"]
  node_user_store[("User profiles<br/>[User.js]")]
  node_progress_store[("Learning progress<br/>[Progress.js]")]
  node_topic_store[("Topics<br/>[Topic.js]")]
  node_diagnostic_store[("Diagnostic sessions")]
end

subgraph group_learning["Learning services"]
  node_diagnostic["Adaptive diagnostic"]
  node_coding["Coding practice"]
  node_progression["Progression and roadmap"]
  node_assessment["Assessments and lessons"]
  node_institution_ops["Institution operations"]
end

subgraph group_monitoring["Monitoring"]
  node_monitoring["Monitoring orchestration"]
  node_malpractice_rules["Malpractice rules<br/>[antiMalpractice.js]"]
  node_monitor_store[("Monitoring sessions")]
  node_malpractice_store[("Malpractice records<br/>[MalpracticeLog.js]")]
end

subgraph group_ml["ML services"]
  node_ml_bridge["ML service bridge<br/>[mlService.js]"]
  node_ml_runtime["ML runtime<br/>[app.py]"]
  node_ml_diagnostics["Diagnostic models"]
end

node_student(("Student"))
node_institution_user(("Institution user"))
node_external_judge["Code judge"]

node_student -->|"uses"| node_web_app
node_institution_user -->|"uses"| node_web_app
node_web_app -->|"routes to"| node_student_learning
node_web_app -->|"routes to"| node_institution_portal
node_student_learning -.->|"requests data"| node_api_server
node_institution_portal -.->|"requests data"| node_api_server
node_api_server -->|"protects routes"| node_auth
node_api_server -->|"routes requests"| node_diagnostic
node_api_server -->|"routes requests"| node_coding
node_api_server -->|"routes requests"| node_monitoring
node_api_server -->|"routes requests"| node_institution_ops
node_diagnostic -->|"creates sessions"| node_diagnostic_store
node_diagnostic -->|"updates profile"| node_user_store
node_diagnostic -->|"generates roadmap"| node_progression
node_diagnostic -->|"classifies diagnostic"| node_ml_bridge
node_coding -->|"reads and updates"| node_progress_store
node_coding -->|"checks progression"| node_progression
node_coding -->|"analyzes frames"| node_ml_bridge
node_coding -.->|"runs submissions"| node_external_judge
node_progression -->|"reads progress"| node_progress_store
node_progression -->|"reads topics"| node_topic_store
node_assessment -.->|"updates results"| node_progress_store
node_institution_ops -.->|"reads student data"| node_user_store
node_practice_monitoring -->|"sends signals"| node_monitoring_client
node_monitoring_client -->|"calls monitoring API"| node_api_server
node_monitoring -->|"records sessions"| node_monitor_store
node_monitoring -->|"records evidence"| node_malpractice_store
node_monitoring -->|"applies rules"| node_malpractice_rules
node_monitoring -.->|"analyzes vision"| node_ml_bridge
node_ml_bridge -->|"calls ML endpoints"| node_ml_runtime
node_ml_runtime -->|"loads diagnostic model"| node_ml_diagnostics

click node_web_app "https://github.com/bharathrajgit/zerith-v1/blob/main/client/src/App.jsx"
click node_student_learning "https://github.com/bharathrajgit/zerith-v1/tree/main/client/src/pages/student"
click node_institution_portal "https://github.com/bharathrajgit/zerith-v1/tree/main/client/src/pages/institution"
click node_practice_monitoring "https://github.com/bharathrajgit/zerith-v1/blob/main/client/src/hooks/usePracticeMonitoring.js"
click node_monitoring_client "https://github.com/bharathrajgit/zerith-v1/blob/main/client/src/services/monitoringService.js"
click node_api_server "https://github.com/bharathrajgit/zerith-v1/blob/main/server/index.js"
click node_auth "https://github.com/bharathrajgit/zerith-v1/blob/main/server/middleware/auth.middleware.js"
click node_diagnostic "https://github.com/bharathrajgit/zerith-v1/blob/main/server/controllers/diagnosticController.js"
click node_coding "https://github.com/bharathrajgit/zerith-v1/blob/main/server/controllers/coding.controller.js"
click node_progression "https://github.com/bharathrajgit/zerith-v1/blob/main/server/services/progressionService.js"
click node_assessment "https://github.com/bharathrajgit/zerith-v1/blob/main/server/controllers/assessment.controller.js"
click node_institution_ops "https://github.com/bharathrajgit/zerith-v1/blob/main/server/controllers/institution.analytics.controller.js"
click node_user_store "https://github.com/bharathrajgit/zerith-v1/blob/main/server/models/User.js"
click node_progress_store "https://github.com/bharathrajgit/zerith-v1/blob/main/server/models/Progress.js"
click node_topic_store "https://github.com/bharathrajgit/zerith-v1/blob/main/server/models/Topic.js"
click node_diagnostic_store "https://github.com/bharathrajgit/zerith-v1/blob/main/server/models/DiagnosticSession.js"
click node_monitoring "https://github.com/bharathrajgit/zerith-v1/blob/main/server/services/monitoringService.js"
click node_malpractice_rules "https://github.com/bharathrajgit/zerith-v1/blob/main/server/services/antiMalpractice.js"
click node_monitor_store "https://github.com/bharathrajgit/zerith-v1/blob/main/server/models/MonitoringSession.js"
click node_malpractice_store "https://github.com/bharathrajgit/zerith-v1/blob/main/server/models/MalpracticeLog.js"
click node_ml_bridge "https://github.com/bharathrajgit/zerith-v1/blob/main/server/services/mlService.js"
click node_ml_runtime "https://github.com/bharathrajgit/zerith-v1/blob/main/ml-service/app.py"
click node_ml_diagnostics "https://github.com/bharathrajgit/zerith-v1/blob/main/ml-service/diagnostic_model.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_web_app,node_student_learning,node_institution_portal,node_practice_monitoring,node_monitoring_client,node_institution_user toneBlue
class node_api_server,node_auth,node_user_store,node_progress_store,node_topic_store,node_diagnostic_store toneAmber
class node_diagnostic,node_coding,node_progression,node_assessment,node_institution_ops toneMint
class node_monitoring,node_malpractice_rules,node_monitor_store,node_malpractice_store toneRose
class node_ml_bridge,node_ml_runtime,node_ml_diagnostics,node_student,node_external_judge toneIndigo
```

## Components

### Learning client

- [Web application](https://github.com/bharathrajgit/zerith-v1/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Student learning](https://github.com/bharathrajgit/zerith-v1/tree/main/client/src/pages/student): `client/src/pages/student`
- [Institution portal](https://github.com/bharathrajgit/zerith-v1/tree/main/client/src/pages/institution): `client/src/pages/institution`
- [Practice monitoring UI](https://github.com/bharathrajgit/zerith-v1/blob/main/client/src/hooks/usePracticeMonitoring.js): `client/src/hooks/usePracticeMonitoring.js`
- [Monitoring API client](https://github.com/bharathrajgit/zerith-v1/blob/main/client/src/services/monitoringService.js): `client/src/services/monitoringService.js`

### Platform API

- [API server](https://github.com/bharathrajgit/zerith-v1/blob/main/server/index.js): `server/index.js`
- [Student authentication](https://github.com/bharathrajgit/zerith-v1/blob/main/server/middleware/auth.middleware.js): `server/middleware/auth.middleware.js`
- [User profiles](https://github.com/bharathrajgit/zerith-v1/blob/main/server/models/User.js): `server/models/User.js`
- [Learning progress](https://github.com/bharathrajgit/zerith-v1/blob/main/server/models/Progress.js): `server/models/Progress.js`
- [Topics](https://github.com/bharathrajgit/zerith-v1/blob/main/server/models/Topic.js): `server/models/Topic.js`
- [Diagnostic sessions](https://github.com/bharathrajgit/zerith-v1/blob/main/server/models/DiagnosticSession.js): `server/models/DiagnosticSession.js`

### Learning services

- [Adaptive diagnostic](https://github.com/bharathrajgit/zerith-v1/blob/main/server/controllers/diagnosticController.js): `server/controllers/diagnosticController.js`
- [Coding practice](https://github.com/bharathrajgit/zerith-v1/blob/main/server/controllers/coding.controller.js): `server/controllers/coding.controller.js`
- [Progression and roadmap](https://github.com/bharathrajgit/zerith-v1/blob/main/server/services/progressionService.js): `server/services/progressionService.js`
- [Assessments and lessons](https://github.com/bharathrajgit/zerith-v1/blob/main/server/controllers/assessment.controller.js): `server/controllers/assessment.controller.js`
- [Institution operations](https://github.com/bharathrajgit/zerith-v1/blob/main/server/controllers/institution.analytics.controller.js): `server/controllers/institution.analytics.controller.js`

### Monitoring

- [Monitoring orchestration](https://github.com/bharathrajgit/zerith-v1/blob/main/server/services/monitoringService.js): `server/services/monitoringService.js`
- [Malpractice rules](https://github.com/bharathrajgit/zerith-v1/blob/main/server/services/antiMalpractice.js): `server/services/antiMalpractice.js`
- [Monitoring sessions](https://github.com/bharathrajgit/zerith-v1/blob/main/server/models/MonitoringSession.js): `server/models/MonitoringSession.js`
- [Malpractice records](https://github.com/bharathrajgit/zerith-v1/blob/main/server/models/MalpracticeLog.js): `server/models/MalpracticeLog.js`

### ML services

- [ML service bridge](https://github.com/bharathrajgit/zerith-v1/blob/main/server/services/mlService.js): `server/services/mlService.js`
- [ML runtime](https://github.com/bharathrajgit/zerith-v1/blob/main/ml-service/app.py): `ml-service/app.py`
- [Diagnostic models](https://github.com/bharathrajgit/zerith-v1/blob/main/ml-service/diagnostic_model.py): `ml-service/diagnostic_model.py`

### Other components

- **Student**
- **Institution user**
- **Code judge**

## Connections

- Student → Web application: uses (evidence: `client/src/App.jsx`)
- Institution user → Web application: uses (evidence: `client/src/App.jsx`)
- Web application → Student learning: routes to (evidence: `client/src/App.jsx`)
- Web application → Institution portal: routes to (evidence: `client/src/App.jsx`)
- Student learning → API server: requests data
- Institution portal → API server: requests data
- API server → Student authentication: protects routes
- API server → Adaptive diagnostic: routes requests (evidence: `server/index.js`)
- API server → Coding practice: routes requests (evidence: `server/index.js`)
- API server → Monitoring orchestration: routes requests (evidence: `server/index.js`)
- API server → Institution operations: routes requests (evidence: `server/index.js`)
- Adaptive diagnostic → Diagnostic sessions: creates sessions (evidence: `server/controllers/diagnosticController.js`)
- Adaptive diagnostic → User profiles: updates profile (evidence: `server/controllers/diagnosticController.js`)
- Adaptive diagnostic → Progression and roadmap: generates roadmap (evidence: `server/controllers/diagnosticController.js`)
- Adaptive diagnostic → ML service bridge: classifies diagnostic (evidence: `server/controllers/diagnosticController.js`)
- Coding practice → Learning progress: reads and updates (evidence: `server/controllers/coding.controller.js`)
- Coding practice → Progression and roadmap: checks progression (evidence: `server/controllers/coding.controller.js`)
- Coding practice → ML service bridge: analyzes frames (evidence: `server/controllers/coding.controller.js`)
- Coding practice → Code judge: runs submissions
- Progression and roadmap → Learning progress: reads progress (evidence: `server/services/roadmapGenerator.js`)
- Progression and roadmap → Topics: reads topics (evidence: `server/services/roadmapGenerator.js`)
- Assessments and lessons → Learning progress: updates results
- Institution operations → User profiles: reads student data
- Practice monitoring UI → Monitoring API client: sends signals (evidence: `client/src/hooks/usePracticeMonitoring.js`)
- Monitoring API client → API server: calls monitoring API (evidence: `client/src/services/monitoringService.js`)
- Monitoring orchestration → Monitoring sessions: records sessions (evidence: `server/services/monitoringService.js`)
- Monitoring orchestration → Malpractice records: records evidence (evidence: `server/services/monitoringService.js`)
- Monitoring orchestration → Malpractice rules: applies rules (evidence: `server/services/monitoringService.js`)
- Monitoring orchestration → ML service bridge: analyzes vision
- ML service bridge → ML runtime: calls ML endpoints (evidence: `server/services/mlService.js`)
- ML runtime → Diagnostic models: loads diagnostic model (evidence: `ml-service/app.py`)
