How theunknownodysseus/ccc-seb works
CCC Assess is a self-hosted exam platform for administrators to configure question banks, students, exams and results, and for students to take timed MCQ, snippet and coding exams with optional Safe Exam Browser lockdown. The main workflow runs from role-based sign-in through exam management or exam attempt, autosave/submission, evaluation and reporting. The graph separates the React experience, API/domain services, persistence/security and code execution. Several subsystem links rely on the README or source-index references because their implementations were not excerpted.
Main entry points: main.py FastAPI application · student_exam.py Student exam routes · exams.py Exam management routes · evaluation_service.py Answer evaluation
Components 28
Web application
- Admin workspace
frontend/src/admin - Student exam UI
frontend/src/student - Login and SEB entry
frontend/src/pages - Frontend API services
frontend/src/services - Frontend routing
frontend/src/App.tsx
API and domain
- FastAPI application
backend/app/main.py - Authentication routes
backend/app/api/auth.py - Exam management routes
backend/app/api/exams.py - Question bank routes
backend/app/api/questions.py - Student management routes
backend/app/api/students.py - Student exam routes
backend/app/api/student_exam.py - Results routes
backend/app/api/results.py - Attempt lifecycle
backend/app/services/attempt_service.py - Exam services
backend/app/services/exam_service.py
Security and persistence
- Token authorization
backend/app/security/auth.py - SEB verification
backend/app/security/seb.py - SQLAlchemy session
backend/app/database/session.py - Exam data model
backend/app/models/models.py - Admin audit log
backend/app/services/audit.py
Evaluation and reporting
- Answer evaluation
backend/app/services/evaluation_service.py - Submission grading
backend/app/services/grading_service.py - Judge0 client
backend/app/services/judge0_client.py - Results analysis
backend/app/services/results_service.py - Results export
backend/app/services/results_export.py
External services
- Judge0 execution service
Other components
- Administrator
- Student
- Safe Exam Browser
Connections 35
- Frontend routing → Admin workspace: routes to
frontend/src/App.tsx - Frontend routing → Student exam UI: routes to
frontend/src/App.tsx - Frontend routing → Login and SEB entry: routes to
frontend/src/App.tsx - Administrator → Admin workspace: manages exams
README.md - Student → Student exam UI: takes exams
README.md - Admin workspace → Frontend API services: requests data
frontend/src/admin/ExamsPage.tsx - Student exam UI → Frontend API services: requests data
frontend/src/student/ExamTakingPage.tsx - Login and SEB entry → Frontend API services: authenticates via
frontend/src/pages/LoginPage.tsx - Frontend API services → FastAPI application: calls API
- FastAPI application → Authentication routes: registers routes
backend/app/main.py - FastAPI application → Exam management routes: registers routes
backend/app/main.py - FastAPI application → Question bank routes: registers routes
backend/app/main.py - FastAPI application → Student management routes: registers routes
backend/app/main.py - FastAPI application → Student exam routes: registers routes
backend/app/main.py - FastAPI application → Results routes: registers routes
backend/app/main.py - Authentication routes → Token authorization: authenticates with
backend/app/api/auth.py - Student exam routes → Attempt lifecycle: manages attempts
backend/app/api/student_exam.py - Student exam routes → Answer evaluation: evaluates answers
backend/app/api/student_exam.py - Student exam routes → Submission grading: grades submissions
backend/app/api/student_exam.py - Student exam routes → SEB verification: checks lockdown
backend/app/api/student_exam.py - SEB verification → Safe Exam Browser: verifies client
- Answer evaluation → Judge0 client: submits batches
backend/app/services/evaluation_service.py - Submission grading → Answer evaluation: evaluates code
backend/app/services/grading_service.py - Judge0 client → Judge0 execution service: executes code
- Exam management routes → Exam services: uses services
backend/app/api/exams.py - Exam management routes → Attempt lifecycle: starts attempts
backend/app/api/exams.py - Exam management routes → Admin audit log: records actions
backend/app/api/exams.py - Student management routes → Admin audit log: records actions
backend/app/api/students.py - Results routes → Results analysis: loads results
backend/app/api/results.py - Results routes → Results export: exports results
backend/app/api/results.py - Token authorization → SQLAlchemy session: gets session
backend/app/security/auth.py - SQLAlchemy session → Exam data model: provides ORM base
backend/app/models/models.py - FastAPI application → SQLAlchemy session: creates tables
backend/app/main.py - Attempt lifecycle → Exam data model: reads and writes
backend/app/services/attempt_service.py - Answer evaluation → Judge0 client: returns results
backend/app/services/evaluation_service.py