ECOPROJECT-4214 | feat: persist cluster requirements inputs with upsert and add GET endpoint for PDF reuse

Signed-off-by: Ronen Avraham <ravraham@redhat.com>

Author: ronenav

api/v1alpha1/openapi.yaml

@@ -662,6 +662,63 @@ paths:
             application/json:
               schema:
                 $ref: "#/components/schemas/Error"
+  /api/v1/assessments/{id}/cluster-requirements/stored-input:
+    get:
+      tags:
+        - assessment
+      description: Get stored cluster requirements input for an assessment cluster
+      operationId: getAssessmentClusterRequirementsStoredInput
+      parameters:
+        - name: id
+          in: path
+          description: ID of the assessment
+          required: true
+          schema:
+            type: string
+            format: uuid
+        - name: clusterId
+          in: query
+          description: ID of the VMware cluster
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: Stored cluster requirements input found
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/ClusterRequirementsStoredInput"
+        "400":
+          description: Bad Request
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+        "401":
+          description: Unauthorized
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+        "403":
+          description: Forbidden
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+        "404":
+          description: Assessment or cluster requirements input not found
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
+        "500":
+          description: Internal error
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/Error"
   /api/v1/assessments/{id}/migration-estimation:
     post:
       tags:
@@ -2451,6 +2508,49 @@ components:
         - workerNodeCPU
         - workerNodeMemory
 
+    ClusterRequirementsStoredInput:
+      type: object
+      description: Stored cluster requirements payload for a cluster
+      properties:
+        clusterId:
+          type: string
+          description: ID of the cluster
+        cpuOverCommitRatio:
+          type: string
+          enum: ["1:1", "1:2", "1:4", "1:6"]
+          description: CPU over-commit ratio (e.g., "1:4")
+        memoryOverCommitRatio:
+          type: string
+          enum: ["1:1", "1:2", "1:4"]
+          description: Memory over-commit ratio (e.g., "1:2")
+        workerNodeCPU:
+          type: integer
+          description: CPU cores per worker node
+        workerNodeMemory:
+          type: integer
+          description: Memory (GB) per worker node
+        workerNodeThreads:
+          type: integer
+          description: Number of CPU threads per worker node
+        controlPlaneSchedulable:
+          type: boolean
+          description: Allow workload scheduling on control plane nodes
+        controlPlaneCPU:
+          type: integer
+          description: CPU cores per control plane node
+        controlPlaneMemory:
+          type: integer
+          description: Memory in GB per control plane node
+        controlPlaneNodeCount:
+          type: integer
+          enum: [1, 3]
+          description: Number of control plane nodes
+        hostedControlPlane:
+          type: boolean
+          description: If true, control plane is hosted externally
+      required:
+        - clusterId
+
     ClusterRequirementsResponse:
       type: object
       description: Cluster requirements calculation results