How bspreddy/coding-platfrom works
This is a multi-role online coding platform: students solve problems and contests, while college staff and platform administrators manage learning activities and monitor outcomes. The central student path runs from authenticated API access through submission evaluation to persisted results and XP, streak, and leaderboard updates; dashboards and analytics then expose progress. The tree also documents assignments, proctoring, notifications, and bulk administration. Connections are limited to relationships demonstrated by excerpts or SOURCE INDEX references; unsampled feature branches are retained without speculative call chains.
Main entry points: college College portal · route.ts Submission endpoint · index.ts PostgreSQL database · xpService.ts XP progression
Components 29
User experiences
- Student portal
src/app/user - College portal
src/app/college - Admin portal
src/app/admin - Contest workbench
src/components/contest/FullScreenContestWorkbench.tsx
Learning workflows
- Problem catalog
src/app/api/problems/route.ts - Submission endpoint
src/app/api/submissions/route.ts - Contest APIs
src/app/api/contests - Assignments
src/app/api/college/assignments/route.ts - Contest proctoring
src/components/contest/ContestProctorWrapper.tsx - Student dashboard
src/app/api/student/dashboard/route.ts
Administration
- College analytics
src/app/api/college/analytics/route.ts - College contests
src/app/api/college/contests/route.ts - College problems
src/app/api/college/problems/route.ts - Student management
src/app/api/college/students/route.ts - Admin APIs
src/app/api/admin
Platform services
- Code runner
src/lib/docker-runner.ts - Judge0 client
src/lib/compilers/judge0Client.ts - Session and auth
src/lib/auth.ts - XP progression
src/lib/xpService.ts - Streak service
src/lib/streakService.ts - Leaderboard service
src/lib/leaderboardService.ts - Problem statistics
src/lib/problemStats.ts
Persistence
- Redis cache
src/lib/redis.ts - PostgreSQL database
src/db/index.ts - Platform data schema
src/db/postgres/schema.ts
Other components
- Student
- College staff
- Platform admin
- Judge0 service
Connections 39
- Student → Student portal: uses
- Student portal → Contest workbench: opens workbench
- Contest workbench → Submission endpoint: submits code
- Student portal → Problem catalog: browses problems
- Submission endpoint → Session and auth: gets session
src/app/api/submissions/route.ts - Submission endpoint → Code runner: executes code
src/app/api/submissions/route.ts - Code runner → Judge0 client: delegates execution
- Judge0 client → Judge0 service: submits and polls
src/lib/compilers/judge0Client.ts - Submission endpoint → PostgreSQL database: reads and writes
src/app/api/submissions/route.ts - Submission endpoint → XP progression: awards progress
src/app/api/submissions/route.ts - Submission endpoint → Streak service: updates activity
src/app/api/submissions/route.ts - Submission endpoint → Leaderboard service: updates rankings
src/app/api/submissions/route.ts - Student dashboard → Session and auth: gets session
src/app/api/student/dashboard/route.ts - Student dashboard → XP progression: loads level data
src/app/api/student/dashboard/route.ts - XP progression → Redis cache: caches progression
src/lib/xpService.ts - XP progression → Leaderboard service: references service
src/lib/xpService.ts - Streak service → XP progression: awards bonus XP
src/lib/streakService.ts - Leaderboard service → Redis cache: invalidates cache
src/lib/leaderboardService.ts - Problem catalog → Session and auth: gets session
src/app/api/problems/route.ts - Problem catalog → Problem statistics: loads statistics
src/app/api/problems/route.ts - College staff → College portal: uses
- College portal → College analytics: views analytics
- College portal → College contests: manages contests
- College portal → College problems: manages problems
- College portal → Assignments: manages assignments
- College portal → Student management: manages students
- College analytics → Session and auth: gets session
src/app/api/college/analytics/route.ts - College analytics → PostgreSQL database: queries analytics
src/app/api/college/analytics/route.ts - College contests → Session and auth: gets session
src/app/api/college/contests/route.ts - College problems → Session and auth: gets session
src/app/api/college/problems/route.ts - College problems → PostgreSQL database: manages records
src/app/api/college/problems/route.ts - College portal → Contest proctoring: uses contest controls
- Platform admin → Admin portal: uses
- Admin portal → Admin APIs: manages platform
- PostgreSQL database → Platform data schema: loads schema
src/db/index.ts - Student dashboard → PostgreSQL database: reads learner data
src/app/api/student/dashboard/route.ts - Leaderboard service → PostgreSQL database: reads and updates ranks
src/lib/leaderboardService.ts - Streak service → PostgreSQL database: reads activity
src/lib/streakService.ts - XP progression → PostgreSQL database: reads and writes XP
src/lib/xpService.ts