init

backend/app/Http/Controllers/Api/V1/HealthController.php

@@ -0,0 +1,19 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers\Api\V1;
+
+use App\Http\Controllers\Controller;
+use App\Support\ApiResponse;
+use Illuminate\Http\JsonResponse;
+
+final class HealthController extends Controller
+{
+    public function __invoke(): JsonResponse
+    {
+        return ApiResponse::success([
+            'status' => 'ok',
+        ]);
+    }
+}

backend/app/Http/Controllers/Controller.php

@@ -0,0 +1,8 @@
+<?php
+
+namespace App\Http\Controllers;
+
+abstract class Controller
+{
+    //
+}

backend/app/Http/Middleware/AssignRequestId.php

@@ -0,0 +1,31 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Middleware;
+
+use Closure;
+use Illuminate\Http\Request;
+use Illuminate\Support\Str;
+use Symfony\Component\HttpFoundation\Response;
+
+final class AssignRequestId
+{
+    public const ATTRIBUTE = 'request_id';
+
+    public function handle(Request $request, Closure $next): Response
+    {
+        $incoming = $request->headers->get('X-Request-Id');
+        $requestId = is_string($incoming) && preg_match('/^[A-Za-z0-9_-]{1,64}$/', $incoming) === 1
+            ? $incoming
+            : (string) Str::uuid();
+
+        $request->attributes->set(self::ATTRIBUTE, $requestId);
+
+        /** @var Response $response */
+        $response = $next($request);
+        $response->headers->set('X-Request-Id', $requestId);
+
+        return $response;
+    }
+}