# Комментарии Комментарии обеспечивают коммуникацию участников внутри задач. В документе описаны типы комментариев, адресаты и видимость, настройки категории, автопрочтение, закреплённые комментарии, треды, вопросы, ссылки, оценки исполнителей, редактирование и удаление, подписка и уведомления. Поведение комментариев настраивается на уровне категории. ## Обзор — Комментарии Комментарии обеспечивают коммуникацию участников внутри задач. Поддерживаются треды (вложенные ответы), реакции (эмоции), пересылка комментариев между задачами, а также форматирование текста и прикрепление файлов. Поведение комментариев настраивается на уровне категории. **Типы комментариев** В ленте задачи отображается два вида записей: сообщения, написанные пользователями, и системные уведомления, которые 1Форма добавляет автоматически при изменениях в задаче. **Пользовательские типы** | Описание | Создаётся | |---|---| | Пользовательский комментарий | Вручную пользователем | | Комментарий из подзадачи | Автоматически при публикации в подзадаче | | Вложение файла (без текста) | Пользователем через drag&drop файла | | Внесение трудозатрат | Пользователем через форму трудозатрат | **Системные типы** Системные записи создаются автоматически при каждом значимом изменении в задаче — пользователь видит, что произошло, без необходимости разбираться в истории вручную. | Описание | Событие | |---|---| | Переход по маршруту | Смена шага/статуса задачи | | Подпись (резолюция) | Согласование/подписание | | Служебный | Различные системные действия | | Изменение ДП или файлов | Изменение допараметра или файла | | Создание задачи | Создание новой задачи | | Изменение текста задачи | Редактирование описания | | Смена категории | Перемещение задачи | | Смена срока | Изменение дедлайна | | Добавлен исполнитель | Назначение исполнителя | | Добавлен подписчик | Добавление подписчика | | Задача просрочена | Автоматически при просрочке | | Смена заказчика | Изменение заказчика задачи | | Удалён файл | Удаление файла | | Утверждение трудозатрат | Акцепт фактических трудозатрат и снятие акцепта | Текст системных комментариев формируется автоматически по событию задачи. Каждый читатель видит его на своём языке: шаблон выбирается по языку пользователя (`Users.LanguageID`), а если шаблона на этом языке нет — по языку системы по умолчанию. Международный язык в этой цепочке не участвует. Отрисованный текст кешируется отдельно для каждого языка, поэтому читатели с разными языками интерфейса видят каждый свой вариант одной и той же системной записи. Язык шаблона определяется для того, кто читает ленту, а не для того, кто вызвал событие: после смены языка интерфейса шаблонный текст при следующем получении ленты формируется для новой локали. Текст, который человек ввёл сам — например причину подписи или пояснение, — при этом не переводится. Даты в тексте системных комментариев — например, новый срок или дата начала работы — в веб-интерфейсе показываются по часовому поясу из профиля читателя, так же как на карточке задачи. В push-уведомлениях и письмах такие даты приводятся к часовому поясу профиля получателя. Мобильные приложения показывают эти даты в часовом поясе сервера. ## Интерактивные отчёты в сообщениях В комментарий можно приложить интерактивный отчёт — файл с именем, оканчивающимся на `.dash.html`. Такой файл отображается прямо в ленте отдельным блоком во всю ширину сообщения: его не нужно предварительно открывать в просмотрщике. Интерактивные отчёты используются для наглядной подачи результатов: например, для KPI-плиток, диаграмм, динамики показателей или небольшого дашборда. Один комментарий может содержать несколько отчётов и обычные вложения одновременно. ### Как это выглядит для читателя - отчёт показывается под текстом комментария; - ширина блока подстраивается под ширину сообщения; - высота меняется по содержимому отчёта; - интерактивность графика работает внутри блока; - обычные вложения в том же комментарии отображаются штатно. ### Тема и оформление Отчёт получает тему, шрифт и цветовые токены из ленты и подстраивается под светлую и тёмную тему. Фон блока соответствует фону самого сообщения — обычному или акцентному в чате — и слегка меняется при наведении курсора на комментарий, как и у самого сообщения; автору отчёта не нужно задавать фон самостоятельно. ### Ограничения Интерактивный отчёт предназначен для результатов, подготовленных Анфисой или автоматизацией. Пользователь создаёт и редактирует обычные файлы как прежде. Если файл не распознан как интерактивный отчёт или его отображение недоступно, он остаётся обычным вложением, которое можно открыть или скачать. В отчёт не добавляют растровые изображения, base64-данные и внешние загрузки. Для графиков используют векторную графику; для простых показателей достаточно HTML и CSS. **Адресаты комментариев (кто видит что)** **Ключевой принцип** Видимость комментария определяется списком его адресатов. Если пользователь не попал в список — комментарий не появится у него в ленте. **Типы адресатов** У каждого адресата комментария есть роль, которая определяет, как именно он получит сообщение. | Тип | Значение | |---|---| | Явный адресат | Выбран пользователем при отправке | | Неявный адресат / подписчик | Подписчик задачи без прямой адресации | | В копии | Получает сообщение, но без «непрочитанного» | | Требует ответа | Получатель должен ответить (вопрос) | **Что влияет на список адресатов** Когда комментарий публикуется, система рассчитывает кому он будет показан: - явно выбранные пользователи и группы из поля «Кому»/«Копия», - подписчики задачи (если категория не запрещает), - ограничения через смарт-события (тип «Перед отправкой уведомления»), - персональные настройки пользователей (подписка на тип, автопрочтение). ## Изменение адресатов при редактировании При редактировании комментария можно изменить список адресатов. Система пересчитывает список и корректирует push-уведомления: - Добавленные адресаты получают push о комментарии и начинают видеть его в ленте. - Исключённые адресаты получают сигнал удаления push (уведомление исчезает из центра уведомлений на устройстве), и комментарий перестаёт быть видимым для них в ленте. - При сужении «Всем» до конкретного пользователя push остаётся только у указанного. Подробнее о поведении push-уведомлений при изменении адресатов — см. [notifications/business.md → Редактирование адресатов комментария](https://help.1forma.ru/domains/notifications/business.md#редактирование-адресатов-комментария). ## Поведение поля адресата при отправке При отправке комментария в задаче поле «Кому» сохраняет выбранного адресата для следующего сообщения. Пользователю не нужно выбирать получателя повторно, если он продолжает переписку с тем же коллегой. Это поведение работает одинаково для всех сообщений в рамках открытой задачи — и для первого, и для последующих. Если пользователь явно сменит адресата, новое значение сохранится для следующих сообщений вместо прежнего. При перезагрузке страницы или открытии другой задачи поле «Кому» инициализируется заново согласно настройкам категории и списку подписчиков. ## Индикатор «печатает» Когда собеседник набирает сообщение в ленте задачи, остальные участники видят индикатор «печатает…». По умолчанию его видят все подписчики задачи. Функция поддерживает адресный режим: индикатор можно показать только определённым участникам (например, когда сообщение готовится для одного адресата), не отвлекая остальных. Показать индикатор пользователю, у которого нет доступа к задаче, нельзя — система всегда сверяет список адресатов с подписчиками. Состав данных о печатающем считается под того, кто смотрит, а не под того, кто печатает: сведения об отсутствии коллеги приходят в объёме прав смотрящего. Коллеге без доступа к календарю печатающего индикатор отдаёт только признак активности — без темы, места и текста отсутствия и без списка участников; владелец данных и пользователи с полным доступом видят их полностью. **Настройки категории, влияющие на видимость** Эти настройки задаются в категории её администратором — конечный пользователь их не настраивает, но видит результат. | Настройка | Влияние | |---|---| | Скрытие системных комментариев | Системные комментарии записываются, но не показываются никому в ленте | | Передача комментариев всем исполнителям | При адресации одному исполнителю комментарий получают все исполнители задачи | | Включение комментариев в категории | Если выключено — лента комментариев в задаче полностью отключена | | Режим видимости в главной ленте | Режимы «Только задачи» / «Ничего не показывать» скрывают комментарии из главной ленты | | Запрет удаления пользовательских комментариев | Автор не может удалить собственные комментарии | **Видимость при чтении ленты** **Как формируется лента** При открытии задачи система собирает ленту: отбирает комментарии, адресованные текущему пользователю, не удалённые, с учётом фильтров по дате, типу, задаче и обсуждениям. **Когда пользователь может НЕ видеть отправленный комментарий** | Причина | |---| | Пользователь не попал в список адресатов комментария | | В категории включено скрытие системных комментариев, а тип системный | | У пользователя отключена подписка на этот тип комментариев в настройках | | Смарт-событие «Перед отправкой уведомления» заблокировало адресацию | | В категории отключены комментарии | | Категория скрывает комментарии из главной ленты | | Комментарий удалён | | Пользователь не подписан на задачу | Подписка и отписка не пересматривают прошлое: при подписке на задачу её прошлые сообщения в ленту не добавляются. **Автопрочтение** Комментарий может быть автоматически помечен как прочитанный без участия пользователя: 1. Если в профиле включена настройка автопрочтения комментариев. 2. Если пользователь исключён из адресатов смарт-событием. 3. Для событий календаря — при выключенном уведомлении по событию. 4. По персональным настройкам уведомлений пользователя. ## Закреплённые комментарии Участники с соответствующим правом могут закрепить любое сообщение, чтобы оно всегда было на виду. Для этого нужно вызвать контекстное меню сообщения (правая кнопка мыши) и выбрать пункт **Закрепить**. В чате закреплённые сообщения отображаются в отдельной панели над лентой — все участники видят их сразу при открытии чата. Закрепление доступно в трёх контекстах: в чате, в обычной ленте задачи и внутри отдельного обсуждения (треда). В чате закреплять и откреплять вправе владелец, администратор и модератор чата, а также подписчик, если в настройках чата включена опция «Закреплять сообщения для всех». В обычной задаче закрепление доступно тем, кому доступно добавление комментариев: комментарии в категории не запрещены и задача не закрыта, если в категории стоит запрет комментировать закрытые задачи. Закреп внутри обсуждения виден только в нём — в общую панель он не попадает. При закреплении или откреплении в ленте появляется системное сообщение. Push- и email-уведомления при этом не отправляются. Изменение отражается у всех участников мгновенно. В панели закреплённых сообщений чата доступно действие **«Открепить все сообщения»** — оно снимает закрепление сразу со всех сообщений и для всех участников. Перед откреплением запрашивается подтверждение. Действие доступно тем же, кто вправе закреплять сообщения в этом чате. **Все закреплённые сообщения задачи.** В карточке задачи вне режима чата в меню «…» в шапке, сразу после пункта включения или отключения уведомлений, есть пункт **«Все закрепленные сообщения»**. Он виден всегда, даже если закреплённых сообщений нет, и открывает окно со списком закреплённых сообщений задачи; при пустом списке в окне написано «Нет закреплённых сообщений». Выбор сообщения закрывает окно и прокручивает ленту к нему, кнопка «Назад» закрывает окно. Действие «Открепить все сообщения» в меню «Больше действий» этого окна доступно тем, кто вправе добавлять комментарии в задаче. **Только закреплённые.** Лента сообщений поддерживает режим «только закреплённые» — в выдачу попадают лишь закреплённые сообщения. Режим не заменяет остальные условия отбора, а сужает выдачу: порядок сортировки, фильтр по типам сообщений, отбор по адресатам, поиск и выборка внутри отдельного обсуждения работают как обычно, но уже внутри подборки закреплённых. Поиск в этом режиме идёт только по тексту сообщений: совпадения по именам вложений, заголовкам опросов и превью ссылок выдачу не дополняют. Если в задаче или чате закреплённых сообщений нет, лента остаётся пустой — ничего вместо них не подставляется. В ленте задачи в этот режим ведёт вкладка «Закреплённые» — она стоит сразу за «Лентой» и появляется, только когда в самой задаче есть закреплённые сообщения; закрепления внутри обсуждений на её появление не влияют. Вкладка работает по текущей задаче: при выборе её источник сообщений возвращается к текущей задаче, а при переключении источника на подзадачи или связанные задачи лента возвращается на «Ленту». Скрытие закрепа у себя действует только на обычную вкладку «Лента»: там сообщение остаётся на своём месте по времени и не поднимается к закреплённым. Вкладка «Закреплённые» и отдельный список закреплённых сообщений показывают одинаковый полный состав — в том числе закрепы, скрытые вами: это одна и та же подборка в двух местах. Постраничной подгрузки на вкладке нет — список приходит целиком. **Закреплённые вверху ленты задачи.** На вкладке «Лента» карточки задачи закреплённые сообщения поднимаются в начало ленты под разделителем «Закреплённые» и убираются со своего места по времени. Сообщение, закрепление которого пользователь скрыл у себя пунктом «Скрыть закрепленное сообщение», остаётся на своём месте по времени. У закреплённых сообщений в ленте виден значок закрепления. В режиме чата и внутри открытого обсуждения сообщения не поднимаются. **Скрыть закреп у себя.** Закреплённое сообщение можно убрать из закрепов персонально — и в чате, и в обычной задаче. Пункт «Скрыть закреп» есть в контекстном меню самого сообщения; он доступен, пока сообщение закреплено и не скрыто, и не показывается внутри обсуждения. Скрытие действует только для того, кто его сделал: само закрепление остаётся, другие участники видят сообщение закреплённым. Вернуть закреп себе можно тем же меню — пунктом «Вернуть в закреплённые», — а восстановить все скрытые разом получится из списка закреплённых сообщений, одним запросом на задачу. **Действия на вкладке «Закреплённые».** Вкладка показывает отдельную подборку сообщений, но действия над сообщением на ней те же, что в обычной ленте: изменить, удалить, снять непрочитанность, посмотреть прочтения. Результат виден прямо на вкладке — переключаться в «Ленту» и обратно не нужно: после правки показывается новый текст, после снятия непрочитанности — обновлённый признак. Удаление сообщения с вкладки удаляет и приложенные к нему файлы, как при удалении из ленты. ### Треды (обсуждения) Тред = корневой комментарий + дочерние ответы. Статусы: открыт / закрыт. В закрытом треде публикация запрещена (кроме транскрибации): недоступны и одиночные действия с сообщением (ответ, редактирование своего сообщения, отметка вопроса и снятие вопроса, удаление), и групповые — при множественном выборе групповое удаление скрывается, если выбор выполняется внутри закрытого треда или среди выделенных есть хотя бы одно его сообщение. Пересылка выделенных сообщений остаётся доступной. Подробнее — см. [chat/business.md → Права на управление обсуждениями](https://help.1forma.ru/domains/chat/business.md#права-на-управление-обсуждениями). Просмотр закрытого треда не меняет его статус: чтобы вернуть тред в работу, нужно явно выбрать **«Открыть обсуждение»** — при простом открытии закрытого треда для чтения он остаётся закрытым. ## Создание обсуждения пользователем Обсуждение можно создать в ленте задачи и в чате двумя способами. **Из уже отправленного сообщения.** Нужно перейти к сообщению в ленте, вызвать контекстное меню и выбрать пункт **Начать обсуждение**. Создать обсуждение из сообщения можно также **кнопкой создания обсуждения** в меню быстрых действий. Открывается модальное окно ввода темы обсуждения; поскольку обсуждение создаётся из существующего сообщения, тема автоматически заполняется его текстом — при необходимости её можно изменить. Текст исходного сообщения отображается отдельно в начале обсуждения. Исходное сообщение над разделителем «Начало обсуждения» — такой же комментарий, как в ленте: у него есть панель действий по наведению, контекстное меню, ответ и редактирование. Если в категории или чате включены реакции, их можно поставить и снять прямо здесь — в том числе когда реакций на сообщении ещё не было. Набор реакций в ленте и внутри обсуждения совпадает сразу, без обновления страницы: поставленная в одном месте появляется в другом. При выключенных реакциях выбор эмодзи недоступен. В обсуждении, созданном вторым способом — из окна «Все обсуждения», без исходного сообщения, — служебная запись о начале обсуждения внутри не показывается: сразу после темы идут разделитель и обычные сообщения. **Из задачи без привязки к сообщениям.** На панели инструментов карточки задачи есть **кнопка обсуждений** — она доступна всем участникам задачи. Рядом с кнопкой указано количество активных обсуждений; отсутствие числа означает, что обсуждений ещё нет либо все закрыты. По нажатию открывается модальное окно **«Все обсуждения»** со строкой поиска вверху (поиск по названию обсуждения) и тремя вкладками: | Вкладка | Содержимое | |---|---| | **Все** | Все созданные в задаче обсуждения | | **Активные** | Только открытые обсуждения | | **Закрытые** | Только завершённые обсуждения, выделены серым цветом; оставлять в них новые сообщения нельзя | Из этого же окна можно создать новое обсуждение. Нажатие на строку списка открывает выбранное обсуждение. В строке каждого обсуждения справа выводятся счётчики: непрочитанные сообщения, вопросы к вам (красный) и вопросы от вас (зелёный). **Закрытие и переоткрытие.** Активное обсуждение закрывается через ПКМ по строке списка → **«Закрыть обсуждение»**. Закрытое обсуждение можно переоткрыть через ПКМ → **«Открыть обсуждение»**. Обсуждение, в котором последнее сообщение отправлено более 2 недель назад, закрывается автоматически. **Удаление.** Удалённое обсуждение исчезает из списка вместе со всеми сообщениями, а в задаче создаётся служебная запись «Обсуждение удалено» от имени пользователя, выполнившего удаление. Запись видна как обычное системное сообщение во вкладках «Лента» и «Журнал» — без префикса «Начато обсуждение», без ссылки и без перехода в удалённое обсуждение. Уведомления по ней не рассылаются. Чужим ответом считается сообщение другого участника внутри обсуждения. Служебная запись о начале обсуждения создаётся системой от лица автора и чужим ответом не считается, поэтому сама по себе права автора не отнимает. Как только в обсуждении ответил кто-то другой, автор удалить его уже не может — остаются владелец, администратор и модератор чата, а также участник с правами администратора категории. Если прав не хватает, удаление отклоняется целиком: обсуждение и все его сообщения остаются на месте — ничего не удаляется. Подробнее — в разделе «Удаление комментариев» в конце документа. **Тема обсуждения.** Тему можно отредактировать в любой момент — пункт доступен по кнопке **Дополнительные действия** в панели инструментов обсуждения. Отредактировать тему может только автор обсуждения. После создания обсуждение отображается в ленте под исходным сообщением. В задачу также отправляется системное сообщение без адресата с текстом **«Начато обсуждение»** и активной ссылкой на него; уведомления о нём зависят от настроек уведомлений в задаче, но само сообщение всегда попадает в список непрочитанных. Под веткой обсуждения показывается последнее написанное сообщение, справа — общее количество ответов и индикатор непрочитанных. Каждый подписчик задачи может перейти в обсуждение и принять в нём участие. ### Шапка открытого обсуждения Под названием открытого обсуждения показываются автор, подпись «Создано обсуждение» и дата и время его создания. Строка одинакова, когда обсуждение только что создано из окна создания, открыто нажатием на его превью в ленте задачи или чата либо выбрано в окне «Все обсуждения», и остаётся такой же после перезагрузки страницы. Правило действует независимо от способа создания: и для обсуждения, начатого от существующего сообщения, и для обсуждения, созданного через «+» без исходного сообщения. Если обсуждение начато от сообщения, само исходное сообщение показывается отдельно в начале треда, а подпись в шапке сообщает об авторе и времени создания обсуждения. **Создание обсуждения через смарт-действие** Доступно как смарт-действие «Создать тред» в смарт-автоматизации. **Права** | Действие | Кто может | |----------|-----------| | Создать тред | Любой участник задачи | | Закрыть | Автор, Owner, Admin, Moderator | | Удалить | Автор — пока в обсуждении нет чужих ответов; Owner/Admin/Moderator чата — любое; администратор категории — любое | **Удаление обсуждения в интерфейсе.** Пункт «Удалить» есть в меню действий обсуждения: в карточке треда в ленте, в шапке открытого обсуждения и в окне со списком всех обсуждений задачи или чата. Отдельного права «удалить обсуждение» нет: пункт показывается ровно тогда, когда пользователь вправе удалить каждое входящее в обсуждение сообщение по обычному правилу удаления чужих сообщений. Поэтому автору обсуждения и владельцу обычной задачи кнопка доступна, только пока в обсуждении нет ответов других участников, а в групповом чате владелец, администратор и модератор удаляют обсуждение целиком, потому что их роль позволяет удалять чужие сообщения. Служебное сообщение о начале обсуждения чужим ответом не считается. Пункт открывает окно подтверждения. После подтверждения обсуждение удаляется вместе со своими сообщениями и вложениями: открытая панель обсуждения закрывается, сам тред исчезает из списка обсуждений, а в ленту добавляется системная запись «Обсуждение удалено». Если сервер отказал — например, по правам, — показывается сообщение об ошибке, а обсуждение остаётся на месте. ## Вопрос-ответ Любое сообщение можно пометить как вопрос — тогда у адресата появится счётчик неотвеченных вопросов и сообщение выделится цветом. Входящий вопрос подсвечивается красным, исходящий (от вас) — зелёным. ![Входящий вопрос (розовый фон) — требует ответа](https://help.1forma.ru/help-images/comments/tickers_and_notifications-16.png) **Подсветка ответа на ваш вопрос.** Непрочитанный ответ на ваше сообщение выделяется в ленте информационным цветом, но только если исходное сообщение было вопросом: подсветка отвечает на вопрос «мне ответили?», а не «кто-то что-то написал после меня». Если исходное сообщение вопросом не было, ответ ему не подсвечивается. Подсветку видит только автор вопроса: получателям в копии и подписчикам задачи ответ так не выделяется. Собственные сообщения не подсвечиваются, а ответ, помеченный как вопрос, сохраняет цвет вопроса — красный или зелёный. Выделение снимается, как только сообщение прочитано. Правило работает во всех видах ленты — в карточке задачи, в чате и в представлениях категории. **Состояния вопроса** | Состояние | Что значит для пользователя | |---|---| | Комментарий помечен как вопрос | Автор отправил сообщение с запросом ответа | | На вопрос дан ответ | Кто-то ответил, и вопрос считается закрытым | | Конкретный получатель должен ответить | В счётчике этого пользователя есть требование ответа | Быстро открыть все активные вопросы к вам или ваши собственные можно чипами над лентой — см. «Фильтр неотвеченных вопросов». ![Исходящий вопрос (зелёный фон) — отправлен вами](https://help.1forma.ru/help-images/comments/tickers_and_notifications-17.png) **Действия с вопросом** Управлять состоянием вопроса можно так: 1. **Пометить сообщение как вопрос.** Автор отправляет комментарий с включённым флажком «Нужен ответ» — у всех адресатов (явных, не в копии) появляется требование ответить. 2. **Ответить на вопрос.** Любой адресат отвечает на вопрос текстом — вопрос автоматически помечается как отвеченный, требование ответа снимается у всех. 3. **«Вопрос не мне».** Адресат может убрать требование ответа лично для себя через контекстное меню сообщения. Если ни у кого больше не осталось требования ответить — вопрос автоматически помечается как отвеченный. 4. **Пометить как отвеченный вручную.** Автор может явно отметить свой вопрос как отвеченный через контекстное меню. 5. **Массово отметить все мои вопросы отвеченными.** В разделе входящих доступно действие «Отметить все мои вопросы отвеченными» (`POST /api/comments/mark-all-as-answered`). С версии **2.268.336** оно закрывает **только авторские** вопросы пользователя — `Comments.IsAnswered` и все `CommentRecipients` симметрично, как при ручной пометке. Персональные записи во входящих чужих вопросах (когда пользователь — один из адресатов) **не меняются**: для отказа от конкретного входящего используйте «Вопрос не мне». До 2.268.336 действие затрагивало и авторские, и входящие, из-за чего у других адресатов того же `commentId` записи рассинхронизировались, а через 30 дней фоновая процедура архивации могла переносить целые группы получателей в архив — на одном из клиентских стендов баг привёл к потере 154 `commentId` и ещё 14 находились в очереди на потерю. ```mermaid stateDiagram-v2 [*] --> Обычное Обычное --> Вопрос : пометить «Нужен ответ» (требование у всех адресатов) Вопрос --> Отвечен : адресат ответил (требование снято у всех) Вопрос --> Отвечен : автор пометил отвеченным (вручную или массово) Вопрос --> Вопрос : «Вопрос не мне» — снять требование лично Вопрос --> Отвечен : больше ни у кого нет требования ответить ``` **Ответ на входящий вопрос: автор вопроса не удаляется из адресатов** Если вопрос был задан вам (вы указаны в поле «Кому»), при ответе автор вопроса остаётся среди получателей — удалить его нельзя: - чип автора вопроса в полях «Кому» и «Копия» подсвечен светло-красным фоном, как сам вопрос; - крестик удаления на чипе недоступен; - контекстное меню (ПКМ) позволяет перенести автора вопроса между «Кому» и «Копия», но не удалить его; - очистить поле или выбрать «Только этому адресату» без автора вопроса нельзя; - отправить ответ «никому» или только другим получателям нельзя — автор вопроса обязательно остаётся в «Кому» или «Копия». Правило действует только для неотвеченного входящего вопроса. Для собственных и уже отвеченных вопросов чип не подсвечивается и удаление доступно как обычно. ## Автодетекция вопроса Система автоматически ставит флажок «Нужен ответ» при наборе текста, если: - пользователь не переключал флажок вручную в этом сеансе, - категория разрешает вопросы, - выбран хотя бы один получатель или открыт приватный чат. Текст признаётся вопросом по одному из 4 правил (достаточно одного): | # | Правило | Примеры | |---|---------|---------| | 1 | Символ `?` в тексте | «Это работает?», «Когда будет готово?» | | 2 | Вопросительные слова в начале строки (RU + EN) | «Когда будет готово», «Как это работает», «Could you check», «Is there a way» | | 3 | Императивные просьбы (RU) | «Подскажите», «Прошу уточнить», «Сообщите» | | 4 | Императивные просьбы (EN) | «Please let me know», «Kindly confirm» | Императивные правила (RU) срабатывают по конкретным перечням: - **Глаголы в повелительном наклонении на `-ите`/`-и`** в начале строки или предложения: «покажите»/«покажи», «узнайте»/«узнай», «сделайте»/«сделай», «отправьте»/«отправь», «направьте»/«направь», «верните»/«верни», «переделайте»/«переделай», «исправьте»/«исправь», «поправьте»/«поправь», «обновите»/«обнови», «дополните»/«дополни», «подготовьте»/«подготовь», «согласуйте»/«согласуй», «подтвердите»/«подтверди», «предоставьте»/«предоставь», «организуйте»/«организуй», «переведите»/«переведи», «настройте»/«настрой», «выгрузите»/«выгрузи», «загрузите»/«загрузи». - **Слово «Пожалуйста»** в сочетании с глагольными корнями: «покаж», «узнай», «сделай», «отправ», «направ», «верн», «исправ», «поправ», «обнов», «дополн», «подготов», «согласу», «подтверд», «предостав», «настро», «выгруз», «загруз». - **«Прошу» + инфинитив**: «показать», «узнать», «сделать», «отправить», «исправить», «поправить», «обновить», «дополнить», «подготовить», «согласовать», «организовать», «перевести», «настроить», «выгрузить», «загрузить». **Настройка пользователя** Автодетекцию можно отключить в профиле: **Профиль → Прочее → «Не помечать сообщение как вопрос автоматически»**. После этого флажок «Нужен ответ» автоматически не ставится. При ручном переключении флажка настройка не мешает. **Ссылки в комментариях (Comment Links)** **Обзор** При создании или редактировании комментария система автоматически извлекает из текста два типа ссылок: | Тип | Как распознаётся | Пример | |-----|-----------------|--------| | Ссылка на задачу | `#номер` в тексте | `#12345` | | Внешний URL | Полный адрес `https://...` | `https://example.com/page` | | Домен без протокола | Последняя часть адреса — существующая доменная зона | `yandex.ru` — открывается как `https://yandex.ru` | | Ссылка на сообщение | `#!номер` в тексте | `#!12345` | **Автопарсинг и ручные ссылки** По умолчанию система сама извлекает ссылки из текста (автопарсинг). Через SmartAction «Написать комментарий» можно управлять тем, показываются ли найденные ссылки в UI (параметр «Показывать найденные ссылки»). Скрыть найденные ссылки можно не только действием: при отправке комментария через API и через инструмент AI-агента превью-карточки выключаются отдельным признаком. У комментариев агента карточки скрыты по умолчанию, у запросов через API — нет, поэтому привычное поведение интерфейса не меняется. Скрытие не удаляет ссылку: адрес остаётся кликабельным в тексте, а запись о ссылке сохраняется в задаче; карточка связи с задачей платформы подчиняется тому же признаку. Все ссылки, найденные в комментариях задачи, — внутренние ссылки на задачи и внешние адреса — собраны на отдельной вкладке «Ссылки» блока вложений задачи (см. «Блок «Файлы» в карточке задачи» в домене «Файлы»); ссылки со скрытыми превью на вкладку не попадают. Признак учитывается при создании комментария — если позже отредактировать его текст, ссылки разбираются заново и карточки возвращаются. **Ссылки без протокола.** Домен, написанный в комментарии без протокола — например `yandex.ru` — распознаётся как ссылка и открывается по адресу с `https://`. Дописывать протокол вручную не нужно. Для таких ссылок, как и для адресов с `http://` или `https://`, подгружается превью-карточка страницы. Если сайт по https не отвечает — соединение не устанавливается, имя не разрешается, соединение сбрасывается или истекает время, — система один раз повторяет запрос по http, и сайты, доступные только по http, продолжают показывать превью. Если же сайт по https отвечает и отвечает перенаправлением на http, повтора не будет: понижение схемы запрещено, и превью не появится. Для сайтов, которые сами уводят с http на https, пишите адрес сразу с `https://`. **Фоновый разбор ссылок.** Домен без протокола подхватывает не только момент сохранения комментария: фоновый разбор по истории комментариев тоже находит такие адреса и создаёт по ним связь-ссылку. Поэтому у комментариев, сохранённых до появления распознавания доменов без протокола, со временем также появляется связь-ссылка — без ручных действий автора. Уже разобранные комментарии (у которых связь-ссылка уже есть) повторно не обрабатываются, а новые разбираются как обычно. Дата и время, к которым «догон» доходит, зависят от положения фонового разбора, поэтому точный момент появления связи заранее неизвестен. Ссылкой становится только домен, зона которого есть в справочнике доменных зон и не совпадает с именем файлового расширения, и в самом домене есть хотя бы одна буква. Полный список расширений-исключений — 28 зон: `zip`, `mov`, `app`, `dev`, `md`, `sh`, `so`, `rs`, `java`, `ai`, `pl`, `ps`, `py`, `map`, `docs`, `video`, `cc`, `pm`, `ml`, `am`, `mk`, `in`, `as`, `sv`, `la`, `gd`, `st`, `to` — приведён в разделе [«Ограничения и поддержка на платформах»](https://help.1forma.ru/domains/comments/text-formatting.md). Поэтому ссылками не становятся даты (`15.02`, `15.02.2024`), дробные числа (`1.5`), IP-адреса (`8.8.8.8`), имена файлов (`файл.txt`, `main.cc`, `Module.pm`, `config.h.in`) и строки вида `function.onload`. Знаки препинания после адреса в ссылку не входят. Исключение действует на зону целиком: в зонах `cc`, `pm`, `ml`, `am`, `mk`, `in`, `as`, `sv`, `la`, `gd`, `st`, `to` обычным текстом остаются и настоящие сайты — `site.in`, `example.to`, `site.la`. Такой адрес оформляется ссылкой, если указать его с протоколом (`https://site.in`). Правило действует только на текст при чтении: ссылки, уже сохранённые для старых комментариев, остаются в карточке задачи, поэтому в комментарии, написанном до изменения, имя файла может по-прежнему показываться ссылкой. Если превью для адреса получить не удалось — например, это внутренний сайт компании, — комментарий всё равно отправляется сразу: ожидание превью отправку не задерживает. ### Прямая ссылка на сообщение и на обсуждение Сообщение и обсуждение можно передать ссылкой — двумя способами. **Из меню сообщения.** Чтобы скопировать ссылку на сообщение, откройте его контекстное меню правой кнопкой мыши, выберите **«Переслать»**, затем — **«Копировать ссылку»**. В подменю пункт стоит после **«В текущую задачу»** (в чате — **«В текущий чат»**) и перед **«Ещё»**. Ссылка копируется в буфер обмена и открывает нужное место переписки. В шапке и в списке обсуждений действие «Копировать ссылку» остаётся доступным в своих меню. Пункт «Копировать ссылку» доступен там, где показывается «Переслать»: если «Переслать» недоступен, скопировать ссылку через это подменю нельзя. **В тексте сообщения.** Запись `#!` с номером сообщения — подробнее в разделе [форматирование текста](https://help.1forma.ru/domains/comments/text-formatting.md) — становится ссылкой на это сообщение. Как ведёт себя переход: | Что указано в ссылке | Что происходит | |----------------------|----------------| | Задача и сообщение | Открывается чат, лента прокручивается к сообщению и подсвечивает его | | Задача, сообщение и обсуждение | Сначала раскрывается обсуждение, затем лента прокручивается к сообщению внутри него | | Задача и обсуждение, без сообщения | Открывается само обсуждение; прокрутки к конкретному сообщению нет | Если сообщения нет в загруженной части ленты, она подгружает переписку вокруг него сама — нажимать ничего дополнительно не нужно. Если сообщение удалено или загрузить его не удалось, чат открывается, но показывается сообщение об ошибке, а номер сообщения и обсуждения убираются из адреса — ссылку можно переслать заново, без старой привязки. Нажатие с `Ctrl` или `Cmd` открывает сообщение в новой вкладке. Переход работает в веб-интерфейсе: в мобильных приложениях запись `#!12345` остаётся текстом. ## OpenGraph-превью (сниппеты) **Как показывается картинка превью.** Картинка из метаданных страницы выводится в одном из двух видов. Прямоугольная — обложка, баннер, картинка страницы — показывается крупно, во всю ширину карточки превью под её текстом и без искажения пропорций. Квадратная или совсем маленькая картинка показывается небольшой, фиксированного размера, у правого края карточки: заголовок ссылки обтекает её, а описание идёт ниже на всю ширину. Значок сайта для этих карточек не используется. Как показывать картинку, решает тип, определённый при разборе страницы. Для внешних URL-ссылок доступно автоматическое формирование превью: система загружает страницу, извлекает заголовок, изображение и другие Open Graph-метаданные, и показывает карточку-превью прямо в ленте. **Требование:** функция работает только если на сервере разрешены исходящие HTTP-запросы. Если превью не формируется — обратитесь к администратору сервера. Превью-карточка строится загрузкой самой страницы. Если страница или её распакованный ответ превышает предел размера, либо адрес ведёт в служебную или приватную сеть, карточка не показывается; ссылка в тексте остаётся обычной кликабельной ссылкой, а другие ссылки того же комментария разбираются как обычно. Разбор обычных страниц этим ограничением не затрагивается. **Почему превью может не появиться.** Во всех случаях ссылка в тексте остаётся кликабельной, остальные ссылки того же комментария разбираются как обычно, а отправка сообщения не задерживается. | Причина | Как выглядит | Что делать | |---|---|---| | Сайт по https отвечает перенаправлением на http | превью нет | написать адрес с `https://`, если сайт поддерживает https | | Цепочка перенаправлений длиннее десяти | превью нет | проверить адрес: обычно это ссылка через сокращатель или редирект-петля | | Перенаправление без адреса перехода | превью нет | обратиться к владельцу страницы: сайт отдаёт некорректный ответ | | Адрес ведёт в служебную или приватную сеть | превью нет | это защита: превью внутренних адресов не строится | | Страница или её распакованный ответ больше предела | превью нет | превью тяжёлых страниц не строится | | Исходящие HTTP-запросы на сервере запрещены | превью нет ни для одной ссылки | включить исходящие HTTP-запросы на сервере | **Права доступа** - **Создание/редактирование** ссылок: только автор комментария, если есть доступ к задаче. - **Чтение** ссылок: любой, кто имеет доступ к задаче. --- **Оценки исполнителей** В категориях с включённым режимом оценки исполнителей заказчик после завершения задачи может оценить работу каждого исполнителя по **пятибалльной шкале**. | Аспект | Правило | |---|---| | Кто оценивает | Заказчик задачи | | Кого оценивает | Каждый исполнитель (кроме себя, если заказчик сам является исполнителем) | | Обязательность комментария | Заказчик **обязан** прокомментировать оценку | | Видимость оценок | Открытые (всем) или закрытые (только пользователям с соответствующим правом) | | Где отображаются | Комментарии к оценке показываются в ленте комментариев задачи | Оценка проставляется из карточки задачи или из ленты задач и комментариев. **Геолокация в комментариях** Если в профиле включена геолокация и мобильное устройство дало разрешение на определение местоположения, при отправке комментария через мобильное приложение к сообщению прикрепляются координаты. В веб-интерфейсе в контекстном меню такого комментария появляется пункт **Посмотреть в Google картах** — по нажатию откроется карта с указанием места, откуда было отправлено сообщение. Функция работает только при одновременном выполнении двух условий: геолокация включена в настройках профиля **и** устройство разрешило приложению доступ к местоположению. ## Опросы (SurveyJS) В специально настроенных категориях поддерживается проведение опросов и тестирований через интеграцию с SurveyJS. **Создание опросов** Опросы создаются в визуальном редакторе (конструктор SurveyJS) в категории-каталоге опросов. Поддерживаются: - Текстовые поля, чекбоксы, радиокнопки, загрузка файлов и другие типы вопросов - Логика прохождения (разветвление, пропуск вопросов) - Таймер на прохождение - Отображение правильных/неправильных ответов - Перемешивание вопросов для тестирований - JSON-редактор для гибкой настройки ## Редактор опросов В пользовательском режиме в категории-каталоге опросов доступна кнопка **Редактор**. По её нажатию открывается редактор, в котором можно создавать, настраивать и предварительно тестировать логику прохождения опросов. Редактор разделён на вкладки. | Вкладка | Назначение | |---|---| | **Обзор конструктора** | Визуальное построение структуры опроса: добавление страниц, вопросов разных типов (текстовые поля, чекбоксы, радиокнопки и др.), вариантов ответов, управление порядком следования. Новый вопрос добавляется перетаскиванием элемента из левой панели. Панель общих настроек по умолчанию раскрыта, её можно скрыть и раскрыть повторно. Изменения сохраняются кнопкой сохранения; есть кнопки отмены и повтора последнего изменения | | **Тестировать опросник** | Просмотр опроса с точки зрения респондента перед сохранением | | **Логика опросника** | Настройка логики работы: условия отображения вопросов в зависимости от ответов, ветвления, динамическое изменение содержимого | | **JSON редактор** | Гибкая настройка опроса через JSON | На вкладке **«Тестировать опросник»** в панели инструментов доступны: - **Кнопка выбора устройства** — переключение между типами устройств для проверки адаптивности; размер окна автоматически подстраивается под выбранный формат экрана. - **Кнопка смены ориентации** (книжная/альбомная) — изменяет ориентацию экрана устройства; недоступна в десктопном режиме. - **Кнопка показа скрытых элементов** — делает видимыми служебные блоки, инструкции, логические триггеры и прочие невидимые для обычных пользователей части опроса; полезна для диагностики логики. Повторное нажатие снова скрывает элементы. На вкладке **«JSON редактор»** в панели инструментов: кнопка загрузки файла `.json` с устройства для вставки в редактор, кнопка скачивания текущего скрипта и кнопка копирования кода со страницы в буфер обмена. ### Динамические варианты ответа по ссылке В вопросах опроса (SurveyJS) варианты ответа можно подставлять из внешнего для формы источника — по адресу (URL) списка: при открытии опроса браузер респондента запрашивает этот адрес и показывает полученные варианты. Подгрузка выполняется, только если адрес ведёт на тот же сервис (origin), с которого открыт опрос, — совпадают схема, хост и порт. Относительный адрес (путь к API своего стенда) подходит; абсолютный адрес другого сайта, порта или схемы не запрашивается. Поэтому в опросе указывайте относительный путь или адрес того же стенда, где работает 1Форма. Если адрес не подходит или источник недоступен, динамическая подгрузка для вопроса отключается — показываются статические варианты ответа, если они заданы. ## Прохождение опроса Задачи на прохождение создаются для каждого участника. В карточке задачи доступна кнопка **Пройти опрос**. Администратор может настроить видимость кнопки **Пройти опрос** для ролей в задаче и групп пользователей на различных статусах задачи. Кнопку видит только ответственный исполнитель задачи и только пока у него нет завершённого результата. Если доступ к кнопке не настраивали, она показывается ответственному исполнителю на всех статусах; настроенная матрица может скрыть кнопку и у него. ⚠️ В задаче обязательно должен быть назначен ответственный исполнитель — прохождение разрешено только ему. Каждая задача предназначена для одного исполнителя. **Режимы сохранения:** - По умолчанию — результат сохраняется только при полном завершении опроса и нажатии **Готово** - При разрешённом частичном прохождении — каждый ответ сохраняется автоматически, при повторном входе пользователь продолжает с места остановки После завершения повторное прохождение недоступно. 🗂️ Файлы-вложения в ответах на вопросы типа «Загрузка файла» корректно сохраняются и восстанавливаются при частичном прохождении — даже при очистке кеша браузера или работе в режиме инкогнито. Настройка вопроса «Хранить содержимое файла в формате JSON как текст» не обязательна для корректного отображения. Исправлено в сборке 2.264 «Кассиопея». **Результаты** Результаты отображаются в карточке задачи в виде древовидной таблицы (вопросы сгруппированы по страницам). Администратор может настроить видимость блока результатов для ролей в задаче и групп пользователей на различных статусах задачи. Наличие результата определяется по задаче, а не по её ответственному исполнителю: как только в задаче появляется завершённый результат опроса, признак наличия результата взводится для задачи и не теряется при смене ответственного исполнителя. Доступ к самому содержимому результата определяет матрица видимости блока результатов: участник с правом просмотра видит завершённый результат, даже если этот опрос он не проходил. Для анонимного опроса поведение прежнее — чужой отдельный ответ без указания результата не отдаётся. Запись ответа не изменилась: проходить опрос и сохранять ответ может только ответственный исполнитель. Блок виден любому участнику задачи, которому матрица разрешает просмотр: собственный результат для этого не нужен, поэтому блок доступен и тем, кто опрос не проходил, — заказчику, проверяющему, другим исполнителям. Обязательное условие — в задаче есть хотя бы один завершённый результат: пока его нет, блок не показывается никому. Если доступ к блоку не настраивали, он показывается всем, у кого есть доступ к задаче. По умолчанию необязательные вопросы без ответа скрыты. Чтобы их показать, нужно нажать **кнопку показа вопросов без ответов** справа от индикатора прохождения. При сворачивании блока результатов эта кнопка скрывается. Также доступны сводные таблицы и графики. Опросы могут быть персонализированными и анонимными. **Лента сообщений в задаче** Блок «Лента» в карточке задачи отделён синей полосой — это позволяет сразу увидеть, где в задаче начинаются сообщения. **Вкладки ленты** ![Вкладки ленты сообщений в карточке задачи](https://help.1forma.ru/help-images/comments/block_comments-01.png) | Вкладка | Что показывает | |---------|---------------| | **Лента** (по умолчанию) | Все типы событий и сообщения с учётом настроек пользователя | | **Закреплённые** | Только закреплённые сообщения задачи. Вкладка есть, пока в задаче есть закреплённые | | **Сообщения** | Только пользовательские сообщения | | **Журнал** | Системные события (без сообщений пользователей) | | **Все** | Все события вне зависимости от настройки «Видно в ленте» | **Вкладки, когда не помещаются.** Если для всех вкладок не хватает ширины — лента открыта в правой панели таблицы, левый сайдбар развёрнут или окно узкое, — вкладки не обрезаются и не уходят за край панели. Непоместившиеся собираются под кнопкой **«Ещё»** с раскрывающимся списком: у активной вкладки в списке стоит галочка, а выбор вкладки из списка сразу открывает её. Состав списка пересчитывается при изменении ширины — после сворачивания или разворачивания сайдбара вкладки возвращаются на полосу без перезагрузки страницы. Пока все вкладки помещаются, кнопки «Ещё» на полосе нет. Правило относится к самой полосе вкладок: кнопка выбора источника сообщений, кнопка «Отметить всё как прочитанное» и чипы неотвеченных вопросов остаются на своих местах. В списке чатов поведение другое: там полоса вкладок прокручивается по горизонтали. **Источник сообщений** По кнопке меню над лентой выбирается источник: - **Текущая задача** (по умолчанию) — сообщения текущей задачи - **Из подзадач** — сообщения подзадач уровнем ниже - **Используется** — сообщения задач, где данная задача выбрана в ДП ![Меню выбора источника сообщений](https://help.1forma.ru/help-images/comments/block_comments-02.png) Если выбран источник, отличный от умолчания, на кнопке отображается синяя точка. Кнопка «Отметить всё как прочитанное» автоматически прочитывает все новые сообщения в ленте задачи; если задача открыта из ленты непрочитанных, её строка в фоновом списке этой ленты сразу меняет начертание на обычное, без перезагрузки страницы. **Фильтр неотвеченных вопросов.** Над лентой, рядом с вкладками, могут быть два чипа со счётчиком: «Входящие» — неотвеченные вопросы к вам, «Исходящие» — неотвеченные вопросы, которые поставили вы. Чип появляется, только если таких вопросов больше нуля, а число на нём — по всей задаче, а не только по уже загруженным сообщениям. Нажатие оставляет в ленте только вопросы этого чипа. Повторное нажатие возвращает обычную ленту, нажатие другого чипа переключает отбор. Поиск по тексту при этом сохраняется: остаются сообщения, которые подходят и по чипу, и по строке поиска; снятие чипа поиск не очищает. Чипов нет на вкладках «Журнал» и «Закреплённые»: при переходе туда отбор снимается. На узком экране и в мобильном режиме чипы тоже скрыты; вкладки, источник сообщений и поиск остаются. Пока чип включён, настройка «Фильтровать комментарии в задаче согласно настройкам ленты» не применяется. ## Сортировка ленты По умолчанию комментарии отображаются в **обратном хронологическом порядке** (свежие сверху). Стрелки в шапке ленты переключают порядок на прямой и обратно. **Фильтрация по типам сообщений** Настройка `Все типы событий` на вкладке «Уведомления» в профиле пользователя: - **Включена** — в ленте отображаются комментарии **всех типов**, независимо от персональных настроек. - **Выключена** — отображаются только типы, отмеченные флажком «Видно в ленте». Связана с настройкой профиля **«Фильтровать комментарии в задаче согласно настройкам ленты»**: настройки фильтрации действуют на все задачи в категории; в разных категориях могут отличаться. Фильтрация влияет только на **отображение** — комментарии всех типов всегда публикуются и хранятся. Изменив настройки, можно увидеть ранее скрытые комментарии. **Адресация сообщений** Каждое сообщение отправляется в рамках задачи или чата. У сообщения один автор и несколько адресатов. | Адресат | Поведение | |---------|-----------| | **Явный** (поле «Кому») | Сообщение помечается непрочитанным у адресата | | **Копия** | Получает сообщение, но «непрочитанным» не помечается | | **Всем** | Отправить всем подписчикам задачи | | **Никому** | Сообщение всегда попадает в список непрочитанных, уведомление — по настройкам категории | > Рекомендуется всегда отправлять сообщения адресно — указывая конкретных адресатов. Если сообщения отправляются всем подписчикам задачи, пользователи получают много лишних сообщений, воспринимают их как спам и читают невнимательно — так легко пропустить важную информацию. По умолчанию в выборе адресатов отображаются только подписчики задачи. Для выбора других пользователей — ввести имя в строку поиска. Поиск работает по имени, фамилии и основной должности. Начиная с версии 2.265 «Цефей» в выпадающем списке под именем и фамилией пользователя отображаются его основная должность и отдел, что ускоряет поиск нужного человека в организациях с большим числом сотрудников. **Отправитель в числе адресатов.** Если пользователь явно указал себя в поле «Кому» или «Копия», он остаётся в адресатах отправленного сообщения: его строка есть в шапке и показывается одинаково в ленте, в ответе и в пересылке — и сразу после отправки, и после перезагрузки страницы. Своё сообщение ему при этом не приходит: строка отправителя помечается прочитанной и не попадает ни в уведомления (пуш, почта), ни в счётчик непрочитанного. Исключение — отправка с включённым «Принудительно на почту»: тогда письмо приходит и ему. В списке получателей по правой кнопке и в счётчике «прочитали» он виден так же, как при отправке сообщения только себе. Если себя указать и в «Кому», и в «Копия», в шапке он отобразится только в «Кому». То же верно рядом с тегом «Всем»: отправитель, назвавший себя вместе с «Всем», показывается в шапке как явно указанный адресат — в «Кому» это «Имя, Всем», в «Копии» — «Всем (Имя)». **Ограничения сохранения состава адресатов.** Явно указанное «Себе» отображается в шапке, если отправитель выбран в «Кому» вместе с другими адресатами или указан только в «Копии». В этом случае собственное сообщение отправителя автоматически считается прочитанным и не создаёт ему обычное уведомление; при включённой принудительной отправке на почту отправитель получает письмо. Если отправитель выбран одновременно в «Кому» и «Копии», он отображается только в «Кому». Одиночное «Себе» в «Кому» работает как прежде. Шапка показывает состав, который система сохранила для сообщения, но некоторые совпадающие адресаты не сохраняются отдельными чипами. Если один и тот же пользователь указан в «Кому» и «Копии», пользователь явно выбран внутри добавленной группы или группы пересекаются, часть исходных чипов может не отобразиться: исходный состав уже потерян при записи. Отображение после перезагрузки, ответа или пересылки эти чипы не восстанавливает. Доставка участникам группы при этом не страдает — речь именно о сохранении исходного состава для шапки. **Выбор групп** в поле адресатов доступен только сотрудникам компании и администраторам категории. **Меню группы в полях «Кому» и «Копия».** По правой кнопке мыши на чипе группы доступны два пункта. «Посмотреть участников» открывает окно с составом группы. «Развернуть список» заменяет группу её участниками: чип группы убирается, а вместо него в поле подставляются пользователи из её состава; те, кто в этом поле уже указан, повторно не добавляются. Пункт «Развернуть список» есть только у групп — у чипа пользователя его нет. Если состав группы пуст или получить его не удалось, поле не меняется и группа остаётся на месте. **Действия с чипом адресата.** Крестик на чипе убирает только этого адресата — остальные остаются на месте в прежнем порядке. Клик по имени в чипе, а не по крестику, наоборот оставляет только этого адресата, а остальных убирает из поля. Чипы, которые удалить нельзя, — например, чип автора неотвеченного входящего вопроса, — при этом остаются: у них нет крестика, и клик по имени их не снимает. **Отметки в списке выбора адресата.** Уже выбранный адресат в раскрытом списке не помечен: отметка снимается сразу после выбора. Поэтому список показывает только то, что происходит сейчас, — если адресат убран из поля, его строка отмечена не будет. Это верно и для удаления последнего адресата, и когда выбрано несколько: в поле может стоять чип, а в списке не будет отмечено ни одной строки. О том, кто выбран, видно по чипам в самом поле. Снятого адресата можно выбрать снова — он добавится обычным чипом, как при первом выборе. **Где открывается список выбора адресата.** Список в полях «Кому» и «Копия» открывается в ту сторону, где он помещается целиком: если места под полем хватает, список идёт вниз, если нет — вверх, над полем. Это работает и при первом открытии сразу после загрузки страницы, и при повторном. Пока список сотрудников догружается, в панели видны только индикатор загрузки и пункт «Всем»; когда подписчики показаны, панель сразу встаёт в выбранную сторону — обрезанного снизу списка нет. Выбор адресата кликом, поиск по имени и добавление чипа работают как раньше. **Перетаскивание адресатов.** Чипы пользователей и групп в полях «Кому» и «Копия» можно перетаскивать: внутри поля — чтобы поменять порядок, между полями — чтобы перенести адресата из «Кому» в «Копия» и обратно. Адресат встаёт туда, где его отпустили, и убирается из другого поля. Пользователя из блока «Подписчики» можно перетащить сразу в нужное место поля «Кому» или «Копия», а чип, перетащенный из поля обратно в блок «Подписчики», убирается из адресатов. **Как выглядит перетаскивание.** Пока адресат «висит» на курсоре, остальные чипы в поле расходятся, освобождая место, — видно, куда адресат встанет. Сам перетаскиваемый чип приподнимается тенью, а если чип отпустить вне полей «Кому» и «Копия», перенос считается отменой: чип возвращается на прежнее место, адресат остаётся в поле. **Порядок адресатов при отправке.** Порядок, заданный перетаскиванием, сохраняется при отправке — так его увидит получатель. Порядок хранится отдельно для сотрудников и отдельно для групп: если поставить сотрудника между группами, при отправке эти части всё равно разойдутся — сотрудники останутся вместе, группы вместе. **Адресаты в шапке сообщения.** В ленте и в чате в шапке сообщения показывается не больше пяти адресатов **в каждом из полей** — лимит «Кому» и лимит «Копии» считаются отдельно, — в порядке: пользователи, затем группы; группа занимает одно место, как и ярлык «Всем». Остальные скрыты за ссылкой «и ещё N», где N — число скрытых адресатов этого поля. Ссылка своя у каждого поля: у «Копии» она стоит внутри скобок, поэтому у сообщения может быть две ссылки — «и ещё» после имён «Кому» и своя внутри блока «Копия». Клик по любой из них раскрывает полный список этого сообщения целиком; обратно список не сворачивается, другие сообщения остаются свёрнутыми. Клик по шапке сообщения — вне имени автора и ссылок — раскрывает список так же. **Дополнительные адресаты рядом с «Всем».** «Всем» — это тег, а не сокращение фактического состава подписчиков. Сообщение, отправленное «Всем», показывается ярлыком «Всем»; если вместе с тегом в нём названы другие адресаты — любой пользователь в «Кому» или «Копии», в том числе сам отправитель и подписчик задачи, а также группа, — рядом с ярлыком выводится и этот состав. Правило действует и когда подписчика поставили вместе с тегом: его имя стоит рядом с ярлыком, как и у любого другого адресата. В один ярлык «Всем» состав сворачивается, только когда других адресатов нет. Правило одинаково в ленте задачи и в чате, и оно не зависит от числа подписчиков: ни небольшой состав, ни тег «Всем» не подменяются одним ярлыком. Видимый рядом состав на склейку соседних сообщений одного автора не влияет — они по-прежнему объединяются под одним аватаром. **Сортировка результатов поиска адресатов:** 1. Подписчики и частые собеседники (по рейтингу общения) 2. Сотрудники той же оргструктуры 3. Сотрудники компании (выше внешних пользователей) Сортировка остаётся гибкой и подстраивается под контекст (например, при поиске в конкретном чате подписчики этого чата показываются раньше). При назначении исполнителей в задачах сохранён привычный алфавитный порядок. **Отправка без адресата** невозможна для вопросов — кнопка «Как вопрос» блокируется, пока не указан адресат. **@-упоминание (визитка)** Символ `@` после пробела, начала строки или открывающей скобки раскрывает список подписчиков. Выбор добавляет пользователя в поле «Кому». После отправки @-упоминание отображается как кликабельное имя — по нажатию открывается краткая карточка пользователя. ## Панель команд (slash-команды) В поле ввода сообщения можно быстро вставить команду или шаблон ответа через панель команд. Чтобы её открыть, введите `/` в начале поля или после пробела — появится список доступных команд с фильтрацией. **Где работает.** В полях ввода сообщений — в ленте задачи, в карточке задачи и в чате. **Русская раскладка.** Если на клавише «/» набирается точка (например, в русской раскладке), нажатие этой клавиши в поле ввода подставляет «/» и открывает панель — переключать раскладку не нужно. Замена срабатывает только там, где панель открывается; в остальных местах вводится точка. Backspace сразу после замены возвращает точку. **Что показывает.** В одном списке два источника: - **шаблоны быстрых ответов** — заготовленные фразы, настроенные администратором категории; - **платформенные slash-команды** — команды Анфисы (`/clear`, `/program:`, `/format` и др.) и выбор модели. Состав зависит от роли: администратор видит весь каталог, обычный сотрудник — команды без пометки «только для админа» (в частности, выбор модели `/claude`, `/kimi` доступен только администраторам), внешний пользователь платформенные команды не получает. **Как выбрать.** Навигация — стрелками вверх/вниз, выбор — `Enter`, `Tab` или клик. Команда вставляется без пробела после неё, чтобы можно было сразу дописать параметры. Команда `/clear` при нажатии `Enter` отправляет сообщение сразу. **Несколько команд подряд.** Команды набираются через пробел, пока каждое слово начинается с `/`. Как только после пробела идёт слово без `/`, дальнейший текст считается обычным сообщением: `/clear /claude проверь задачу` **Параметры.** Параметр записывается через двоеточие без пробела. У части команд есть русские написания (`/модуль:` = `/box:`, `/программа:` = `/program:`, `/формат` = `/format`): - `/program:my-tasks-query` — запуск программы по машинному имени; - `/program:"Мои задачи" за неделю` — по человекочитаемой подписи в кавычках; - `/program:a,b` — несколько программ через запятую. **Если панель не появляется** — для текущего пользователя нет ни шаблонов быстрых ответов, ни доступных платформенных команд. **Момент загрузки данных панели.** Шаблоны быстрых ответов и список команд загружаются не при открытии чата, а при первом обращении к полю ввода — фокусе или вводе `/`; при первом вызове панели содержимое может появиться с небольшой задержкой. Список сотрудников для полей получателей загружается при раскрытии списка; если загрузка не удалась, закройте и откройте список снова — запрос повторится. Команды относятся к текущему чату: после перехода в другой чат подсказки предыдущего не показываются. В чате с Анфисой подсказки в ленте загружаются сразу при открытии — это отдельный список, и на него правило не распространяется. ### Режимы вставки готовых ответов и подсказок (чипы и шаблоны) При выборе готового ответа — кликом по чипу над полем ввода, из блока подсказок в ленте или через панель slash-команд — вставка текста в поле комментария работает в одном из трёх режимов: - **полная замена** (по умолчанию): текст подсказки заменяет весь ранее набранный текст в поле; - **добавление в конец**: текст дописывается в конец сообщения независимо от позиции курсора; если текст в поле уже был, перед вставкой добавляется пробел; - **вставка по шаблону**: текст вставляется сразу после фрагмента, найденного по заданному шаблону. Если совпадений нет или шаблон некорректен, текст в поле остаётся без изменений. **Короткие названия чипов.** На чипе может показываться короткое понятное название (например, «Service Desk»), а в поле при клике подставляется полный текст или команда (например, `/servicedesk`). Полный текст, который будет вставлен, всегда видно во всплывающей подсказке при наведении на чип. В режиме чата клик по чипу сразу вставляет текст в поле и закрывает панель подсказок; у чипов кнопки сворачивания скрыты. ## Аватар автора сообщения Рядом с сообщением показывается аватар его автора: загруженное фото, а если фото нет — инициалы. Инициалы подчиняются общей настройке цвета аватаров: в режиме «цветные» у каждого человека свой устойчивый цвет, в режиме «фирменные» все инициалы окрашены основным цветом бренда, в режиме «серые» — серым. На фотографию режим не влияет. Поверх аватара показывается точка присутствия — и в ленте задачи, и в чатах. Пока автор в сети, точка горит зелёным. Если у автора идёт отсутствие, точка окрашивается в цвет этого типа отсутствия, и тем же цветом выводится его имя. Когда автор не в сети и текущего отсутствия у него нет, точки нет. У сообщений, отправленных от имени группы, точки на аватаре нет. ## Аватар адресата в полях «Кому» и «Копия» Каждый выбранный адресат показан в поле чипом, а в раскрытом списке — строкой с аватаром, именем, должностью и подразделением. Вид аватара зависит от того, кто адресат. | Кто адресат | Аватар | Точка присутствия | |---|---|---| | Пользователь | фото, если оно загружено, иначе инициалы с устойчивым цветом | есть | | Группа, орг. единица, адрес электронной почты, группа встречи | значок соответствующего типа | нет | У пользователя точка зелёная, когда он в сети, и цвета текущего отсутствия, когда за ним зарегистрировано отсутствие с заполненным сообщением. Если человек не в сети и отсутствия нет, точки нет. Состояние обновляется по событиям присутствия, поэтому цвет имени адресата и точка показывают одно и то же. Цвет инициалов без фото подчиняется общей настройке цвета аватаров. ## Индикаторы сообщений В ленте рядом с сообщениями отображается несколько видов индикаторов — они показывают, набирает ли собеседник текст, доставлено ли сообщение и прочитали ли его. **Блок отметок у сообщения.** Рядом с сообщением справа стоит одна строка служебных отметок. В ленте они идут в порядке: звезда избранного, значок закрепления, подпись «изменено», галки прочтения, время. В чате в виде баблов время и галки меняются местами: звезда, значок закрепления, «изменено», время, галки. Порядок одинаков и в списке чата, и в представлениях чата вне него — например, в закреплённых сообщениях. Звезда появляется у сообщения, добавленного в избранное, и окрашена жёлтым на обычном фоне и приглушённым серым на цветных баблах — вопросах к вам, ваших вопросах, непрочитанных ответах и ваших сообщениях в чате. Подпись «изменено» показывается у отредактированного сообщения, галки — у собственных отправленных сообщений и меняются по мере прочтения получателями. Имя автора и блок отметок стоят одной строкой: когда ширины не хватает, отметки отодвигают имя автора или переносят его на следующую строку, а текст сообщения остаётся читаемым. У сообщений без шапки — подряд идущих от одного автора и со скрытым получателем — время и отметки стоят в одной строке с содержимым сообщения и на узкой ширине на него не наезжают: содержимым может быть текст, превью ответа, пересылка, вложение, превью ссылки, опрос или блок виджетов. Аватар, точка присутствия и отступ от аватара до текста не изменились. **Набора текста** Когда собеседник набирает сообщение, над строкой ввода появляется «ФИО печатает...». **Отправки и прочтения** После отправки в правом нижнем углу сообщения появляется значок, который меняется по мере того как адресаты его читают. | Индикатор | Состояние | |-----------|-----------| | ✓ (одинарный) | Сообщение доставлено на сервер, никем не прочитано | | ✓✓ (двойной, серый) | Прочитано кем-то из адресатов, но не всеми | | ✓✓ (двойной, синий) | Прочитано всеми получателями | Индикатор не отображается для сообщений без адресата и для чужих сообщений. Просмотр кто и когда прочитал — пункт **Прочтения** в контекстном меню. Показываются первые 5 пользователей, кнопка «Ещё» открывает полный список. Открытие «Прочтений» не только показывает список, но и выравнивает индикатор сообщения: статус пересчитывается по фактическим отметкам просмотра всех адресатов и обновляется в ленте сразу, без перезагрузки страницы. Поэтому расхождение — например, серая галка у сообщения, которое в списке уже прочитано всеми, — исчезает в тот же момент. **«Прочтения» и вкладка «Новые».** Список «Прочтения» — не только справка о том, кто прочитал сообщение. В главной ленте на вкладке «Новые» при включённом переключателе «Прочитано» прочитанное сообщение остаётся в списке, если текущий пользователь есть в его «Прочтениях»: он значится в адресатах, в копии или отмечен прочитавшим автоматически. Если пользователя в «Прочтениях» нет — сообщение собственное или адресовано только другим, — в этой вкладке оно не появится. Индикатор не отстаёт и сам, без открытия «Прочтений»: статусы галок своих сообщений актуализируются автоматически при открытии ленты, после восстановления соединения и при возврате на вкладку браузера. Если собеседник прочитал сообщения «через одно», каждая прочитанная галка обновится отдельно. **Черновик** При закрытии задачи недописанный черновик сохраняется. При повторном открытии текст восстанавливается. **Форматирование текста** При выделении текста в поле ввода появляется панель форматирования; она автоматически скрывается, как только выделение пропадает — при наборе, удалении или вставке текста с клавиатуры, навигации клавишами (стрелки, `Esc`) или клике в пустую область. Также доступен markdown — жирный `**текст**`, курсив `__текст__`, зачёркнутый, подчёркнутый, код, ссылки, заголовки, таблицы, списки, спойлер: полная таблица разметки с разбивкой по клиентам (веб, iOS, Android) — в [форматировании текста](https://help.1forma.ru/domains/comments/text-formatting.md). Специфика поля ввода комментария поверх общей разметки: `#номер` и `№номер` дают активную ссылку на задачу, `+#номер` — устанавливает связь с задачей. **Горячие клавиши форматирования:** `Ctrl/Cmd+B` (жирный), `Ctrl/Cmd+I` (курсив), `Ctrl/Cmd+U` (подчёркивание), `Ctrl/Cmd+Shift+X` (зачёркивание). Повторное применение снимает форматирование. **Вставка из внешних источников** (`Ctrl/Cmd+V`): система автоматически приводит Markdown и HTML (Word, веб-страницы) к единому виду — заголовки → жирный, маркированные списки, ссылки, переносы строк сохраняются. **Превью ссылок:** при добавлении ссылки на задачу, чат, пространство — автоматически формируется блок-превью (аватарка, текст, категория, номер). Полная ссылка на карточку задачи этой площадки превращается в такой же блок-превью при отправке комментария, поэтому ссылка, добавленная при редактировании уже отправленного комментария, превью не даёт. При добавлении внешнего URL — превью-карточка с заголовком и описанием из OG-метаданных. **Безопасность текста комментария.** Опасные фрагменты разметки не исполняются: теги (`