add health endpoint

Author: Thiritin

app/Http/Controllers/HealthController.php

@@ -0,0 +1,30 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use Illuminate\Http\JsonResponse;
+use Illuminate\Support\Facades\DB;
+
+class HealthController extends Controller
+{
+    public function __invoke(): JsonResponse
+    {
+        try {
+            DB::connection()->getPdo();
+            $dbStatus = 'ok';
+        } catch (\Exception $e) {
+            $dbStatus = 'error';
+        }
+
+        $status = $dbStatus === 'ok' ? 'healthy' : 'unhealthy';
+        $httpCode = $status === 'healthy' ? 200 : 503;
+
+        return response()->json([
+            'status' => $status,
+            'timestamp' => now()->toISOString(),
+            'services' => [
+                'database' => $dbStatus,
+            ],
+        ], $httpCode);
+    }
+}

infra/dev/image/Containerfile

@@ -14,7 +14,7 @@ WORKDIR /var/www/html
 # PHP version to be installed
 # See: https://rpms.remirepo.net/wizard/
 # WARNING: PHP 8.2 have only security only support until December 2026
-ARG PHP_VERSION=8.2
+ARG PHP_VERSION=8.3
 
 # list of all PHP packages to be installed
 ARG PHP_PACKAGES="php-cli composer php-intl php-json php-mbstring php-mysqlnd php-opcache php-pdo php-gd php-redis php-xml php-swoole php-zip php-sodium php-bcmath"

routes/api.php

@@ -4,6 +4,7 @@
 use App\Http\Controllers\Api\v1\GroupUserController;
 use App\Http\Controllers\Api\v1\IntrospectionController;
 use App\Http\Controllers\Api\v1\UserinfoController;
+use App\Http\Controllers\HealthController;
 use Illuminate\Support\Facades\Route;
 
 /*
@@ -34,3 +35,6 @@
     // Introspect requires auth via client id + secret
     Route::post('introspect', IntrospectionController::class)->name('introspect');
 });
+
+// Health check endpoint - no authentication required
+Route::get('health', HealthController::class)->name('health');