Перейти к основному содержимому

Чаты

Чаты в ArchiVision помогают обсуждать архитектуру рядом с моделью: на диаграмме, элементе, связи, потоке данных или другом рабочем контексте. Это снижает риск, что важное решение останется только во внешнем мессенджере и не будет связано с архитектурными данными.

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

Где используются чаты​

В обновлённом интерфейсе все активные обсуждения собраны в разделе «Чаты» слева. Он показывает число активных и непрочитанных чатов и позволяет перейти к объекту обсуждения. Пункт появляется, если в окружении доступен обычный чат, Telegram или AI.

Чат можно открыть в нескольких контекстах:

  • диаграмма — обсуждение состава схемы, уровня детализации, видимости элементов, связей и layout;
  • архитектурный элемент — обсуждение системы, контейнера, компонента, актора или специализированного элемента;
  • связь — уточнение назначения интеграции, направления, владельцев, вложенных отношений и использования в потоках;
  • поток данных — обсуждение сценария, шагов, альтернатив, параллельных веток и привязки к интерфейсам;
  • согласование слияния ветки — обсуждение готовности рабочей ветки к переносу в master;
  • запрос на слияние ветки — обсуждение выполнения переноса группой исполнителей;
  • документация — обсуждение текста, полноты спецификации и материалов для ревью;
  • задачи и изменения — уточнение требований, статуса и ответственных.

Главное правило: создавайте обсуждение там, где находится предмет разговора. Если вопрос про конкретную диаграмму, не заводите общий чат по домену; если вопрос про один элемент, используйте чат элемента.

Чаты и совместная работа на диаграмме​

Когда несколько пользователей одновременно открывают одну диаграмму, realtime-панель помогает видеть присутствие коллег и их курсоры. Чат в этом сценарии нужен для фиксации договоренностей: что решили, кто отвечает и где это будет отражено в модели.

Практический сценарий:

  1. Откройте диаграмму вместе с командой.
  2. Используйте совместную работу, чтобы показать область обсуждения курсором или follow-режимом.
  3. Создайте чат диаграммы или элемента, если вопрос требует решения.
  4. Закрепите итоговое сообщение после обсуждения.
  5. Если нужно действие, создайте задачу или внесите изменение в рабочей ветке.

Так обсуждение не теряется после встречи: визуальный контекст остается на диаграмме, а решение хранится рядом с объектом модели.

Как открыть чат диаграммы​

  1. Откройте диаграмму.
  2. В верхней панели редактора нажмите кнопку Чат с иконкой комментария.
  3. Если обсуждений ещё нет, создайте новый чат.
  4. Укажите короткое название.
  5. Напишите первое сообщение.
  6. Проверьте контекст, который система показывает в окне создания.
  7. Создайте чат.
Загрузка изображения...
Название, первое сообщение и автоматически определённый контекст диаграммы перед созданием чата.

Как открыть чат элемента или связи​

  1. Откройте диаграмму.
  2. Выберите элемент или связь.
  3. Откройте панель свойств.
  4. Перейдите на вкладку Чат, если она доступна.
  5. Создайте новый чат или откройте существующий.

Если вкладка Чат не отображается, проверьте режим доступа, настройки окружения и права пользователя. В share/read-only режиме рабочие чаты обычно недоступны.

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

Чаты процесса слияния​

Если в настройках ландшафта включено согласование или выполнение слияния через группу исполнителей, система автоматически создает чаты процесса.

Доступны два контекста:

  • чат согласования - создается при нажатии «Запросить согласование» в окне различий ветки;
  • чат запроса на слияние - создается при нажатии «Запросить слияние».

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

Используйте эти чаты для вопросов, которые влияют на решение по ветке:

  • почему изменение нужно переносить сейчас;
  • какие домены и диаграммы затронуты;
  • почему выбраны именно эти leaf-изменения;
  • нужно ли блокировать ветку до завершения переноса;
  • что доработать, если согласование или запрос отклоняются.

Не переносите обсуждение процесса в общий чат диаграммы, если решение касается всей ветки. Иначе исполнителю слияния придется собирать контекст из нескольких мест.

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

Контекст чата​

При создании чата система показывает контекст:

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

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

Участники​

В чат обычно добавляют:

  • владельца элемента или домена;
  • автора изменения;
  • архитектора решения;
  • аналитика, который описывает UseCase;
  • разработчика или технического владельца интеграции;
  • DevOps или эксплуатацию, если вопрос связан с инфраструктурой;
  • внешнего ревьюера, если ему выдан доступ.

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

Рядом с сообщениями и участниками показывается фотография из профиля. Если фотография не загружена, интерфейс использует первую букву отображаемого имени. Обновление аватара не меняет автора старых сообщений: после перезагрузки они показываются с текущей фотографией профиля.

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

Действия в чате​

В рабочем чате доступны:

  • отправка сообщений;
  • ответ на конкретное сообщение;
  • закрепление важного сообщения;
  • открепление сообщения;
  • приглашение участников;
  • просмотр участников;
  • выход из чата;
  • отметка обсуждения как решенного;
  • архивирование обсуждения;
  • повторное открытие обсуждения, если вопрос вернулся.
Загрузка изображения...
Ответ на сообщение коллеги закреплён над перепиской как итог обсуждения.

Непрочитанные сообщения и ветки​

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

В таком обзоре можно увидеть:

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

Это важно для командной работы с архитектурой: обсуждение может идти в feature-ветке, пока пользователь находится в master или в другой рабочей ветке. Счетчик помогает не пропустить вопросы, которые относятся к еще не слитому проектному решению.

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

Как пригласить участника​

  1. Откройте нужный чат.
  2. Нажмите Invite.
  3. Выберите пользователя из списка или укажите email, если приглашения по email включены.
  4. Проверьте, что у пользователя есть доступ к контексту обсуждения.
  5. Отправьте приглашение.

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

Как фиксировать решение​

После обсуждения не оставляйте итог только в чате.

В зависимости от результата:

  • измените свойства элемента;
  • обновите диаграмму;
  • создайте или исправьте поток данных;
  • привяжите шаг к интерфейсу;
  • создайте задачу ответственному;
  • согласуйте или отклоните заявку процесса слияния;
  • добавьте пояснение в документацию;
  • выполните изменение в рабочей ветке и затем подготовьте слияние.

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

Чаты и AI​

AI помогает работать с обсуждениями:

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

Если итог чата нужно превратить в документацию, откройте AI в нужном контексте и попросите подготовить текст с учетом принятого решения.

Когда использовать чат, задачу или share-ссылку​

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

Используйте задачу, если есть конкретное действие, ответственный и ожидаемый результат.

Используйте процесс слияния, если нужно формально согласовать рабочую ветку или передать перенос изменений группе исполнителей. Чат процесса в этом случае создается автоматически и связан с заявкой.

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

Подробнее о share-ссылках см. «Шаринг диаграмм».

Краевые случаи​

Кнопка Chat не отображается​

Проверьте:

  • включен ли чат в окружении;
  • открыт ли обычный режим, а не share-ссылка;
  • не включен ли read-only режим;
  • загружена ли диаграмма;
  • есть ли у пользователя доступ к выбранному объекту.

Участник не видит контекст​

Проверьте:

  • добавлен ли пользователь в нужную организацию;
  • есть ли доступ к ландшафту и домену;
  • открыт ли тот же branch-контекст;
  • если это чат процесса слияния, входит ли пользователь в нужную группу согласования или группу исполнителей;
  • не обсуждается ли объект, который был удален или ещё не слит в master.

Обсуждение решено, но проблема осталась в модели​

Чат фиксирует договоренность, но не меняет модель сам по себе. Проверьте, создана ли задача или внесено ли изменение в ветке. Для проверки фактических изменений используйте историю действий.

Чат ушел в архив по ошибке​

Откройте архивированное обсуждение и используйте Reopen, если действие доступно. Если обсуждение недоступно, проверьте права пользователя или попросите участника с нужными правами восстановить чат.

Связанные разделы​

Видеоурок: Контекстные чаты​

Практический сценарий: контекстные чаты.

Видеоурок: Совместная работа в чатах​

Практический сценарий: совместная работа в чатах.