总学业统计

src/Jiaowu.Api/Domain/Academic/GradeEntities.cs

@@ -139,6 +139,37 @@ public sealed class CourseGradeStatisticsRefreshJob : EntityBase
     public string? ErrorMessage { get; set; }
 }
 
+/// <summary>
+/// Materialized all-term academic metrics for one student. Rankings are derived
+/// from this compact table, never by scanning raw grade records on a request.
+/// </summary>
+public sealed class StudentAcademicStatistic : EntityBase
+{
+    public Guid StudentId { get; set; }
+    public Student? Student { get; set; }
+    public int CourseCount { get; set; }
+    public decimal? Gpa { get; set; }
+    public decimal? WeightedAverageScore { get; set; }
+    public decimal? AverageScore { get; set; }
+    public DateTime CalculatedAt { get; set; }
+}
+
+/// <summary>
+/// Materialized academic metrics for one student in one academic term.
+/// </summary>
+public sealed class StudentAcademicTermStatistic : EntityBase
+{
+    public Guid StudentId { get; set; }
+    public Student? Student { get; set; }
+    public Guid AcademicTermId { get; set; }
+    public AcademicTerm? AcademicTerm { get; set; }
+    public int CourseCount { get; set; }
+    public decimal? Gpa { get; set; }
+    public decimal? WeightedAverageScore { get; set; }
+    public decimal? AverageScore { get; set; }
+    public DateTime CalculatedAt { get; set; }
+}
+
 public enum CourseGradeStatisticsRefreshJobStatus
 {
     Queued = 1,