From 49dd885344aafb58fa811a647ebe181b164afdc4 Mon Sep 17 00:00:00 2001
From: mitrikov <j6p@bk.ru>
Date: Tue, 8 Apr 2025 14:17:19 +1200
Subject: [PATCH] =?UTF-8?q?feat:=20=D0=B8=D0=B7=D0=BC=D0=B5=D0=BD=D0=B5?=
 =?UTF-8?q?=D0=BD=D0=B8=D1=8F=20=D0=B2=20api=20=D0=B4=D0=BE=D1=81=D0=BE?=
 =?UTF-8?q?=D0=BA?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 v2/swagger.yaml | 47 +++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 47 insertions(+)

diff --git a/v2/swagger.yaml b/v2/swagger.yaml
index 08c5a5d..8901d25 100644
--- a/v2/swagger.yaml
+++ b/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: [ ]
\ No newline at end of file