How northstar-vdwrx/evalbackend works
EvalBackend is a FastAPI assessment API. Its central workflow is quiz and question authoring, scheduling an exam session, accepting student attempts, and grading answers; administration, identity, groups, institutes, and analytics are additional product areas. The app factory registers the route families, while route handlers use the shared database dependency and domain models. Several route families are represented from the file tree and source index rather than inspected excerpts, so their internal connections are not inferred.
Main entry points: __init__.py FastAPI app · db.py DB connection pool · questions.py Question authoring · attempts.py Exam attempts
Components 24
API entry
- FastAPI app
app/__init__.py - Home routes
app/routes/home.py - DB connection pool
db.py - Domain models
models.py
Identity and administration
- Authentication
app/routes/auth - Admin users
app/routes/admin/users.py - Admin settings
app/routes/admin/settings.py
Assessment authoring
- Quiz banks
app/routes/quiz/banks.py - Quiz management
app/routes/quiz/crud.py - Question authoring
app/routes/quiz/questions.py - Question storage
app/routes/quiz/question_storage.py - Quiz structure
app/routes/quiz/structure.py - Quiz import/export
app/routes/quiz/import_export.py - Question parameterization
app/routes/quiz/parameterization.py
Exam delivery
- Exam sessions
app/routes/exams/scheduled.py - Exam attempts
app/routes/exams/attempts.py - Grading
app/routes/exams/grading.py - Student analytics
app/routes/exams/student_analytics.py - Practice
app/routes/practice.py
User and institution management
- Extended profiles
app/routes/profiles/extended_users.py - Institutes
app/routes/institutes/router.py - Groups
app/routes/groups/router.py
Other components
- API client
- PostgreSQL
Connections 30
- API client → FastAPI app: sends API requests
- FastAPI app → Home routes: registers routes
app/__init__.py - FastAPI app → Authentication: registers routes
app/__init__.py - FastAPI app → Admin users: registers routes
app/__init__.py - FastAPI app → Admin settings: registers routes
app/__init__.py - FastAPI app → Extended profiles: registers routes
app/__init__.py - FastAPI app → Institutes: registers routes
app/__init__.py - FastAPI app → Groups: registers routes
app/__init__.py - FastAPI app → Quiz banks: registers routes
app/__init__.py - FastAPI app → Quiz management: registers routes
app/__init__.py - FastAPI app → Question authoring: registers routes
app/__init__.py - FastAPI app → Quiz structure: registers routes
app/__init__.py - FastAPI app → Quiz import/export: registers routes
app/__init__.py - FastAPI app → Exam sessions: registers routes
app/__init__.py - FastAPI app → Student analytics: registers routes
app/__init__.py - FastAPI app → Practice: registers routes
app/__init__.py - FastAPI app → Exam attempts: registers routes
app/__init__.py - Question authoring → Question storage: stores questions
app/routes/quiz/questions.py - Exam attempts → Grading: auto-grades answers
app/routes/exams/attempts.py - Exam attempts → Question parameterization: materializes questions
app/routes/exams/attempts.py - Question authoring → Grading: regrades attempts
app/routes/quiz/questions.py - Authentication → DB connection pool: gets connections
app/routes/auth/security.py - Groups → DB connection pool: gets connections
app/routes/groups/router.py - Institutes → DB connection pool: gets connections
app/routes/institutes/router.py - Extended profiles → DB connection pool: gets connections
app/routes/profiles/extended_users.py - Admin users → DB connection pool: gets connections
app/routes/admin/users.py - Quiz banks → DB connection pool: gets connections
app/routes/quiz/banks.py - Question authoring → DB connection pool: gets connections
app/routes/quiz/questions.py - Question storage → PostgreSQL: writes questions
app/routes/quiz/question_storage.py - DB connection pool → PostgreSQL: pools connections
db.py