How vudinhphong2-1/be-mos_excel_grade works
MOS Project is an ASP.NET Core backend for managing coursework and classes, grading Excel and Word submissions, and administering published exams. A teacher submits a workbook through the grading API; the controller invokes the grading service, which runs project/task graders and returns results, while the controller records an attempt for analytics. Other API areas cover identity, assignments, classroom operations, scores, scheduling, and exam sessions. MongoDB/GridFS and optional Redis support persistence and caching; Google Sheets attendance sync is also documented. Some subsystem links are dashed because their implementation was not sampled.
Main entry points: Program.cs Web API · AssignmentController.cs Assignments · GradingController.cs Grading API · AuthController.cs Authentication
Components 23
API and Identity
- Web API
MOS.ExcelGrading.API/Program.cs - Authentication
MOS.ExcelGrading.API/Controllers/AuthController.cs - User service
MOS.ExcelGrading.Core/Interfaces/IUserService.cs
Grading and Results
- Assignments
MOS.ExcelGrading.API/Controllers/AssignmentController.cs - Assignment service
MOS.ExcelGrading.Core/Services/AssignmentService.cs - Grading API
MOS.ExcelGrading.API/Controllers/GradingController.cs - Grading service
MOS.ExcelGrading.Core/Services/GradingService.cs - Project task graders
MOS.ExcelGrading.Core/Graders/OTTH/Excel/Project01/P01T1Grader.cs - Scores
MOS.ExcelGrading.Core/Services/ScoreService.cs - Analytics
MOS.ExcelGrading.Core/Services/AnalyticsService.cs
Classroom Operations
Exams and Scheduling
- Exam sessions
MOS.ExcelGrading.Core/Services/ExamSessionService.cs - Exam publications
MOS.ExcelGrading.API/Controllers/ExamPublicationsController.cs - Scheduling
MOS.ExcelGrading.API/Controllers/ScheduleController.cs - Attendance sync
MOS.ExcelGrading.Core/Services/GoogleSheetAttendanceSyncService.cs
Persistence and Integrations
- MongoDB
MOS.ExcelGrading.Core/Models/MongoDbSettings.cs - Redis cache
MOS.ExcelGrading.Core/Models/RedisSettings.cs - Google Sheets
- GridFS assets
MOS.ExcelGrading.Core/Services/AssignmentFileService.cs
Other components
- Teacher
- Student
Connections 23
- Teacher → Web API: uses
README.md - Student → Web API: uses
README.md - Web API → Authentication: routes requests
- Authentication → User service: calls
MOS.ExcelGrading.API/Controllers/AuthController.cs - Web API → Assignments: routes requests
- Assignments → Assignment service: calls
MOS.ExcelGrading.API/Controllers/AssignmentController.cs - Web API → Grading API: routes requests
- Grading API → Grading service: grades submission
MOS.ExcelGrading.API/Controllers/GradingController.cs - Grading service → Project task graders: dispatches tasks
MOS.ExcelGrading.Core/Services/GradingService.cs - Grading API → Analytics: saves attempt
MOS.ExcelGrading.API/Controllers/GradingController.cs - Web API → Scores: routes score requests
MOS.ExcelGrading.API/Program.cs - Web API → Schools: routes requests
- Web API → Classes: routes requests
- Classes → Schools: uses school service
MOS.ExcelGrading.API/Controllers/ClassController.cs - Web API → Students: routes requests
MOS.ExcelGrading.API/Program.cs - Web API → Exam sessions: routes requests
MOS.ExcelGrading.API/Program.cs - Exam sessions → Exam publications: loads publication
- Web API → Scheduling: routes requests
- Scheduling → Attendance sync: invokes sync
MOS.ExcelGrading.API/Controllers/ScheduleController.cs - Attendance sync → Google Sheets: syncs attendance
- Web API → MongoDB: configures database
MOS.ExcelGrading.API/Program.cs - Web API → Redis cache: configures cache
MOS.ExcelGrading.API/Program.cs - Assignments → GridFS assets: uses file service
MOS.ExcelGrading.API/Controllers/AssignmentController.cs