Замечания: обзор

Что это

Замечание — формальная запись о проблеме на конкретной ревизии листа рабочей документации. Замечание всегда привязано к ревизии листа (через лист — к документу и комплекту) и проходит свой путь от создания до закрытия.

Замечания нужны, чтобы:

зафиксировать, что именно на листе нужно исправить;
назначить ответственного за устранение;
проследить, что исправление действительно сделано и проверено;
не дать опубликовать лист окончательно, пока критичные замечания не закрыты.

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

Привязка к ревизии листа и наследование. Когда автор загружает новую ревизию листа (например, после доработки), открытые замечания наследуются: они переносятся на новую ревизию с теми же координатами разметки на PDF (UI делает best-effort пересчёт, если страница изменилась по размеру или повёрнута). Закрытые и устранённые замечания не переносятся — они остаются в истории прошлой ревизии. Подробно — в Ревизиях листа и истории загрузок.

Жизненный цикл замечания — переходы между статусами Открыто, В работе, Нужна информация, Снято, Закрыто, Отклонено, Открыто повторно

Как обычно работают с замечаниями

Безопасный порядок:

Автор замечания (согласующий, нормоконтролёр или сам автор листа) находит проблему и создаёт замечание на листе. Подробнее — в Создание замечания.
Исполнитель видит замечание у себя в задачах, берёт его в работу, исправляет лист и отмечает замечание как устранённое.
Автор замечания проверяет исправление и либо закрывает замечание, либо открывает повторно с пояснением.

Если замечание помечено как блокирующее — лист нельзя выпустить, пока оно не закрыто.

Из чего состоит замечание

Замечание — это не одно сообщение, а структурированная запись:

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

Пункты замечания

Внутри одного замечания обычно несколько пунктов. Каждый пункт — это отдельная позиция, по которой можно отчитываться отдельно. У пункта есть:

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

Статусы замечания

Статус	Что означает	Кто переключает
Черновик	Замечание ещё не отправлено, автор готовит формулировку	Автор замечания
Открыто	Замечание активно, ждёт действий исполнителя	Ставится автоматически при создании
В работе	Исполнитель взял замечание в работу	Исполнитель
Нужна информация	Исполнитель приостановил работу и ждёт уточнения от автора	Исполнитель
Снято	Исполнитель отметил, что исправил — ждёт проверки	Исполнитель
Закрыто	Автор замечания подтвердил исправление; замечание закрыто окончательно	Автор замечания
Отклонено	Замечание признано необоснованным; закрыто без исправления	Автор замечания
Открыто повторно	Ранее закрытое замечание возвращено в работу	Автор замечания

Типовой путь:

Открыто → В работе → Снято → Закрыто

С запросом уточнения:

В работе → Нужна информация → В работе → Снято → Закрыто

При отказе от исправления:

Открыто → Отклонено

При возврате к старому замечанию:

Закрыто → Открыто повторно → В работе → Снято → Закрыто

Категории замечания

Категория помогает фильтровать замечания в реестре и правильно интерпретировать претензию.

Общее — не подходит ни под одну специализированную категорию.
Проектное решение — проблема в самом проектном решении: компоновка, размеры, узлы.
Увязка разделов — несостыковка между разделами, специалистами, подрядчиками.
Нормы / требования — несоответствие нормативам, СНиП, ГОСТ, заданию.
Выполнимость — решение сложно или невозможно реализовать на стройке.
Комплектность — не хватает деталей, узлов, разделов.
Уточнение — нужно дополнительное пояснение.
Опечатка / оформление — текстовая или числовая ошибка без влияния на смысл.
Другое — не подходит ни одна категория.

Уровни важности

Уровень	Когда применять
Информация	К сведению, без обязательного исправления
Незначимое	Можно исправить, но не критично
Существенное	Желательно исправить до публикации
Критичное	Обязательно к исправлению до использования на стройке
Блокирующее	Без исправления документ не может быть выпущен

Флаг «Блокирует публикацию»

Любое замечание (независимо от уровня важности) может быть отдельно помечено как блокирующее публикацию.

Когда замечание помечено как блокирующее:

Лист, к которому оно привязано, нельзя перевести в статус «Опубликовано окончательно».
В реестре согласований у листа появляется красный баннер «Нельзя использовать как финальный».
В дашборде координации число «Блокирующие замечания» увеличивается на 1.

Снять флаг блокировки может автор замечания. Закрытие замечания тоже снимает блокировку.

Типы пунктов замечания

У каждого пункта внутри замечания есть тип — он определяет, как пункт привязан к чертежу:

Тип	Что это	Когда использовать
Текст	Пункт без визуальной привязки	Когда проблема общая по листу
Точка на чертеже	Один клик на PDF — маркер	Когда нужно показать конкретное место
Область на чертеже	Прямоугольник на PDF	Когда проблема охватывает зону листа
Линия	Прямая линия (например, для размера или оси)	Когда нужно показать ось, размер, дистанцию
Стрелка	Линия с маркером на конце	Когда нужно указать направление или объект
Метка	Точка с текстовой подписью	Когда привязка нужна вместе с короткой подписью
Прикрепляемый файл	Файл-вложение как самостоятельный пункт	Когда замечание подкреплено документом
Внешний документ	Связь с внешним документом-основанием	Когда замечание формализовано отдельным внешним документом

Геометрические пункты (точка, область, линия, стрелка, метка) ставятся через инструменты разметки в окне создания замечания. Подробно — в Создание замечания.

Где появляются замечания

Место	Что видно
Карточка листа	Все замечания, привязанные к этому листу
Реестр замечаний	Полный список замечаний проекта с фильтрами и поиском
Экран маршрута пакета	Замечания по листам пакета во время согласования и утверждения
Карточка согласования листа	Блокирующие замечания, влияющие на статус публикации
Координация	Сводка по открытым и блокирующим замечаниям
Кабинет событий	Замечания, назначенные на текущего пользователя

Когда создаётся замечание

Согласующий или утверждающий — во время согласования или утверждения, если нашёл проблему. Замечание привязывается к текущей ревизии листа и сохраняется в истории.
Нормоконтроль — на любом листе, на любой ревизии, не дожидаясь стадии согласования.
Автор — иногда сам себе или коллеге, чтобы зафиксировать задачу на доработку.

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

Замечание считается окончательно закрытым, когда автор замечания подтвердил, что исполнитель исправил проблему. До этого момента замечание остаётся в статусе «Снято» и в реестре отображается как ещё не закрытое.

Если автор не согласен с тем, как исполнитель закрыл замечание — замечание можно открыть заново.

Что происходит с замечанием при перезаливке листа

Если по листу с открытыми замечаниями автор грузит новую ревизию, открытые замечания наследуются: для новой ревизии создаются соответствующие записи с теми же текстами, категориями, важностью и разметкой на PDF. Это значит, что автор не может «потерять» замечание перезаливкой — оно автоматически переходит на новую ревизию и продолжает учитываться при решениях по этой ревизии.

Закрытые и устранённые замечания при этом не наследуются — они остаются в истории прошлой ревизии листа. Подробно про модель ревизий — в Ревизиях листа и истории загрузок.

Связь с публикацией листа

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

Внешние документы

К замечанию можно прикрепить внешние документы — формальные основания или подтверждения:

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

Внешние документы хранятся как вложения и видны в обсуждении замечания.

Контрольный список перед созданием замечания

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

Типовые ошибки

Замечание без конкретики — «доработать», «уточнить». Исполнитель не понимает, что делать. Описывайте проверяемое действие и конкретное место на листе.
Несколько разных проблем в одном пункте — затрудняет частичное закрытие. Разделяйте проблемы по отдельным пунктам.
Завышенная важность — каждое замечание не может быть «блокирующим», иначе теряется смысл блокировки.
Закрытие замечания исполнителем — статус «Закрыто» должен ставить автор замечания, а не исполнитель. Исполнитель ставит «Снято».
Отсутствие привязки на PDF, когда проблема локальная — автор и исполнитель тратят время на поиск места.