How cameronmoodley/rubricheck works
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: App.tsx App routes · upload.ts Submission and grading · auth.ts Authentication · AuthContext.tsx Auth state
Components 24
Web application
- App routes
frontend/src/App.tsx - Auth state
frontend/src/context/AuthContext.tsx - API client
frontend/src/lib/api.ts - Dashboard
frontend/src/DashboardPage.tsx - Classes
frontend/src/ClassesPage.tsx - Exam projects
frontend/src/ExamProjectsPage.tsx - Exam results
frontend/src/ExamProjectResultsPage.tsx - Grading results
frontend/src/ResultsPage.tsx - Quizzes
frontend/src/QuizPage.tsx - Paper upload
frontend/src/UploadPage.tsx - Rubric templates
frontend/src/RubricTemplatesPage.tsx
Grading workflow
- Submission and grading
backend/src/routes/upload.ts - Quiz API
backend/src/routes/quiz.ts - Built-in rubrics
backend/src/data/rubric-templates.ts
Identity and auditing
- Authentication
backend/src/auth/auth.ts - Auth routes
backend/src/routes/auth.ts - Audit logging
backend/src/lib/audit.ts - Email service
backend/src/lib/email.ts
Academic management
- Classes and subjects API
backend/src/index.ts - Student API
backend/src/routes/student.ts - Rubric template API
backend/src/routes/rubric-templates.ts
Other components
- Teacher / admin
- n8n grading service
- Application database
Connections 27
- Teacher / admin → App routes: uses
frontend/src/App.tsx - App routes → Auth state: provides auth
frontend/src/App.tsx - App routes → Dashboard: routes to
frontend/src/App.tsx - App routes → Classes: routes to
frontend/src/App.tsx - App routes → Exam projects: routes to
frontend/src/App.tsx - App routes → Exam results: routes to
frontend/src/App.tsx - App routes → Grading results: routes to
frontend/src/App.tsx - App routes → Quizzes: routes to
frontend/src/App.tsx - App routes → Paper upload: routes to
frontend/src/App.tsx - App routes → Rubric templates: routes to
frontend/src/App.tsx - Auth state → API client: validates token
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
backend/src/routes/auth.ts - Submission and grading → n8n grading service: posts grading job
backend/src/routes/upload.ts - n8n grading service → Submission and grading: returns grades
backend/src/routes/upload.ts - Submission and grading → Application database: stores grades
backend/src/routes/upload.ts - Submission and grading → Email service: sends completion
backend/src/routes/upload.ts - Authentication → Email service: sends reset mail
backend/src/auth/auth.ts - Authentication → Audit logging: records reset
backend/src/auth/auth.ts - Classes and subjects API → Application database: reads and writes
backend/src/index.ts - Student API → Application database: accesses student data
- Rubric template API → Built-in rubrics: uses templates
backend/src/routes/rubric-templates.ts