Buff Development

Глоссарий

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

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