feat: Add basic exam widgets

app/Filament/Training/Pages/Exam/ExamHistory.php

@@ -2,6 +2,7 @@
 
 namespace App\Filament\Training\Pages\Exam;
 
+use App\Filament\Training\Pages\Exam\Widgets\ExamOverview;
 use App\Repositories\Cts\ExamResultRepository;
 use Filament\Forms;
 use Filament\Pages\Page;
@@ -28,6 +29,13 @@ public static function canAccess(): bool
         return auth()->user()->can('training.exams.access');
     }
 
+    protected function getHeaderWidgets(): array
+    {
+        return [
+            ExamOverview::class,
+        ];
+    }
+
     public function table(Table $table): Table
     {
         $userPermissionsTruthTable = [

app/Filament/Training/Pages/Exam/Widgets/ExamOverview.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace App\Filament\Training\Pages\Exam\Widgets;
+
+use App\Models\Cts\PracticalResult;
+use Filament\Widgets\StatsOverviewWidget as BaseWidget;
+use Filament\Widgets\StatsOverviewWidget\Stat;
+use Illuminate\Support\Facades\DB;
+
+class ExamOverview extends BaseWidget
+{
+    protected function getCards(): array
+    {
+        $total = PracticalResult::count();
+        $passed = PracticalResult::where('result', PracticalResult::PASSED)->count();
+        $failed = PracticalResult::where('result', PracticalResult::FAILED)->count();
+        $incomplete = PracticalResult::where('result', PracticalResult::INCOMPLETE)->count();
+
+        $examStats = PracticalResult::select('exam', 'result', DB::raw('count(*) as total'))
+            ->groupBy('exam', 'result')
+            ->get()
+            ->groupBy('exam');
+
+        $cards = [
+            Stat::make('Total Taken', $total),
+            Stat::make('Pass Rate', ($total ? round($passed / $total * 100) : 100).'%')->description("$passed Passed, $failed Failed, $incomplete Incomplete"),
+        ];
+
+        $examOrder = ['OBS', 'TWR', 'APP', 'CTR'];
+
+        foreach ($examOrder as $exam) {
+            $results = $examStats->get($exam, collect());
+            $examTotal = $results->sum('total');
+            $examPassed = $results->firstWhere('result', PracticalResult::PASSED)->total ?? 0;
+            $examFailed = $results->firstWhere('result', PracticalResult::FAILED)->total ?? 0;
+            $examIncomplete = $results->firstWhere('result', PracticalResult::INCOMPLETE)->total ?? 0;
+
+            $cards[] = Stat::make("{$exam} Pass Rate", ($examTotal ? round($examPassed / $examTotal * 100) : 100).'%')
+                ->description("$examTotal Total, $examPassed Passed, $examFailed Failed, $examIncomplete Incomplete");
+        }
+
+        return $cards;
+    }
+}

app/Filament/Training/Pages/TheoryExamHistory.php → app/Filament/Training/Pages/TheoryExam/TheoryExamHistory.php

@@ -1,7 +1,8 @@
 <?php
 
-namespace App\Filament\Training\Pages;
+namespace App\Filament\Training\Pages\TheoryExam;
 
+use App\Filament\Training\Pages\TheoryExam\Widgets\TheoryExamOverview;
 use App\Repositories\Cts\TheoryExamResultRepository;
 use Carbon\Carbon;
 use Filament\Forms;
@@ -32,6 +33,13 @@ public static function canAccess(): bool
         return auth()->user()->can('training.theory.access');
     }
 
+    protected function getHeaderWidgets(): array
+    {
+        return [
+            TheoryExamOverview::class,
+        ];
+    }
+
     protected function buildQuestionPlaceholders($record): array
     {
 

app/Filament/Training/Pages/TheoryExam/Widgets/TheoryExamOverview.php

@@ -0,0 +1,42 @@
+<?php
+
+namespace App\Filament\Training\Pages\TheoryExam\Widgets;
+
+use App\Models\Cts\TheoryResult;
+use Filament\Widgets\StatsOverviewWidget as BaseWidget;
+use Filament\Widgets\StatsOverviewWidget\Stat;
+use Illuminate\Support\Facades\DB;
+
+class TheoryExamOverview extends BaseWidget
+{
+    protected function getCards(): array
+    {
+        $total = TheoryResult::count();
+        $passed = TheoryResult::where('pass', true)->count();
+        $failed = TheoryResult::where('pass', false)->count();
+
+        $examStats = TheoryResult::select('exam', 'pass', DB::raw('count(*) as total'))
+            ->groupBy('exam', 'pass')
+            ->get()
+            ->groupBy('exam');
+
+        $cards = [
+            Stat::make('Total Taken', $total),
+            Stat::make('Pass Rate', ($total ? round($passed / $total * 100) : 100).'%')->description("$passed Passed, $failed Failed"),
+        ];
+
+        $examOrder = ['S1', 'S2', 'S3', 'C1'];
+
+        foreach ($examOrder as $exam) {
+            $results = $examStats->get($exam, collect());
+            $examTotal = $results->sum('total');
+            $examPassed = $results->firstWhere('pass', true)->total ?? 0;
+            $examFailed = $results->firstWhere('pass', false)->total ?? 0;
+
+            $cards[] = Stat::make("{$exam} Pass Rate", ($examTotal ? round($examPassed / $examTotal * 100) : 100).'%')
+                ->description("$examTotal Total, $examPassed Passed, $examFailed Failed");
+        }
+
+        return $cards;
+    }
+}

tests/Feature/TrainingPanel/Exams/TheoryExamHistoryTest.php

@@ -2,7 +2,7 @@
 
 namespace Tests\Feature\TrainingPanel\Exams;
 
-use App\Filament\Training\Pages\TheoryExamHistory;
+use App\Filament\Training\Pages\TheoryExam\TheoryExamHistory;
 use App\Models\Cts\Member;
 use App\Models\Cts\TheoryAnswer;
 use App\Models\Cts\TheoryQuestion;