Enable multiple catalogs (#3) (#4)

Author: jordivx

.gitignore

@@ -17,6 +17,10 @@ bin/
 !**/src/main/**/bin/
 !**/src/test/**/bin/
 
+### secrets skip for token generation ###
+/openshift/*.key
+/openshift/*.p12
+
 ### IntelliJ IDEA ###
 .idea
 *.iws
@@ -41,3 +45,4 @@ out/
 
 # Exclude executable JAR file from gradle build
 /docker/app.jar
+

README.md

@@ -91,3 +91,11 @@ To do that:
 
 **TODO** link to the documentation for the required directory structure and Catalog(Item).yaml specifications 
 
+# Security and local development
+In order to get access to the different bickbucket repositories, the local development environment needs to be configured with the required credentials. Those credentials will be part of the request, as a token.
+
+To get the token for the local development, feel free to get security token from any page where azure SSO is required. (you can also execute the script below in your browser console)
+```javascript
+javascript:(function(){let value=JSON.parse(localStorage[Object.keys(localStorage).find(key=>key.includes('idtoken'))])['secret'];navigator.clipboard.writeText(value);alert('Token copied to clipboard');})();
+```
+

build.gradle

@@ -23,7 +23,7 @@ plugins {
     id 'jacoco'
     id 'maven-publish'
 	id 'java'
-	id 'org.springframework.boot' version '3.4.3'
+	id 'org.springframework.boot' version '3.4.7'
 	id 'io.spring.dependency-management' version '1.1.7'
     id "com.gorylenko.gradle-git-properties" version "2.4.1" // Adds git info on /actuator/info endpoint
 }

doc/cc-backend-run-config-01.png

@@ -29,6 +29,87 @@ tags:
   - name: Files
     description: File operations.
 paths:
+  /catalog-descriptors:
+    get:
+      tags:
+        - Catalog-descriptors
+      summary: List of all available Catalog Descriptors.
+      description: > 
+        Returns a list of all available Catalog Descriptors.<br/>
+      operationId: getCatalogDescriptors
+      responses:
+        "200":
+          description: A list of Catalog Descriptors.
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  $ref: '#/components/schemas/CatalogDescriptor'
+        "401":
+          description: Invalid client token on the request.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/RestErrorMessage'
+        "403":
+          description: Insufficient permissions for the client to access the resource.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/RestErrorMessage'
+        "500":
+          description: Server error.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/RestErrorMessage'
+  /catalogs/{id}:
+    get:
+      tags:
+        - Catalogs
+      summary: Get a catalog by id.
+      description: >
+        Returns a valid catalog.
+      operationId: getCatalog
+      parameters:
+        - name: id
+          in: path
+          description: id for the Catalog.
+          required: true
+          schema:
+            type: string
+      responses:
+        "200":
+          description: A Single catalog.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Catalog'
+        "401":
+          description: Invalid client token on the request.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/RestErrorMessage'
+        "403":
+          description: Insufficient permissions for the client to access the resource.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/RestErrorMessage'
+        "404":
+          description: Catalog not found
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/RestErrorMessage'
+        "500":
+          description: Server error.
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/RestErrorMessage'
   /catalog-items:
     get:
       tags:
@@ -274,6 +355,44 @@ components:
       scheme: bearer
       bearerFormat: JWT
   schemas:
+    Catalog:
+      properties:
+        name:
+          type: string
+          example: 'catalog-name'
+        description:
+          type: string
+          example: 'A brief description for a catalog'
+        communityPageId:
+          type: string
+          example: 'aSdFam...yCg=='
+        links:
+          type: array
+          items:
+            $ref: '#/components/schemas/CatalogLink'
+        tags:
+          type: array
+          items:
+            type: string
+          example:
+            - 'tasks'
+            - 'technologies'
+    CatalogDescriptor:
+      properties:
+        id:
+          type: string
+          example: 'aSdFam...yCg=='
+        slug:
+          type: string
+          example: 'aSdFam...yCg=='
+    CatalogLink:
+      properties:
+        url:
+          type: string
+          example: 'http://some-link.com'
+        name:
+          type: string
+          example: 'whatever name'
     CatalogItem:
       properties:
         id:
@@ -297,6 +416,9 @@ components:
         itemSrc:
           type: string
           example: 'https://bitbucket.some-company.com/projects/SOMEPROJECT/repos/some-repo/browse/CatalogItem.yaml?at=refs/heads/master'
+        type:
+          type: string
+          example: 'machine-learning-model'
         tags:
           type: array
           items: