# jiyabatra/codevibe- architecture

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

- Interactive diagram: https://gitdiagram.com/jiyabatra/codevibe-
- Repository: https://github.com/jiyabatra/codevibe-

## Overview

CodeVibe is a browser-based coding education platform: learners browse guided courses, study lessons, write and run code, receive evaluation, and track their progress. The frontend also exposes assessments, certificates, dashboards, and mistake insights; backend controllers support execution, authentication, lesson progress, and analytics backed by MongoDB models. The principal workflow and product capabilities are documented in the README, while several backend and UI connections are inferred because their implementation excerpts were not provided; those links are marked unverified.

Main entry points: [`client/src/main.jsx`](https://github.com/jiyabatra/codevibe-/blob/main/client/src/main.jsx) (React app), [`client/src/components/Courses.jsx`](https://github.com/jiyabatra/codevibe-/blob/main/client/src/components/Courses.jsx) (Course catalog), [`server/controller/execute/executeController.js`](https://github.com/jiyabatra/codevibe-/blob/main/server/controller/execute/executeController.js) (Code execution), [`server/routes/api`](https://github.com/jiyabatra/codevibe-/tree/main/server/routes/api) (HTTP API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_learning["Learning experience"]
  node_app["React app<br/>[main.jsx]"]
  node_courses["Course catalog<br/>[Courses.jsx]"]
  node_lessons["Guided lessons"]
  node_csslesson["CSS lessons<br/>[CssLesson.jsx]"]
  node_htmllesson["HTML lessons<br/>[HtmlLesson.jsx]"]
  node_roadmap["Learning roadmaps"]
end

subgraph group_practice["Practice and assessment"]
  node_compiler["Code editor<br/>[Compiler.jsx]"]
  node_execution["Code execution"]
  node_evaluation["Solution evaluation"]
  node_exams["Final assessments<br/>[examController.js]"]
  node_certificates["Certificates"]
end

subgraph group_identity["Accounts and insights"]
  node_auth["Authentication<br/>[AuthProvider.jsx]"]
  node_login["Account access<br/>[Login.jsx]"]
  node_dashboard["Progress dashboard<br/>[Dashboard.jsx]"]
  node_mistakes["Mistake insights"]
end

subgraph group_backend["Backend services"]
  node_analytics["Learning analytics"]
  node_lessonservice["Lesson progress"]
  node_progressstore[("Progress records<br/>[progress.js]")]
  node_mistakeservice["Mistake analysis"]
  node_executestore[("Execution logs<br/>[execute.model.js]")]
  node_authmiddleware["Token verification<br/>[authMiddleware.js]"]
  node_api["HTTP API"]
end

node_learner(("Learner"))

node_learner -->|"opens"| node_app
node_app -->|"routes to"| node_courses
node_app -->|"routes to"| node_lessons
node_courses -->|"offers"| node_roadmap
node_courses -->|"presents paths"| node_learner
node_learner -->|"writes code"| node_compiler
node_compiler -.->|"sends requests"| node_api
node_api -.->|"dispatches"| node_execution
node_execution -->|"evaluates"| node_evaluation
node_execution -->|"records runs"| node_executestore
node_learner -->|"takes tests"| node_exams
node_exams -.->|"qualifies for"| node_certificates
node_learner -->|"signs in"| node_login
node_login -.->|"establishes session"| node_auth
node_learner -->|"reviews progress"| node_dashboard
node_dashboard -.->|"requests insights"| node_analytics
node_learner -->|"reviews errors"| node_mistakes
node_mistakes -.->|"requests patterns"| node_mistakeservice
node_mistakeservice -->|"reads errors"| node_executestore
node_lessonservice -->|"updates progress"| node_progressstore
node_lessonservice -->|"records activity"| node_analytics
node_api -.->|"verifies protected requests"| node_authmiddleware
node_learner -->|"studies CSS"| node_csslesson
node_learner -->|"studies HTML"| node_htmllesson

click node_app "https://github.com/jiyabatra/codevibe-/blob/main/client/src/main.jsx"
click node_courses "https://github.com/jiyabatra/codevibe-/blob/main/client/src/components/Courses.jsx"
click node_lessons "https://github.com/jiyabatra/codevibe-/tree/main/client/src/components"
click node_csslesson "https://github.com/jiyabatra/codevibe-/blob/main/client/src/components/CssLesson.jsx"
click node_htmllesson "https://github.com/jiyabatra/codevibe-/blob/main/client/src/components/HtmlLesson.jsx"
click node_roadmap "https://github.com/jiyabatra/codevibe-/blob/main/client/src/components/RoadmapGenerator.jsx"
click node_compiler "https://github.com/jiyabatra/codevibe-/blob/main/client/src/components/Compiler.jsx"
click node_execution "https://github.com/jiyabatra/codevibe-/blob/main/server/controller/execute/executeController.js"
click node_evaluation "https://github.com/jiyabatra/codevibe-/blob/main/server/controller/execute/executeController.js"
click node_exams "https://github.com/jiyabatra/codevibe-/blob/main/server/controller/exam/examController.js"
click node_certificates "https://github.com/jiyabatra/codevibe-/blob/main/server/controller/certificate/certificatecontroller.js"
click node_auth "https://github.com/jiyabatra/codevibe-/blob/main/client/src/AuthProvider.jsx"
click node_login "https://github.com/jiyabatra/codevibe-/blob/main/client/src/components/Login.jsx"
click node_dashboard "https://github.com/jiyabatra/codevibe-/blob/main/client/src/components/Dashboard.jsx"
click node_mistakes "https://github.com/jiyabatra/codevibe-/blob/main/client/src/components/MyMistakesDashboard.jsx"
click node_analytics "https://github.com/jiyabatra/codevibe-/blob/main/server/controller/analytics/analyticsController.js"
click node_lessonservice "https://github.com/jiyabatra/codevibe-/blob/main/server/controller/Lesson/lessoncontroller.js"
click node_progressstore "https://github.com/jiyabatra/codevibe-/blob/main/server/models/progress.js"
click node_mistakeservice "https://github.com/jiyabatra/codevibe-/blob/main/server/controller/mistakes/mistakesController.js"
click node_executestore "https://github.com/jiyabatra/codevibe-/blob/main/server/models/execute.model.js"
click node_authmiddleware "https://github.com/jiyabatra/codevibe-/blob/main/server/middleware/authMiddleware.js"
click node_api "https://github.com/jiyabatra/codevibe-/tree/main/server/routes/api"

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_courses,node_lessons,node_csslesson,node_htmllesson,node_roadmap toneBlue
class node_compiler,node_execution,node_evaluation,node_exams,node_certificates toneAmber
class node_auth,node_login,node_dashboard,node_mistakes toneMint
class node_analytics,node_lessonservice,node_progressstore,node_mistakeservice,node_executestore,node_authmiddleware,node_api toneRose
class node_learner toneIndigo
```

## Components

### Learning experience

- [React app](https://github.com/jiyabatra/codevibe-/blob/main/client/src/main.jsx): `client/src/main.jsx`
- [Course catalog](https://github.com/jiyabatra/codevibe-/blob/main/client/src/components/Courses.jsx): `client/src/components/Courses.jsx`
- [Guided lessons](https://github.com/jiyabatra/codevibe-/tree/main/client/src/components): `client/src/components`
- [CSS lessons](https://github.com/jiyabatra/codevibe-/blob/main/client/src/components/CssLesson.jsx): `client/src/components/CssLesson.jsx`
- [HTML lessons](https://github.com/jiyabatra/codevibe-/blob/main/client/src/components/HtmlLesson.jsx): `client/src/components/HtmlLesson.jsx`
- [Learning roadmaps](https://github.com/jiyabatra/codevibe-/blob/main/client/src/components/RoadmapGenerator.jsx): `client/src/components/RoadmapGenerator.jsx`

### Practice and assessment

- [Code editor](https://github.com/jiyabatra/codevibe-/blob/main/client/src/components/Compiler.jsx): `client/src/components/Compiler.jsx`
- [Code execution](https://github.com/jiyabatra/codevibe-/blob/main/server/controller/execute/executeController.js): `server/controller/execute/executeController.js`
- [Solution evaluation](https://github.com/jiyabatra/codevibe-/blob/main/server/controller/execute/executeController.js): `server/controller/execute/executeController.js`
- [Final assessments](https://github.com/jiyabatra/codevibe-/blob/main/server/controller/exam/examController.js): `server/controller/exam/examController.js`
- [Certificates](https://github.com/jiyabatra/codevibe-/blob/main/server/controller/certificate/certificatecontroller.js): `server/controller/certificate/certificatecontroller.js`

### Accounts and insights

- [Authentication](https://github.com/jiyabatra/codevibe-/blob/main/client/src/AuthProvider.jsx): `client/src/AuthProvider.jsx`
- [Account access](https://github.com/jiyabatra/codevibe-/blob/main/client/src/components/Login.jsx): `client/src/components/Login.jsx`
- [Progress dashboard](https://github.com/jiyabatra/codevibe-/blob/main/client/src/components/Dashboard.jsx): `client/src/components/Dashboard.jsx`
- [Mistake insights](https://github.com/jiyabatra/codevibe-/blob/main/client/src/components/MyMistakesDashboard.jsx): `client/src/components/MyMistakesDashboard.jsx`

### Backend services

- [Learning analytics](https://github.com/jiyabatra/codevibe-/blob/main/server/controller/analytics/analyticsController.js): `server/controller/analytics/analyticsController.js`
- [Lesson progress](https://github.com/jiyabatra/codevibe-/blob/main/server/controller/Lesson/lessoncontroller.js): `server/controller/Lesson/lessoncontroller.js`
- [Progress records](https://github.com/jiyabatra/codevibe-/blob/main/server/models/progress.js): `server/models/progress.js`
- [Mistake analysis](https://github.com/jiyabatra/codevibe-/blob/main/server/controller/mistakes/mistakesController.js): `server/controller/mistakes/mistakesController.js`
- [Execution logs](https://github.com/jiyabatra/codevibe-/blob/main/server/models/execute.model.js): `server/models/execute.model.js`
- [Token verification](https://github.com/jiyabatra/codevibe-/blob/main/server/middleware/authMiddleware.js): `server/middleware/authMiddleware.js`
- [HTTP API](https://github.com/jiyabatra/codevibe-/tree/main/server/routes/api): `server/routes/api`

### Other components

- **Learner**

## Connections

- Learner → React app: opens
- React app → Course catalog: routes to (evidence: `client/src/main.jsx`)
- React app → Guided lessons: routes to (evidence: `client/src/main.jsx`)
- Course catalog → Learning roadmaps: offers (evidence: `client/src/components/Courses.jsx`)
- Course catalog → Learner: presents paths
- Learner → Code editor: writes code
- Code editor → HTTP API: sends requests
- HTTP API → Code execution: dispatches (evidence: `server/routes/api/executeRoutes.js`)
- Code execution → Solution evaluation: evaluates (evidence: `server/controller/execute/executeController.js`)
- Code execution → Execution logs: records runs (evidence: `server/controller/execute/executeController.js`)
- Learner → Final assessments: takes tests
- Final assessments → Certificates: qualifies for
- Learner → Account access: signs in
- Account access → Authentication: establishes session
- Learner → Progress dashboard: reviews progress
- Progress dashboard → Learning analytics: requests insights
- Learner → Mistake insights: reviews errors
- Mistake insights → Mistake analysis: requests patterns
- Mistake analysis → Execution logs: reads errors (evidence: `server/controller/mistakes/mistakesController.js`)
- Lesson progress → Progress records: updates progress (evidence: `server/controller/Lesson/lessoncontroller.js`)
- Lesson progress → Learning analytics: records activity (evidence: `server/controller/Lesson/lessoncontroller.js`)
- HTTP API → Token verification: verifies protected requests (evidence: `server/routes/api/authRoutes.js`)
- Learner → CSS lessons: studies CSS
- Learner → HTML lessons: studies HTML
