# charansaiburra/coursearena architecture

> Architecture diagram of the GitHub repository charansaiburra/coursearena, 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/charansaiburra/coursearena
- Repository: https://github.com/charansaiburra/coursearena

## Overview

CourseArena is a learning and career-preparation platform. Learners browse courses, enroll, study lessons, track progress, and use practice, compiler, assessment, and career-preparation features; JWT authentication protects learner-specific actions. The graph combines documented product areas with sampled service behavior. Several branches are documented in the README but their implementation was not sampled, so their internal call relationships are intentionally omitted.

Main entry points: [`backend/src/main/java/com/coursearena/CourseArenaApplication.java`](https://github.com/charansaiburra/coursearena/blob/main/backend/src/main/java/com/coursearena/CourseArenaApplication.java) (Spring REST backend), [`backend/src/main/java/com/coursearena/enrollment/EnrollmentService.java`](https://github.com/charansaiburra/coursearena/blob/main/backend/src/main/java/com/coursearena/enrollment/EnrollmentService.java) (Enrollment), [`frontend/src/App.jsx`](https://github.com/charansaiburra/coursearena/blob/main/frontend/src/App.jsx) (React application), [`backend/src/main/java/com/coursearena/practice/PracticeService.java`](https://github.com/charansaiburra/coursearena/blob/main/backend/src/main/java/com/coursearena/practice/PracticeService.java) (Practice arena)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Learner application"]
  node_webapp["React application<br/>[App.jsx]"]
  node_course_ui["Course workspace<br/>[CourseDetail.jsx]"]
  node_auth_ui["Auth and theme<br/>[AuthContext.jsx]"]
end

subgraph group_learning["Courses and progress"]
  node_course_catalog[("Course catalog<br/>[Course.java]")]
  node_enrollment["Enrollment"]
  node_lessons[("Lesson content<br/>[Lesson.java]")]
  node_progress["Learning progress"]
end

subgraph group_practice["Practice and assessment"]
  node_practice["Practice arena"]
  node_code_runner["Code sandbox"]
  node_sql_practice[("SQL practice<br/>[SqlProblem.java]")]
  node_course_assessments["Course assessments"]
end

subgraph group_career["Career and cohorts"]
  node_career_prep["Career preparation<br/>[CareerService.java]"]
  node_arenapro["ArenaPro cohorts"]
end

subgraph group_platform["Identity and services"]
  node_auth["JWT authentication<br/>[JwtService.java]"]
  node_users[("User records<br/>[User.java]")]
  node_ai["AI assistant"]
  node_compiler_api["Compiler endpoint"]
  node_backend["Spring REST backend"]
  node_database[("Relational database")]
end

node_learner(("Learner"))
node_docker["Docker containers"]
node_openai["OpenAI provider"]

node_learner -->|"uses"| node_webapp
node_webapp -->|"calls REST API"| node_backend
node_webapp -->|"routes to"| node_course_ui
node_course_ui -.->|"loads course content"| node_backend
node_backend -.->|"serves enrollment"| node_enrollment
node_enrollment -->|"looks up user"| node_users
node_enrollment -->|"looks up course"| node_course_catalog
node_enrollment -->|"deletes progress"| node_progress
node_backend -.->|"serves lessons"| node_lessons
node_backend -.->|"tracks completion"| node_progress
node_backend -.->|"serves practice"| node_practice
node_practice -->|"executes code"| node_code_runner
node_practice -->|"uses problem data"| node_sql_practice
node_backend -.->|"serves assessments"| node_course_assessments
node_backend -.->|"serves career prep"| node_career_prep
node_backend -.->|"serves cohort learning"| node_arenapro
node_backend -.->|"secures endpoints"| node_auth
node_auth -.->|"authenticates users"| node_users
node_backend -.->|"serves AI chat"| node_ai
node_ai -.->|"requests responses"| node_openai
node_backend -.->|"serves compilation"| node_compiler_api
node_compiler_api -.->|"runs arbitrary code"| node_code_runner
node_code_runner -->|"runs isolated jobs"| node_docker
node_backend -.->|"persists data"| node_database
node_auth_ui -.->|"sends JWT requests"| node_backend

click node_webapp "https://github.com/charansaiburra/coursearena/blob/main/frontend/src/App.jsx"
click node_course_ui "https://github.com/charansaiburra/coursearena/blob/main/frontend/src/pages/CourseDetail.jsx"
click node_auth_ui "https://github.com/charansaiburra/coursearena/blob/main/frontend/src/context/AuthContext.jsx"
click node_course_catalog "https://github.com/charansaiburra/coursearena/blob/main/backend/src/main/java/com/coursearena/course/Course.java"
click node_enrollment "https://github.com/charansaiburra/coursearena/blob/main/backend/src/main/java/com/coursearena/enrollment/EnrollmentService.java"
click node_lessons "https://github.com/charansaiburra/coursearena/blob/main/backend/src/main/java/com/coursearena/lesson/Lesson.java"
click node_progress "https://github.com/charansaiburra/coursearena/blob/main/backend/src/main/java/com/coursearena/progress/LessonProgressService.java"
click node_practice "https://github.com/charansaiburra/coursearena/blob/main/backend/src/main/java/com/coursearena/practice/PracticeService.java"
click node_code_runner "https://github.com/charansaiburra/coursearena/blob/main/backend/src/main/java/com/coursearena/practice/coding/DockerCodeExecutionService.java"
click node_sql_practice "https://github.com/charansaiburra/coursearena/blob/main/backend/src/main/java/com/coursearena/practice/sql/SqlProblem.java"
click node_course_assessments "https://github.com/charansaiburra/coursearena/tree/main/backend/src/main/java/com/coursearena/practice"
click node_career_prep "https://github.com/charansaiburra/coursearena/blob/main/backend/src/main/java/com/coursearena/career/CareerService.java"
click node_arenapro "https://github.com/charansaiburra/coursearena/blob/main/backend/src/main/java/com/coursearena/arenapro/ArenaProService.java"
click node_auth "https://github.com/charansaiburra/coursearena/blob/main/backend/src/main/java/com/coursearena/auth/JwtService.java"
click node_users "https://github.com/charansaiburra/coursearena/blob/main/backend/src/main/java/com/coursearena/user/User.java"
click node_ai "https://github.com/charansaiburra/coursearena/blob/main/backend/src/main/java/com/coursearena/ai/OpenAiAiService.java"
click node_compiler_api "https://github.com/charansaiburra/coursearena/blob/main/backend/src/main/java/com/coursearena/compiler/CompilerService.java"
click node_backend "https://github.com/charansaiburra/coursearena/blob/main/backend/src/main/java/com/coursearena/CourseArenaApplication.java"

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_webapp,node_course_ui,node_auth_ui toneBlue
class node_course_catalog,node_enrollment,node_lessons,node_progress toneAmber
class node_practice,node_code_runner,node_sql_practice,node_course_assessments toneMint
class node_career_prep,node_arenapro toneRose
class node_auth,node_users,node_ai,node_compiler_api,node_backend,node_database,node_learner,node_docker,node_openai toneIndigo
```

## Components

### Learner application

- [React application](https://github.com/charansaiburra/coursearena/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Course workspace](https://github.com/charansaiburra/coursearena/blob/main/frontend/src/pages/CourseDetail.jsx): `frontend/src/pages/CourseDetail.jsx`
- [Auth and theme](https://github.com/charansaiburra/coursearena/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`

### Courses and progress

- [Course catalog](https://github.com/charansaiburra/coursearena/blob/main/backend/src/main/java/com/coursearena/course/Course.java): `backend/src/main/java/com/coursearena/course/Course.java`
- [Enrollment](https://github.com/charansaiburra/coursearena/blob/main/backend/src/main/java/com/coursearena/enrollment/EnrollmentService.java): `backend/src/main/java/com/coursearena/enrollment/EnrollmentService.java`
- [Lesson content](https://github.com/charansaiburra/coursearena/blob/main/backend/src/main/java/com/coursearena/lesson/Lesson.java): `backend/src/main/java/com/coursearena/lesson/Lesson.java`
- [Learning progress](https://github.com/charansaiburra/coursearena/blob/main/backend/src/main/java/com/coursearena/progress/LessonProgressService.java): `backend/src/main/java/com/coursearena/progress/LessonProgressService.java`

### Practice and assessment

- [Practice arena](https://github.com/charansaiburra/coursearena/blob/main/backend/src/main/java/com/coursearena/practice/PracticeService.java): `backend/src/main/java/com/coursearena/practice/PracticeService.java`
- [Code sandbox](https://github.com/charansaiburra/coursearena/blob/main/backend/src/main/java/com/coursearena/practice/coding/DockerCodeExecutionService.java): `backend/src/main/java/com/coursearena/practice/coding/DockerCodeExecutionService.java`
- [SQL practice](https://github.com/charansaiburra/coursearena/blob/main/backend/src/main/java/com/coursearena/practice/sql/SqlProblem.java): `backend/src/main/java/com/coursearena/practice/sql/SqlProblem.java`
- [Course assessments](https://github.com/charansaiburra/coursearena/tree/main/backend/src/main/java/com/coursearena/practice): `backend/src/main/java/com/coursearena/practice`

### Career and cohorts

- [Career preparation](https://github.com/charansaiburra/coursearena/blob/main/backend/src/main/java/com/coursearena/career/CareerService.java): `backend/src/main/java/com/coursearena/career/CareerService.java`
- [ArenaPro cohorts](https://github.com/charansaiburra/coursearena/blob/main/backend/src/main/java/com/coursearena/arenapro/ArenaProService.java): `backend/src/main/java/com/coursearena/arenapro/ArenaProService.java`

### Identity and services

- [JWT authentication](https://github.com/charansaiburra/coursearena/blob/main/backend/src/main/java/com/coursearena/auth/JwtService.java): `backend/src/main/java/com/coursearena/auth/JwtService.java`
- [User records](https://github.com/charansaiburra/coursearena/blob/main/backend/src/main/java/com/coursearena/user/User.java): `backend/src/main/java/com/coursearena/user/User.java`
- [AI assistant](https://github.com/charansaiburra/coursearena/blob/main/backend/src/main/java/com/coursearena/ai/OpenAiAiService.java): `backend/src/main/java/com/coursearena/ai/OpenAiAiService.java`
- [Compiler endpoint](https://github.com/charansaiburra/coursearena/blob/main/backend/src/main/java/com/coursearena/compiler/CompilerService.java): `backend/src/main/java/com/coursearena/compiler/CompilerService.java`
- [Spring REST backend](https://github.com/charansaiburra/coursearena/blob/main/backend/src/main/java/com/coursearena/CourseArenaApplication.java): `backend/src/main/java/com/coursearena/CourseArenaApplication.java`
- **Relational database**

### Other components

- **Learner**
- **Docker containers**
- **OpenAI provider**

## Connections

- Learner → React application: uses (evidence: `README.md`)
- React application → Spring REST backend: calls REST API (evidence: `README.md`)
- React application → Course workspace: routes to (evidence: `frontend/src/App.jsx`)
- Course workspace → Spring REST backend: loads course content
- Spring REST backend → Enrollment: serves enrollment
- Enrollment → User records: looks up user (evidence: `backend/src/main/java/com/coursearena/enrollment/EnrollmentService.java`)
- Enrollment → Course catalog: looks up course (evidence: `backend/src/main/java/com/coursearena/enrollment/EnrollmentService.java`)
- Enrollment → Learning progress: deletes progress (evidence: `backend/src/main/java/com/coursearena/enrollment/EnrollmentService.java`)
- Spring REST backend → Lesson content: serves lessons
- Spring REST backend → Learning progress: tracks completion
- Spring REST backend → Practice arena: serves practice
- Practice arena → Code sandbox: executes code (evidence: `backend/src/main/java/com/coursearena/practice/PracticeService.java`)
- Practice arena → SQL practice: uses problem data (evidence: `backend/src/main/java/com/coursearena/practice/PracticeService.java`)
- Spring REST backend → Course assessments: serves assessments
- Spring REST backend → Career preparation: serves career prep
- Spring REST backend → ArenaPro cohorts: serves cohort learning
- Spring REST backend → JWT authentication: secures endpoints
- JWT authentication → User records: authenticates users
- Spring REST backend → AI assistant: serves AI chat
- AI assistant → OpenAI provider: requests responses (evidence: `README.md`)
- Spring REST backend → Compiler endpoint: serves compilation
- Compiler endpoint → Code sandbox: runs arbitrary code (evidence: `README.md`)
- Code sandbox → Docker containers: runs isolated jobs (evidence: `backend/src/main/java/com/coursearena/practice/coding/DockerCodeExecutionService.java`)
- Spring REST backend → Relational database: persists data (evidence: `README.md`)
- Auth and theme → Spring REST backend: sends JWT requests (evidence: `README.md`)
