feat: Extend Swagger Coverage for controller ReleasesApiController

Author: andrestejerina97

app/Http/Controllers/Apis/ReleasesApiController.php

@@ -17,6 +17,8 @@
 use Illuminate\Support\Facades\Log;
 use models\oauth2\IResourceServerContext;
 use ModelSerializers\SerializerRegistry;
+use OpenApi\Attributes as OA;
+use Symfony\Component\HttpFoundation\Response;
 
 /**
  * Class ReleasesApiController
@@ -42,6 +44,29 @@ public function __construct
     /**
      * @return \Illuminate\Http\JsonResponse|mixed|void
      */
+    #[OA\Get(
+        path: '/api/v1/releases/current',
+        operationId: 'getCurrentRelease',
+        description: 'Retrieve the current OpenStack release',
+        tags: ['Releases'],
+        responses: [
+            new OA\Response(
+                response: Response::HTTP_OK,
+                description: 'Current OpenStack release',
+                content: new OA\JsonContent(
+                    ref: '#/components/schemas/OpenStackRelease'
+                )
+            ),
+            new OA\Response(
+                response: Response::HTTP_NOT_FOUND,
+                description: 'Current release not found'
+            ),
+            new OA\Response(
+                response: Response::HTTP_INTERNAL_SERVER_ERROR,
+                description: 'Server Error'
+            ),
+        ]
+    )]
     public function getCurrent(){
         try{
             $current = $this->repository->getCurrent();

app/Swagger/ReleasesSchemas.php

@@ -0,0 +1,36 @@
+<?php 
+
+namespace App\Swagger\schemas;
+
+use OpenApi\Attributes as OA;
+
+
+#[OA\Schema(
+    schema: 'OpenStackRelease',
+    type: 'object',
+    properties: [
+        new OA\Property(property: 'id', type: 'integer', example: 1),
+        new OA\Property(property: 'created', type: 'integer', description: 'Unix timestamp', example: 1630500518),
+        new OA\Property(property: 'last_edited', type: 'integer', description: 'Unix timestamp', example: 1630500518),
+        new OA\Property(property: 'name', type: 'string', example: 'Zed'),
+        new OA\Property(property: 'release_number', type: 'string', example: '2024.2'),
+        new OA\Property(property: 'release_date', type: 'integer', description: 'Unix timestamp', example: 1729123200),
+        new OA\Property(property: 'status', type: 'string', example: 'current'),
+    ],
+    anyOf: [
+        new OA\Property(
+            property: 'components',
+            type: 'array',
+            items: new OA\Items(type: 'integer'),
+            description: 'Array of component IDs (only when not expanded)',
+            example: [1, 2, 3]
+        ),
+        new OA\Property(
+            property: 'components',
+            type: 'array',
+            items: new OA\Items(type: 'SoftwareComponent'),
+            description: 'Array of component objects (only when expanded with expand=components)'
+        ),
+    ]
+)]
+class OpenStackReleaseSchema {}