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

> Организация, проект, репозиторий, задача, подзадачи, ревью.

Короткая карта сущностей продукта. Полные определения — в [Глоссарии](/docs/glossary).

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

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

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

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

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

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

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

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

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

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

## Атомы и волны

При декомпозиции задача разбивается на **атомы** — наименьшие независимо собираемые единицы. Атомы выполняются **волнами** в порядке зависимостей; это видно на [Схеме выполнения](/docs/pipeline/execution-scheme).

## База знаний

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

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

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