# cs3227-2610-mp4-codeleet/cs3227-2610-mp4 architecture

> Architecture diagram of the GitHub repository cs3227-2610-mp4-codeleet/cs3227-2610-mp4, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4
- Repository: https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4

## Overview

CodeLeet is an authenticated learning platform for programming courses. Students join a course, work on assignments, run Python or Java code in the browser, submit revisions, and follow grades and progress; instructors author assignments and practice cases, review submissions, and publish grades. Course discussions, XP, leaderboards, and role-specific AI assistance are distinct product branches. The graph combines README-described capabilities with relationships visible in sampled source and the SOURCE INDEX; unsampled subsystems are represented without speculative internal links.

Main entry points: [`src/lib/auth/verified-user.ts`](https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/lib/auth/verified-user.ts) (Verified identity), [`src/app/api/assignments/route.ts`](https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/app/api/assignments/route.ts) (Assignment service), [`src/app/api/submissions/route.ts`](https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/app/api/submissions/route.ts) (Submission service), [`src/features/student-assignments/workspace-shell.tsx`](https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/features/student-assignments/workspace-shell.tsx) (Student assignment workspace)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_courses["Courses and access"]
  node_course_ui["Course workspaces"]
  node_course_api["Course services<br/>[http.ts]"]
  node_course_access["Membership and features<br/>[access.ts]"]
end

subgraph group_learning["Programming and assessment"]
  node_assignment_ui["Assignment authoring<br/>[page.tsx]"]
  node_assignment_api["Assignment service<br/>[route.ts]"]
  node_assignment_contracts["Assignment contracts<br/>[contracts.ts]"]
  node_student_workspace["Student assignment workspace"]
  node_browser_runner["Browser code runner<br/>[browser-client.ts]"]
  node_drafts["Draft recovery<br/>[draft-storage.ts]"]
  node_submission_api["Submission service<br/>[route.ts]"]
  node_practice_tests["Practice tests<br/>[routes.ts]"]
  node_grades["Grades and publication<br/>[route.ts]"]
end

subgraph group_assistance["AI assistance"]
  node_ai_review["AI review service<br/>[review-service.ts]"]
  node_ai_provider["SoCLaaS model service<br/>[soclaas.ts]"]
  node_ai_routes["AI review routes<br/>[review-route.ts]"]
end

subgraph group_engagement["Progress and community"]
  node_forums["Course discussions<br/>[components.tsx]"]
  node_progress["Student progress<br/>[components.tsx]"]
  node_leaderboard["XP and leaderboard<br/>[queries.server.ts]"]
end

subgraph group_foundation["Identity and services"]
  node_auth["Account access<br/>[page.tsx]"]
  node_verified["Verified identity<br/>[verified-user.ts]"]
  node_supabase[("Supabase service<br/>[server.ts]")]
end

node_user(("Student or instructor"))

node_user -->|"signs in"| node_auth
node_auth -.->|"verifies account"| node_verified
node_verified -->|"creates client"| node_supabase
node_user -->|"enters courses"| node_course_ui
node_course_ui -->|"uses course services"| node_course_api
node_course_api -->|"verifies user"| node_verified
node_course_api -->|"reads and updates"| node_supabase
node_assignment_ui -->|"saves assignment"| node_assignment_api
node_assignment_api -->|"verifies user"| node_verified
node_assignment_api -->|"checks access"| node_course_access
node_assignment_api -->|"validates input"| node_assignment_contracts
node_assignment_api -->|"reads and saves"| node_supabase
node_user -->|"works on assignment"| node_student_workspace
node_student_workspace -.->|"runs code"| node_browser_runner
node_student_workspace -.->|"recovers drafts"| node_drafts
node_student_workspace -->|"submits solution"| node_submission_api
node_submission_api -->|"verifies user"| node_verified
node_submission_api -->|"checks access"| node_course_access
node_submission_api -->|"validates submission"| node_assignment_contracts
node_submission_api -->|"stores revision"| node_supabase
node_assignment_ui -->|"authors practice cases"| node_practice_tests
node_user -->|"reviews and publishes"| node_grades
node_user -->|"requests assistance"| node_ai_routes
node_ai_routes -->|"verifies user"| node_verified
node_ai_routes -->|"dispatches review"| node_ai_review
node_ai_review -->|"requests completion"| node_ai_provider
node_user -->|"discusses coursework"| node_forums
node_user -->|"checks progress"| node_progress
node_user -->|"checks XP ranking"| node_leaderboard

click node_auth "https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/app/sign-in/page.tsx"
click node_verified "https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/lib/auth/verified-user.ts"
click node_supabase "https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/lib/supabase/server.ts"
click node_course_ui "https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/features/course-workspaces/course-workspace.tsx"
click node_course_api "https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/features/course-workspaces/http.ts"
click node_course_access "https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/lib/courses/access.ts"
click node_assignment_ui "https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/app/courses/%5BcourseId%5D/assignments/new/page.tsx"
click node_assignment_api "https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/app/api/assignments/route.ts"
click node_assignment_contracts "https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/features/codementor/contracts.ts"
click node_student_workspace "https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/features/student-assignments/workspace-shell.tsx"
click node_browser_runner "https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/features/student-submissions/browser-client.ts"
click node_drafts "https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/features/student-submissions/draft-storage.ts"
click node_submission_api "https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/app/api/submissions/route.ts"
click node_practice_tests "https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/features/practice-test-authoring/routes.ts"
click node_grades "https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/app/api/grades/%5Bid%5D/route.ts"
click node_ai_review "https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/features/codementor/review-service.ts"
click node_ai_provider "https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/lib/ai/soclaas.ts"
click node_ai_routes "https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/lib/ai/review-route.ts"
click node_forums "https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/features/forums/components.tsx"
click node_progress "https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/features/student-progress/components.tsx"
click node_leaderboard "https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/features/leaderboard/queries.server.ts"

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_course_ui,node_course_api,node_course_access toneBlue
class node_assignment_ui,node_assignment_api,node_assignment_contracts,node_student_workspace,node_browser_runner,node_drafts,node_submission_api,node_practice_tests,node_grades toneAmber
class node_ai_review,node_ai_provider,node_ai_routes toneMint
class node_forums,node_progress,node_leaderboard toneRose
class node_auth,node_verified,node_supabase,node_user toneIndigo
```

## Components

### Courses and access

- [Course workspaces](https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/features/course-workspaces/course-workspace.tsx): `src/features/course-workspaces/course-workspace.tsx`
- [Course services](https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/features/course-workspaces/http.ts): `src/features/course-workspaces/http.ts`
- [Membership and features](https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/lib/courses/access.ts): `src/lib/courses/access.ts`

### Programming and assessment

- [Assignment authoring](https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/app/courses/%5BcourseId%5D/assignments/new/page.tsx): `src/app/courses/[courseId]/assignments/new/page.tsx`
- [Assignment service](https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/app/api/assignments/route.ts): `src/app/api/assignments/route.ts`
- [Assignment contracts](https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/features/codementor/contracts.ts): `src/features/codementor/contracts.ts`
- [Student assignment workspace](https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/features/student-assignments/workspace-shell.tsx): `src/features/student-assignments/workspace-shell.tsx`
- [Browser code runner](https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/features/student-submissions/browser-client.ts): `src/features/student-submissions/browser-client.ts`
- [Draft recovery](https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/features/student-submissions/draft-storage.ts): `src/features/student-submissions/draft-storage.ts`
- [Submission service](https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/app/api/submissions/route.ts): `src/app/api/submissions/route.ts`
- [Practice tests](https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/features/practice-test-authoring/routes.ts): `src/features/practice-test-authoring/routes.ts`
- [Grades and publication](https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/app/api/grades/%5Bid%5D/route.ts): `src/app/api/grades/[id]/route.ts`

### AI assistance

- [AI review service](https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/features/codementor/review-service.ts): `src/features/codementor/review-service.ts`
- [SoCLaaS model service](https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/lib/ai/soclaas.ts): `src/lib/ai/soclaas.ts`
- [AI review routes](https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/lib/ai/review-route.ts): `src/lib/ai/review-route.ts`

### Progress and community

- [Course discussions](https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/features/forums/components.tsx): `src/features/forums/components.tsx`
- [Student progress](https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/features/student-progress/components.tsx): `src/features/student-progress/components.tsx`
- [XP and leaderboard](https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/features/leaderboard/queries.server.ts): `src/features/leaderboard/queries.server.ts`

### Identity and services

- [Account access](https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/app/sign-in/page.tsx): `src/app/sign-in/page.tsx`
- [Verified identity](https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/lib/auth/verified-user.ts): `src/lib/auth/verified-user.ts`
- [Supabase service](https://github.com/cs3227-2610-mp4-codeleet/cs3227-2610-mp4/blob/develop/src/lib/supabase/server.ts): `src/lib/supabase/server.ts`

### Other components

- **Student or instructor**

## Connections

- Student or instructor → Account access: signs in (evidence: `README.md`)
- Account access → Verified identity: verifies account
- Verified identity → Supabase service: creates client (evidence: `src/lib/auth/verified-user.ts`)
- Student or instructor → Course workspaces: enters courses (evidence: `README.md`)
- Course workspaces → Course services: uses course services (evidence: `src/features/course-workspaces/http.ts`)
- Course services → Verified identity: verifies user (evidence: `src/features/course-workspaces/http.ts`)
- Course services → Supabase service: reads and updates (evidence: `src/features/course-workspaces/http.ts`)
- Assignment authoring → Assignment service: saves assignment (evidence: `README.md`)
- Assignment service → Verified identity: verifies user (evidence: `src/app/api/assignments/route.ts`)
- Assignment service → Membership and features: checks access (evidence: `src/app/api/assignments/route.ts`)
- Assignment service → Assignment contracts: validates input (evidence: `src/app/api/assignments/route.ts`)
- Assignment service → Supabase service: reads and saves (evidence: `src/app/api/assignments/route.ts`)
- Student or instructor → Student assignment workspace: works on assignment (evidence: `README.md`)
- Student assignment workspace → Browser code runner: runs code
- Student assignment workspace → Draft recovery: recovers drafts
- Student assignment workspace → Submission service: submits solution (evidence: `README.md`)
- Submission service → Verified identity: verifies user (evidence: `src/app/api/submissions/route.ts`)
- Submission service → Membership and features: checks access (evidence: `src/app/api/submissions/route.ts`)
- Submission service → Assignment contracts: validates submission (evidence: `src/app/api/submissions/route.ts`)
- Submission service → Supabase service: stores revision (evidence: `src/app/api/submissions/route.ts`)
- Assignment authoring → Practice tests: authors practice cases (evidence: `README.md`)
- Student or instructor → Grades and publication: reviews and publishes (evidence: `README.md`)
- Student or instructor → AI review routes: requests assistance (evidence: `README.md`)
- AI review routes → Verified identity: verifies user (evidence: `src/lib/ai/review-route.ts`)
- AI review routes → AI review service: dispatches review (evidence: `src/lib/ai/review-route.ts`)
- AI review service → SoCLaaS model service: requests completion (evidence: `src/features/codementor/review-service.ts`)
- Student or instructor → Course discussions: discusses coursework (evidence: `README.md`)
- Student or instructor → Student progress: checks progress (evidence: `README.md`)
- Student or instructor → XP and leaderboard: checks XP ranking (evidence: `README.md`)
