# siddharth-bhairy/codiumv1 architecture

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

- Interactive diagram: https://gitdiagram.com/siddharth-bhairy/codiumv1
- Repository: https://github.com/siddharth-bhairy/codiumv1

## Overview

Codium is a full-stack DSA and SQL learning platform. Learners browse practice problems or study material, solve coding tasks in an editor, and take standard or custom quizzes; accounts and quiz/problem activity are handled through a Django REST backend. The backend persists learning and progress data and evaluates submitted code. The README also describes AI hints and quiz generation. Some page-to-endpoint wiring and the AI implementation are not shown in the excerpts, so those links are marked unverified or omitted.

Main entry points: [`codium_frontend/src/App.js`](https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/App.js) (App navigation), [`codium_backend/core/views.py`](https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_backend/core/views.py) (Django API), [`codium_frontend/src/pages/ProblemSolve/ProblemSolve.js`](https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/pages/ProblemSolve/ProblemSolve.js) (Problem workspace), [`codium_frontend/src/pages/Signup/Signup.js`](https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/pages/Signup/Signup.js) (Signup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Learning client"]
  node_app["App navigation<br/>[App.js]"]
  node_navbar["Navbar<br/>[Navbar.js]"]
  node_sidebar["Sidebar<br/>[Sidebar.js]"]
  node_signup["Signup<br/>[Signup.js]"]
  node_login["Login<br/>[Login.js]"]
end

subgraph group_learning["Learning experiences"]
  node_home["Home<br/>[Home.js]"]
  node_dsa["DSA practice<br/>[PracticeDSA.js]"]
  node_sql["SQL practice<br/>[PracticeSQL.js]"]
  node_problem["Problem workspace<br/>[ProblemSolve.js]"]
  node_dsa_sheets["DSA sheets<br/>[DSASheets.js]"]
  node_sql_sheets["SQL sheets<br/>[SQLSheets.js]"]
  node_topic["Topic lessons<br/>[LearnTopic.js]"]
  node_quiz_select["Quiz selection<br/>[TakeQuiz.js]"]
  node_quiz["Quiz session<br/>[Quiz.js]"]
  node_custom_quiz["Custom quiz upload"]
  node_add_problem["Problem authoring<br/>[AddProblem.js]"]
  node_profile["Profile dashboard<br/>[Profile.js]"]
end

subgraph group_server["Backend services"]
  node_api["Django API<br/>[views.py]"]
  node_executor["Code evaluator<br/>[executor.py]"]
end

subgraph group_persistence["Learning data"]
  node_models["Domain models<br/>[models.py]"]
  node_database[("Relational database")]
end

node_learner(("Learner"))
node_groq["Groq inference"]

node_learner -->|"uses"| node_app
node_app -->|"renders"| node_navbar
node_app -->|"renders"| node_sidebar
node_app -->|"renders"| node_signup
node_app -->|"renders"| node_home
node_app -->|"renders"| node_sql
node_app -->|"renders"| node_quiz_select
node_app -->|"renders"| node_sql_sheets
node_app -->|"renders"| node_topic
node_app -->|"renders"| node_add_problem
node_signup -->|"registers via"| node_api
node_dsa -->|"fetches problems"| node_api
node_topic -->|"fetches lessons"| node_api
node_quiz -->|"loads and submits"| node_api
node_custom_quiz -->|"requests generation"| node_api
node_problem -.->|"submits code"| node_api
node_api -->|"reads and writes"| node_models
node_api -->|"evaluates submission"| node_executor
node_models -.->|"persists"| node_database
node_api -.->|"requests AI generation"| node_groq
node_problem -.->|"requests contextual hints"| node_groq

click node_app "https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/App.js"
click node_navbar "https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/components/Navbar/Navbar.js"
click node_sidebar "https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/components/Sidebar/Sidebar.js"
click node_signup "https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/pages/Signup/Signup.js"
click node_login "https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/pages/login/Login.js"
click node_home "https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/pages/Home/Home.js"
click node_dsa "https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/pages/PracticeDSA/PracticeDSA.js"
click node_sql "https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/pages/PracticeSQL/PracticeSQL.js"
click node_problem "https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/pages/ProblemSolve/ProblemSolve.js"
click node_dsa_sheets "https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/pages/DSASheets/DSASheets.js"
click node_sql_sheets "https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/pages/SQLSheets/SQLSheets.js"
click node_topic "https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/pages/LearnTopic/LearnTopic.js"
click node_quiz_select "https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/pages/TakeQuiz/TakeQuiz.js"
click node_quiz "https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/pages/Quiz/Quiz.js"
click node_custom_quiz "https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/pages/CustomQuizUpload.js"
click node_add_problem "https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/pages/Add_Ques/AddProblem.js"
click node_profile "https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/pages/Profile/Profile.js"
click node_api "https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_backend/core/views.py"
click node_executor "https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_backend/core/utils/executor.py"
click node_models "https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_backend/core/models.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_navbar,node_sidebar,node_signup,node_login toneBlue
class node_home,node_dsa,node_sql,node_problem,node_dsa_sheets,node_sql_sheets,node_topic,node_quiz_select,node_quiz,node_custom_quiz,node_add_problem,node_profile toneAmber
class node_api,node_executor toneMint
class node_models,node_database toneRose
class node_learner,node_groq toneIndigo
```

## Components

### Learning client

- [App navigation](https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/App.js): `codium_frontend/src/App.js`
- [Navbar](https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/components/Navbar/Navbar.js): `codium_frontend/src/components/Navbar/Navbar.js`
- [Sidebar](https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/components/Sidebar/Sidebar.js): `codium_frontend/src/components/Sidebar/Sidebar.js`
- [Signup](https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/pages/Signup/Signup.js): `codium_frontend/src/pages/Signup/Signup.js`
- [Login](https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/pages/login/Login.js): `codium_frontend/src/pages/login/Login.js`

### Learning experiences

- [Home](https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/pages/Home/Home.js): `codium_frontend/src/pages/Home/Home.js`
- [DSA practice](https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/pages/PracticeDSA/PracticeDSA.js): `codium_frontend/src/pages/PracticeDSA/PracticeDSA.js`
- [SQL practice](https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/pages/PracticeSQL/PracticeSQL.js): `codium_frontend/src/pages/PracticeSQL/PracticeSQL.js`
- [Problem workspace](https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/pages/ProblemSolve/ProblemSolve.js): `codium_frontend/src/pages/ProblemSolve/ProblemSolve.js`
- [DSA sheets](https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/pages/DSASheets/DSASheets.js): `codium_frontend/src/pages/DSASheets/DSASheets.js`
- [SQL sheets](https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/pages/SQLSheets/SQLSheets.js): `codium_frontend/src/pages/SQLSheets/SQLSheets.js`
- [Topic lessons](https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/pages/LearnTopic/LearnTopic.js): `codium_frontend/src/pages/LearnTopic/LearnTopic.js`
- [Quiz selection](https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/pages/TakeQuiz/TakeQuiz.js): `codium_frontend/src/pages/TakeQuiz/TakeQuiz.js`
- [Quiz session](https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/pages/Quiz/Quiz.js): `codium_frontend/src/pages/Quiz/Quiz.js`
- [Custom quiz upload](https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/pages/CustomQuizUpload.js): `codium_frontend/src/pages/CustomQuizUpload.js`
- [Problem authoring](https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/pages/Add_Ques/AddProblem.js): `codium_frontend/src/pages/Add_Ques/AddProblem.js`
- [Profile dashboard](https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_frontend/src/pages/Profile/Profile.js): `codium_frontend/src/pages/Profile/Profile.js`

### Backend services

- [Django API](https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_backend/core/views.py): `codium_backend/core/views.py`
- [Code evaluator](https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_backend/core/utils/executor.py): `codium_backend/core/utils/executor.py`

### Learning data

- [Domain models](https://github.com/siddharth-bhairy/codiumv1/blob/main/codium_backend/core/models.py): `codium_backend/core/models.py`
- **Relational database**

### Other components

- **Learner**
- **Groq inference**

## Connections

- Learner → App navigation: uses (evidence: `README.md`)
- App navigation → Navbar: renders (evidence: `codium_frontend/src/App.js`)
- App navigation → Sidebar: renders (evidence: `codium_frontend/src/App.js`)
- App navigation → Signup: renders (evidence: `codium_frontend/src/App.js`)
- App navigation → Home: renders (evidence: `codium_frontend/src/App.js`)
- App navigation → SQL practice: renders (evidence: `codium_frontend/src/App.js`)
- App navigation → Quiz selection: renders (evidence: `codium_frontend/src/App.js`)
- App navigation → SQL sheets: renders (evidence: `codium_frontend/src/App.js`)
- App navigation → Topic lessons: renders (evidence: `codium_frontend/src/App.js`)
- App navigation → Problem authoring: renders (evidence: `codium_frontend/src/App.js`)
- Signup → Django API: registers via (evidence: `codium_frontend/src/pages/Signup/Signup.js`)
- DSA practice → Django API: fetches problems (evidence: `codium_frontend/src/pages/PracticeDSA/PracticeDSA.js`)
- Topic lessons → Django API: fetches lessons (evidence: `codium_frontend/src/pages/LearnTopic/LearnTopic.js`)
- Quiz session → Django API: loads and submits (evidence: `codium_frontend/src/pages/Quiz/Quiz.js`)
- Custom quiz upload → Django API: requests generation (evidence: `codium_frontend/src/pages/CustomQuizUpload.js`)
- Problem workspace → Django API: submits code
- Django API → Domain models: reads and writes (evidence: `codium_backend/core/views.py`)
- Django API → Code evaluator: evaluates submission (evidence: `codium_backend/core/views.py`)
- Domain models → Relational database: persists
- Django API → Groq inference: requests AI generation (evidence: `README.md`)
- Problem workspace → Groq inference: requests contextual hints (evidence: `README.md`)
