Направление работ: AdmLk Код раздела: 2.3.5 Раздел: Настройки > Сервисные параметры > Системные параметры Статус: черновик Ответственный: Панкова Л.А. Версия: 0.3 Обновлено: 05.08.26
1. Назначение
Данный раздел обеспечивает сотруднику сервисного кабинета интерфейс для просмотра и добавления системных параметров в подразделе «Сервисные» раздела «Параметры».
Сотрудник просматривает параметры и их значения в таблице, управляет отображением архива и добавляет новый параметр с описанием, значениями, источниками и статусом.
Раздел зависит от Back: 8.4 Администрирование > Параметры системы.
2. Ключевые понятия
Системный параметр — параметр системы, значение и область применения которого сотрудник настраивает в сервисном кабинете.
Источник — интерфейс или канал системы, для которого применяется системный параметр.
Архивный системный параметр — параметр со статусом «Архив», который визуально отличается от действующих параметров и может быть показан или скрыт в таблице.
3. Scope
Входит
S1: Просмотр страницы.
S2: Добавление параметра.
S3: Дополнительные состояния экрана: адаптив и загрузка.
Не входит
- Настройка данных других подразделов раздела AdmLk: 2.3 Настройки > Сервисные параметры — описывается в соответствующих соседних Front BRD.
4. BR
Указаны в пункте 4 раздела Back: 8.4 Администрирование > Параметры системы.
5. Функциональные требования (UC + FR)
| ID | Сценарий | Функциональное требование | BR | Вес | Статус |
|---|---|---|---|---|---|
| S1: FR2.3.5-1 | Сотрудник в разделе AdmLk: 2.3 «Параметры» открывает подраздел системных параметров | Интерфейс открывает страницу «Сервисные» и показывает действие возврата в раздел AdmLk: 2.3 «Параметры». | 1 | Реализовано | |
| S1: FR2.3.5-2 | Сотрудник просматривает страницу «Сервисные» | Интерфейс показывает действие управления отображением архива, действие добавления параметра и таблицу системных параметров. | 1 | Реализовано | |
| S1: FR2.3.5-3 | Сотрудник просматривает список системных параметров | Интерфейс показывает в таблице столбцы: - «Параметр»; - «Описание»; - «Дата»; - «Число»; - «Код» с признаком наличия или отсутствия значения; - «Источники» с обозначением выбранных источников иконками; - «Статус» с обозначением действующего или архивного параметра иконкой. | 1 | Реализовано | |
| S1: FR2.3.5-4 | Сотрудник управляет отображением архивных системных параметров | Интерфейс позволяет отдельным действием показать или скрыть архивные системные параметры в таблице. | 2 | Частично #[OQ2.3.5-3] | |
| S1: FR2.3.5-5 | Сотрудник просматривает архивные системные параметры | Строки архивных системных параметров визуально отличаются от строк действующих параметров. | 2 | Частично #[OQ2.3.5-3] | |
| S2: FR2.3.5-6 | Сотрудник начинает добавление системного параметра | Интерфейс по действию добавления открывает поверх таблицы панель «Добавление параметра». | 1 | Реализовано | |
| S2: FR2.3.5-7 | Сотрудник просматривает панель добавления параметра | Интерфейс показывает: - поле «Параметр»; - поле «Описание»; - поле «Дата»; - поле «Число»; - поле «Ссылка»; - поле «Код»; - поле «Источники»; - переключатель «Архив»; - действие «Сохранить»; - действие закрытия панели. | 1 | Реализовано | |
| S2: FR2.3.5-8 | Сотрудник выбирает параметр | Интерфейс позволяет раскрыть поле «Параметр» и выбрать значение из выпадающего списка. | 1 | Частично #[OQ2.3.5-2] | |
| S2: FR2.3.5-9 | Сотрудник добавляет описание параметра | Интерфейс позволяет ввести текст в поле «Описание». | 1 | Реализовано | |
| S2: FR2.3.5-10 | Сотрудник указывает дату | Интерфейс позволяет открыть календарь и выбрать значение для поля «Дата». | 2 | Реализовано | |
| S2: FR2.3.5-11 | Сотрудник указывает числовое значение | Интерфейс позволяет ввести числовое значение в поле «Число». | 2 | Реализовано | |
| S2: FR2.3.5-12 | Сотрудник указывает внешний источник | Интерфейс позволяет ввести в поле «Ссылка» адрес для перенаправления на внешний источник. | 2 | Реализовано | |
| S2: FR2.3.5-13 | Сотрудник добавляет код | Интерфейс позволяет ввести значение в многострочное поле «Код». При вводе большого значения поле сначала увеличивается по высоте. Если после достижения максимальной высоты содержимое не помещается в поле, интерфейс включает режим прокрутки. | 2 | Реализовано | |
| S2: FR2.3.5-14 | Сотрудник выбирает источники | Интерфейс позволяет выбрать в поле «Источники» один или несколько источников и показывает выбранные значения в поле. | 2 | Реализовано | |
| S2: FR2.3.5-15 | Сотрудник выбирает статус параметра | Интерфейс позволяет переключателем «Архив» выбрать действующий или архивный статус системного параметра. При переводе переключателя «Архив» в активное состояние интерфейс открывает окно подтверждения «Вы действительно хотите отключить системный параметр?» с действиями «Отмена» и «Отключить». Действие «Отмена» закрывает окно без изменения статуса. Действие «Отключить» подтверждает выбор архивного статуса. | 2 | Реализовано | |
| S2: FR2.3.5-16 | Сотрудник заполняет обязательные поля | Поля «Параметр» и «Описание» обязательны. Пока оба поля не заполнены, действие «Сохранить» неактивно. После заполнения обоих полей действие «Сохранить» становится доступным. Поля «Дата», «Число», «Ссылка», «Код» и «Источники» могут оставаться незаполненными. | 1 | Реализовано | |
| S2: FR2.3.5-17 | Сотрудник сохраняет новый системный параметр | Интерфейс по действию «Сохранить» сохраняет системный параметр, закрывает панель добавления и показывает созданный параметр в таблице. | 1 | Частично #[OQ2.3.5-3] | |
| S2: FR2.3.5-18 | Сотрудник закрывает панель добавления | Интерфейс позволяет закрыть панель без добавления нового системного параметра. | 2 | Реализовано | |
| S3: FR2.3.5-19 | Сотрудник открывает страницу, данные загружаются | Интерфейс показывает состояние загрузки со скелетонами действия и ячеек таблицы до получения данных системных параметров. | 2 | Реализовано | |
| S3: FR2.3.5-20 | Сотрудник использует раздел на разных ширинах экрана | Интерфейс адаптирует страницу системных параметров, панель добавления, связанные блоки и таблицу для desktop, laptop и tablet без потери доступных функций. | 2 | Реализовано |
6. Открытые вопросы
Контекст сверки. BRD версия 0.3 (обновлено 05.08.26). Репозиторий:
musbooking.weblk.adminpanel, commit3a107bd(origin/main, 2026-09-06). Дата сверки: 2026-09-08. Якорь в коде:pages/settings/parameters/service.vue,widgets/system-parameters/**,features/system-parameter-list/**,features/system-parameter-drawer/**,entities/system-parameter/**,shared/api/SystemParametersService.ts. Для подтверждения бэкенд-ручек проверялсяbooking-monorepo, commit82359296(origin/main, 2026-09-07), и техдолг-документdocs/technical debt/Сервисные параметры.mdв репозитории AdmLk. Первая сверка — колонка «Статус» была пустой у всех 20 требований. Гайдбук не передавался — маршрутизация вопросов без сверки с гайдбуком.
| ID | Источник | Вопрос | Кому | Статус | Рекомендации | Итоговое решение |
|---|---|---|---|---|---|---|
| OQ2.3.5-1 | ||||||
| OQ2.3.5-2 | FR2.3.5-8 | Требование говорит: сотрудник раскрывает поле «Параметр» и выбирает значение из выпадающего списка (обязательное поле, без него действие «Сохранить» недоступно — FR2.3.5-16). В коде: список типов параметра загружается через GetSystemParameterTypesService (entities/system-parameter/model/useSystemParameterQueries.ts:19-27, shared/api/SystemParametersService.ts:38-46); этого RPC-метода нет в бэкенде — по всему booking-monorepo (commit 82359296) поиск SystemParameter не находит ни одного файла или обработчика. Сам сервис-класс на фронте прямо помечен комментарием «методов в swagger пока нет; вызовы будут падать до готовности бэка» (shared/api/SystemParametersService.ts:1-2), это же зафиксировано в docs/technical debt/Сервисные параметры.md:1-6,19. Пока метод не реализован на бэке, поле «Параметр» останется пустым и сотрудник не сможет создать ни одного системного параметра. | Разработка | Open | Реализовать GetSystemParameterTypesService в бэкенде (сервис уточнить — см. техдолг, временно указан PartnerZonesService) до релиза раздела; без него ключевой сценарий S2 не работает целиком. | |
| OQ2.3.5-3 | FR2.3.5-4, FR2.3.5-5, FR2.3.5-17 | Требование говорит: сотрудник видит в таблице действующие и архивные системные параметры, может скрыть/показать архив (FR2.3.5-4, FR2.3.5-5), а по действию «Сохранить» — создать параметр и увидеть его в таблице (FR2.3.5-17). В коде: список параметров вызывает GetSystemParametersService, создание — CreateSystemParameterService, обновление/архивация — UpdateSystemParameterService (shared/api/SystemParametersService.ts:25-76); все три метода отсутствуют в booking-monorepo (commit 82359296 — 0 совпадений по SystemParameter во всём src) и перечислены как незакрытый техдолг в docs/technical debt/Сервисные параметры.md:14-19,251-257. UI-логика показа архива (features/system-parameter-list/model/useSystemParameterList.ts:42,105-109), визуального отличия архивных строк (useSystemParameterList.ts:111-113, shared/ui/data-table/DataTable.vue:247-252) и сохранения (features/system-parameter-drawer/model/useSystemParameterDrawer.ts:166-201) реализована полностью и корректно, но до появления этих трёх методов на бэке таблица никогда не получит реальные данные, а «Сохранить» не сможет ничего создать. | Разработка | Open | Реализовать GetSystemParametersService, CreateSystemParameterService, UpdateSystemParameterService в бэкенде по контракту из техдолга (docs/technical debt/Сервисные параметры.md) — раздел на фронте полностью готов и ждёт эти три ручки. |