How cs341-illinois/broadway-on-demand works
Broadway on Demand is a grading-focused web application for CS 341, with a browser UI and a Fastify API. In the primary workflow, course staff manage assignments and project grading through the UI; API routes invoke domain functions that coordinate course data, grading runs, and GitHub updates. Students also use the application for course and assignment information. Scheduled jobs and Jenkins callbacks support grading operations. The graph includes documented and indexed capabilities, but several route and UI implementations were not sampled; their internal connections are shown only where supported by the excerpts, index, or README.
Main entry points: server.ts Application server · github.ts GitHub operations · course.ts Course routes · assignment.ts Assignment logic
Components 27
Web interface
- Browser UI
src/client/mount.tsx - Course workflows
src/client/pages - Grade workflows
src/client/pages - UI authentication
src/client/contexts/AuthContext.tsx
API and access
- Application server
src/server.ts - Authentication
src/plugins/auth.ts - Error handling
src/plugins/errorHandler.ts - Course routes
src/routes/course.ts - Project grade routes
src/routes/projectGrades.ts - Project repo routes
src/routes/projectRepos.ts - Other API routes
src/routes
Grading domain
- Assignment logic
src/functions/assignment.ts - Partner groups
src/functions/partners.ts - Project repo allocation
src/functions/projectRepos.ts - Grading execution
src/functions/gradeAssignment.ts
Integrations and jobs
- GitHub operations
src/functions/github.ts - Jenkins jobs
src/functions/jenkins.ts - Grader callbacks
src/routes/graderCallbacks.ts - Job scheduler
src/scheduler/scheduler.ts - Scheduled handlers
src/scheduler/handlers.ts - Job repository
src/scheduler/prismaRepository.ts - Job reconciliation
src/reconciler/index.ts
Other components
- Course staff
- Students
- Application database
- GitHub
- Jenkins
Connections 32
- Course staff → Browser UI: uses
- Students → Browser UI: uses
- Browser UI → Application server: requests
- Application server → Course routes: registers
src/server.ts - Application server → Project grade routes: registers
src/server.ts - Application server → Project repo routes: registers
src/server.ts - Application server → Other API routes: registers
src/server.ts - Application server → Authentication: registers
src/server.ts - Application server → Error handling: registers
src/server.ts - UI authentication → Application server: authenticates
- Course routes → Assignment logic: calls
src/routes/course.ts - Course routes → GitHub operations: calls
src/routes/course.ts - Course routes → Jenkins jobs: calls
src/routes/course.ts - Project grade routes → Assignment logic: calls
src/routes/projectGrades.ts - Project grade routes → Partner groups: calls
src/routes/projectGrades.ts - Project repo routes → Project repo allocation: calls
src/routes/projectRepos.ts - Project repo routes → GitHub operations: calls
src/routes/projectRepos.ts - Project repo allocation → Partner groups: looks up groups
src/functions/projectRepos.ts - Project repo allocation → GitHub operations: provisions repos
src/functions/projectRepos.ts - GitHub operations → GitHub: uses API
src/functions/github.ts - Assignment logic → Job repository: creates jobs
src/functions/assignment.ts - Application server → Scheduled handlers: starts jobs
src/server.ts - Scheduled handlers → Grading execution: invokes
src/scheduler/handlers.ts - Application server → Job scheduler: starts scheduler
src/server.ts - Job scheduler → Job repository: uses repository
- Application server → Job reconciliation: starts reconciliation
src/server.ts - Job reconciliation → Jenkins: polls jobs
src/reconciler/index.ts - Jenkins jobs → Jenkins: runs jobs
- Application server → Grader callbacks: registers
src/server.ts - Grader callbacks → GitHub operations: calls
src/routes/graderCallbacks.ts - Job repository → Application database: reads and writes
src/scheduler/prismaRepository.ts - Assignment logic → Application database: reads and writes