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

Управление изменениями

Управление изменениями в ArchiVision строится вокруг веток, синхронизации, истории действий, задач и слияния изменений в основную архитектурную модель.

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

Основной сценарий​

  1. Откройте нужную организацию и ландшафт.
  2. Убедитесь, что выбрана основная ветка master.
  3. Создайте рабочую ветку по инструкции «Создание ветки».
  4. Переключитесь в созданную ветку.
  5. Внесите изменения: создайте объекты, диаграммы, потоки данных, шаги, интерфейсы или свойства.
  6. Проверьте раздел «История» в левом меню, чтобы увидеть список внесенных изменений.
  7. Проверьте раздел «Обзор» и предупреждения качества модели.
  8. Если master или связанная рабочая ветка изменились, выполните синхронизацию и повторно проверьте решение.
  9. Если нужно согласование, создайте задачи или передайте ветку ответственному пользователю.
  10. Выполните слияние изменений в master.
  11. После слияния проверьте master-ветку и обновите share-ссылки, если изменения нужно показать внешним участникам.
Загрузка изображения...
Верхняя панель с меню ветки и выбранной рабочей веткой. В кадре видны пункты создания ветки и слияния.

Что можно менять в рабочей ветке​

В рабочей ветке можно готовить изменения без влияния на основную архитектуру:

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

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

Как проверить изменения перед слиянием​

  1. Откройте рабочую ветку.
  2. Перейдите в раздел «История» левого меню.
  3. Отфильтруйте события по текущему пользователю, периоду или типу операции.
  4. Проверьте, нет ли случайных изменений.
  5. Откройте раздел «Обзор» в левом меню.
  6. Проверьте задачи, предупреждения healthcheck и аналитику интерфейсов/потоков.
  7. Откройте измененные диаграммы и потоки данных.
  8. Убедитесь, что документация UseCase-ов строится корректно.
Загрузка изображения...
Раздел «История» с фильтрами по тексту, пользователю, операции, типу и периоду и списком изменений перед слиянием.

Слияние веток​

Слияние переносит выбранные изменения из рабочей ветки в master.

  1. Выберите рабочую ветку.
  2. Откройте меню ветки.
  3. Нажмите «Слияние».
  4. В окне различий проверьте список изменений.
  5. Выберите изменения, которые нужно перенести.
  6. Проверьте зависимости выбранных изменений.
  7. Подтвердите слияние.
  8. Переключитесь в master и проверьте результат.

Подробное описание окна различий, частичного выбора и правил переноса находится в разделе «Слияние изменений».

Когда использовать задачи​

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

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

Как откатить ошибочное изменение​

  1. Откройте ветку, где выполнено изменение.
  2. Перейдите в раздел «История» левого меню.
  3. Найдите ошибочное действие.
  4. Если кнопка «Отменить» доступна, выполните отмену.
  5. Если отмена недоступна, исправьте данные вручную или удалите рабочую ветку, если изменения еще не нужны.
  6. Проверьте объект, диаграмму или поток данных после исправления.

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

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

Изменение сделано не в той ветке​

Проверьте текущую ветку в верхней панели. Если изменение сделано в рабочей ветке, его можно не переносить в master. Если изменение попало в master ошибочно, используйте историю действий или внесите обратное изменение.

При слиянии видно слишком много изменений​

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

После слияния share-ссылка показывает старое состояние​

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

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