# Глоссарий

> Термины продукта одним списком.

| Термин | Значение |
| --- | --- |
| **Организация** | Изолированное пространство команды: владелец и участники. |
| **Владелец** | Участник с полными правами в организации: состав, права, биллинг, коннекторы. |
| **Роль участника** | Набор прав по умолчанию: Contributor (свои задачи) или Maintainer (и чужие тоже). См. [Участники и права](/docs/teams). |
| **Область прав** | Где действует роль участника: вся организация, проект разработки или репозиторий. Самая узкая область главнее. |
| **Право** | Атомарное разрешение на одно действие («утверждать формулировку чужих задач»); роль — их набор, который можно поправить точечно. |
| **Журнал аудита** | Неизменяемая запись действий в организации: кто, когда, откуда, что и с каким результатом. Не путать с аудитом проекта. См. [Журнал аудита](/docs/audit-log). |
| **База знаний** | Общее хранилище знаний организации для человека и модели: правила, факты и ловушки. Доходит до модели на всех этапах работы. См. [База знаний](/docs/knowledge). |
| **Знание** | Одна запись базы: заголовок, описание одной строкой, тип, область, тело. Один факт — одна запись. |
| **Индекс знаний** | Список всех записей области (заголовок + описание одной строкой), который попадает в каждый прогон модели; тела открываются по требованию. |
| **«Показывать модели сразу»** | Признак записи: модель получает её целиком в каждой задаче, а не открывает по необходимости. Увеличивает расход каждой задачи. |
| **Перманентная запись** | Признак записи: ИИ не может её изменить или убрать в архив; человек с правом изменения — может. |
| **Архив знаний** | Куда уходит запись вместо удаления: видна по праву чтения, возвращается по праву изменения. Удаления в базе знаний нет. |
| **Проход извлечения** | Прогон по итогам законченной работы: читает её и записывает уроки в базу знаний. |
| **Проход консолидации** | Прогон следом за извлечением: сливает дубли, актуализирует описания, архивирует своё устаревшее, помечает расхождения в записях человека. |
| **«Требует проверки»** | Пометка, которую проход консолидации ставит записи человека, разошедшейся с текущим кодом: сам он её не меняет. |
| **Единый вход (SSO)** | Вход через корпоративный провайдер идентификации (IdP) по OIDC или SAML 2.0 вместо пароля и кода на почту; аккаунт создаётся при первом входе. См. [Единый вход](/docs/sso). |
| **Провайдер идентификации (IdP)** | Система компании, которая подтверждает личность сотрудника: Keycloak, AD FS, Entra ID, Avanpost и другие. |
| **Проект разработки** | Проект, где идёт разработка; собирает репозитории как источники. |
| **Репозиторий** | Импортированное зеркало внешнего git-репозитория (upstream). |
| **Источник** | Репозиторий и ветка (`repo@branch`), подключённые в проект. |
| **Upstream** | Внешний оригинал репозитория (GitHub / GitLab / Bitbucket / Gitea). |
| **Коннектор** | Агент в вашей сети для подключения self-hosted git за фаерволом (или чтобы не передавать нам токены). См. [Коннектор](/docs/connector). |
| **Интеграция (плагин)** | Код из каталога, который коннектор запускает у себя: связь с трекером или другой вашей системой. См. [Каталог](/docs/connector/marketplace). |
| **Подключение** | Связь интеграции с конкретной системой: адрес, учётные данные, область видимости, проект разработки. Двух Jira — два подключения одной интеграции. |
| **Слаг** | Короткое имя подключения. Попадает в имена инструментов, которые видит модель. |
| **Каталог интеграций** | Подписанный список того, что можно поставить, с границами доступа каждой версии. |
| **Область видимости** | Репозитории, проекты или пространства, где подключение читает обращения и пишет ответы. Пустой список означает «нигде». |
| **Источник знаний** | Интеграция, которая даёт модели читать написанное и нарисованное командой (Confluence, Figma), а не ведёт задачи. См. [Источники знаний](/docs/connector/knowledge). |
| **Инструмент** | Действие, которое интеграция отдаёт модели (найти задачи, прочитать тикет, взять diff). Пишущие модели не отдаются. |
| **Приёмник событий** | Необязательный порт коннектора для вебхуков трекера. Без него работает опрос. |
| **Задача** | Единица работы: постановка → формулировка → декомпозиция → разработка → ревью. |
| **Черновик** | Задача, которую вы ещё редактируете и не отправили в проработку. |
| **Постановка** | Исходная формулировка задачи от автора. |
| **Проработка / формулировка** | Этап, где аналитик превращает постановку в согласованную спецификацию. |
| **Уточнения** | Уточняющие вопросы аналитика к автору задачи. |
| **Декомпозиция** | Разбиение задачи на атомы. |
| **Атом (подзадача)** | Наименьшая независимо собираемая единица работы. |
| **Волна** | Группа атомов, выполняемых параллельно в порядке зависимостей. |
| **Схема выполнения** | Граф атомов и волн задачи. |
| **Прогон** | Один запуск пайплайна задачи; его можно остановить и возобновить. |
| **Ревью** | Проверка изменений человеком до публикации. |
| **Замечание** | Комментарий ревью (от модели или пользователя) со статусом. |
| **Публикация** | Открытие pull request / merge request в upstream после одобрения. |
| **Аудит** | Понимание кодовой базы «как есть», по разделам. |
| **Инструменты разработки** | Подготовка сборки/тестов — «точки отсчёта» проекта. |
| **Спросить** | Вопросы по коду только на чтение. |
| **Глубокое исследование** | Два агента (аналитик и ревьюер) готовят выверенный документ. |
| **Токены** | Расход модели: ввод, кэш, вывод, рассуждения. |