Merge branch 'feature/H-1821' into 'master'

feat: изменения в api досок

See merge request hrbox-public/api!15

v2/swagger.yaml

@@ -3822,6 +3822,9 @@ paths:
       summary: Список новичков
       operationId: /newbies/index
       parameters:
+        - $ref: '#/components/parameters/boardDepartmentId'
+        - $ref: '#/components/parameters/userListKey'
+        - $ref: '#/components/parameters/boardWithFavorites'
         - $ref: '#/components/parameters/boardDateTypeParam'
         - $ref: '#/components/parameters/boardDateDayParam'
         - $ref: '#/components/parameters/boardDateWeekParam'
@@ -3867,6 +3870,10 @@ paths:
                     $ref: '#/components/schemas/_meta'
                   _periodUrls:
                     $ref: '#/components/schemas/_periodUrls'
+                  periodUrls:
+                    $ref: '#/components/schemas/_periodUrls'
+                  currentPeriod:
+                    $ref: '#/components/schemas/currentPeriod'
         400:
           description: Bad Request.
         401:
@@ -3883,6 +3890,9 @@ paths:
       summary: Список дней рождений
       operationId: /birthday/index
       parameters:
+        - $ref: '#/components/parameters/boardDepartmentId'
+        - $ref: '#/components/parameters/userListKey'
+        - $ref: '#/components/parameters/boardWithFavorites'
         - $ref: '#/components/parameters/boardDateTypeParam'
         - $ref: '#/components/parameters/boardDateDayParam'
         - $ref: '#/components/parameters/boardDateWeekParam'
@@ -3928,6 +3938,10 @@ paths:
                     $ref: '#/components/schemas/_meta'
                   _periodUrls:
                     $ref: '#/components/schemas/_periodUrls'
+                  periodUrls:
+                    $ref: '#/components/schemas/_periodUrls'
+                  currentPeriod:
+                    $ref: '#/components/schemas/currentPeriod'
         400:
           description: Bad Request.
         401:
@@ -3944,6 +3958,9 @@ paths:
       summary: Список годовщин по стажу в компании
       operationId: /experienced/index
       parameters:
+        - $ref: '#/components/parameters/boardDepartmentId'
+        - $ref: '#/components/parameters/userListKey'
+        - $ref: '#/components/parameters/boardWithFavorites'
         - $ref: '#/components/parameters/boardDateTypeParam'
         - $ref: '#/components/parameters/boardDateDayParam'
         - $ref: '#/components/parameters/boardDateWeekParam'
@@ -4006,6 +4023,10 @@ paths:
                     $ref: '#/components/schemas/_meta'
                   _periodUrls:
                     $ref: '#/components/schemas/_periodUrls'
+                  periodUrls:
+                    $ref: '#/components/schemas/_periodUrls'
+                  currentPeriod:
+                    $ref: '#/components/schemas/currentPeriod'
         400:
           description: Bad Request.
         401:
@@ -4583,6 +4604,12 @@ components:
           properties:
             href:
               type: string
+
+    currentPeriod:
+      type: string
+      description: Выбранный период дат в текстовом формате, с учётом локализации
+      example: "07.04.25 - 13.04.25"
+
     WorkflowCategory:
       type: object
       properties:
@@ -8025,6 +8052,9 @@ components:
               description: User department name
               type: string
               example: 'New Department'
+            isFavorite:
+              description: Находится ли пользователь в избранном
+              type: boolean
 
     shopOrderCheckoutRequestBody:
       type: object
@@ -8264,6 +8294,23 @@ components:
       schema:
         type: integer
       example: 2024
+    boardDepartmentId:
+      name: department_id
+      in: query
+      description: UUID подразделения, либо их список, разделённый запятой
+      required: false
+    boardWithFavorites:
+      name: with_favorites
+      in: query
+      description: Возвращать результат вместе с избранными пользователями
+      required: false
+      example: 1
+    userListKey:
+      name: user_list_key
+      in: query
+      description: UUID списка пользователей
+      schema:
+        type: string
 security:
   - SessionAuth: [ ]
   - ApiKeyAuth: [ ]