Направление работ: AdmLk Код раздела: 4.2 Раздел: Отчёты > Заказы Статус: черновик Ответственный: Панкова Л.А. Версия: 0.1 Обновлено: 10.08.26
1. Назначение
Раздел обеспечивает сотруднику сервисной зоны просмотр отчёта по заказам и заявкам.
Сотрудник задаёт верхнеуровневые параметры отчёта, просматривает и фильтрует таблицу, ищет заказы, выгружает данные и настраивает состав колонок. Из строки заказа или заявки сотрудник открывает соответствующую карточку. Карточка заказа содержит данные клиента, состав, скидки, оплату и итоговую стоимость и позволяет перейти к заказу в календаре.
Состав данных заказа определяется в Back: 3.1 «Состав заказа», состояния бронирования — в Back: 3.2 «Процессинг заказов», состояния заявок — в Back: 3.2.2 «Заявки».
2. Ключевые понятия
Отчёт по заказам — экран сервисной зоны с фильтрами, таблицей заказов и заявок и карточкой выбранного заказа или заявки.
Заказ — сущность, которая сопровождает и фиксирует процесс использования клиентом площадки или услуги партнёра.
Заявка — предварительная форма заказа без резервирования времени и финансовых обязательств клиента.
Состояние заказа — отображаемый в отчёте этап жизненного цикла бронирования.
Партнерская зона — контекст партнёра, в рамках которого сотруднику доступны связанные объекты, площадки и заказы.
Опция — параметр заказа, состав и наименование которого зависят от сферы, например вид работ или количество человек.
Верхнеуровневая фильтрация — параметры, которые сотрудник задаёт до загрузки строк отчёта: партнерская зона, объект или площадка, период, сфера и город.
Настройки отображения — панель управления видимостью и порядком колонок таблицы.
3. Scope
Входит
S1: Открытие отчёта и верхнеуровневая фильтрация данных.
S2: Просмотр, поиск и выгрузка таблицы заказов и заявок.
S3: Дополнительная фильтрация таблицы.
S4: Настройка состава и порядка колонок.
S5: Просмотр карточки заказа или заявки и переход к заказу в календаре.
S6: Дополнительные состояния экрана: адаптивы.
Не входит
- AdmLk 4.1 «Главный экран» — просмотр карточек отчётов и переход к отчёту по заказам.
- WebLk 6.2 «Отчеты > Заказы и заявки» — просмотр отчёта по заказам и заявкам в кабинете партнёра.
- WebLk 5.2 «Календарь» — просмотр и работа с заказом в календаре.
- WebLk 5.3.2 «Карточка заказа» — редактирование заказа и выполнение процессинговых действий.
4. BR
Указаны в пункте 4 разделов Back: 9.4.1 «Статистика по заказам», 3.1 «Состав заказа», 3.2 «Процессинг заказов», 3.2.1 «Сборы за заказ», 3.2.2 «Заявки» и 8.2.1 «Сферы и Опции».
5. Функциональные требования (UC + FR)
| ID | Сценарий | Функциональное требование | BR | Вес | Статус |
|---|---|---|---|---|---|
| S1: FR4.2-1 | Сотрудник переходит с главного экрана к отчёту по заказам | Интерфейс открывает экран «Отчет по заказам», показывает действие возврата и область верхнеуровневых фильтров. | 1 | Реализовано | |
| S1: FR4.2-2 | Сотрудник возвращается к списку отчётов | Интерфейс по действию возврата открывает AdmLk 4.1 «Главный экран». | 2 | Реализовано | |
| S1: FR4.2-4 | Сотрудник задаёт верхнеуровневые параметры отчёта | Интерфейс позволяет выбрать одну, несколько или все доступные партнерские зоны, объекты или площадки, сферы и города, а также период отчёта. Для периода доступны действия применения и сброса значения. | 1 | Реализовано | |
| S1: FR4.2-5 | Сотрудник применяет верхнеуровневую фильтрацию | При обычном открытии отчёта для загрузки заказов и заявок сотрудник должен выбрать хотя бы один верхнеуровневый параметр. До выбора параметра интерфейс не показывает строки отчёта. После применения фильтрации интерфейс загружает соответствующие выбранным параметрам заказы и заявки. При переходе из AdmLk 3.8 «Сервисные промокоды» по промокоду интерфейс применяет фильтр «Промокод» к выбранному значению и показывает соответствующие заказы без дополнительного выбора верхнеуровневого параметра. | 1 | Реализовано | |
| S2: FR4.2-6 | Сотрудник просматривает таблицу отчёта | Интерфейс показывает отдельной строкой каждый заказ или заявку, соответствующие выбранным фильтрам, и отображает источник, основные данные, суммы и состояние записи. | 1 | Реализовано | |
| S2: FR4.2-7 | Сотрудник просматривает стандартный вариант таблицы | По умолчанию интерфейс показывает колонки «Источник», «Клиент», «Создание», «Дата заказа», «Объект», «Площадка», «Итого», «Оплата нал.», «Оплата безнал.» и «Состояние». | 1 | Реализовано | |
| S2: FR4.2-8 | Сотрудник просматривает полный набор данных отчёта | Интерфейс позволяет отобразить данные об источнике, клиенте и контактах, датах создания, заказа и оплаты, партнерской зоне, объекте, площадке и сфере, идентификаторе, комментариях, промокодах, позициях, скидках, баллах, сборе, времени, опции и её значении, стоимости, комиссии, оплатах, возвратах, состоянии и инициаторе отмены. В отличие от отчёта WebLk 6.2 «Отчеты > Заказы и заявки» набор данных содержит «Партнерская зона» и «Сфера». | 1 | Частично #[OQ4.2-1] | |
| S2: FR4.2-9 | Сотрудник сопоставляет состояние строки с легендой | Интерфейс показывает под таблицей легенды «Состояния заказов» и «Состояния заявок» и связывает обозначение в строке с соответствующим состоянием. | 2 | Реализовано | |
| S2: FR4.2-10 | Сотрудник ищет клиента в отчёте | Поле «Найти» позволяет искать клиента по ФИО или номеру телефона и обновляет состав показанных строк по найденным совпадениям. | 2 | Реализовано | |
| S2: FR4.2-11 | Сотрудник выгружает отчёт | Действие скачивания открывает меню с вариантами «Скачать в CSV» и «Скачать в XLS» и выгружает отчёт с учётом применённых фильтров в выбранном формате. | 2 | Реализовано | |
| S3: FR4.2-12 | Сотрудник открывает дополнительные фильтры | Интерфейс показывает панель с фильтрами «Тип заказа», «Источник», «Оплата», «Наличие скидки», «Вид работ», «Кол-во человек», «Тип позиции», «Состояние заказа» и «Промокод». | 2 | Реализовано | |
| S3: FR4.2-13 | Сотрудник фильтрует записи по типу, источнику и оплате | Интерфейс позволяет выбрать «Бронирования» или «Заявки», один или несколько источников и состояние оплаты «Не оплачено», «Частично» или «Полностью». | 2 | Реализовано | |
| S3: FR4.2-14 | Сотрудник фильтрует записи по параметрам заказа | Интерфейс позволяет отобрать записи по опции и её значению, доступным для выбранной сферы, например по виду работ или количеству человек, а также по типу позиции, наличию скидки и промокоду. Для промокода интерфейс показывает совпадающие варианты по введённому значению. | 2 | Реализовано | |
| S3: FR4.2-15 | Сотрудник фильтрует записи по состоянию | Интерфейс группирует доступные значения на «Состояние заказа» и «Состояние заявки» и позволяет выбрать одно, несколько или все состояния. Для заявок доступны состояния «Новая», «Не обработана», «В работе», «Подтверждена» и «Отклонена». | 2 | Реализовано | |
| S3: FR4.2-16 | Сотрудник применяет дополнительные фильтры | Интерфейс обновляет таблицу и показывает только записи, соответствующие одновременно верхнеуровневым и дополнительным фильтрам. | 2 | Реализовано | |
| S4: FR4.2-17 | Сотрудник открывает настройки таблицы | Действие дополнительных настроек открывает панель «Настройки отображения» со списками открытых и скрытых колонок. | 2 | Реализовано | |
| S4: FR4.2-18 | Сотрудник изменяет видимость колонок | Интерфейс позволяет скрыть или показать отдельную колонку, применить действия «Скрыть все» и «Показать все», а также вернуть вариант «По умолчанию». | 2 | Реализовано | |
| S4: FR4.2-19 | Сотрудник изменяет порядок колонок | Интерфейс позволяет перетащить колонку на другую позицию и обновляет порядок колонок таблицы. | 2 | Реализовано | |
| S5: FR4.2-20 | Сотрудник выбирает строку заказа или заявки | После клика по строке заказа интерфейс открывает панель «О заказе», а после клика по строке заявки — выбранную заявку. Таблица отчёта при этом остаётся открытой. | 1 | Реализовано | |
| S5: FR4.2-21 | Сотрудник просматривает основные данные заказа | Панель показывает клиента и его контакты, состояние, дату и время заказа, ID заказа, дату создания, объект, площадку, а также опцию и её значение, зависящие от сферы заказа, например вид работ или количество человек. | 1 | Реализовано | |
| S5: FR4.2-22 | Сотрудник просматривает состав и стоимость заказа | Панель показывает оборудование и услуги, комментарий администратора, применённые скидки и промокод, списанные баллы, сумму заказа, учтённый сбор, оплаченную сумму, итог к оплате и срок бесплатной отмены при наличии соответствующих данных. | 1 | Реализовано | |
| S5: FR4.2-23 | Сотрудник копирует идентификатор заказа | Действие копирования рядом с ID помещает идентификатор заказа в буфер обмена. | 2 | Реализовано | |
| S5: FR4.2-24 | Сотрудник просматривает учёт сбора | Интерфейс показывает параметр «Учитывать сбор» во включённом или выключенном состоянии в соответствии с данными заказа. Переключатель недоступен для изменения. | 2 | Реализовано | |
| S5: FR4.2-25 | Сотрудник открывает заказ в календаре | Действие «Показать заказ в календаре» открывает выбранный заказ в разделе WebLk 5.2 «Календарь» в новой вкладке браузера. | 2 | Частично #[OQ4.2-2] | |
| S6: FR4.2-26 | Сотрудник использует отчёт на поддерживаемом устройстве | Интерфейс адаптирует страницу отчёта по заказам, таблицу, фильтры, панель настроек и карточку заказа для desktop, laptop и tablet. | 2 | Частично #[OQ4.2-3] |
6. Открытые вопросы
Контекст сверки. BRD версия 0.1 (обновлено 10.08.26). Репозиторий:
musbooking.weblk.adminpanel, commit3a107bd(origin/main, 2026-09-06); для проверки диплинка в календарь дополнительно просмотренmusbooking_personal_account, commitcdfa1dad(origin/main, 2026-09-07). Дата сверки: 2026-09-08. Якорь в коде:pages/reports/orders.vue,widgets/report-orders/**,entities/orders-report/**,features/orders-report-*/**,features/order-details-*/**(FSD-слайсы, Nuxt 3 + Vue, Vuetify); дополнительно учтёнdocs/technical debt/Отчеты по заказам.md— известные пробелы бэк-контрактаOrdersService.GetOrdersAndRequestsService. Первая полная сверка — колонка «Статус» была пустой. Гайдбук не передавался — маршрутизация вопросов без сверки с гайдбуком.
| ID | Источник | Вопрос | Кому | Статус | Рекомендации | Итоговое решение |
|---|---|---|---|---|---|---|
| OQ4.2-1 | FR4.2-8 | Требование говорит: полный набор данных отчёта должен включать инициатора отмены заказа. В коде: колонка «Отменено кем» есть в каталоге (features/orders-report-table/model/ordersReportColumns.ts:107), но её значение всегда равно «—» — getOrdersReportCancelledBy() в entities/orders-report/lib/orders-report.getters.ts:71-74 жёстко возвращает заглушку с комментарием «в API есть только uuid updatedBy, имя не подставляем». Это совпадает с пунктом 6 docs/technical debt/Отчеты по заказам.md («Поле «Кем отменён»: в строке отчёта вместо (или вместе с) updatedBy uuid вернуть имя отменившего пользователя»). | Разработка | Open | Реализовать на бэкенде §6 техдолга (вернуть имя/cancelledByName из GetOrdersAndRequestsService) и убрать заглушку на фронте. | |
| OQ4.2-2 | FR4.2-25 | Требование говорит: действие «Показать заказ в календаре» должно открывать именно выбранный заказ в разделе WebLk 5.2 «Календарь». В коде: диплинк формируется с параметрами orderId, partnerZoneId, roomId, baseId, date и открывается в новой вкладке (features/order-details-drawer/lib/weblkCalendarDeeplink.ts:1-37, model/useOrderDetailsDrawer.ts:220-242, window.open(..., '_blank', ...)), но комментарий в коде прямо указывает: «Календарь эти параметры пока не читает». Проверка страницы musbooking_personal_account/pages/orders/calendar.vue подтверждает: она не читает route.query вовсе — открывается общий календарь без перехода к конкретному заказу. | Разработка | Open | Реализовать на странице календаря WebLk чтение query-параметров диплинка (orderId/baseId/roomId/date) и автоматическое открытие/подсветку заказа. | |
| OQ4.2-3 | FR4.2-26 | Требование говорит: страница отчёта, таблица, фильтры, панель настроек колонок и карточка заказа должны адаптироваться под desktop, laptop и tablet. В коде: @media-запрос найден только в панели дополнительных фильтров (features/orders-report-advanced-filters/ui/OrdersReportAdvancedFilters.vue:352-357, брейкпоинт 960px); в верхних фильтрах, таблице (кроме встроенного горизонтального скролла — features/orders-report-table/ui/OrdersReportTable.vue:290-299) и в карточке заказа (OrderDetailsDrawer.vue:3 — фиксированная ширина 400px без адаптивных стилей) отдельных @media-правил не найдено. | Разработка | Open | Проверить раздел вручную на типичных tablet-ширинах (≈768–1024px) и доработать адаптивные стили карточки заказа и панели настроек при необходимости. |