总学业统计

tests/Jiaowu.Api.Tests/GradesPaginationTests.cs

@@ -3,7 +3,10 @@ using Jiaowu.Api.Contracts;
 using Jiaowu.Api.Controllers;
 using Jiaowu.Api.Domain.Academic;
 using Jiaowu.Api.Domain.Identity;
+using Jiaowu.Api.Domain.System;
 using Jiaowu.Api.Infrastructure.Auth;
+using Jiaowu.Api.Infrastructure.Caching;
+using Jiaowu.Api.Infrastructure.Grades;
 using Jiaowu.Api.Infrastructure.Persistence;
 using Microsoft.AspNetCore.Mvc;
 using Microsoft.Data.Sqlite;
@@ -241,6 +244,70 @@ public sealed class GradesPaginationTests
             await db.GradeSheets.Where(x => x.Id == sheet.Id)
                 .Select(x => x.Status)
                 .SingleAsync());
+
+        var approvedSheet = await db.GradeSheets.SingleAsync(x => x.Id == sheet.Id);
+        approvedSheet.Status = GradeSheetStatus.Approved;
+        await db.SaveChangesAsync();
+        var publishResult = await new GradesController(db, new AllScope()).Publish(
+            sheet.Id,
+            CancellationToken.None);
+
+        Assert.IsType<NoContentResult>(publishResult);
+        Assert.Empty(await db.CourseGradeStatisticsRefreshJobs.ToListAsync());
+        Assert.Empty(await db.BackgroundJobOutboxMessages.ToListAsync());
+    }
+
+    [Fact]
+    public async Task StudentAcademicOverview_UsesAllPublishedGradesAndRanksPeers()
+    {
+        await using var connection = new SqliteConnection("Data Source=:memory:");
+        await connection.OpenAsync();
+        await using var db = new AppDbContext(
+            new DbContextOptionsBuilder<AppDbContext>().UseSqlite(connection).Options);
+        await db.Database.EnsureCreatedAsync();
+
+        var college = new College { Code = "CS", Name = "计算机学院" };
+        var major = new Major { Code = "080901", Name = "计算机科学与技术", CollegeId = college.Id, DegreeType = "工学学士" };
+        var administrativeClass = new AdministrativeClass { Code = "CS2026-01", Name = "计科 2026-1 班", MajorId = major.Id, Grade = 2026 };
+        var course = new Course { Code = "CS101", Name = "程序设计基础", CollegeId = college.Id, Credits = 4, TotalHours = 64, LectureHours = 48, PracticeHours = 16, Nature = CourseNature.MajorRequired, AssessmentMethod = AssessmentMethod.Examination };
+        var term = new AcademicTerm { Code = "2026-1", Name = "2026—2027 学年第一学期", AcademicYear = "2026-2027", Season = TermSeason.Autumn, StartDate = new DateOnly(2026, 9, 1), EndDate = new DateOnly(2027, 1, 20) };
+        var userId = Guid.NewGuid();
+        var user = new ApplicationUser { Id = userId, UserName = "202601001", DisplayName = "学生 1" };
+        var student = new Student { StudentNumber = "202601001", Name = "学生 1", UserId = userId, AdministrativeClassId = administrativeClass.Id, EnrollmentYear = 2026, EnrollmentDate = new DateOnly(2026, 9, 1) };
+        var peer = new Student { StudentNumber = "202601002", Name = "学生 2", AdministrativeClassId = administrativeClass.Id, EnrollmentYear = 2026, EnrollmentDate = new DateOnly(2026, 9, 1) };
+        var task = new TeachingTask { TaskNumber = "2026-1-CS101-01", Name = "程序设计基础教学班", AcademicTermId = term.Id, CourseId = course.Id, Capacity = 60, Status = TeachingTaskStatus.Closed };
+        var sheet = new GradeSheet
+        {
+            TeachingTaskId = task.Id,
+            Status = GradeSheetStatus.Published,
+            RegularWeight = 40,
+            FinalWeight = 60,
+            Records =
+            [
+                new GradeRecord { StudentId = student.Id, TotalScore = 80, GradePoint = 3.0m },
+                new GradeRecord { StudentId = peer.Id, TotalScore = 90, GradePoint = 4.0m }
+            ]
+        };
+        db.AddRange(college, major, administrativeClass, course, term, user, student, peer, task, sheet);
+        await db.SaveChangesAsync();
+        await new StudentAcademicStatisticsService(db, NoOpAppCache.Instance)
+            .RefreshForGradeSheetAsync(sheet.Id, CancellationToken.None);
+
+        var result = Assert.IsType<OkObjectResult>(await new GradesController(
+            db,
+            new StudentScope(userId)).GetStudentAcademicOverview(CancellationToken.None));
+        var metrics = result.Value!.GetType().GetProperty("Metrics")!.GetValue(result.Value)!;
+        var gpa = metrics.GetType().GetProperty("Gpa")!.GetValue(metrics)!;
+        var classRank = gpa.GetType().GetProperty("ClassRank")!.GetValue(gpa)!;
+        var trend = ((System.Collections.IEnumerable)result.Value.GetType()
+            .GetProperty("TermTrend")!.GetValue(result.Value)!).Cast<object>().ToList();
+
+        Assert.Equal(3.0m, gpa.GetType().GetProperty("Value")!.GetValue(gpa));
+        Assert.Equal(2, classRank.GetType().GetProperty("Rank")!.GetValue(classRank));
+        Assert.Equal(2, classRank.GetType().GetProperty("PeerCount")!.GetValue(classRank));
+        var firstTerm = Assert.Single(trend);
+        Assert.Equal("2026—2027 学年第一学期", firstTerm.GetType().GetProperty("TermName")!.GetValue(firstTerm));
+        Assert.Equal(3.0m, firstTerm.GetType().GetProperty("Gpa")!.GetValue(firstTerm));
     }
 
     private static int ReadInt(object value, string property) =>
@@ -259,4 +326,14 @@ public sealed class GradesPaginationTests
             DataScope.All,
             new HashSet<string>([SystemRoles.SuperAdmin]));
     }
+
+    private sealed class StudentScope(Guid userId) : ICurrentUserDataScope
+    {
+        public CurrentUserScope Current { get; } = new(
+            userId,
+            "测试学生",
+            null,
+            DataScope.Self,
+            new HashSet<string>([SystemRoles.Student]));
+    }
 }