РД в событиях: роль согласующего

Что делает согласующий в процессе

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

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

Как согласующий попадает в работу

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

Кнопка перехода в строке задачи открывает Экран маршрута пакета документации в режиме согласующего: /sod/projects/<id>/modules/working-docs/reviewer/batches/<batchId>.

Что согласующий видит на экране пакета

На экране пакета согласующий видит:

Hero пакета с кодом и наименованием документа, ревизией.
Сводку этапа — сколько листов всего, сколько уже решено, сколько ожидают действия.
Таблицу листов пакета со столбцами:
- подпись листа в формате «Лист N (рев. X): {название}»;
- указание на изменение (изменён / без изменений);
- превью изменённого листа;
- открытые замечания на этом листе;
- результат текущего этапа (если решение уже принято);
- кнопки действий.
Кнопку в шапке страницы для финального действия этапа — «Передать на утверждение».
Замечания, которые валидатор или сам согласующий создал по листам пакета.

Варианты решения по листу

По каждому листу согласующий принимает одно из двух решений (см. единый словарь):

Решение	Что значит	Когда применять
Согласовать	Лист идёт дальше на этап утверждения	На листе нет проблем, либо замечания планируется закрыть до утверждения
Дать замечание	Создаётся замечание прямо на PDF, лист помечается как требующий доработки	Найдена проблема, которую нужно зафиксировать формально

Финальные решения о публикации (окончательно / с замечаниями / временно / вернуть на доработку) принимает уже утверждающий — см. Роль утверждающего в событиях.

Решение принимается прямо в строке листа в колонке «Действия». Под каждой кнопкой — короткое описание, что произойдёт.

Как работают замечания на этапе согласования

Согласующий может:

Создать новое замечание — нажать «Создать замечание» рядом с листом. Открывается модалка создания: выбор типа разметки, описание, категория, уровень важности, флаг блокировки. Подробно — в Создание замечания.
Снять существующее замечание — открыть замечание из колонки «Замечания» в строке листа. В карточке замечания можно изменить статус (например, «Закрыто» с указанием причины).

Замечание с флагом «Блокирует публикацию» на этапе согласования просто фиксируется на листе. На этапе утверждения оно автоматически сделает кнопку «Утвердить окончательно» недоступной — утверждающий должен будет либо дождаться закрытия замечания, либо выбрать другое решение (см. единый словарь).

Когда передавать пакет дальше

Когда по всем листам приняты решения, в шапке страницы становится активна кнопка «Передать на утверждение».

Нажать кнопку.
Подтвердить диалог (можно оставить комментарий для утверждающего).
Пакет переходит на этап утверждения. У согласующего задача закрывается.

Этап согласования закрывается по правилу кворума шаблона:

если в шаблоне стоит «Согласование: требовать всех» — нужны решения всех назначенных согласующих;
если стоит «минимум подтверждений N» — достаточно N положительных решений по этапу. Прочим согласующим их задачи становятся ненужными.

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

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

пакет в принципе не соответствует тому, что ожидалось от автора;
большинство листов имеют блокирующие замечания и проще начать новую итерацию.

Обычная практика — использовать per-sheet решения: на проблемных листах нажать «Дать замечание» и точечно описать проблему, остальные — «Согласовать». Дальше уже утверждающий принимает финальное решение по каждому листу (в том числе «Вернуть на доработку»). Это аккуратнее, чем возвращать весь пакет: автор получает точечный список замечаний, а одобренные листы идут на утверждение.

Контрольный список согласующего перед передачей

По каждому листу принято решение (нет листов без решения).
На каждом листе с решением «Дать замечание» создано замечание с конкретной разметкой и понятным описанием.
Открытые блокирующие замечания на согласованных листах сознательно зафиксированы — на этапе утверждения они автоматически запретят «Утвердить окончательно».
Комментарий к этапу заполнен, если регламент проекта это требует.
Кнопка «Передать на утверждение» в шапке страницы активна.

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

Согласовал все листы, но забыл нажать «Передать на утверждение». Принятие решений по листам само по себе не двигает процесс. Процесс двигает только финальная кнопка этапа.
Согласовал лист, по которому хотел зафиксировать проблему. «Согласовать» отправляет лист дальше без отметки о проблеме. Если есть претензия — выбирайте «Дать замечание» и опишите её.
Вернул весь пакет вместо точечной фиксации проблем. Это сбрасывает прогресс по всем листам, включая хорошие. Используйте «Дать замечание» на проблемных листах и «Согласовать» на остальных.
Не написал понятного комментария к замечанию. Автор не поймёт, что исправлять. Описание замечания должно содержать конкретное действие и место на листе.

Если согласующих несколько

Когда в шаблоне на этап согласования назначено несколько участников, поведение зависит от правила кворума:

«Требовать всех» — каждый из назначенных должен принять решение по этапу. Лист в пакете может быть отмечен решением одного согласующего, но для закрытия этапа нужны решения всех.
«Минимум N» — этап закрывается, когда N согласующих приняли решение «Передать на утверждение». Прочим участникам этап больше не виден.

Решения по конкретным листам всегда хранятся индивидуально, с автором решения и временем. Это видно в карточке листа в разделе «История решений».

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

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