How andreii2305/sharprunner works
SharpRunner is a full-stack C# learning platform. Students authenticate, join a classroom, study lessons, then solve C# challenges in game levels; attempts, scores, and progression are persisted. Teachers manage classroom content and student work, while admins govern accounts and platform activity. The graph emphasizes those documented capabilities and the shown application/API wiring. Many domain routes and frontend pages are not excerpted, so their internal calls are not asserted; dashed links indicate major documented workflows whose exact code path was not sampled.
Main entry points: App.jsx Web App Router · app.js Express API · User.js Domain Models · GamePage.jsx Coding Game
Components 28
Student Web App
- Web App Router
frontend/src/App.jsx - Auth & Session
frontend/src/utils/auth.js - Student Dashboard
frontend/src/Components/Dashboard/Dashboard.jsx
Learning Experience
- Lesson Map
frontend/src/pages/map/LessonMapPage.jsx - Lesson Content
frontend/src/Components/LessonRenderer/LessonRenderer.jsx - Coding Game
frontend/src/pages/game/GamePage.jsx - Level Scenes
frontend/src/pages/game/scenes/LevelOneScene.js - C# Editor
frontend/src/Components/PracticeCompiler/PracticeCompiler.jsx - Assessment Player
frontend/src/pages/student/assessment/AssessmentPlayer.jsx
Classroom Tools
- Classroom Management
frontend/src/pages/teacher/TeacherClassDetailPage.jsx - Lesson Builder
frontend/src/pages/teacher/TeacherLessonBuilderPage.jsx - Teacher Analytics
frontend/src/pages/teacher/TeacherAnalyticsPage.jsx - Admin Governance
frontend/src/pages/admin/AdminDashboardPage.jsx
Backend API
- Express API
backend/src/app.js - Authentication
backend/src/routes/auth.js - Progress & Scoring
backend/src/routes/progress.js - Practice Runner
backend/src/services/practiceRunnerService.js - Roslyn Compiler Host
backend/compiler-host/Program.cs - Classroom Services
backend/src/routes/teacher.js - Assessment Services
backend/src/routes/assessments.js - Admin Services
backend/src/routes/admin.js - Lesson File Storage
backend/src/services/lessonFileStorageService.js
Persistence
- Domain Models
backend/src/models/User.js - PostgreSQL
backend/src/config/database.js
Other components
- Student
- Teacher
- Admin
- Supabase Storage
Connections 34
- Student → Web App Router: uses
- Teacher → Web App Router: uses
- Admin → Web App Router: uses
- Web App Router → Auth & Session: routes through
frontend/src/App.jsx - Web App Router → Student Dashboard: routes to
frontend/src/App.jsx - Web App Router → Lesson Map: routes to
frontend/src/App.jsx - Web App Router → Classroom Management: routes to
frontend/src/App.jsx - Web App Router → Admin Governance: routes to
frontend/src/App.jsx - Student → Lesson Map: selects lessons
- Lesson Map → Lesson Content: opens lesson
- Student → Coding Game: plays levels
- Coding Game → Level Scenes: loads scenes
- Coding Game → C# Editor: hosts editor
- Student → Assessment Player: takes assessment
- Teacher → Classroom Management: manages classes
- Teacher → Lesson Builder: creates content
- Teacher → Teacher Analytics: reviews metrics
- Admin → Admin Governance: governs platform
- Express API → Authentication: mounts routes
backend/src/app.js - Express API → Progress & Scoring: mounts routes
backend/src/app.js - Express API → Assessment Services: mounts routes
backend/src/app.js - Express API → Classroom Services: mounts routes
backend/src/app.js - Express API → Admin Services: mounts routes
backend/src/app.js - Express API → Practice Runner: mounts routes
backend/src/app.js - Web App Router → Express API: requests API
- Practice Runner → Roslyn Compiler Host: compiles code
backend/src/services/practiceRunnerService.js - Authentication → Domain Models: reads users
backend/src/routes/auth.js - Classroom Services → Domain Models: manages classroom data
backend/src/routes/teacher.js - Assessment Services → Domain Models: stores attempts
- Progress & Scoring → Domain Models: saves progress
- Admin Services → Domain Models: governs records
backend/src/routes/admin.js - Lesson File Storage → Supabase Storage: stores files
backend/src/services/lessonFileStorageService.js - Lesson File Storage → Domain Models: uses file records
- Domain Models → PostgreSQL: persists data
backend/src/models/User.js