feat: tag user paths

openapi/mv-openapi-root.yaml

@@ -33,6 +33,13 @@ paths:
   '/users/{user-id}':
     $ref: 'paths/users@{user-id}.yaml'
 tags:
+  - name: User Management
+    description: |
+      All the paths for:
+        - user creation
+        - authentication
+        - security
+        - trust levels
   - name: Poll Indexation
     description: >
       Paths about indexing (public) polls.
@@ -60,3 +67,6 @@ components:
     userAuth:
       type: http
       scheme: bearer
+    adminAuth:
+      type: http
+      scheme: bearer

openapi/paths/polls@{poll-id}@ballots@{ballot-id}.yaml

@@ -13,8 +13,8 @@ get:
   operationId: get-ballot
   summary: Gets a ballot by ID
   tags:
-    - Poll Participation
     - Poll Deliberation
+    - Poll Participation
   responses:
     '200':
       description: A ballot object

openapi/paths/users.yaml

@@ -1,6 +1,9 @@
+#
 get:
   operationId: get-users
-  summary: Gets all users.
+  summary: Gets all users
+  tags:
+    - User Management
   responses:
     '200':
       description: OK
@@ -10,9 +13,13 @@ get:
             type: array
             items:
               $ref: ../components/schemas/user.yaml
+  security:
+    - adminAuth: []
 post:
   operationId: create-user
   summary: Creates an user
+  tags:
+    - User Management
   requestBody:
     required: true
     content:

openapi/paths/users@{user-id}.yaml

@@ -8,6 +8,8 @@ parameters:
 get:
   operationId: get-user
   summary: Gets a user by ID
+  tags:
+    - User Management
   responses:
     '200':
       description: OK
@@ -20,6 +22,8 @@ get:
 patch:
   operationId: update-user
   summary: Updates a user
+  tags:
+    - User Management
   requestBody:
     required: true
     content:
@@ -41,6 +45,8 @@ patch:
 delete:
   operationId: delete-user
   summary: Deletes a user
+  tags:
+    - User Management
   responses:
     '200':
       description: OK