calculator = new AverageCalculator(); } // --- Subject Average --- #[Test] public function subjectAverageReturnsNullWhenNoGrades(): void { self::assertNull($this->calculator->calculateSubjectAverage([])); } #[Test] public function subjectAverageWithSingleGrade(): void { $grades = [ new GradeEntry( value: 15.0, gradeScale: new GradeScale(20), coefficient: new Coefficient(1.0), ), ]; self::assertSame(15.0, $this->calculator->calculateSubjectAverage($grades)); } #[Test] public function subjectAverageWithEqualCoefficients(): void { $grades = [ new GradeEntry(value: 12.0, gradeScale: new GradeScale(20), coefficient: new Coefficient(1.0)), new GradeEntry(value: 16.0, gradeScale: new GradeScale(20), coefficient: new Coefficient(1.0)), new GradeEntry(value: 8.0, gradeScale: new GradeScale(20), coefficient: new Coefficient(1.0)), ]; // (12 + 16 + 8) / 3 = 12.0 self::assertSame(12.0, $this->calculator->calculateSubjectAverage($grades)); } #[Test] public function subjectAverageWithDifferentCoefficients(): void { $grades = [ new GradeEntry(value: 14.0, gradeScale: new GradeScale(20), coefficient: new Coefficient(2.0)), new GradeEntry(value: 8.0, gradeScale: new GradeScale(20), coefficient: new Coefficient(1.0)), ]; // (14×2 + 8×1) / (2+1) = 36/3 = 12.0 self::assertSame(12.0, $this->calculator->calculateSubjectAverage($grades)); } #[Test] public function subjectAverageNormalizesToScale20(): void { $grades = [ new GradeEntry(value: 8.0, gradeScale: new GradeScale(10), coefficient: new Coefficient(1.0)), ]; // 8/10 × 20 = 16.0 self::assertSame(16.0, $this->calculator->calculateSubjectAverage($grades)); } #[Test] public function subjectAverageWithMixedScales(): void { $grades = [ new GradeEntry(value: 15.0, gradeScale: new GradeScale(20), coefficient: new Coefficient(1.0)), new GradeEntry(value: 40.0, gradeScale: new GradeScale(100), coefficient: new Coefficient(1.0)), ]; // 15/20×20=15 et 40/100×20=8 → (15+8)/2 = 11.5 self::assertSame(11.5, $this->calculator->calculateSubjectAverage($grades)); } #[Test] public function subjectAverageWithMixedScalesAndCoefficients(): void { $grades = [ new GradeEntry(value: 16.0, gradeScale: new GradeScale(20), coefficient: new Coefficient(3.0)), new GradeEntry(value: 7.0, gradeScale: new GradeScale(10), coefficient: new Coefficient(2.0)), ]; // 16/20×20=16 (coef 3), 7/10×20=14 (coef 2) // (16×3 + 14×2) / (3+2) = (48+28)/5 = 76/5 = 15.2 self::assertSame(15.2, $this->calculator->calculateSubjectAverage($grades)); } #[Test] public function subjectAverageRoundsToTwoDecimals(): void { $grades = [ new GradeEntry(value: 13.0, gradeScale: new GradeScale(20), coefficient: new Coefficient(1.0)), new GradeEntry(value: 7.0, gradeScale: new GradeScale(20), coefficient: new Coefficient(1.0)), new GradeEntry(value: 11.0, gradeScale: new GradeScale(20), coefficient: new Coefficient(1.0)), ]; // (13+7+11)/3 = 31/3 = 10.333... → 10.33 self::assertSame(10.33, $this->calculator->calculateSubjectAverage($grades)); } // --- General Average --- #[Test] public function generalAverageReturnsNullWhenNoSubjects(): void { self::assertNull($this->calculator->calculateGeneralAverage([])); } #[Test] public function generalAverageWithSingleSubject(): void { self::assertSame(14.5, $this->calculator->calculateGeneralAverage([14.5])); } #[Test] public function generalAverageIsArithmeticMean(): void { // (12.0 + 15.0 + 9.0) / 3 = 12.0 self::assertSame(12.0, $this->calculator->calculateGeneralAverage([12.0, 15.0, 9.0])); } #[Test] public function generalAverageRoundsToTwoDecimals(): void { // (14.0 + 13.0 + 11.0) / 3 = 38/3 = 12.666... → 12.67 self::assertSame(12.67, $this->calculator->calculateGeneralAverage([14.0, 13.0, 11.0])); } // --- Class Statistics --- #[Test] public function classStatisticsReturnsEmptyWhenNoGrades(): void { $stats = $this->calculator->calculateClassStatistics([]); self::assertNull($stats->average); self::assertNull($stats->min); self::assertNull($stats->max); self::assertNull($stats->median); self::assertSame(0, $stats->gradedCount); } #[Test] public function classStatisticsWithSingleGrade(): void { $stats = $this->calculator->calculateClassStatistics([15.0]); self::assertSame(15.0, $stats->average); self::assertSame(15.0, $stats->min); self::assertSame(15.0, $stats->max); self::assertSame(15.0, $stats->median); self::assertSame(1, $stats->gradedCount); } #[Test] public function classStatisticsWithOddNumberOfGrades(): void { $stats = $this->calculator->calculateClassStatistics([8.0, 15.0, 12.0]); // Sorted: 8, 12, 15 self::assertSame(11.67, $stats->average); // 35/3 self::assertSame(8.0, $stats->min); self::assertSame(15.0, $stats->max); self::assertSame(12.0, $stats->median); // middle element self::assertSame(3, $stats->gradedCount); } #[Test] public function classStatisticsWithEvenNumberOfGrades(): void { $stats = $this->calculator->calculateClassStatistics([7.0, 12.0, 14.0, 18.0]); // Sorted: 7, 12, 14, 18 self::assertSame(12.75, $stats->average); // 51/4 self::assertSame(7.0, $stats->min); self::assertSame(18.0, $stats->max); self::assertSame(13.0, $stats->median); // (12+14)/2 self::assertSame(4, $stats->gradedCount); } #[Test] public function classStatisticsSortsInputValues(): void { // Input not sorted $stats = $this->calculator->calculateClassStatistics([18.0, 7.0, 14.0, 12.0]); self::assertSame(7.0, $stats->min); self::assertSame(18.0, $stats->max); self::assertSame(13.0, $stats->median); // (12+14)/2 } #[Test] public function classStatisticsWithIdenticalGrades(): void { $stats = $this->calculator->calculateClassStatistics([10.0, 10.0, 10.0]); self::assertSame(10.0, $stats->average); self::assertSame(10.0, $stats->min); self::assertSame(10.0, $stats->max); self::assertSame(10.0, $stats->median); self::assertSame(3, $stats->gradedCount); } #[Test] public function classStatisticsWithTwoGrades(): void { $stats = $this->calculator->calculateClassStatistics([6.0, 16.0]); self::assertSame(11.0, $stats->average); self::assertSame(6.0, $stats->min); self::assertSame(16.0, $stats->max); self::assertSame(11.0, $stats->median); // (6+16)/2 self::assertSame(2, $stats->gradedCount); } }