Направление работ: AdmLk Код раздела: 3.8 Раздел: Управление > Сервисные промокоды Статус: черновик Ответственный: Панкова Л.А. Версия: 0.2 Обновлено: 04.08.26
1. Назначение
Данный раздел обеспечивает сотруднику сервисного кабинета интерфейс для просмотра, создания и удаления сервисных промокодов.
Сотрудник просматривает промокоды в таблице, ищет и фильтрует записи, управляет отображением столбцов и архива, а также настраивает область действия, скидку, условия активации, персонализацию и лимиты нового промокода.
Раздел зависит от Back: 8.4.1 Администрирование > Параметры системы > Сервисные промокоды. Также раздел зависит от Back: 2.7.1 Объекты и предложения > Скидки > Акции и промокоды.
2. Ключевые понятия
Сервисный промокод — промокод, который сотрудник сервисного кабинета настраивает для одной, нескольких или всех партнерских зон.
Промокод — ручная скидка, применяемая по уникальному коду при создании заказа.
Условия активации — настраиваемые в форме параметры заказа, при которых действует сервисный промокод: дни недели, время действия, время до начала, порядок действия и минимальная длительность заказа.
Персонализация — ограничение доступности сервисного промокода выбранными клиентами или группами клиентов.
Архив сервисных промокодов — записи, отображение которых сотрудник включает или выключает отдельным действием на странице.
3. Scope
Входит
S1: Страница сервисных промокодов.
S2: Создание сервисного промокода.
S3: Состояние загрузки и адаптивы.
S4: Удаление сервисного промокода.
Не входит
- Back: 2.7.1 Объекты и предложения > Скидки > Акции и промокоды — правила создания и применения промокодов в рамках одной партнерской зоны.
- WebLk: 4.6 Контент > Скидки и акции — управление скидками и акциями партнером.
- Widget: 5.2 Дополнения к заказу и подтверждение > Скидки, комментарий и правила — выбор и применение промокода клиентом при оформлении заказа.
4. BR
Связанные BR относятся к разделам Back: 8.4.1 Администрирование > Параметры системы > Сервисные промокоды и Back: 2.7.1 Объекты и предложения > Скидки > Акции и промокоды.
5. Функциональные требования (UC + FR)
| ID | Сценарий | Функциональное требование | BR | Вес | Статус |
|---|---|---|---|---|---|
| S1: FR3.8-1 | Сотрудник открывает раздел «Сервисные промокоды» | Интерфейс открывает страницу «Промокоды» и показывает: - поле «Найти»; - фильтр «Скидка на»; - действие «Скрыть архив» или «Показать архив»; - кнопку создания промокода; - кнопку с тремя точками для открытия «Настроек отображения»; - таблицу сервисных промокодов. Если столбцы не помещаются в доступную ширину экрана, интерфейс позволяет прокручивать таблицу по горизонтали. | 1 | Реализовано | |
| S1: FR3.8-2 | Сотрудник ищет сервисный промокод | Интерфейс фильтрует список по введенному в поле «Найти» названию (коду) промокода или описанию. | 2 | Реализовано | |
| S1: FR3.8-3 | Сотрудник фильтрует сервисные промокоды по виду скидки | Интерфейс позволяет выбрать в фильтре «Скидка на» одно из значений: - «Все»; - «На заказ»; - «На время»; - «На позиции». Интерфейс показывает записи, соответствующие выбранному виду скидки; значение «Все» снимает ограничение. | 2 | Реализовано | |
| S1: FR3.8-4 | Сотрудник просматривает список сервисных промокодов | Интерфейс показывает в таблице столбцы: - «Промокод»; - «Описание»; - «Действует на»; - «Период действия»; - «Сферы»; - «Города»; - «Источники»; - «Скидка на»; - «Время действия»; - «Время до начала»; - «Порядок действия»; - «Длительность от»; - «Персонализация»; - «Общее кол-во исп.»; - «Кол-во исп. на клиента»; - «Статус». При нажатии на промокод в таблице интерфейс открывает в новой вкладке AdmLk 4.2 «Отчёт по заказам» с фильтрацией по выбранному промокоду. | 1 | Реализовано | |
| S1: FR3.8-5 | Сотрудник управляет архивом сервисных промокодов | Интерфейс позволяет показать или скрыть архивные сервисные промокоды отдельным действием над списком. При попытке отключить активный сервисный промокод интерфейс открывает окно подтверждения «Вы действительно хотите отключить сервисный промокод?» с действиями «Отмена» и «Отключить». Действие «Отмена» закрывает окно без изменений. Действие «Отключить» подтверждает отключение сервисного промокода. | 2 | Реализовано | |
| S1: FR3.8-6 | Сотрудник открывает настройки отображения таблицы | Интерфейс открывает панель «Настройки отображения» со списками «Открыто» и «Скрыто», которые вместе содержат полный перечень доступных столбцов таблицы, и действием «По умолчанию». | 3 | Реализовано | |
| S1: FR3.8-7 | Сотрудник настраивает отображение столбцов таблицы | Интерфейс позволяет: - скрыть или показать отдельный столбец; - скрыть все открытые столбцы действием «Скрыть все»; - показать все скрытые столбцы действием «Показать все»; - изменить порядок столбцов перетаскиванием; - показать все столбцы в порядке «По умолчанию» одноименным действием. | 3 | Реализовано | |
| S1: FR3.8-8 | Сотрудник начинает создание сервисного промокода | Интерфейс по действию добавления открывает боковую панель «Создание промокода». | 1 | Реализовано | |
| S2: FR3.8-9 | Сотрудник просматривает форму создания сервисного промокода | Интерфейс показывает основные настройки: - «Код промокода»; - «Промокод действует на» для выбора партнерских зон; - «Период действия». Ниже интерфейс показывает разделы: - «Установить ограничения»; - «Установить скидку»; - «Условия активации»; - «Дополнительно»; - «Персонализация»; - «Количество использований». В нижней части формы доступны действия «Отменить» и «Сохранить». | 1 | Реализовано | |
| S2: FR3.8-10 | Сотрудник вводит код промокода | Интерфейс позволяет ввести значение в поле «Код промокода» или заполнить его действием «Сгенерировать». | 1 | Реализовано | |
| S2: FR3.8-11 | Сотрудник выбирает партнерские зоны | Поле «Промокод действует на» поддерживает поиск партнерской зоны по введенному значению и открывает готовый выпадающий список партнерских зон. Интерфейс позволяет выбрать одну, несколько или все партнерские зоны и отменить выбор. | 2 | Реализовано | |
| S2: FR3.8-12 | Сотрудник выбирает период действия промокода | Интерфейс раскрывает календарь и позволяет выбрать одну дату или период. Сотрудник может выбрать месяц и год из списков или переключать месяцы стрелками назад и вперед. Действие «Применить» переносит выбранную дату или период в форму создания промокода. Действие «Сбросить» отменяет текущий выбор в календаре и возвращает предыдущее значение периода в форме. | 2 | Реализовано | |
| S2: FR3.8-13 | Сотрудник ограничивает действие промокода по сферам | Интерфейс позволяет выбрать одну, несколько или все сферы и показывает выбранные значения в форме. Действие «?» рядом с заголовком «Установить ограничения» открывает подсказку по ограничениям. | 2 | Реализовано | |
| S2: FR3.8-14 | Сотрудник ограничивает действие промокода по городам | Интерфейс позволяет выбрать один, несколько или все города и показывает выбранные значения в форме. | 2 | Реализовано | |
| S2: FR3.8-15 | Сотрудник ограничивает действие промокода по интерфейсам создания заказа | Интерфейс позволяет выбрать один, несколько или все интерфейсы создания заказа: - «Мобильное приложение»; - «Каталог»; - «Виджет»; - «Внешние календари»; - «Telegram bot». | 2 | Частично #[OQ3.8-1] | |
| S2: FR3.8-16 | Сотрудник выбирает скидку на заказ | Интерфейс позволяет выбрать «На заказ» и числовое значение скидки в процентах с шагом 5%. Минимальное значение скидки — 5%. При выбранной скидке на заказ элементы «На время» и «На позиции» недоступны. Действие «?» рядом с заголовком «Установить скидку» открывает подсказку по настройке скидки. | 1 | Частично #[OQ3.8-2] | |
| S2: FR3.8-17 | Сотрудник выбирает скидку на время или позиции | Интерфейс позволяет выбрать «На время» и «На позиции» по отдельности или совместно и выбрать значение для каждого выбранного вида скидки. При выборе скидки на время или позиции элемент «На заказ» недоступен. | 1 | Реализовано | |
| S2: FR3.8-18 | Сотрудник настраивает условия активации промокода | Интерфейс позволяет настроить: - один, несколько или все дни недели с понедельника по воскресенье; - время действия; - время до начала заказа; - порядок действия; - минимальную длительность заказа. Действие «?» рядом с заголовком «Условия активации» открывает подсказку по условиям активации. | 2 | Реализовано | |
| S2: FR3.8-19 | Сотрудник выбирает время действия промокода | Интерфейс позволяет выбрать время начала и окончания интервала действия и добавить один или несколько интервалов. | 2 | Реализовано | |
| S2: FR3.8-20 | Сотрудник выбирает время до начала заказа | Интерфейс позволяет выбрать значение ограничения «Время до начала заказа» с шагом один час. | 2 | Реализовано | |
| S2: FR3.8-21 | Сотрудник выбирает порядок действия промокода | Интерфейс позволяет выбрать для «Порядка действия» значение «Заранее», «День в день» или «Всегда». | 2 | Реализовано | |
| S2: FR3.8-22 | Сотрудник выбирает минимальную длительность заказа | Интерфейс позволяет выбрать значение ограничения «Длительность заказа от» с шагом один час. | 2 | Реализовано | |
| S2: FR3.8-23 | Сотрудник добавляет описание | Интерфейс позволяет раскрыть поле действием «Добавить описание» и ввести описание сервисного промокода. | 3 | Реализовано | |
| S2: FR3.8-24 | Сотрудник персонализирует промокод | Интерфейс позволяет найти клиента по имени, телефону или email, выбрать одного, нескольких или всех клиентов и показывает выбранных клиентов и группы в форме. | 2 | Реализовано | |
| S2: FR3.8-25 | Сотрудник ограничивает количество использований | Интерфейс позволяет выбрать «Общее кол-во использований» и «Кол-во использований на клиента» или оставить общее количество без ограничения. | 2 | Реализовано | |
| S2: FR3.8-26 | Сотрудник сохраняет новый сервисный промокод | Пока обязательные поля «Код промокода» и значение скидки не заполнены, действие «Сохранить» неактивно, а интерфейс показывает подсказку «Установите код промокода и размер скидки для сохранения». После заполнения обязательных полей действие «Сохранить» становится доступным. | 1 | Реализовано | |
| S2: FR3.8-27 | Сотрудник отменяет создание сервисного промокода | Интерфейс позволяет закрыть панель или выбрать «Отменить» без сохранения нового сервисного промокода. | 2 | Реализовано | |
| S2: FR3.8-28 | Сотрудник настраивает дополнительные ограничения (на будущую реализацию) | Интерфейс позволяет добавить ограничения «На группы клиентов» и «На сумму» при создании сервисного промокода. | 3 | Не реализовано | |
| S2: FR3.8-29 | Сотрудник ограничивает количество заказов в партнерской зоне (на будущую реализацию) | Интерфейс позволяет выбрать «Кол-во заказов на одной парт. зоне» для сервисного промокода. | 3 | Не реализовано | |
| S2: FR3.8-30 | Сотрудник сбрасывает выбранную настройку | Интерфейс показывает действие удаления в виде крестика у каждого заполненного пункта настройки. Нажатие на крестик сбрасывает значение соответствующего пункта, не изменяя остальные настройки формы. | 2 | Реализовано | |
| S3: FR3.8-31 | Сотрудник открывает страницу, данные загружаются | Интерфейс показывает состояние загрузки для поля поиска, фильтра, действий и строк таблицы до получения данных сервисных промокодов. | 2 | Реализовано | |
| S3: FR3.8-32 | Сотрудник использует раздел на разных ширинах экрана | Интерфейс адаптирует страницу сервисных промокодов, связанные блоки, фильтры, действия и таблицу для desktop, laptop и tablet без потери доступных функций. | 2 | Частично #[OQ3.8-3] | |
| S4: FR3.8-33 | Сотрудник включает режим удаления сервисных промокодов | Интерфейс отмечает действие удаления как активное и показывает действие удаления в каждой строке таблицы. | 1 | Реализовано | |
| S4: FR3.8-34 | Сотрудник выбирает сервисный промокод для удаления | Интерфейс по действию удаления в строке открывает окно подтверждения с текстом «Удалить промокод „[код промокода]“?» и действиями «Отмена» и «Удалить». | 2 | Реализовано | |
| S4: FR3.8-35 | Сотрудник отменяет удаление сервисного промокода | Интерфейс по действию «Отмена» закрывает окно подтверждения без удаления сервисного промокода. | 2 | Реализовано | |
| S4: FR3.8-36 | Сотрудник подтверждает удаление сервисного промокода | Интерфейс по действию «Удалить» удаляет выбранный сервисный промокод, закрывает окно подтверждения и обновляет список. | 1 | Реализовано |
6. Открытые вопросы
Контекст сверки. BRD версия 0.2 (обновлено 04.08.26). Репозиторий:
musbooking.weblk.adminpanel, commit3a107bd(origin/main, 2026-09-06). Дата сверки: 2026-09-08. Якорь в коде:pages/management/promocodes.vue,widgets/promo-codes/**,entities/promo-code/**,features/promo-code-*/**(FSD-слайсы, Nuxt 3 + Vue, Vuetify). Первая полная сверка — колонка «Статус» была пустой. Гайдбук не передавался — маршрутизация вопросов без сверки с гайдбуком.
| ID | Источник | Вопрос | Кому | Статус | Рекомендации | Итоговое решение |
|---|---|---|---|---|---|---|
| OQ3.8-1 | FR3.8-15 | Требование говорит: фильтр/ограничение «Промокод действует на интерфейсы создания заказа» должен содержать ровно пять значений — «Мобильное приложение», «Каталог», «Виджет», «Внешние календари», «Telegram bot». В коде: список источников подгружается динамически из справочника OrderSourcesService.fetchList() (entities/order-source/store/order-sources.api.ts:19-21, features/promo-code-drawer/model/usePromoCodeDrawer.options.ts:110-118) без каких-либо захардкоженных значений — фактический состав зависит от данных справочника на бэкенде/в БД, который с фронта не проверить. | Бизнес | Open | Сверить содержимое справочника источников заказов (GetOrderSources) в проде/на стенде с перечнем из FR3.8-15; при расхождении — актуализировать справочник или формулировку требования. | |
| OQ3.8-2 | FR3.8-16 | Требование говорит: скидка «На заказ» задаётся только в процентах, с шагом 5% и минимумом 5%. В коде: для режима «На заказ» доступен тот же компонент выбора единицы измерения %/₽, что и для «На время»/«На позиции» (features/promo-code-discount/ui/PromoCodeDiscountSection.vue:64-85, shared/ui/discount-value-input/DiscountValueInput.vue:22-33,63-66 — шаг/минимум применяются только при выбранной единице percent), то есть скидку «На заказ» можно также указать в рублях. | Разработка | Open | Убрать выбор единицы «₽» для режима «На заказ» либо, если возможность задавать скидку на заказ в рублях — осознанное решение продукта, обновить формулировку FR3.8-16. | |
| OQ3.8-3 | FR3.8-32 | Требование говорит: страница сервисных промокодов, фильтры, действия и таблица должны адаптироваться под desktop, laptop и tablet без потери функций. В коде: ни в features/promo-code-list/ui/PromoCodesList.vue, ни в widgets/promo-codes/ui/PromoCodesWidget.vue, ни в features/promo-code-drawer/ui/PromoCodeDrawer.vue нет ни одного @media-запроса; ключевые элементы имеют фиксированную ширину (поле поиска 360px и фильтр «Скидка на» 240px — PromoCodesList.vue:706-717; drawer формы 460px — PromoCodeDrawer.vue:6). Отдельного файла техдолга по разделу промокодов в docs/technical debt/ нет. | Разработка | Open | Проверить раздел вручную на планшетных ширинах (≈768–1024px) и добавить адаптивные стили для фильтров и формы при необходимости. |