Только изменённые вами строки
Старый долг в том же файле по-прежнему измеряет ArchScan, но он никогда не превращается в шум на вашем merge request.
- Новое нарушение: прокомментировано
- Существующий долг: без комментария
Опытный архитектор в каждом pull request.
ArchPilot включается в момент открытия pull/merge request, читает изменённый код по вашим архитектурным правилам и оставляет исправление прямо в строке комментарием ревью.
Экраны работающей установки
Путь merge request'а
Шесть шагов между вашим CI и панелью AppArch, и то и другое внутри вашей сети. Репозиторий никогда не загружается; передаются только находки.
- CI и Git
Открывается merge request
Новый MR или новый пуш в него запускает ваш пайплайн.
- CI и Git
Запускается job анализатора
Он получает набор правил из панели с уже применёнными настройками проекта и пространства.
- CI и Git
Читаются только изменённые файлы
В режиме ревью анализатор сначала определяет изменённые файлы и читает только их.
- Панель AppArch
Находки уходят в панель
Правило, файл, строка и сообщение уходят в панель; сам репозиторий никогда не загружается.
- Панель AppArch
Новая, повторная или исправленная
Панель сравнивает с предыдущим запуском: на новую находку пишется комментарий, повторная не публикуется заново, исправленная закрывается.
- CI и Git
Появляются комментарии и сводка
Комментарии прямо на нужных строках и раздел AppArch с итогами в описании MR.
Необязательный порог: выберите в панели серьёзность fail-on; как только находка её достигает, job завершается с кодом 4 после отправки результатов, и пайплайн становится красным.
Анатомия комментария
Каждый комментарий отвечает на одни и те же пять вопросов и выглядит одинаково у всех четырёх Git-провайдеров.
-
Правило и серьёзность
Какое правило и насколько серьёзно. От серьёзности зависят оценка и необязательный порог.
-
Точная строка
Комментарий стоит на строке, нарушающей правило, а не на аннотации над ней.
-
Почему это важно
Обоснование, чтобы исправление было решением, а не догадкой.
-
Предложение
Что изменить, как это предлагает анализатор.
-
Подробнее о правиле
Ссылка на страницу документации правила.
Жизнь находки в merge request
Один комментарий на находку, от первого пуша до последнего. Находки закрываются по одной: исправлением или вручную.
- НайденаПуш, который её вносит: один комментарий на строке.
- Всё ещё естьПоследующие пуши: комментарий остаётся, дубли не публикуются.
- ИсправленаСтрока больше не нарушает правило: комментарий закрывается.Закрыта вручнуюЧеловек закрывает её: она считается отклонённой, а не исправленной.
Четыре Git-провайдера, одно поведение
Комментарии публикуются от имени пользователя интеграции по умолчанию или выделенного для рабочего пространства бот-аккаунта.
GitHub GitLab Bitbucket Azure DevOps
Что у него под капотом
ArchPilot - не линтер. Он ведёт себя как архитектор, который встраивается в рабочий процесс команды без лишнего шума.
Комментарии-ревью прямо в коде
Замечание появляется ровно на нужной строке - объясняет, что не так, почему и как это исправить, совсем как живой рецензент. Вы можете ответить в треде и обсудить.
Анализ в границах diff
Проверяется только код, изменённый в этом PR/MR. Легаси-долг никогда не превращается в шум - команда сосредотачивается лишь на риске, который вносит прямо сейчас.
Дедупликация и авторазрешение
Комментарии привязаны к маркерам: одно и то же замечание не публикуется заново при каждом push, а исправленные нарушения закрываются автоматически. PR остаётся чистым и читаемым.
Выделенный бот-аккаунт + язык комментариев
Комментарии отправляются от стандартного интеграционного пользователя или от выделенного для workspace бот-аккаунта. Язык комментариев вы выбираете для каждого workspace (EN/TR).
Ручные проверки по запросу
Запустите проверку конкретного MR прямо из панели. ArchPilot сначала проверяет доступ («могу ли я это прочитать?»), а затем запускает ревью в вашем собственном CI-пайплайне.
Синхронизация разработчиков и оценки
Участники Git и авторы MR синхронизируются автоматически; сервисные и бот-аккаунты помечаются автоматически (и правятся вручную). Каждый разработчик получает оценку на основе ArchPilot.
Переопределение правил по проектам
Включайте, отключайте или настраивайте правила для каждого проекта или workspace. Правила, отключённые в панели, никогда не доходят до бота - никаких ложных срабатываний.
Работает в вашем собственном CI
Анализ выполняется в вашем собственном CI, на вашей инфраструктуре - исходный код никогда её не покидает; в панель отправляются только замечания.
Как это выглядит в продукте
Все скриншоты
Получите первое ревью уже сегодня
Подключите Git, включите правила и позвольте ArchPilot высказаться на следующем PR.