@hubex/mcp 0.2.0

package/swagger/dev/WSP.json

@@ -0,0 +1,1612 @@
+{
+  "openapi": "3.0.1",
+  "info": {
+    "title": "API for work schedule managing for HubEx",
+    "description": "Service offers various methods for managing schedule rules and their corresponding attributes.",
+    "contact": {
+      "name": "SmartService Backend Team",
+      "email": "fmbackend@melston.ru"
+    },
+    "version": "v1.0.0.0"
+  },
+  "servers": [
+    {
+      "url": "/WSP"
+    }
+  ],
+  "paths": {
+    "/ScheduleRules": {
+      "get": {
+        "tags": [
+          "ScheduleRules"
+        ],
+        "summary": "Возвращает список доступных графиков рабочего времени.",
+        "description": "## Пример запроса:\r\n```text\r\nGET /ScheduleRules\r\nAuthorization: Bearer <access-token>\r\nRange: Offset=0; Fetch=50\r\n```\r\n            \r\n## Пример успешного ответа (200):\r\n```json\r\n{\r\n  \"10\": {\r\n    \"name\": \"Стандартный график\",\r\n    \"description\": \"График работы с 9:00 до 18:00\",\r\n    \"scheduleTypeID\": 1,\r\n    \"dataFrom\": \"2024-01-01T00:00:00Z\"\r\n  }\r\n}\r\n```\r\n            \r\n## Пример успешного ответа (206):\r\nТело ответа имеет тот же формат, что и для `200`, но содержит частичный диапазон.\r\n            \r\n## Негативные сценарии:\r\n- 204 No Content — графики не найдены.\r\n- 401 Unauthorized — отсутствует или некорректен Bearer-токен.\r\n- 403 Forbidden — недостаточно прав.",
+        "parameters": [
+          {
+            "name": "X-Application-ID",
+            "in": "header",
+            "description": "Идентификатор приложения. EngineerMobile - 1, CustomerMobile - 2, MainWeb - 3, AdminWeb - 4, Api - 5, PlateWeb - 6",
+            "schema": {
+              "enum": [
+                1,
+                2,
+                3,
+                4,
+                5,
+                6
+              ],
+              "type": "integer",
+              "format": "int32",
+              "default": 3,
+              "x-enumNames": [
+                "EngineerMobile",
+                "CustomerMobile",
+                "MainWeb",
+                "AdminWeb",
+                "Api",
+                "PlateWeb"
+              ]
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Список графиков успешно получен.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "$ref": "#/components/schemas/ListResult"
+                  }
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "$ref": "#/components/schemas/ListResult"
+                  }
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "$ref": "#/components/schemas/ListResult"
+                  }
+                }
+              }
+            }
+          },
+          "206": {
+            "description": "Возвращена часть списка в пределах диапазона.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "$ref": "#/components/schemas/ListResult"
+                  }
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "$ref": "#/components/schemas/ListResult"
+                  }
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "$ref": "#/components/schemas/ListResult"
+                  }
+                }
+              }
+            }
+          },
+          "204": {
+            "description": "Графики не найдены."
+          },
+          "401": {
+            "description": "Токен отсутствует или некорректен."
+          },
+          "403": {
+            "description": "Недостаточно прав."
+          }
+        },
+        "security": [
+          {
+            "Bearer": [ ]
+          }
+        ]
+      },
+      "post": {
+        "tags": [
+          "ScheduleRules"
+        ],
+        "summary": "Создаёт график рабочего времени.",
+        "description": "## Пример запроса:\r\n```json\r\nPOST /ScheduleRules\r\nAuthorization: Bearer <access-token>\r\n            \r\n{\r\n  \"name\": \"Стандартный график\",\r\n  \"description\": \"График работы с 9:00 до 18:00\",\r\n  \"isDefault\": false,\r\n  \"scheduleTypeID\": 1,\r\n  \"from\": \"2024-06-01T00:00:00Z\",\r\n  \"till\": \"2024-12-31T23:59:59Z\",\r\n  \"considerPublicHolidays\": true,\r\n  \"shortageHoursBeforeHoliday\": 1,\r\n  \"rules\": [\r\n    {\r\n      \"cron\": \"0 9 * * 1-5\",\r\n      \"occurrenceDuration\": \"08:00:00\"\r\n    }\r\n  ],\r\n  \"overridings\": []\r\n}\r\n```\r\n            \r\n## Пример успешного ответа (201):\r\n```json\r\n10\r\n```\r\n            \r\n## Негативные сценарии:\r\n- 409 Conflict — некорректные данные модели.\r\n- 401 Unauthorized — отсутствует или некорректен Bearer-токен.\r\n- 403 Forbidden — недостаточно прав.",
+        "parameters": [
+          {
+            "name": "X-Application-ID",
+            "in": "header",
+            "description": "Идентификатор приложения. EngineerMobile - 1, CustomerMobile - 2, MainWeb - 3, AdminWeb - 4, Api - 5, PlateWeb - 6",
+            "schema": {
+              "enum": [
+                1,
+                2,
+                3,
+                4,
+                5,
+                6
+              ],
+              "type": "integer",
+              "format": "int32",
+              "default": 3,
+              "x-enumNames": [
+                "EngineerMobile",
+                "CustomerMobile",
+                "MainWeb",
+                "AdminWeb",
+                "Api",
+                "PlateWeb"
+              ]
+            }
+          }
+        ],
+        "requestBody": {
+          "description": "Данные для создания графика.",
+          "content": {
+            "application/json-patch+json": {
+              "schema": {
+                "$ref": "#/components/schemas/ScheduleCreateDto"
+              }
+            },
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ScheduleCreateDto"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ScheduleCreateDto"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/ScheduleCreateDto"
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "description": "График успешно создан.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "type": "integer",
+                  "format": "int32"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "integer",
+                  "format": "int32"
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "type": "integer",
+                  "format": "int32"
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "Некорректные данные."
+          },
+          "401": {
+            "description": "Токен отсутствует или некорректен."
+          },
+          "403": {
+            "description": "Недостаточно прав."
+          }
+        },
+        "security": [
+          {
+            "Bearer": [ ]
+          }
+        ]
+      }
+    },
+    "/ScheduleRules/preview": {
+      "post": {
+        "tags": [
+          "ScheduleRules"
+        ],
+        "summary": "Возвращает предпросмотр графика рабочего времени.",
+        "description": "## Пример запроса:\r\n```json\r\nPOST /ScheduleRules/preview\r\nAuthorization: Bearer <access-token>\r\n            \r\n{\r\n  \"from\": \"2024-06-01T00:00:00Z\",\r\n  \"till\": \"2024-06-30T23:59:59Z\",\r\n  \"considerPublicHolidays\": true,\r\n  \"shortageHoursBeforeHoliday\": 1,\r\n  \"rules\": [\r\n    {\r\n      \"cron\": \"0 9 * * 1-5\",\r\n      \"occurrenceDuration\": \"08:00:00\"\r\n    }\r\n  ],\r\n  \"overridings\": []\r\n}\r\n```\r\n            \r\n## Пример успешного ответа (201):\r\n```json\r\n[\r\n  {\r\n    \"scheduleRuleID\": 0,\r\n    \"timeFrom\": \"2024-06-03T09:00:00Z\",\r\n    \"timeTill\": \"2024-06-03T17:00:00Z\",\r\n    \"isPublicHoliday\": false,\r\n    \"isNightShift\": false,\r\n    \"dateWork\": \"2024-06-03T00:00:00Z\"\r\n  }\r\n]\r\n```\r\n            \r\n## Негативные сценарии:\r\n- 401 Unauthorized — отсутствует или некорректен Bearer-токен.\r\n- 403 Forbidden — недостаточно прав.",
+        "parameters": [
+          {
+            "name": "X-Application-ID",
+            "in": "header",
+            "description": "Идентификатор приложения. EngineerMobile - 1, CustomerMobile - 2, MainWeb - 3, AdminWeb - 4, Api - 5, PlateWeb - 6",
+            "schema": {
+              "enum": [
+                1,
+                2,
+                3,
+                4,
+                5,
+                6
+              ],
+              "type": "integer",
+              "format": "int32",
+              "default": 3,
+              "x-enumNames": [
+                "EngineerMobile",
+                "CustomerMobile",
+                "MainWeb",
+                "AdminWeb",
+                "Api",
+                "PlateWeb"
+              ]
+            }
+          }
+        ],
+        "requestBody": {
+          "description": "Данные для генерации предпросмотра.",
+          "content": {
+            "application/json-patch+json": {
+              "schema": {
+                "$ref": "#/components/schemas/ScheduleExtendDto"
+              }
+            },
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ScheduleExtendDto"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ScheduleExtendDto"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/ScheduleExtendDto"
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "description": "Предпросмотр успешно сгенерирован.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/WorkScheduleDailyItemResult"
+                  }
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/WorkScheduleDailyItemResult"
+                  }
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "type": "array",
+                  "items": {
+                    "$ref": "#/components/schemas/WorkScheduleDailyItemResult"
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Токен отсутствует или некорректен."
+          },
+          "403": {
+            "description": "Недостаточно прав."
+          }
+        },
+        "security": [
+          {
+            "Bearer": [ ]
+          }
+        ]
+      }
+    },
+    "/ScheduleRules/{id}": {
+      "get": {
+        "tags": [
+          "ScheduleRules"
+        ],
+        "summary": "Возвращает график рабочего времени по идентификатору.",
+        "description": "## Пример запроса:\r\n```text\r\nGET /ScheduleRules/10\r\nAuthorization: Bearer <access-token>\r\n```\r\n            \r\n## Пример успешного ответа (200):\r\n```json\r\n{\r\n  \"name\": \"Стандартный график\",\r\n  \"description\": \"График работы с 9:00 до 18:00\",\r\n  \"scheduleTypeID\": 1,\r\n  \"periods\": [\r\n    {\r\n      \"from\": \"2024-01-01T00:00:00Z\",\r\n      \"till\": \"2024-12-31T23:59:59Z\",\r\n      \"holidayCalendarID\": 1,\r\n      \"shortageHoursBeforeHoliday\": 1,\r\n      \"model\": {\r\n        \"rules\": [\r\n          {\r\n            \"cron\": \"0 9 * * 1-5\",\r\n            \"occurrenceDuration\": \"08:00:00\"\r\n          }\r\n        ],\r\n        \"overridings\": []\r\n      }\r\n    }\r\n  ]\r\n}\r\n```\r\n            \r\n## Негативные сценарии:\r\n- 401 Unauthorized — отсутствует или некорректен Bearer-токен.\r\n- 403 Forbidden — недостаточно прав.",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "Идентификатор правила графика.",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int32"
+            }
+          },
+          {
+            "name": "X-Application-ID",
+            "in": "header",
+            "description": "Идентификатор приложения. EngineerMobile - 1, CustomerMobile - 2, MainWeb - 3, AdminWeb - 4, Api - 5, PlateWeb - 6",
+            "schema": {
+              "enum": [
+                1,
+                2,
+                3,
+                4,
+                5,
+                6
+              ],
+              "type": "integer",
+              "format": "int32",
+              "default": 3,
+              "x-enumNames": [
+                "EngineerMobile",
+                "CustomerMobile",
+                "MainWeb",
+                "AdminWeb",
+                "Api",
+                "PlateWeb"
+              ]
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "График успешно получен.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "$ref": "#/components/schemas/ScheduleRuleDto"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ScheduleRuleDto"
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ScheduleRuleDto"
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Токен отсутствует или некорректен."
+          },
+          "403": {
+            "description": "Недостаточно прав."
+          }
+        },
+        "security": [
+          {
+            "Bearer": [ ]
+          }
+        ]
+      },
+      "put": {
+        "tags": [
+          "ScheduleRules"
+        ],
+        "summary": "Обновляет график рабочего времени.",
+        "description": "Если `rules` не указаны, используются правила последнего периода существующего графика.\r\n            \r\n## Пример запроса:\r\n```json\r\nPUT /ScheduleRules/10\r\nAuthorization: Bearer <access-token>\r\n            \r\n{\r\n  \"name\": \"Обновлённый график\",\r\n  \"description\": \"Новое описание\",\r\n  \"scheduleTypeID\": 1,\r\n  \"from\": \"2024-01-01T00:00:00Z\",\r\n  \"till\": \"2024-12-31T23:59:59Z\",\r\n  \"considerPublicHolidays\": true,\r\n  \"shortageHoursBeforeHoliday\": 1,\r\n  \"rules\": [],\r\n  \"overridings\": []\r\n}\r\n```\r\n            \r\n## Пример успешного ответа (202):\r\nТело ответа пустое.\r\n            \r\n## Негативные сценарии:\r\n- 409 Conflict — некорректные данные модели.\r\n- 401 Unauthorized — отсутствует или некорректен Bearer-токен.\r\n- 403 Forbidden — недостаточно прав.",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "Идентификатор правила графика.",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int32"
+            }
+          },
+          {
+            "name": "X-Application-ID",
+            "in": "header",
+            "description": "Идентификатор приложения. EngineerMobile - 1, CustomerMobile - 2, MainWeb - 3, AdminWeb - 4, Api - 5, PlateWeb - 6",
+            "schema": {
+              "enum": [
+                1,
+                2,
+                3,
+                4,
+                5,
+                6
+              ],
+              "type": "integer",
+              "format": "int32",
+              "default": 3,
+              "x-enumNames": [
+                "EngineerMobile",
+                "CustomerMobile",
+                "MainWeb",
+                "AdminWeb",
+                "Api",
+                "PlateWeb"
+              ]
+            }
+          }
+        ],
+        "requestBody": {
+          "description": "Данные для обновления графика.",
+          "content": {
+            "application/json-patch+json": {
+              "schema": {
+                "$ref": "#/components/schemas/ScheduleUpdateDto"
+              }
+            },
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ScheduleUpdateDto"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ScheduleUpdateDto"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/ScheduleUpdateDto"
+              }
+            }
+          }
+        },
+        "responses": {
+          "202": {
+            "description": "График успешно обновлён."
+          },
+          "409": {
+            "description": "Некорректные данные."
+          },
+          "401": {
+            "description": "Токен отсутствует или некорректен."
+          },
+          "403": {
+            "description": "Недостаточно прав."
+          }
+        },
+        "security": [
+          {
+            "Bearer": [ ]
+          }
+        ]
+      },
+      "delete": {
+        "tags": [
+          "ScheduleRules"
+        ],
+        "summary": "Удаляет график рабочего времени.",
+        "description": "## Пример запроса:\r\n```text\r\nDELETE /ScheduleRules/10\r\nAuthorization: Bearer <access-token>\r\n```\r\n            \r\n## Пример успешного ответа (202):\r\nТело ответа пустое.\r\n            \r\n## Негативные сценарии:\r\n- 401 Unauthorized — отсутствует или некорректен Bearer-токен.\r\n- 403 Forbidden — недостаточно прав.",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "Идентификатор правила графика.",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int32"
+            }
+          },
+          {
+            "name": "X-Application-ID",
+            "in": "header",
+            "description": "Идентификатор приложения. EngineerMobile - 1, CustomerMobile - 2, MainWeb - 3, AdminWeb - 4, Api - 5, PlateWeb - 6",
+            "schema": {
+              "enum": [
+                1,
+                2,
+                3,
+                4,
+                5,
+                6
+              ],
+              "type": "integer",
+              "format": "int32",
+              "default": 3,
+              "x-enumNames": [
+                "EngineerMobile",
+                "CustomerMobile",
+                "MainWeb",
+                "AdminWeb",
+                "Api",
+                "PlateWeb"
+              ]
+            }
+          }
+        ],
+        "responses": {
+          "202": {
+            "description": "График успешно удалён."
+          },
+          "401": {
+            "description": "Токен отсутствует или некорректен."
+          },
+          "403": {
+            "description": "Недостаточно прав."
+          }
+        },
+        "security": [
+          {
+            "Bearer": [ ]
+          }
+        ]
+      }
+    },
+    "/ScheduleRules/extend/{id}": {
+      "put": {
+        "tags": [
+          "ScheduleRules"
+        ],
+        "summary": "Расширяет график рабочего времени.",
+        "description": "Если `rules` не указаны, используются правила последнего периода существующего графика.\r\n            \r\n## Пример запроса:\r\n```json\r\nPUT /ScheduleRules/extend/10\r\nAuthorization: Bearer <access-token>\r\n            \r\n{\r\n  \"from\": \"2025-01-01T00:00:00Z\",\r\n  \"till\": \"2025-12-31T23:59:59Z\",\r\n  \"considerPublicHolidays\": true,\r\n  \"shortageHoursBeforeHoliday\": 1,\r\n  \"rules\": [],\r\n  \"overridings\": []\r\n}\r\n```\r\n            \r\n## Пример успешного ответа (202):\r\nТело ответа пустое.\r\n            \r\n## Негативные сценарии:\r\n- 409 Conflict — некорректные данные модели.\r\n- 401 Unauthorized — отсутствует или некорректен Bearer-токен.\r\n- 403 Forbidden — недостаточно прав.",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "Идентификатор правила графика.",
+            "required": true,
+            "schema": {
+              "type": "integer",
+              "format": "int32"
+            }
+          },
+          {
+            "name": "X-Application-ID",
+            "in": "header",
+            "description": "Идентификатор приложения. EngineerMobile - 1, CustomerMobile - 2, MainWeb - 3, AdminWeb - 4, Api - 5, PlateWeb - 6",
+            "schema": {
+              "enum": [
+                1,
+                2,
+                3,
+                4,
+                5,
+                6
+              ],
+              "type": "integer",
+              "format": "int32",
+              "default": 3,
+              "x-enumNames": [
+                "EngineerMobile",
+                "CustomerMobile",
+                "MainWeb",
+                "AdminWeb",
+                "Api",
+                "PlateWeb"
+              ]
+            }
+          }
+        ],
+        "requestBody": {
+          "description": "Данные для расширения графика.",
+          "content": {
+            "application/json-patch+json": {
+              "schema": {
+                "$ref": "#/components/schemas/ScheduleExtendDto"
+              }
+            },
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ScheduleExtendDto"
+              }
+            },
+            "text/json": {
+              "schema": {
+                "$ref": "#/components/schemas/ScheduleExtendDto"
+              }
+            },
+            "application/*+json": {
+              "schema": {
+                "$ref": "#/components/schemas/ScheduleExtendDto"
+              }
+            }
+          }
+        },
+        "responses": {
+          "202": {
+            "description": "График успешно расширен."
+          },
+          "409": {
+            "description": "Некорректные данные."
+          },
+          "401": {
+            "description": "Токен отсутствует или некорректен."
+          },
+          "403": {
+            "description": "Недостаточно прав."
+          }
+        },
+        "security": [
+          {
+            "Bearer": [ ]
+          }
+        ]
+      }
+    },
+    "/ScheduleRules/holiday": {
+      "get": {
+        "tags": [
+          "ScheduleRules"
+        ],
+        "summary": "Возвращает график праздничных дней за указанный год.",
+        "description": "## Пример запроса:\r\n```text\r\nGET /ScheduleRules/holiday?year=2024\r\nAuthorization: Bearer <access-token>\r\n```\r\n            \r\n## Пример успешного ответа (200):\r\n```json\r\n{\r\n  \"RU\": [\r\n    \"2024-01-01T00:00:00Z\",\r\n    \"2024-01-07T00:00:00Z\"\r\n  ]\r\n}\r\n```\r\n            \r\n## Негативные сценарии:\r\n- 401 Unauthorized — отсутствует или некорректен Bearer-токен.\r\n- 403 Forbidden — недостаточно прав.",
+        "parameters": [
+          {
+            "name": "year",
+            "in": "query",
+            "description": "Год, за который требуется получить график праздничных дней.",
+            "schema": {
+              "type": "string"
+            }
+          },
+          {
+            "name": "X-Application-ID",
+            "in": "header",
+            "description": "Идентификатор приложения. EngineerMobile - 1, CustomerMobile - 2, MainWeb - 3, AdminWeb - 4, Api - 5, PlateWeb - 6",
+            "schema": {
+              "enum": [
+                1,
+                2,
+                3,
+                4,
+                5,
+                6
+              ],
+              "type": "integer",
+              "format": "int32",
+              "default": 3,
+              "x-enumNames": [
+                "EngineerMobile",
+                "CustomerMobile",
+                "MainWeb",
+                "AdminWeb",
+                "Api",
+                "PlateWeb"
+              ]
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "График праздников успешно получен.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "array",
+                    "items": {
+                      "type": "string",
+                      "format": "date-time"
+                    }
+                  }
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "array",
+                    "items": {
+                      "type": "string",
+                      "format": "date-time"
+                    }
+                  }
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "array",
+                    "items": {
+                      "type": "string",
+                      "format": "date-time"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Токен отсутствует или некорректен."
+          },
+          "403": {
+            "description": "Недостаточно прав."
+          }
+        },
+        "security": [
+          {
+            "Bearer": [ ]
+          }
+        ]
+      }
+    },
+    "/WorkSchedules": {
+      "get": {
+        "tags": [
+          "WorkSchedules"
+        ],
+        "summary": "Возвращает график рабочего времени на заданный период.",
+        "description": "## Пример запроса:\r\n```text\r\nGET /WorkSchedules?validFrom=2024-06-01&validTill=2024-06-30&scheduleRuleID=10\r\nAuthorization: Bearer <access-token>\r\nRange: Offset=0; Fetch=50\r\n```\r\n            \r\n## Пример успешного ответа (200):\r\n```json\r\n{\r\n  \"10\": [\r\n    {\r\n      \"scheduleRuleID\": 10,\r\n      \"timeFrom\": \"2024-06-15T09:00:00Z\",\r\n      \"timeTill\": \"2024-06-15T18:00:00Z\",\r\n      \"isPublicHoliday\": false,\r\n      \"isNightShift\": false,\r\n      \"dateWork\": \"2024-06-15T00:00:00Z\"\r\n    }\r\n  ]\r\n}\r\n```\r\n            \r\n## Пример успешного ответа (206):\r\nТело ответа имеет тот же формат, что и для `200`, но содержит частичный диапазон.\r\n            \r\n## Пример негативного ответа (400):\r\n```json\r\n{\r\n  \"traceIdentifier\": \"0HN1234567890\",\r\n  \"code\": \"ScheduleRuleNull\",\r\n  \"message\": \"Schedule rule is required\"\r\n}\r\n```\r\n            \r\n## Негативные сценарии:\r\n- 204 No Content — график не найден.\r\n- 400 Bad Request — некорректные query-параметры.\r\n- 401 Unauthorized — отсутствует или некорректен Bearer-токен.\r\n- 403 Forbidden — недостаточно прав.",
+        "parameters": [
+          {
+            "name": "X-Application-ID",
+            "in": "header",
+            "description": "Идентификатор приложения. EngineerMobile - 1, CustomerMobile - 2, MainWeb - 3, AdminWeb - 4, Api - 5, PlateWeb - 6",
+            "schema": {
+              "enum": [
+                1,
+                2,
+                3,
+                4,
+                5,
+                6
+              ],
+              "type": "integer",
+              "format": "int32",
+              "default": 3,
+              "x-enumNames": [
+                "EngineerMobile",
+                "CustomerMobile",
+                "MainWeb",
+                "AdminWeb",
+                "Api",
+                "PlateWeb"
+              ]
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "График успешно получен.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/components/schemas/WorkScheduleDailyItemResult"
+                    }
+                  }
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/components/schemas/WorkScheduleDailyItemResult"
+                    }
+                  }
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/components/schemas/WorkScheduleDailyItemResult"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "206": {
+            "description": "Возвращена часть записей в пределах диапазона.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/components/schemas/WorkScheduleDailyItemResult"
+                    }
+                  }
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/components/schemas/WorkScheduleDailyItemResult"
+                    }
+                  }
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/components/schemas/WorkScheduleDailyItemResult"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "204": {
+            "description": "Записи не найдены."
+          },
+          "400": {
+            "description": "Некорректные параметры запроса.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Токен отсутствует или некорректен.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Недостаточно прав.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "Bearer": [ ]
+          }
+        ]
+      }
+    },
+    "/WorkSchedules/daily": {
+      "get": {
+        "tags": [
+          "WorkSchedules"
+        ],
+        "summary": "Возвращает график рабочего времени на заданный период, разбитый по суткам.",
+        "description": "## Пример запроса:\r\n```text\r\nGET /WorkSchedules/daily?validFrom=2024-06-01&validTill=2024-06-30&scheduleRuleID=10\r\nAuthorization: Bearer <access-token>\r\nRange: Offset=0; Fetch=50\r\n```\r\n            \r\n## Пример успешного ответа (200):\r\n```json\r\n{\r\n  \"10\": [\r\n    {\r\n      \"date\": \"2024-06-15T00:00:00Z\",\r\n      \"isNightShift\": false,\r\n      \"isPublicHoliday\": false,\r\n      \"timeFrom\": \"2024-06-15T09:00:00Z\",\r\n      \"timeTill\": \"2024-06-15T18:00:00Z\"\r\n    }\r\n  ]\r\n}\r\n```\r\n            \r\n## Пример успешного ответа (206):\r\nТело ответа имеет тот же формат, что и для `200`, но содержит частичный диапазон.\r\n            \r\n## Пример негативного ответа (400):\r\n```json\r\n{\r\n  \"traceIdentifier\": \"0HN1234567890\",\r\n  \"code\": \"ValidityPeriodNull\",\r\n  \"message\": \"Validity period is required\"\r\n}\r\n```\r\n            \r\n## Негативные сценарии:\r\n- 204 No Content — график не найден.\r\n- 400 Bad Request — некорректные query-параметры (обязательны validFrom и validTill).\r\n- 401 Unauthorized — отсутствует или некорректен Bearer-токен.\r\n- 403 Forbidden — недостаточно прав.",
+        "parameters": [
+          {
+            "name": "X-Application-ID",
+            "in": "header",
+            "description": "Идентификатор приложения. EngineerMobile - 1, CustomerMobile - 2, MainWeb - 3, AdminWeb - 4, Api - 5, PlateWeb - 6",
+            "schema": {
+              "enum": [
+                1,
+                2,
+                3,
+                4,
+                5,
+                6
+              ],
+              "type": "integer",
+              "format": "int32",
+              "default": 3,
+              "x-enumNames": [
+                "EngineerMobile",
+                "CustomerMobile",
+                "MainWeb",
+                "AdminWeb",
+                "Api",
+                "PlateWeb"
+              ]
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "График по суткам успешно получен.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/components/schemas/WorkScheduleDailyByDayResult"
+                    }
+                  }
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/components/schemas/WorkScheduleDailyByDayResult"
+                    }
+                  }
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/components/schemas/WorkScheduleDailyByDayResult"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "206": {
+            "description": "Возвращена часть записей в пределах диапазона.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/components/schemas/WorkScheduleDailyByDayResult"
+                    }
+                  }
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/components/schemas/WorkScheduleDailyByDayResult"
+                    }
+                  }
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "array",
+                    "items": {
+                      "$ref": "#/components/schemas/WorkScheduleDailyByDayResult"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "204": {
+            "description": "Записи не найдены."
+          },
+          "400": {
+            "description": "Некорректные параметры запроса.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "401": {
+            "description": "Токен отсутствует или некорректен.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          },
+          "403": {
+            "description": "Недостаточно прав.",
+            "content": {
+              "text/plain": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              },
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              },
+              "text/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ProblemDetails"
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "Bearer": [ ]
+          }
+        ]
+      }
+    }
+  },
+  "components": {
+    "schemas": {
+      "ListResult": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "Название правила",
+            "nullable": true,
+            "example": "Стандартный график"
+          },
+          "description": {
+            "type": "string",
+            "description": "Описание правила",
+            "nullable": true,
+            "example": "График работы с 9:00 до 18:00"
+          },
+          "scheduleTypeID": {
+            "type": "integer",
+            "description": "Тип графика",
+            "format": "int32",
+            "nullable": true,
+            "example": 1
+          },
+          "dataFrom": {
+            "type": "string",
+            "description": "Дата старта графика",
+            "format": "date-time",
+            "example": "2024-01-01T00:00:00Z"
+          }
+        },
+        "additionalProperties": false,
+        "description": "Правило графика рабочего времени для списка"
+      },
+      "ProblemDetails": {
+        "type": "object",
+        "properties": {
+          "type": {
+            "type": "string",
+            "nullable": true
+          },
+          "title": {
+            "type": "string",
+            "nullable": true
+          },
+          "status": {
+            "type": "integer",
+            "format": "int32",
+            "nullable": true
+          },
+          "detail": {
+            "type": "string",
+            "nullable": true
+          },
+          "instance": {
+            "type": "string",
+            "nullable": true
+          }
+        },
+        "additionalProperties": { }
+      },
+      "ScheduleCreateDto": {
+        "type": "object",
+        "properties": {
+          "from": {
+            "type": "string",
+            "description": "Дата начала периода",
+            "format": "date-time",
+            "example": "2024-01-01T00:00:00Z"
+          },
+          "till": {
+            "type": "string",
+            "description": "Дата окончания периода",
+            "format": "date-time",
+            "example": "2024-12-31T23:59:59Z"
+          },
+          "considerPublicHolidays": {
+            "type": "boolean",
+            "description": "Учитывать праздничные дни",
+            "example": true
+          },
+          "shortageHoursBeforeHoliday": {
+            "type": "integer",
+            "description": "Сокращение часов перед праздником",
+            "format": "int32",
+            "example": 1
+          },
+          "rules": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ScheduleDtoRule"
+            },
+            "description": "Правила расписания",
+            "nullable": true
+          },
+          "overridings": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ScheduleDto"
+            },
+            "description": "Переопределения расписания",
+            "nullable": true
+          },
+          "name": {
+            "type": "string",
+            "description": "Название",
+            "nullable": true,
+            "example": "Стандартный график"
+          },
+          "description": {
+            "type": "string",
+            "description": "Описание",
+            "nullable": true,
+            "example": "График работы с 9:00 до 18:00"
+          },
+          "isDefault": {
+            "type": "boolean",
+            "description": "Признак графика по умолчанию",
+            "example": false
+          },
+          "scheduleTypeID": {
+            "type": "integer",
+            "description": "Тип графика",
+            "format": "int32",
+            "nullable": true,
+            "example": 1
+          }
+        },
+        "additionalProperties": false,
+        "description": "Данные для создания графика рабочего времени"
+      },
+      "ScheduleDto": {
+        "type": "object",
+        "properties": {
+          "rules": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ScheduleDtoRule"
+            },
+            "nullable": true
+          },
+          "isWorking": {
+            "type": "boolean"
+          },
+          "isPublicHoliday": {
+            "type": "boolean"
+          }
+        },
+        "additionalProperties": false
+      },
+      "ScheduleDtoRule": {
+        "type": "object",
+        "properties": {
+          "cron": {
+            "type": "string",
+            "nullable": true
+          },
+          "occurrenceDuration": {
+            "type": "string",
+            "format": "date-span"
+          },
+          "periodicity": {
+            "$ref": "#/components/schemas/ScheduleDtoRulePeriodicityData"
+          }
+        },
+        "additionalProperties": false
+      },
+      "ScheduleDtoRulePeriodicityData": {
+        "type": "object",
+        "properties": {
+          "repeatCnt": {
+            "type": "integer",
+            "format": "int32"
+          },
+          "skip": {
+            "type": "string",
+            "format": "date-span"
+          }
+        },
+        "additionalProperties": false
+      },
+      "ScheduleExtendDto": {
+        "type": "object",
+        "properties": {
+          "from": {
+            "type": "string",
+            "description": "Дата начала периода",
+            "format": "date-time",
+            "example": "2024-01-01T00:00:00Z"
+          },
+          "till": {
+            "type": "string",
+            "description": "Дата окончания периода",
+            "format": "date-time",
+            "example": "2024-12-31T23:59:59Z"
+          },
+          "considerPublicHolidays": {
+            "type": "boolean",
+            "description": "Учитывать праздничные дни",
+            "example": true
+          },
+          "shortageHoursBeforeHoliday": {
+            "type": "integer",
+            "description": "Сокращение часов перед праздником",
+            "format": "int32",
+            "example": 1
+          },
+          "rules": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ScheduleDtoRule"
+            },
+            "description": "Правила расписания",
+            "nullable": true
+          },
+          "overridings": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ScheduleDto"
+            },
+            "description": "Переопределения расписания",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false,
+        "description": "Данные для расширения или предпросмотра графика рабочего времени"
+      },
+      "SchedulePersistDto": {
+        "type": "object",
+        "properties": {
+          "rules": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ScheduleDtoRule"
+            },
+            "description": "Правила расписания",
+            "nullable": true
+          },
+          "overridings": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ScheduleDto"
+            },
+            "description": "Переопределения расписания",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false,
+        "description": "Сохранённая модель правил графика"
+      },
+      "ScheduleRuleDto": {
+        "type": "object",
+        "properties": {
+          "name": {
+            "type": "string",
+            "description": "Название",
+            "nullable": true,
+            "example": "Стандартный график"
+          },
+          "description": {
+            "type": "string",
+            "description": "Описание",
+            "nullable": true,
+            "example": "График работы с 9:00 до 18:00"
+          },
+          "scheduleTypeID": {
+            "type": "integer",
+            "description": "Тип графика",
+            "format": "int32",
+            "nullable": true,
+            "example": 1
+          },
+          "periods": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ScheduleRuleDtoPeriod"
+            },
+            "description": "Периоды действия правил",
+            "nullable": true
+          }
+        },
+        "additionalProperties": false,
+        "description": "График рабочего времени (ГРВ)"
+      },
+      "ScheduleRuleDtoPeriod": {
+        "type": "object",
+        "properties": {
+          "from": {
+            "type": "string",
+            "description": "Дата начала периода",
+            "format": "date-time",
+            "example": "2024-01-01T00:00:00Z"
+          },
+          "till": {
+            "type": "string",
+            "description": "Дата окончания периода",
+            "format": "date-time",
+            "example": "2024-12-31T23:59:59Z"
+          },
+          "holidayCalendarID": {
+            "type": "integer",
+            "description": "Идентификатор календаря праздников",
+            "format": "int32",
+            "example": 1
+          },
+          "shortageHoursBeforeHoliday": {
+            "type": "integer",
+            "description": "Сокращение часов перед праздником",
+            "format": "int32",
+            "example": 1
+          },
+          "model": {
+            "$ref": "#/components/schemas/SchedulePersistDto"
+          }
+        },
+        "additionalProperties": false,
+        "description": "Период действия правила графика"
+      },
+      "ScheduleUpdateDto": {
+        "type": "object",
+        "properties": {
+          "from": {
+            "type": "string",
+            "description": "Дата начала периода",
+            "format": "date-time",
+            "example": "2024-01-01T00:00:00Z"
+          },
+          "till": {
+            "type": "string",
+            "description": "Дата окончания периода",
+            "format": "date-time",
+            "example": "2024-12-31T23:59:59Z"
+          },
+          "considerPublicHolidays": {
+            "type": "boolean",
+            "description": "Учитывать праздничные дни",
+            "example": true
+          },
+          "shortageHoursBeforeHoliday": {
+            "type": "integer",
+            "description": "Сокращение часов перед праздником",
+            "format": "int32",
+            "example": 1
+          },
+          "rules": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ScheduleDtoRule"
+            },
+            "description": "Правила расписания",
+            "nullable": true
+          },
+          "overridings": {
+            "type": "array",
+            "items": {
+              "$ref": "#/components/schemas/ScheduleDto"
+            },
+            "description": "Переопределения расписания",
+            "nullable": true
+          },
+          "name": {
+            "type": "string",
+            "description": "Название",
+            "nullable": true,
+            "example": "Стандартный график"
+          },
+          "description": {
+            "type": "string",
+            "description": "Описание",
+            "nullable": true,
+            "example": "График работы с 9:00 до 18:00"
+          },
+          "scheduleTypeID": {
+            "type": "integer",
+            "description": "Тип графика",
+            "format": "int32",
+            "nullable": true,
+            "example": 1
+          }
+        },
+        "additionalProperties": false,
+        "description": "Данные для обновления графика рабочего времени"
+      },
+      "WorkScheduleDailyByDayResult": {
+        "type": "object",
+        "properties": {
+          "date": {
+            "type": "string",
+            "description": "Дата",
+            "format": "date-time",
+            "example": "2024-06-15T00:00:00Z"
+          },
+          "isNightShift": {
+            "type": "boolean",
+            "description": "Признак ночной смены",
+            "example": false
+          },
+          "isPublicHoliday": {
+            "type": "boolean",
+            "description": "Признак праздничного дня",
+            "nullable": true,
+            "example": false
+          },
+          "timeFrom": {
+            "type": "string",
+            "description": "Начало работы",
+            "format": "date-time",
+            "nullable": true,
+            "example": "2024-06-15T09:00:00Z"
+          },
+          "timeTill": {
+            "type": "string",
+            "description": "Окончание работы",
+            "format": "date-time",
+            "nullable": true,
+            "example": "2024-06-15T18:00:00Z"
+          }
+        },
+        "additionalProperties": false,
+        "description": "Запись графика по суткам"
+      },
+      "WorkScheduleDailyItemResult": {
+        "type": "object",
+        "properties": {
+          "scheduleRuleID": {
+            "type": "integer",
+            "description": "Идентификатор правила графика рабочего времени",
+            "format": "int32",
+            "example": 10
+          },
+          "timeFrom": {
+            "type": "string",
+            "description": "Начало работы",
+            "format": "date-time",
+            "nullable": true,
+            "example": "2024-06-15T09:00:00Z"
+          },
+          "timeTill": {
+            "type": "string",
+            "description": "Окончание работы",
+            "format": "date-time",
+            "nullable": true,
+            "example": "2024-06-15T18:00:00Z"
+          },
+          "isPublicHoliday": {
+            "type": "boolean",
+            "description": "Признак праздничного дня",
+            "nullable": true,
+            "example": false
+          },
+          "isNightShift": {
+            "type": "boolean",
+            "description": "Признак ночной смены",
+            "example": false
+          },
+          "dateWork": {
+            "type": "string",
+            "description": "Дата работы",
+            "format": "date-time",
+            "example": "2024-06-15T00:00:00Z"
+          }
+        },
+        "additionalProperties": false,
+        "description": "Режим работы"
+      }
+    },
+    "securitySchemes": {
+      "Bearer": {
+        "type": "http",
+        "description": "Введите токен для авторизации",
+        "scheme": "Bearer",
+        "bearerFormat": "JWT"
+      }
+    }
+  },
+  "tags": [
+    {
+      "name": "ScheduleRules",
+      "description": "Контроллер управления графиками рабочего времени"
+    },
+    {
+      "name": "WorkSchedules",
+      "description": "Контроллер управления сгенерированным графиком рабочего времени"
+    },
+    {
+      "name": "ScheduleRules",
+      "description": "Контроллер управления графиками рабочего времени"
+    },
+    {
+      "name": "WorkSchedules",
+      "description": "Контроллер управления сгенерированным графиком рабочего времени"
+    }
+  ]
+}