How multiagentcodereview2026/codeassessment works
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: main.py Backend API · graph.py Assessment graph · aggregation.py Score aggregation · complexity.py Complexity analysis
Components 28
Student experience
- Problem workspace
frontend/src/components/student/ProblemWorkspace.tsx - Problem catalogue
frontend/src/components/student/ProblemsListView.tsx - Assessment result
frontend/src/components/student/AssessmentResultView.tsx - Feedback and recommendations
frontend/src/components/student/FeedbackRecommendationsView.tsx - Application routes
frontend/src/App.jsx
Backend services
- Backend API
backend/main.py - Authentication
backend/auth.py - Assessment database
backend/database.py - Problem and judge cases
backend/instructor_repository.py
Code execution
- Execution client
backend/docker_runner/executor.py - Execution API
docker-execution-engine/app/main.py - Case orchestration
docker-execution-engine/app/queue_worker.py - Sandbox runner
docker-execution-engine/app/sandbox.py
Assessment workflow
- Assessment graph
backend/workflow/graph.py - Correctness scoring
backend/agents/correctness.py - Complexity analysis
backend/agents/complexity.py - AST analysis
backend/analysis/ast_engine.py - Style and similarity
backend/agents - Score aggregation
backend/agents/aggregation.py - Teaching feedback
backend/agents/explainability.py - Recommendations
backend/agents/recommendation.py - Revised code
backend/agents/revision.py - Score projection
backend/agents/projection.py
Instructor tools
- Instructor workspace
frontend/src/components/instructor/CourseDetailsView.tsx - Assignment manager
frontend/src/components/instructor/AssignmentsManagerView.tsx - Instructor analytics
backend/main.py
Other components
- Student
- Instructor
Connections 31
- 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
backend/main.py - Backend API → Execution client: requests execution
backend/main.py - Execution client → Execution API: posts execution request
backend/docker_runner/executor.py - Execution API → Case orchestration: dispatches request
docker-execution-engine/app/main.py - Case orchestration → Sandbox runner: runs test cases
docker-execution-engine/app/queue_worker.py - Backend API → Assessment graph: invokes assessment
backend/main.py - Assessment graph → Correctness scoring: dispatches
backend/workflow/graph.py - Assessment graph → Complexity analysis: dispatches
backend/workflow/graph.py - Assessment graph → Style and similarity: dispatches
backend/workflow/graph.py - Complexity analysis → AST analysis: uses static analysis
backend/agents/complexity.py - Correctness scoring → Score aggregation: feeds score
- Complexity analysis → Score aggregation: feeds score
backend/workflow/graph.py - Style and similarity → Score aggregation: feeds score
backend/workflow/graph.py - Score aggregation → Teaching feedback: provides assessment
backend/workflow/graph.py - Teaching feedback → Recommendations: feeds guidance
backend/workflow/graph.py - Recommendations → Revised code: guides revision
backend/workflow/graph.py - Revised code → Score projection: feeds projection
backend/workflow/graph.py - Backend API → Assessment database: reads and writes
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
frontend/src/App.jsx - Instructor → Instructor workspace: reviews courses
- Instructor → Assignment manager: manages assignments
- Assignment manager → Backend API: manages assignments
frontend/src/components/instructor/AssignmentsManagerView.tsx - Instructor workspace → Instructor analytics: views analytics
- Instructor analytics → Assessment database: reads persisted data
backend/main.py