feat: add Swagger integration with OpenAPI annotations and endpoints

src/Controllers/HealthcheckController.php

@@ -11,6 +11,7 @@ use Siteworxpro\App\Http\JsonResponseFactory;
 use Siteworxpro\App\Models\Model;
 use Siteworxpro\App\Services\Facades\Redis;
 use Siteworxpro\HttpStatus\CodesEnum;
+use OpenApi\Attributes as OA;
 
 /**
  * Class HealthcheckController
@@ -24,6 +25,9 @@ class HealthcheckController extends Controller
     /**
      * @throws \JsonException
      */
+    #[OA\Get(path: '/healthz')]
+    #[OA\Response(response: '200', description: 'Healthcheck OK')]
+    #[OA\Response(response: '503', description: 'Healthcheck Failed')]
     public function get(ServerRequest $request): ResponseInterface
     {
         try {