# cameronmoodley/rubricheck architecture

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

- Interactive diagram: https://gitdiagram.com/cameronmoodley/rubricheck
- Repository: https://github.com/cameronmoodley/rubricheck

## Overview

RubriCheck is a web app for managing classes and assessments and processing student work through rubric-based grading. The main workflow is a teacher uploading papers and rubric material, the backend forwarding grading work to n8n, then receiving grades for review and results. The frontend also supports quizzes, exam projects, rubric templates, student grades, and administration. The excerpts show upload callbacks and some persistence, but not the full route mounting or all frontend-to-backend calls; those links are omitted or marked unverified.

Main entry points: [`frontend/src/App.tsx`](https://github.com/cameronmoodley/rubricheck/blob/main/frontend/src/App.tsx) (App routes), [`backend/src/routes/upload.ts`](https://github.com/cameronmoodley/rubricheck/blob/main/backend/src/routes/upload.ts) (Submission and grading), [`backend/src/auth/auth.ts`](https://github.com/cameronmoodley/rubricheck/blob/main/backend/src/auth/auth.ts) (Authentication), [`frontend/src/context/AuthContext.tsx`](https://github.com/cameronmoodley/rubricheck/blob/main/frontend/src/context/AuthContext.tsx) (Auth state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_app["App routes<br/>[App.tsx]"]
  node_authui["Auth state<br/>[AuthContext.tsx]"]
  node_api["API client<br/>[api.ts]"]
  node_dashboard["Dashboard<br/>[DashboardPage.tsx]"]
  node_classesui["Classes<br/>[ClassesPage.tsx]"]
  node_examui["Exam projects"]
  node_examresults["Exam results"]
  node_results["Grading results<br/>[ResultsPage.tsx]"]
  node_quizui["Quizzes<br/>[QuizPage.tsx]"]
  node_uploadui["Paper upload<br/>[UploadPage.tsx]"]
  node_templatesui["Rubric templates"]
end

subgraph group_grading["Grading workflow"]
  node_upload["Submission and grading<br/>[upload.ts]"]
  node_quiz["Quiz API<br/>[quiz.ts]"]
  node_rubricdata["Built-in rubrics"]
end

subgraph group_identity["Identity and auditing"]
  node_authbackend["Authentication<br/>[auth.ts]"]
  node_authroutes["Auth routes<br/>[auth.ts]"]
  node_audit["Audit logging<br/>[audit.ts]"]
  node_email["Email service<br/>[email.ts]"]
end

subgraph group_academics["Academic management"]
  node_academicapi["Classes and subjects API<br/>[index.ts]"]
  node_students["Student API<br/>[student.ts]"]
  node_rubricapi["Rubric template API"]
end

node_teacher(("Teacher / admin"))
node_n8n{{"n8n grading service"}}
node_database[("Application database")]

node_teacher -->|"uses"| node_app
node_app -->|"provides auth"| node_authui
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_classesui
node_app -->|"routes to"| node_examui
node_app -->|"routes to"| node_examresults
node_app -->|"routes to"| node_results
node_app -->|"routes to"| node_quizui
node_app -->|"routes to"| node_uploadui
node_app -->|"routes to"| node_templatesui
node_authui -->|"validates token"| node_api
node_uploadui -.->|"submits work"| node_upload
node_results -.->|"requests results"| node_upload
node_examresults -.->|"requests results"| node_upload
node_classesui -.->|"requests classes"| node_academicapi
node_quizui -.->|"requests quizzes"| node_quiz
node_templatesui -.->|"requests templates"| node_rubricapi
node_authroutes -->|"uses handlers"| node_authbackend
node_upload -->|"posts grading job"| node_n8n
node_n8n -->|"returns grades"| node_upload
node_upload -->|"stores grades"| node_database
node_upload -->|"sends completion"| node_email
node_authbackend -->|"sends reset mail"| node_email
node_authbackend -->|"records reset"| node_audit
node_academicapi -->|"reads and writes"| node_database
node_students -.->|"accesses student data"| node_database
node_rubricapi -->|"uses templates"| node_rubricdata

click node_app "https://github.com/cameronmoodley/rubricheck/blob/main/frontend/src/App.tsx"
click node_authui "https://github.com/cameronmoodley/rubricheck/blob/main/frontend/src/context/AuthContext.tsx"
click node_api "https://github.com/cameronmoodley/rubricheck/blob/main/frontend/src/lib/api.ts"
click node_dashboard "https://github.com/cameronmoodley/rubricheck/blob/main/frontend/src/DashboardPage.tsx"
click node_classesui "https://github.com/cameronmoodley/rubricheck/blob/main/frontend/src/ClassesPage.tsx"
click node_examui "https://github.com/cameronmoodley/rubricheck/blob/main/frontend/src/ExamProjectsPage.tsx"
click node_examresults "https://github.com/cameronmoodley/rubricheck/blob/main/frontend/src/ExamProjectResultsPage.tsx"
click node_results "https://github.com/cameronmoodley/rubricheck/blob/main/frontend/src/ResultsPage.tsx"
click node_quizui "https://github.com/cameronmoodley/rubricheck/blob/main/frontend/src/QuizPage.tsx"
click node_uploadui "https://github.com/cameronmoodley/rubricheck/blob/main/frontend/src/UploadPage.tsx"
click node_templatesui "https://github.com/cameronmoodley/rubricheck/blob/main/frontend/src/RubricTemplatesPage.tsx"
click node_authbackend "https://github.com/cameronmoodley/rubricheck/blob/main/backend/src/auth/auth.ts"
click node_authroutes "https://github.com/cameronmoodley/rubricheck/blob/main/backend/src/routes/auth.ts"
click node_audit "https://github.com/cameronmoodley/rubricheck/blob/main/backend/src/lib/audit.ts"
click node_upload "https://github.com/cameronmoodley/rubricheck/blob/main/backend/src/routes/upload.ts"
click node_quiz "https://github.com/cameronmoodley/rubricheck/blob/main/backend/src/routes/quiz.ts"
click node_rubricdata "https://github.com/cameronmoodley/rubricheck/blob/main/backend/src/data/rubric-templates.ts"
click node_email "https://github.com/cameronmoodley/rubricheck/blob/main/backend/src/lib/email.ts"
click node_academicapi "https://github.com/cameronmoodley/rubricheck/blob/main/backend/src/index.ts"
click node_students "https://github.com/cameronmoodley/rubricheck/blob/main/backend/src/routes/student.ts"
click node_rubricapi "https://github.com/cameronmoodley/rubricheck/blob/main/backend/src/routes/rubric-templates.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_app,node_authui,node_api,node_dashboard,node_classesui,node_examui,node_examresults,node_results,node_quizui,node_uploadui,node_templatesui toneBlue
class node_upload,node_quiz,node_rubricdata,node_database toneAmber
class node_authbackend,node_authroutes,node_audit,node_email toneMint
class node_academicapi,node_students,node_rubricapi toneRose
class node_teacher,node_n8n toneIndigo
```

## Components

### Web application

- [App routes](https://github.com/cameronmoodley/rubricheck/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Auth state](https://github.com/cameronmoodley/rubricheck/blob/main/frontend/src/context/AuthContext.tsx): `frontend/src/context/AuthContext.tsx`
- [API client](https://github.com/cameronmoodley/rubricheck/blob/main/frontend/src/lib/api.ts): `frontend/src/lib/api.ts`
- [Dashboard](https://github.com/cameronmoodley/rubricheck/blob/main/frontend/src/DashboardPage.tsx): `frontend/src/DashboardPage.tsx`
- [Classes](https://github.com/cameronmoodley/rubricheck/blob/main/frontend/src/ClassesPage.tsx): `frontend/src/ClassesPage.tsx`
- [Exam projects](https://github.com/cameronmoodley/rubricheck/blob/main/frontend/src/ExamProjectsPage.tsx): `frontend/src/ExamProjectsPage.tsx`
- [Exam results](https://github.com/cameronmoodley/rubricheck/blob/main/frontend/src/ExamProjectResultsPage.tsx): `frontend/src/ExamProjectResultsPage.tsx`
- [Grading results](https://github.com/cameronmoodley/rubricheck/blob/main/frontend/src/ResultsPage.tsx): `frontend/src/ResultsPage.tsx`
- [Quizzes](https://github.com/cameronmoodley/rubricheck/blob/main/frontend/src/QuizPage.tsx): `frontend/src/QuizPage.tsx`
- [Paper upload](https://github.com/cameronmoodley/rubricheck/blob/main/frontend/src/UploadPage.tsx): `frontend/src/UploadPage.tsx`
- [Rubric templates](https://github.com/cameronmoodley/rubricheck/blob/main/frontend/src/RubricTemplatesPage.tsx): `frontend/src/RubricTemplatesPage.tsx`

### Grading workflow

- [Submission and grading](https://github.com/cameronmoodley/rubricheck/blob/main/backend/src/routes/upload.ts): `backend/src/routes/upload.ts`
- [Quiz API](https://github.com/cameronmoodley/rubricheck/blob/main/backend/src/routes/quiz.ts): `backend/src/routes/quiz.ts`
- [Built-in rubrics](https://github.com/cameronmoodley/rubricheck/blob/main/backend/src/data/rubric-templates.ts): `backend/src/data/rubric-templates.ts`

### Identity and auditing

- [Authentication](https://github.com/cameronmoodley/rubricheck/blob/main/backend/src/auth/auth.ts): `backend/src/auth/auth.ts`
- [Auth routes](https://github.com/cameronmoodley/rubricheck/blob/main/backend/src/routes/auth.ts): `backend/src/routes/auth.ts`
- [Audit logging](https://github.com/cameronmoodley/rubricheck/blob/main/backend/src/lib/audit.ts): `backend/src/lib/audit.ts`
- [Email service](https://github.com/cameronmoodley/rubricheck/blob/main/backend/src/lib/email.ts): `backend/src/lib/email.ts`

### Academic management

- [Classes and subjects API](https://github.com/cameronmoodley/rubricheck/blob/main/backend/src/index.ts): `backend/src/index.ts`
- [Student API](https://github.com/cameronmoodley/rubricheck/blob/main/backend/src/routes/student.ts): `backend/src/routes/student.ts`
- [Rubric template API](https://github.com/cameronmoodley/rubricheck/blob/main/backend/src/routes/rubric-templates.ts): `backend/src/routes/rubric-templates.ts`

### Other components

- **Teacher / admin**
- **n8n grading service**
- **Application database**

## Connections

- Teacher / admin → App routes: uses (evidence: `frontend/src/App.tsx`)
- App routes → Auth state: provides auth (evidence: `frontend/src/App.tsx`)
- App routes → Dashboard: routes to (evidence: `frontend/src/App.tsx`)
- App routes → Classes: routes to (evidence: `frontend/src/App.tsx`)
- App routes → Exam projects: routes to (evidence: `frontend/src/App.tsx`)
- App routes → Exam results: routes to (evidence: `frontend/src/App.tsx`)
- App routes → Grading results: routes to (evidence: `frontend/src/App.tsx`)
- App routes → Quizzes: routes to (evidence: `frontend/src/App.tsx`)
- App routes → Paper upload: routes to (evidence: `frontend/src/App.tsx`)
- App routes → Rubric templates: routes to (evidence: `frontend/src/App.tsx`)
- Auth state → API client: validates token (evidence: `frontend/src/context/AuthContext.tsx`)
- Paper upload → Submission and grading: submits work
- Grading results → Submission and grading: requests results
- Exam results → Submission and grading: requests results
- Classes → Classes and subjects API: requests classes
- Quizzes → Quiz API: requests quizzes
- Rubric templates → Rubric template API: requests templates
- Auth routes → Authentication: uses handlers (evidence: `backend/src/routes/auth.ts`)
- Submission and grading → n8n grading service: posts grading job (evidence: `backend/src/routes/upload.ts`)
- n8n grading service → Submission and grading: returns grades (evidence: `backend/src/routes/upload.ts`)
- Submission and grading → Application database: stores grades (evidence: `backend/src/routes/upload.ts`)
- Submission and grading → Email service: sends completion (evidence: `backend/src/routes/upload.ts`)
- Authentication → Email service: sends reset mail (evidence: `backend/src/auth/auth.ts`)
- Authentication → Audit logging: records reset (evidence: `backend/src/auth/auth.ts`)
- Classes and subjects API → Application database: reads and writes (evidence: `backend/src/index.ts`)
- Student API → Application database: accesses student data
- Rubric template API → Built-in rubrics: uses templates (evidence: `backend/src/routes/rubric-templates.ts`)
