# multiagentcodereview2026/codeassessment architecture

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

- Interactive diagram: https://gitdiagram.com/multiagentcodereview2026/codeassessment
- Repository: https://github.com/multiagentcodereview2026/codeassessment

## Overview

CodeAssessment is a programming-education platform: students select problems, run public tests, submit for authoritative judging, and receive scored explanations and improvement guidance; instructors manage courses and review learner progress. The principal runtime spans the React interface, FastAPI, a separate sandboxed execution service, a LangGraph assessment workflow, and persistent storage. The graph preserves the documented analysis and teaching stages plus instructor capabilities. Some source was not sampled, so links for documented subsystems cite the README rather than implying their internals were inspected.

Main entry points: [`backend/main.py`](https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/main.py) (Backend API), [`backend/workflow/graph.py`](https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/workflow/graph.py) (Assessment graph), [`backend/agents/aggregation.py`](https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/agents/aggregation.py) (Score aggregation), [`backend/agents/complexity.py`](https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/agents/complexity.py) (Complexity analysis)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_student_ui["Student experience"]
  node_workspace["Problem workspace"]
  node_problem_catalog["Problem catalogue"]
  node_assessment_result["Assessment result"]
  node_feedback["Feedback and recommendations"]
  node_frontend_routes["Application routes<br/>[App.jsx]"]
end

subgraph group_backend["Backend services"]
  node_backend_api["Backend API<br/>[main.py]"]
  node_authentication["Authentication<br/>[auth.py]"]
  node_database[("Assessment database<br/>[database.py]")]
  node_problem_cases["Problem and judge cases"]
end

subgraph group_execution["Code execution"]
  node_execution_client["Execution client<br/>[executor.py]"]
  node_execution_service["Execution API<br/>[main.py]"]
  node_case_worker["Case orchestration<br/>[queue_worker.py]"]
  node_sandbox["Sandbox runner<br/>[sandbox.py]"]
end

subgraph group_assessment["Assessment workflow"]
  node_evaluation_graph["Assessment graph<br/>[graph.py]"]
  node_correctness["Correctness scoring<br/>[correctness.py]"]
  node_complexity["Complexity analysis<br/>[complexity.py]"]
  node_ast_analysis["AST analysis<br/>[ast_engine.py]"]
  node_style_similarity["Style and similarity"]
  node_aggregation["Score aggregation<br/>[aggregation.py]"]
  node_teaching_feedback["Teaching feedback<br/>[explainability.py]"]
  node_recommendations["Recommendations<br/>[recommendation.py]"]
  node_code_revision["Revised code<br/>[revision.py]"]
  node_score_projection["Score projection<br/>[projection.py]"]
end

subgraph group_instructors["Instructor tools"]
  node_instructor_ui["Instructor workspace"]
  node_assignments_ui["Assignment manager"]
  node_instructor_analytics["Instructor analytics<br/>[main.py]"]
end

node_student(("Student"))
node_instructor(("Instructor"))

node_student -->|"selects problem"| node_problem_catalog
node_student -->|"writes code"| node_workspace
node_problem_catalog -->|"loads problems"| node_backend_api
node_workspace -->|"runs or submits"| node_backend_api
node_backend_api -->|"loads judge cases"| node_problem_cases
node_backend_api -->|"requests execution"| node_execution_client
node_execution_client -->|"posts execution request"| node_execution_service
node_execution_service -->|"dispatches request"| node_case_worker
node_case_worker -->|"runs test cases"| node_sandbox
node_backend_api -->|"invokes assessment"| node_evaluation_graph
node_evaluation_graph -->|"dispatches"| node_correctness
node_evaluation_graph -->|"dispatches"| node_complexity
node_evaluation_graph -->|"dispatches"| node_style_similarity
node_complexity -->|"uses static analysis"| node_ast_analysis
node_correctness -.->|"feeds score"| node_aggregation
node_complexity -->|"feeds score"| node_aggregation
node_style_similarity -->|"feeds score"| node_aggregation
node_aggregation -->|"provides assessment"| node_teaching_feedback
node_teaching_feedback -->|"feeds guidance"| node_recommendations
node_recommendations -->|"guides revision"| node_code_revision
node_code_revision -->|"feeds projection"| node_score_projection
node_backend_api -->|"reads and writes"| node_database
node_backend_api -->|"returns assessment"| node_assessment_result
node_assessment_result -->|"shows guidance"| node_feedback
node_student -->|"signs in"| node_authentication
node_frontend_routes -->|"routes to"| node_workspace
node_instructor -->|"reviews courses"| node_instructor_ui
node_instructor -->|"manages assignments"| node_assignments_ui
node_assignments_ui -->|"manages assignments"| node_backend_api
node_instructor_ui -->|"views analytics"| node_instructor_analytics
node_instructor_analytics -->|"reads persisted data"| node_database

click node_workspace "https://github.com/multiagentcodereview2026/codeassessment/blob/main/frontend/src/components/student/ProblemWorkspace.tsx"
click node_problem_catalog "https://github.com/multiagentcodereview2026/codeassessment/blob/main/frontend/src/components/student/ProblemsListView.tsx"
click node_assessment_result "https://github.com/multiagentcodereview2026/codeassessment/blob/main/frontend/src/components/student/AssessmentResultView.tsx"
click node_feedback "https://github.com/multiagentcodereview2026/codeassessment/blob/main/frontend/src/components/student/FeedbackRecommendationsView.tsx"
click node_frontend_routes "https://github.com/multiagentcodereview2026/codeassessment/blob/main/frontend/src/App.jsx"
click node_backend_api "https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/main.py"
click node_authentication "https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/auth.py"
click node_database "https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/database.py"
click node_problem_cases "https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/instructor_repository.py"
click node_execution_client "https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/docker_runner/executor.py"
click node_execution_service "https://github.com/multiagentcodereview2026/codeassessment/blob/main/docker-execution-engine/app/main.py"
click node_case_worker "https://github.com/multiagentcodereview2026/codeassessment/blob/main/docker-execution-engine/app/queue_worker.py"
click node_sandbox "https://github.com/multiagentcodereview2026/codeassessment/blob/main/docker-execution-engine/app/sandbox.py"
click node_evaluation_graph "https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/workflow/graph.py"
click node_correctness "https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/agents/correctness.py"
click node_complexity "https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/agents/complexity.py"
click node_ast_analysis "https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/analysis/ast_engine.py"
click node_style_similarity "https://github.com/multiagentcodereview2026/codeassessment/tree/main/backend/agents"
click node_aggregation "https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/agents/aggregation.py"
click node_teaching_feedback "https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/agents/explainability.py"
click node_recommendations "https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/agents/recommendation.py"
click node_code_revision "https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/agents/revision.py"
click node_score_projection "https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/agents/projection.py"
click node_instructor_ui "https://github.com/multiagentcodereview2026/codeassessment/blob/main/frontend/src/components/instructor/CourseDetailsView.tsx"
click node_assignments_ui "https://github.com/multiagentcodereview2026/codeassessment/blob/main/frontend/src/components/instructor/AssignmentsManagerView.tsx"
click node_instructor_analytics "https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/main.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_workspace,node_problem_catalog,node_assessment_result,node_feedback,node_frontend_routes toneBlue
class node_backend_api,node_authentication,node_database,node_problem_cases toneAmber
class node_execution_client,node_execution_service,node_case_worker,node_sandbox toneMint
class node_evaluation_graph,node_correctness,node_complexity,node_ast_analysis,node_style_similarity,node_aggregation,node_teaching_feedback,node_recommendations,node_code_revision,node_score_projection toneRose
class node_instructor_ui,node_assignments_ui,node_instructor_analytics,node_student,node_instructor toneIndigo
```

## Components

### Student experience

- [Problem workspace](https://github.com/multiagentcodereview2026/codeassessment/blob/main/frontend/src/components/student/ProblemWorkspace.tsx): `frontend/src/components/student/ProblemWorkspace.tsx`
- [Problem catalogue](https://github.com/multiagentcodereview2026/codeassessment/blob/main/frontend/src/components/student/ProblemsListView.tsx): `frontend/src/components/student/ProblemsListView.tsx`
- [Assessment result](https://github.com/multiagentcodereview2026/codeassessment/blob/main/frontend/src/components/student/AssessmentResultView.tsx): `frontend/src/components/student/AssessmentResultView.tsx`
- [Feedback and recommendations](https://github.com/multiagentcodereview2026/codeassessment/blob/main/frontend/src/components/student/FeedbackRecommendationsView.tsx): `frontend/src/components/student/FeedbackRecommendationsView.tsx`
- [Application routes](https://github.com/multiagentcodereview2026/codeassessment/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`

### Backend services

- [Backend API](https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/main.py): `backend/main.py`
- [Authentication](https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/auth.py): `backend/auth.py`
- [Assessment database](https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/database.py): `backend/database.py`
- [Problem and judge cases](https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/instructor_repository.py): `backend/instructor_repository.py`

### Code execution

- [Execution client](https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/docker_runner/executor.py): `backend/docker_runner/executor.py`
- [Execution API](https://github.com/multiagentcodereview2026/codeassessment/blob/main/docker-execution-engine/app/main.py): `docker-execution-engine/app/main.py`
- [Case orchestration](https://github.com/multiagentcodereview2026/codeassessment/blob/main/docker-execution-engine/app/queue_worker.py): `docker-execution-engine/app/queue_worker.py`
- [Sandbox runner](https://github.com/multiagentcodereview2026/codeassessment/blob/main/docker-execution-engine/app/sandbox.py): `docker-execution-engine/app/sandbox.py`

### Assessment workflow

- [Assessment graph](https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/workflow/graph.py): `backend/workflow/graph.py`
- [Correctness scoring](https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/agents/correctness.py): `backend/agents/correctness.py`
- [Complexity analysis](https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/agents/complexity.py): `backend/agents/complexity.py`
- [AST analysis](https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/analysis/ast_engine.py): `backend/analysis/ast_engine.py`
- [Style and similarity](https://github.com/multiagentcodereview2026/codeassessment/tree/main/backend/agents): `backend/agents`
- [Score aggregation](https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/agents/aggregation.py): `backend/agents/aggregation.py`
- [Teaching feedback](https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/agents/explainability.py): `backend/agents/explainability.py`
- [Recommendations](https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/agents/recommendation.py): `backend/agents/recommendation.py`
- [Revised code](https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/agents/revision.py): `backend/agents/revision.py`
- [Score projection](https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/agents/projection.py): `backend/agents/projection.py`

### Instructor tools

- [Instructor workspace](https://github.com/multiagentcodereview2026/codeassessment/blob/main/frontend/src/components/instructor/CourseDetailsView.tsx): `frontend/src/components/instructor/CourseDetailsView.tsx`
- [Assignment manager](https://github.com/multiagentcodereview2026/codeassessment/blob/main/frontend/src/components/instructor/AssignmentsManagerView.tsx): `frontend/src/components/instructor/AssignmentsManagerView.tsx`
- [Instructor analytics](https://github.com/multiagentcodereview2026/codeassessment/blob/main/backend/main.py): `backend/main.py`

### Other components

- **Student**
- **Instructor**

## Connections

- Student → Problem catalogue: selects problem
- Student → Problem workspace: writes code
- Problem catalogue → Backend API: loads problems
- Problem workspace → Backend API: runs or submits
- Backend API → Problem and judge cases: loads judge cases (evidence: `backend/main.py`)
- Backend API → Execution client: requests execution (evidence: `backend/main.py`)
- Execution client → Execution API: posts execution request (evidence: `backend/docker_runner/executor.py`)
- Execution API → Case orchestration: dispatches request (evidence: `docker-execution-engine/app/main.py`)
- Case orchestration → Sandbox runner: runs test cases (evidence: `docker-execution-engine/app/queue_worker.py`)
- Backend API → Assessment graph: invokes assessment (evidence: `backend/main.py`)
- Assessment graph → Correctness scoring: dispatches (evidence: `backend/workflow/graph.py`)
- Assessment graph → Complexity analysis: dispatches (evidence: `backend/workflow/graph.py`)
- Assessment graph → Style and similarity: dispatches (evidence: `backend/workflow/graph.py`)
- Complexity analysis → AST analysis: uses static analysis (evidence: `backend/agents/complexity.py`)
- Correctness scoring → Score aggregation: feeds score
- Complexity analysis → Score aggregation: feeds score (evidence: `backend/workflow/graph.py`)
- Style and similarity → Score aggregation: feeds score (evidence: `backend/workflow/graph.py`)
- Score aggregation → Teaching feedback: provides assessment (evidence: `backend/workflow/graph.py`)
- Teaching feedback → Recommendations: feeds guidance (evidence: `backend/workflow/graph.py`)
- Recommendations → Revised code: guides revision (evidence: `backend/workflow/graph.py`)
- Revised code → Score projection: feeds projection (evidence: `backend/workflow/graph.py`)
- Backend API → Assessment database: reads and writes (evidence: `backend/main.py`)
- Backend API → Assessment result: returns assessment
- Assessment result → Feedback and recommendations: shows guidance
- Student → Authentication: signs in
- Application routes → Problem workspace: routes to (evidence: `frontend/src/App.jsx`)
- Instructor → Instructor workspace: reviews courses
- Instructor → Assignment manager: manages assignments
- Assignment manager → Backend API: manages assignments (evidence: `frontend/src/components/instructor/AssignmentsManagerView.tsx`)
- Instructor workspace → Instructor analytics: views analytics
- Instructor analytics → Assessment database: reads persisted data (evidence: `backend/main.py`)
