Перейти к содержанию

Чеклист скриншотов для релизной документации

Рабочий список перед публикацией. Готовые пункты ссылаются на файлы в docs/img/.

Диспетчер

  • [x] Отчёт «Активные заявки» с колонками «Обновлена», «Последний комментарий» и «Комментарий паузы» (wn-report-active-wo.png).
  • [x] Вкладка «Премирование» с KPI, ступенью и суммой премии (evaluation1.png).
  • [x] Детальная карточка премии с объяснением расчёта (evaluation2.png).
  • [x] Вкладка «Сотрудники» в разделе «Оценка» (evaluation3.png).
  • [x] Раздел «Карта» — общий вид, план этажа (maps1.png).
  • [x] Карта — план из карточки заявки, кнопка «На плане» (maps2.png).
  • [x] Создание заявки — режим «Помещение» на плане (maps3.png).
  • [x] Создание заявки — режим «Точка» (пин) на плане (maps4.png).
  • [x] Карта — вкладка «Оборудование», маркеры на плане (maps5.png).
  • [x] Карта — навигатор этажей и сводка по объекту (maps6.png).
  • [x] Верхняя панель с колокольчиком центра уведомлений и счётчиком (wnd1.png).
  • [x] Превью центра уведомлений (wnd2.png).
  • [x] Полная страница центра уведомлений с фильтрами (wnd3.png).
  • [x] Форма создания заявки с выбором регламента (wnd11.png, makerequest1.png).
  • [x] Модальный справочник регламентов (wnd8.png, request10.png).
  • [x] Карточка заявки с блоком «Срок выполнения» (wnd9.png, request11.png).
  • [x] Заявка на контроль с ручным сроком (wnd4.png, request8.png).
  • [x] Карточка заявки с подрядчиком и ожиданием приёмки (wnd7.png).
  • [x] Рабочее место обращений (wnd10.png, appeals5.png).
  • [x] Оперативный журнал с активными распоряжениями (wnd5.png, wnd6.png).
  • [x] Чеклист открытия смены со списком распоряжений на ознакомление (shift6.png).
  • [x] Форма ручной записи с мультивыбором зданий (opz1.png).
  • [x] Карточка распоряжения со сводкой ознакомлений (wns11.png).
  • [x] История оперативного журнала в карточке оборудования (equipment4.png).
  • [x] Вкладка «Смены» с KPI диспетчера (shift5.png).
  • [x] Экспорт отчёта «Активные заявки» в Excel (описан в report.md, UI — wn-report-active-wo.png).
  • [x] Карточка обращения со снимком сконвертированной заявки (appeals5.png).

Руководитель

  • [x] Отчёт «Активные заявки» с колонками «Обновлена», «Последний комментарий» и «Комментарий паузы» (wn-report-active-wo.png).
  • [x] Раздел руководителя с вкладками (wns1.png, adm1.png).
  • [x] Проверка повторных открытий (wns2.png).
  • [x] Модальное окно review причины переоткрытия (wns3.png).
  • [x] KPI-сводка повторных открытий (wns4.png).
  • [x] Список премий с объяснением расчёта (wns5.png).
  • [x] Детальная карточка премии (wns6.png).
  • [x] Оборудование на простое с восстановлением (wns7.png).
  • [x] Карточка оборудования с follow-up заявкой (wns8.png).
  • [x] Отчёт «Исполнители заявок» (wns9.png).
  • [x] Отчёт «Клининг подрядчиков» (wns10.png).
  • [x] Прогресс ознакомления диспетчеров с распоряжением (wns11.png).
  • [x] Отчёт истории закрытых смен с Excel (wns12.png).

Администратор

  • [x] Карточка контрагента с ИНН, ролями, контактами и счетами (wna19.png).
  • [x] Форма создания контрагента с полем ИНН (wna20.png).
  • [x] Учётные записи интеграций 1С (wna18.png; журнал обмена — wna13.png).
  • [x] Роли и поиск разрешений (wna1.png).
  • [x] Дежурные группы (wna2.png).
  • [x] Участники подрядчика (wna3.png).
  • [x] Профили услуг подрядчика (wna4.png).
  • [x] Зоны обслуживания подрядчиков (wna5.png).
  • [x] График SLA подрядчика (wna6.png).
  • [x] Справочник регламентов (wna7.png).
  • [x] Импорт регламентов (wna8.png).
  • [x] Режим расчёта дедлайнов площадки (wna9.png).
  • [x] SLA-политики: графики, линии, маршрутизация (wna10.png).
  • [x] Оргструктура и руководители (wna11.png).
  • [x] Карточка персонала с подразделением и графиком (wna15.png).
  • [x] Настройки Bitrix (wna17.png).
  • [x] Версия приложения и DEV/PROD (wna16.png).
  • [x] CSV шаблон / выгрузка / импорт оборудования (wna21.png).
  • [x] Выдача права dispatcher.view кастомной роли и главная панель диспетчера (wna22.png, main1.png).
  • [x] Настройка этажа «Отображать на карте» (wna23.png).

Подрядчик

  • [x] Список заявок подрядчика (iphone/my-works.png).
  • [x] Карточка заявки подрядчика (iphone/work-card.png).
  • [x] Блок Вложения в карточке (iphone/work-attachments-block.png).
  • [x] Завершение с фото/актом (iphone/work-finish-equipment.png).
  • [x] Уведомление о назначении — превью in-app (iphone/contractor-notification-preview.png; push — OS, см. contractor-guide).
  • [x] Запрос паузы (описан в contractor-guide.md; UI действий — work-card.png).

Правила подготовки

  • На скриншоте должен быть виден сам изменённый элемент, а не только общий экран.
  • Минимум один скрин на ключевой сценарий из раздела «Основные действия» / «Пошаговый сценарий» страницы. Один общий кадр не закрывает модуль целиком (пример: карта — навигатор, пин из заявки, выбор помещения и точки, оборудование).
  • Данные должны быть демонстрационными и без персональных телефонов, email и внутренних токенов.
  • Если экран зависит от прав, снимайте его под ролью, для которой он описан.
  • Если сценарий имеет несколько состояний, нужен отдельный скриншот для каждого состояния.
  • Перед commit: проверьте шапку, колонки исполнителей и тела уведомлений на PII; при необходимости замажьте ФИО и телефоны.

Аудит PII (перед публикацией)

Проверяйте каждый новый или обновлённый файл в docs/img/:

Что искать Примеры Действие
Email @megapolis, @mail.ru, @gmail.com Замазать или переснять на DEV с demo
Телефон +7, 8 (9, мобильные в карточках Замазать
ФИО сотрудников реальные имена в списках, сменах, премиях Demo-учётки или blur
JWT / токены eyJ в URL, DevTools Не снимать DevTools с сессией
PROD-данные арендаторы, реальные WO с PROD Только DEV-среда (демо-данные)

Процесс

  1. Инвентарь: find docs/img -type f \( -name '*.png' -o -name '*.jpg' \)
  2. Быстрый скан метаданных: strings файл.png | rg -i '@|\+7|eyJ'
  3. Ручной просмотр — колонки «Исполнитель», «Контакт», уведомления, профиль.
  4. Исправление: переснять на DEV или redact_pii.py (workspace .cursor/tmp/redact_pii.py).
  5. Отчёт в комментарии issue: сколько файлов проверено / сколько исправлено.

Среда съёмки

  • BMS: DEV (демо-объекты МФТК, ТСК и т.д.).
  • Mobile: DEV mobile с demo-исполнителем.
  • Не снимать на PROD без явного redact.

Осталось снять

Приоритет Экран Куда положить
P1 Админка → Email-шлюз admin-guide.md
[x] Склад — приёмка (procurement-warehouse.png) procurement-guide.md
[x] Снабжение → Письма (procurement-email-inbox.png) procurement-guide.md
[x] Обращения → Почта (appeals-email-inbox.png) appeals.md
P1 Кликабельные сводки задач снабжения procurement-guide.md
P1 Телефонная книга / «Позвонить» dispatcher-guide.md
P1 Пользователи и доступ (2 вкладки) admin-guide.md
P1 Персонал: На работе / Отпуск / Больничный staff.md
P1 Клининг: «Работы клининг» и «Расчёт клининга» cleaning-guide.md
P1 Согласования арендаторов (при включённом модуле) tenant-permits.md
P2 Открыть файл счёта (согласование / склад) procurement-guide.md
P2 Mobile: пересъём work.md (WO + оборудование) — GitLab !334 iphone/work.md

Уже есть скрины (не дублировать в backlog)

Экран Файлы
Объекты object1–4.png
Годовой план yearp1–2.png
Настройки settings1–2.png, wna16.png
CSV оборудования wna21.png
Mobile вложения / уведомление подрядчику work-attachments-block.png, contractor-notification-preview.png
Снабжение / коммерция / контрагенты / 1С procurement1.png, commercial1–3.png, wna18–20.png