Организация и участники

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

Проект разработки и репозиторий

Репозиторий — импортированное зеркало вашего внешнего git-репозитория (upstream).
Проект разработки — проект, который собирает один или несколько репозиториев как источники (repo@branch) и в котором ведётся разработка.
Коннектор — агент, который вы запускаете в своей сети, чтобы подключить git, недоступный из интернета (self-hosted за фаерволом), или не отдавать нам токены доступа. Подробнее — в разделе Коннектор.

Интеграция и подключение

Коннектор — ещё и хост интеграций, и здесь важны два разных слова:

Интеграция (плагин) — это код: подписанный комплект из каталога, который коннектор скачивает и запускает у себя. Одна интеграция на трекер: jira, github, redmine.
Подключение — это связь с конкретной системой: адрес, учётные данные, список репозиториев или проектов и проект разработки, куда попадает работа. Две Jira — это два подключения одной интеграции, с разными секретами и разными правами.

У подключения есть слаг — короткое имя, выведенное из названия. Он попадает в имена инструментов, которые видит модель, поэтому jira_prod и jira_sandbox читаются лучше, чем два jira.

Задача и её жизнь

Задача проходит путь: постановка → проработка/формулировка → декомпозиция на атомы (подзадачи) → разработка по волнам → ревью → публикация. На ключевых точках работу продолжает человек: согласует план перед стартом и одобряет результат.

Атомы и волны

При декомпозиции задача разбивается на атомы — наименьшие независимо собираемые единицы. Атомы выполняются волнами в порядке зависимостей; это видно на Схеме выполнения.

База знаний

То, что организация знает о себе, отдельно от кода и от отдельной задачи: правила работы, факты о проекте и ловушки окружения. Записи ведёт человек, а модель их читает на всех этапах и пополняет сама по итогам законченной работы. Это то, что переживает конец задачи: без неё каждая следующая задача начинается с чистого листа. См. База знаний.

Ревью и замечания

Готовые изменения проходят ревью: диффы, обсуждение и замечания (от модели и от вас) с решением «одобрить» или «на доработку». После одобрения открывается pull request в исходном репозитории.

Основные понятия