# Как комментировать документы и фрагменты

**Сотрудничайте в контексте – обсуждайте целые документы или отдельные абзацы, отмечайте коллег с помощью @упоминаний и получайте мгновенные уведомления.**

> **Применяется к:** База знаний Procurize.AI → Документы  
> **Роли пользователей:** Администратор, Редактор, Менеджер безопасности (могут комментировать) | Аудитор (только просмотр)

## Обзор

Procurize.AI теперь предоставляет **комментирование в контексте** из модуля Опросов в ваши **документы Базы знаний**. Вы можете оставлять отзывы, задавать вопросы или начинать обсуждение:

- К **целому документу** — используя кнопку на панели инструментов  
- К **конкретному фрагменту** (абзац, заголовок, элемент списка, ячейка таблицы) — используя значок комментария над каждым фрагментом

Все комментарии видимы всем. Пользователи, **@упомянутые**, получают уведомления. Аудиторы могут читать все комментарии, но не могут публиковать или отвечать.

## Кто что может делать

| Действие | Администратор | Редактор | Менеджер безопасности | Аудитор |
|----------|---------------|----------|-----------------------|---------|
| Просматривать все комментарии | ✅ | ✅ | ✅ | ✅ |
| Оставлять новый комментарий (документ или фрагмент) | ✅ | ✅ | ✅ | ❌ |
| Отвечать на комментарий | ✅ | ✅ | ✅ | ❌ |
| @упоминать другого пользователя | ✅ | ✅ | ✅ | ❌ |
| Получать уведомления при упоминании | ✅ | ✅ | ✅ | ✅ |
| Подписаться на документ (получать уведомления о всех новых комментариях) | ✅ | ✅ | ✅ | ✅ |

> 🔒 **Роль аудитора** имеет минимальные привилегии – доступ только для чтения к комментариям для проверки соответствия.  
> 👁️ Кнопка **"Подписаться"** доступна всем – нажмите её на любом документе, чтобы получать email‑ и внутризапросные уведомления о **всех** новых комментариях (а не только о @упоминаниях).

## Два способа оставлять комментарии

### 1. Комментировать целый документ

Откройте любой документ → **Панель инструментов** → нажмите **«Оставить комментарий»** (значок облачка речи).

- Открывается панель комментариев справа.  
- Введите сообщение, при необходимости @упомяните коллег и опубликуйте.  
- Комментарий привязан к **документу в целом** — а не к конкретному фрагменту.

Используйте для: общего обратного связи, запросов на одобрение или вопросов, относящихся ко всему документу.

![Оставить комментарий к документу](/images/docs/doc-comment-button.png)

### 2. Комментировать конкретный фрагмент (в контексте)

При просмотре документа каждый фрагмент (абзац, заголовок, элемент списка, строка таблицы) имеет небольшую иконку «Оставить комментарий» над ним (справа).

Нажмите эту иконку → откроется панель комментариев, **привязанная к именно этому фрагменту**.

- Фрагмент выделяется, когда комментарий активен.  
- Ответы остаются привязанными к тому же фрагменту.  
- Переход из списка комментариев сразу переходит к соответствующему фрагменту в просмотрщике документа.

Используйте для: предложения изменить формулировку, вопрос о конкретном пункте, или отметить несоответствие в одном предложении.

![Оставить комментарий к разделу документа](/images/docs/doc-section-comment-button.png)

## Ответы на комментарии и обсуждения в ветках

- Любой комментарий (на уровне документа или фрагмента) может иметь **вложенные ответы**.  
- Чтобы ответить: нажмите **«Ответить»** под комментарием → введите ваш ответ → опубликуйте.  
- Все ответы группируются в ветке, сохраняющей контекст.

> 💡 Это работает точно так же, как панель сообщений в Опросах, но привязано к фрагментам документа.

## @Упоминания и уведомления

Когда вы вводите `@` и имя пользователя или email, Procurize.AI предлагает пользователей из вашего рабочего пространства.

- Упомянутые пользователи получают **email‑уведомление** (и уведомление в приложении, если включено).  
- Уведомление содержит: название документа, цитату фрагмента (если комментарий к фрагменту) и ваше сообщение.  
- Нажатие на ссылку в уведомлении открывает документ и прокручивает к точному фрагменту (или к заголовку документа).

> ⚠️ Только пользователи, которые **могут комментировать** (Администратор, Редактор, Просмотрщик), могут использовать @упоминания. Аудиторы не могут упоминать других (поскольку они не могут публиковать).

## Просмотр всех комментариев

Все (включая аудиторов) могут видеть все комментарии:

- **Комментарии уровня документа** — видимы в правой панели комментариев (открывается через панель инструментов).  
- **Комментарии уровня фрагмента** — видимы как в панели комментариев, **так и** отмечены небольшим бейджем над фрагментом (показывает количество комментариев).  
- Нажмите любой комментарий в панели → документ прокручивается к соответствующему фрагменту (или к началу документа для комментариев уровня документа).

## Пример рабочего процесса – проверка контракта

1. **Ведущий юрист (Редактор)** открывает соглашение с поставщиком → нажимает **«Оставить комментарий»** над абзацем об освобождении от ответственности.  
2. Пишет: `@John_Procurement Является ли лимит ответственности правильно установленным в $500k? Это конфликтует с нашей стандартной политикой.`  
3. **John (Просмотрщик)** получает email‑уведомление → нажимает ссылку → видит выделенный абзац.  
4. John отвечает: `Хорошее замечание – должно быть $1M. Я отредактирую после подтверждения.`  
5. **Аудитор** позже открывает тот же документ, читает всю ветку, но не может публиковать.  

Все коммуникации остаются внутри Procurize.AI — без потерянных email‑ов или сообщений в Slack.

## Комментарии vs. AI‑анализ — как они работают вместе

| Функция | Назначение |
|---------|------------|
| **AI‑анализ** | Автоматически обнаруживает несоответствия и предлагает исправления |
| **Комментарии** | Человеческое сотрудничество — задавайте вопросы, предлагайте изменения, запрашивайте уточнения |

Вы можете оставить комментарий **к фрагменту, на котором есть AI‑предупреждение** — например: *«AI говорит, что это конфликтует с политикой X – можем обсудить?»*

## Часто задаваемые вопросы (FAQ)

**В: Могу ли я редактировать или удалять свой собственный комментарий?**  
О: Да, но только если на него никто не ответил. Как только к комментарию появляется любой ответ, редактирование и удаление отключаются, чтобы сохранить целостность ветки.

**В: Что происходит с комментариями, когда фрагмент редактируется?**  
О: Старый фрагмент помечается как «Удалён». Если у него были комментарии, они остаются видимыми в глобальной панели комментариев после включения опции **«Показать удалённые разделы»** (эта опция появляется только когда такие фрагменты существуют). Вы по‑прежнему можете просматривать и отвечать на эти комментарии. Фрагменты без комментариев удаляются окончательно.

**В: Могу ли я отвечать на комментарий к удалённому фрагменту?**  
О: Да – при включенной опции «Показать удалённые разделы» кнопка ответа остаётся активной.

**В: Сохраняются ли ветки комментариев после обновления документа?**  
О: Комментарии к неизменённым фрагментам остаются привязанными. Комментарии к отредактированным фрагментам переходят в состояние «Удалён» (см. выше).

**В: Могу ли я получать уведомления о любом новом комментарии без @упоминания?**  
О: На данный момент уведомления генерируются только при @упоминании. Чтобы получать все новые комментарии, используйте кнопку **«Подписаться»**.

**В: Что происходит, когда аудитор пытается опубликовать комментарий?**  
О: Кнопка «Оставить комментарий» скрыта/деактивирована. Аудиторы имеют только режим чтения для комментариев.

**В: Доступно ли комментирование в модуле Опросов?**  
О: Да – в Опросах есть отдельная панель сообщений. Эта статья охватывает **только документы Базы знаний**.

{{<article-feedback>}}

## Связанные статьи

[Как редактировать документ](/how-to-edit-a-document)

[Что такое AI‑анализ документов?](/what-is-ai-document-analysis)

[Как использовать AI‑анализ документов](/how-to-use-ai-document-analysis)

[Как общаться в опросниках](/how-to-communicate-within-the-questionnaire)

[Роли и разрешения](/what-user-permissions-does-procurize-have)