РД в событиях: роль валидатора

Что делает валидатор в процессе

Валидатор — это участник этапа «Валидация». Он принимает пакет от автора, проводит его через автоматическую обработку и подготавливает к согласованию: сверяет с предыдущей версией, штампует QR на каждом изменённом листе, оставляет замечания при необходимости и отправляет пакет дальше.

На текущей реализации в задачи валидатора входит не только формальная проверка PDF, но и подготовка пакета к согласованию (включая штамповку QR). Это самостоятельная инженерная работа, а не «галочная» приёмка.

Как валидатор попадает в работу

Открыть проект.
Открыть модуль События и нажать «Открыть кабинет».
В разделе «Требуют действия» найти задачу с этапом «Валидация».
Альтернативно — открыть очередь валидатора в модуле РД (/sod/projects/<id>/modules/working-docs/validator/queue). Это та же выборка задач, только в контексте модуля РД.

В кабинете в строке задачи есть кнопка перехода в предметный экран. Она открывает Экран маршрута пакета документации (batch workflow page) на URL /sod/projects/<id>/modules/working-docs/validator/batches/<batchId>.

Что валидатор делает на экране маршрута пакета

Полное описание экрана — в Экран маршрута пакета документации. Кратко стадии:

Первичная проверка — система предлагает запустить автоматическую обработку PDF. Кнопка «Запустить обработку».
Подготовка документа — автоматическая разборка PDF, поиск базовой версии. Валидатор может уйти со страницы, обработка идёт в фоне. Прогресс показывается в трёх укрупнённых группах: «Распознаём PDF», «Сопоставляем версии», «Завершаем».
Привязка и сопоставление — валидатор подтверждает автоматически предложенное сопоставление листов новой версии с прошлой утверждённой. При необходимости — поправляет. Кнопка «Применить сопоставление».
Сравнение изменений — для каждого изменённого листа показано визуальное наложение «было/стало». Валидатор может оставить замечание прямо на разнице. Заполняет описание изменений.
Штамповка QR — для каждого изменённого листа (или для каждого листа первой ревизии) валидатор расставляет QR-код. По каждому листу можно отрегулировать позицию (клик на нужное место) и размер в мм. Кнопка «Сохранить позицию QR» или «Сохранить и далее».
Отправка на согласование — когда все QR проставлены, в шапке страницы становится активна кнопка «Отправить на согласование». По клику — диалог подтверждения, затем процесс уходит на этап согласования.

Что валидатор должен проверить

Что проверять	Где смотреть
Тот ли документ загружен	Hero страницы пакета: код документа, наименование, номер загрузки
Корректно ли разобрался PDF	Прогресс «Подготовка документа» завершён без ошибок; в карточке нет красного маркера
Правильно ли сопоставились страницы PDF с листами реестра	Стадия «Привязка и сопоставление»: предложенные пары «страница ↔ лист» с учётом прошлых ревизий листов
Что реально изменилось по сравнению с прошлой ревизией листа	Стадия «Сравнение изменений»: визуальное наложение и отчёты
Правильное место и размер QR на каждом листе	Превью каждого листа на стадии штамповки
Заполнено ли описание изменений по листам	Поле описания у каждого изменённого листа

Варианты решения

Действие	Когда применять	Кнопка
Отправить пакет на согласование	Пакет проверен, все QR проставлены, описания заполнены	«Отправить на согласование» в шапке страницы
Создать замечание по конкретному листу	Лист нужно доработать, но это можно делать без полного возврата пакета	Кнопка создания замечания рядом с листом или из карточки листа
Вернуть пакет автору	Найдены проблемы, которые не решить замечаниями (повреждённый PDF, не тот документ, не та загрузка)	Кнопка «Вернуть автору» на странице пакета

Как валидатор оставляет замечания

Замечание создаётся прямо во время валидации, чтобы автор увидел его при возврате (или согласующий — на следующем этапе).

Открыть лист, на котором нашлось замечание.
Нажать «Создать замечание» (рядом с листом или в его карточке).
В появившейся модалке выбрать тип привязки: текст без разметки, точка, область, линия, стрелка или текстовая метка.
Поставить разметку на нужной ревизии PDF (предыдущая / текущая / разница).
Заполнить заголовок и описание замечания, выбрать категорию и уровень важности.
Если замечание блокирует публикацию листа — поставить флаг «Блокирует публикацию» (как этот флаг влияет на метку «Можно использовать» — см. единый словарь).
Прикрепить вложения, если есть.
Сохранить.

Подробное описание процесса — в Создание замечания и Замечания: обзор.

Когда возвращать пакет автору

Возврат пакета — крайняя мера. Применяется, если:

загружен не тот документ;
PDF повреждён и не распознаётся системой;
автоматическая обработка не смогла найти/привязать листы (например, нумерация листов разъехалась с реестром);
по результатам сравнения видно, что загруженный PDF фундаментально не соответствует тому, что должно было быть подано.

Во всех остальных случаях используйте замечания по конкретным листам — это аккуратнее, потому что не сбрасывает прогресс пакета и сохраняет контекст для согласующего.

Контрольный список валидатора перед отправкой

Все стадии автоматической обработки прошли без ошибок.
Привязка страниц PDF к листам реестра подтверждена.
На всех изменённых листах (или всех листах при первой загрузке) проставлены QR в корректной позиции и нужного размера.
Описания изменений заполнены по всем изменённым листам.
При необходимости — оставлены замечания с конкретной разметкой и описанием.
Подсказка «Завершите штамповку — осталось N» больше не отображается.
Кнопка «Отправить на согласование» активна в шапке страницы.

Частые ошибки

Отправил пакет, не проверив привязку листов. Согласующий может вернуть пакет, потому что в нём смешаны не те страницы. Всегда проверяйте, что новый лист действительно соответствует старому.
Поставил QR в углу листа поверх рамки или штампа. Используйте стандартную область — обычно справа над основной надписью.
Не оставил замечаний при отправке. Если на каких-то листах есть мелкие проблемы, согласующему будет сложно их найти самому. Лучше зафиксировать как замечания заранее.
Изменил размер QR в превью, но он не применился к финальному PDF. Это была ошибка в прошлых релизах; сейчас исправлено: размер из поля «Размер QR» используется при штамповке. Если что-то не так — посмотрите ревизию в карточке листа.

Визуальные материалы (добавим на следующем шаге)

Скриншот: задача валидатора в кабинете событий.
Скриншот: страница пакета на стадии «Подготовка документа» с прогрессом.
Скриншот: стадия «Сравнение изменений» с overlay.
Скриншот: стадия «Штамповка QR» с маркером на превью.
Скриншот: активная кнопка «Отправить на согласование» в шапке.