feat: implement application health check

Author: SlimDeluxe

composer.json

@@ -59,8 +59,10 @@
         "opcodesio/log-viewer": "^3.17",
         "pxlrbt/filament-environment-indicator": "^2.1",
         "pxlrbt/filament-excel": "^2.4",
+        "shuvroroy/filament-spatie-laravel-health": "^2.3",
         "spatie/laravel-package-tools": "^1.18",
         "spatie/laravel-translatable": "^6.11",
+        "spatie/security-advisories-health-check": "^1.2",
         "stechstudio/filament-impersonate": "^3.16",
         "tangodev-it/filament-emoji-picker": "^1.0",
         "typesense/typesense-php": "^5.0"

database/migrations/2025_06_11_073211_create_health_tables.php

@@ -0,0 +1,36 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+use Spatie\Health\Models\HealthCheckResultHistoryItem;
+use Spatie\Health\ResultStores\EloquentHealthResultStore;
+
+return new class extends Migration
+{
+    public function up()
+    {
+        $connection = (new HealthCheckResultHistoryItem)->getConnectionName();
+        $tableName = EloquentHealthResultStore::getHistoryItemInstance()->getTable();
+
+        Schema::connection($connection)->create($tableName, function (Blueprint $table) {
+            $table->id();
+
+            $table->string('check_name');
+            $table->string('check_label');
+            $table->string('status');
+            $table->text('notification_message')->nullable();
+            $table->string('short_summary')->nullable();
+            $table->json('meta');
+            $table->timestamp('ended_at');
+            $table->uuid('batch');
+
+            $table->timestamps();
+        });
+
+        Schema::connection($connection)->table($tableName, function (Blueprint $table) {
+            $table->index('created_at');
+            $table->index('batch');
+        });
+    }
+};

routes/console.php

@@ -0,0 +1,19 @@
+<?php
+
+use Illuminate\Support\Facades\Schedule;
+use Spatie\Health\Commands\RunHealthChecksCommand;
+use Spatie\Health\Commands\ScheduleCheckHeartbeatCommand;
+
+/*
+|--------------------------------------------------------------------------
+| Console Routes
+|--------------------------------------------------------------------------
+|
+| This file is where you may define all of your Closure based console
+| commands. Each Closure is bound to a command instance allowing a
+| simple approach to interacting with each command's IO methods.
+|
+*/
+
+Schedule::command(RunHealthChecksCommand::class)->everyMinute();
+Schedule::command(ScheduleCheckHeartbeatCommand::class)->everyMinute();

src/EclipseServiceProvider.php

@@ -25,8 +25,18 @@
 use Illuminate\Support\Facades\DB;
 use Illuminate\Support\Facades\Event;
 use Illuminate\Support\Facades\Gate;
+use Spatie\Health\Checks\Checks\CacheCheck;
+use Spatie\Health\Checks\Checks\DebugModeCheck;
+use Spatie\Health\Checks\Checks\EnvironmentCheck;
+use Spatie\Health\Checks\Checks\HorizonCheck;
+use Spatie\Health\Checks\Checks\OptimizedAppCheck;
+use Spatie\Health\Checks\Checks\RedisCheck;
+use Spatie\Health\Checks\Checks\ScheduleCheck;
+use Spatie\Health\Checks\Checks\UsedDiskSpaceCheck;
+use Spatie\Health\Facades\Health;
 use Spatie\LaravelPackageTools\Package as SpatiePackage;
 use Spatie\Permission\PermissionRegistrar;
+use Spatie\SecurityAdvisoriesHealthCheck\SecurityAdvisoriesCheck;
 
 class EclipseServiceProvider extends PackageServiceProvider
 {
@@ -52,7 +62,8 @@ public function configurePackage(SpatiePackage|Package $package): void
             ->hasSettings()
             ->discoversMigrations()
             ->runsMigrations()
-            ->hasTranslations();
+            ->hasTranslations()
+            ->hasRoute('console');
     }
 
     public function register(): self
@@ -125,5 +136,20 @@ public function boot(): void
                 ->locales($availableLocales->pluck('id')->toArray())
                 ->labels($availableLocales->pluck('native_name', 'id')->toArray());
         });
+
+        // Register health checks
+        Health::checks([
+            OptimizedAppCheck::new(),
+            DebugModeCheck::new(),
+            EnvironmentCheck::new(),
+            UsedDiskSpaceCheck::new()
+                ->warnWhenUsedSpaceIsAbovePercentage(70)
+                ->failWhenUsedSpaceIsAbovePercentage(90),
+            CacheCheck::new(),
+            HorizonCheck::new(),
+            RedisCheck::new(),
+            ScheduleCheck::new(),
+            SecurityAdvisoriesCheck::new(),
+        ]);
     }
 }

src/Filament/Pages/Tools/HealthCheckResults.php

@@ -0,0 +1,11 @@
+<?php
+
+namespace Eclipse\Core\Filament\Pages\Tools;
+
+class HealthCheckResults extends \ShuvroRoy\FilamentSpatieLaravelHealth\Pages\HealthCheckResults
+{
+    public static function getNavigationGroup(): ?string
+    {
+        return 'Tools';
+    }
+}

src/Providers/AdminPanelProvider.php

@@ -8,6 +8,7 @@
 use DutchCodingCompany\FilamentDeveloperLogins\FilamentDeveloperLoginsPlugin;
 use Eclipse\Common\Providers\GlobalSearchProvider;
 use Eclipse\Core\Filament\Pages\EditProfile;
+use Eclipse\Core\Filament\Pages\Tools\HealthCheckResults;
 use Eclipse\Core\Models\Locale;
 use Eclipse\Core\Models\Site;
 use Eclipse\Core\Models\User;
@@ -41,6 +42,7 @@
 use Illuminate\Support\Facades\Schema;
 use Illuminate\View\Middleware\ShareErrorsFromSession;
 use pxlrbt\FilamentEnvironmentIndicator\EnvironmentIndicatorPlugin;
+use ShuvroRoy\FilamentSpatieLaravelHealth\FilamentSpatieLaravelHealthPlugin;
 
 class AdminPanelProvider extends PanelProvider
 {
@@ -122,6 +124,9 @@ public function panel(Panel $panel): Panel
                 SpatieLaravelTranslatablePlugin::make()
                     ->defaultLocales($localeIds),
                 ThemesPlugin::make(),
+                FilamentSpatieLaravelHealthPlugin::make()
+                    ->usingPage(HealthCheckResults::class)
+                    ->authorize(fn (): bool => auth()->user()->hasRole('super_admin')),
             ])
             ->navigationGroups([
                 NavigationGroup::make('Users'),

tests/Feature/AccessTest.php

@@ -72,3 +72,25 @@
     $this->actingAs($user);
     $this->get(config('log-viewer.route_path', 'log-viewer'))->assertStatus(200);
 });
+
+test('health check is not accessible for non-super-admin users', function () {
+    $this->set_up_common_user_and_tenant();
+
+    // Assert the user doesn't have super_admin role
+    $this->assertFalse(auth()->user()->hasRole('super_admin'));
+
+    // Test access
+    $this->get('/admin/health-check-results')
+        ->assertStatus(403);
+});
+
+test('health check is accessible for super admin users', function () {
+    $this->set_up_super_admin_and_tenant();
+
+    // Assert the user has super_admin role
+    $this->assertTrue(auth()->user()->hasRole('super_admin'));
+
+    // Test access
+    $this->get('/admin/health-check-results')
+        ->assertStatus(200);
+});