Add role templates, favorite groups query param (#466)

Addresses #101 and #198

Author: VinyarionHyarmendacil

openapi/components/paths.yaml

@@ -132,6 +132,8 @@
 
 "/groups":
   $ref: "./paths/groups.yaml#/paths/~1groups"
+"/groups/roleTemplates":
+  $ref: "./paths/groups.yaml#/paths/~1groups~1roleTemplates"
 "/groups/{groupId}":
   $ref: "./paths/groups.yaml#/paths/~1groups~1{groupId}"
 "/groups/{groupId}/announcement":

openapi/components/paths/favorites.yaml

@@ -108,6 +108,7 @@ paths:
       parameters:
         - $ref: ../parameters.yaml#/number
         - $ref: ../parameters.yaml#/offset
+        - $ref: ../parameters.yaml#/userIdAdmin
         - schema:
             type: string
           in: query

openapi/components/paths/groups.yaml

@@ -44,6 +44,20 @@ paths:
           $ref: ../responses/MissingCredentialsError.yaml
       security:
         - authCookie: []
+  /groups/roleTemplates:
+    get:
+      summary: Get Group Role Templates
+      description: Obtain predefined templates for group roles
+      operationId: getGroupRoleTemplates
+      tags:
+        - groups
+      responses:
+        '200':
+          $ref: ../responses/groups/GroupRoleTemplatesResponse.yaml
+        '401':
+          $ref: ../responses/MissingCredentialsError.yaml
+      security:
+        - authCookie: []
   '/groups/{groupId}':
     parameters:
       - $ref: ../parameters.yaml#/groupId

openapi/components/responses/groups/GroupRoleTemplatesResponse.yaml

@@ -0,0 +1,7 @@
+description: Returns a dictionary of GroupRoleTemplate objects.
+content:
+  application/json:
+    schema:
+      type: object
+      additionalProperties:
+        $ref: ../../schemas/GroupRoleTemplateValues.yaml

openapi/components/schemas/GroupRoleTemplateValues.yaml

@@ -0,0 +1,30 @@
+title: GroupRoleTemplateValues
+type: object
+properties:
+  basePermissions:
+    type: array
+    items:
+      $ref: ./GroupPermissions.yaml
+  description:
+    type: string
+  name:
+    type: string
+  roles:
+    type: object
+    properties:
+      description:
+        type: string
+      name:
+        type: string
+      basePermissions:
+        type: array
+        items:
+          $ref: ./GroupPermissions.yaml
+      isAddedOnJoin:
+        type: boolean
+        default: false
+required:
+  - basePermissions
+  - description
+  - name
+  - roles