Разработки
Назначение
Раздел описывает сопровождение разработки по задачам и запросам в Dinext: связь с GitLab, автоматическое обновление статусов разработки, рабочее пространство «Разработки» и отчёты по traceability и составу релиза. Цель — вести разработку в едином контуре с проектным управлением без отдельного трекера.
Цели и задачи
- Планировать и вести задачи и запросы разработки в Dinext.
- Связывать work item с ветками, коммитами, merge request, pipeline и развёртываниями в GitLab.
- Автоматически обновлять статус разработки по фактам из GitLab.
- Давать тимлидам и руководителям проектов сводку без обязательного входа в GitLab.
- Выявлять расхождения traceability и формировать состав релиза.
Для кого
- Разработчики.
- Тимлиды и руководители разработки.
- Руководители проектов.
- Администраторы интеграции GitLab.
Основные понятия
- Статус разработки — агрегированное состояние задачи или запроса по активным артефактам GitLab (не начато, в разработке, слито, отклонено, сбой pipeline, развёрнуто).
- Артефакт разработки — branch, commit, merge request, pipeline, deployment, release или tag в GitLab, связанный с задачей или запросом.
- Traceability (прослеживаемость) — связь от задачи Dinext до фактов в GitLab и обратно.
- Рабочее пространство «Разработки» — сводный cockpit по Git-статусам, предупреждениям и быстрым переходам к отчётам.
Основные сущности / объекты
- Задача и запрос с вкладкой Development (Разработка).
- Настройки GitLab на уровне организации и маппинг репозиториев на проект.
- Отчёты «Исключения traceability GitLab» и «Состав релиза».
- Журнал событий GitLab и реестр артефактов разработки (для администраторов).
Основные сценарии / процессы
Старт разработки из задачи
- Создайте или откройте задачу/запрос в Dinext.
- Перейдите на вкладку Development.
- Нажмите Create Branch (⎇) или укажите ключ задачи Dinext в названии branch / merge request / commit в GitLab — система свяжет артефакты автоматически.
- Отслеживайте связанные артефакты и агрегированный статус разработки в карточке.
Скриншот: Вкладка Development на карточке задачи. Изображение razrabotki-task-development-vkladka.png будет добавлено после загрузки assets.
Контроль команды
- Откройте рабочее пространство «Разработки».
- В блоке «Сводка разработки» просмотрите карточки-счётчики по статусам для задач и запросов: в разработке, смержено, развёрнуто, отклонено.
- В блоке «Предупреждения и исключения» обратите внимание на расхождения, сбои pipeline и отклонённые work items.
- Перейдите по ярлыкам к отчётам «Исключения traceability», «Состав релиза» или списку «Артефакты разработки».
Скриншот: Рабочее пространство «Разработки» со сводкой по Git-статусам. Изображение razrabotki-workspace-svodka.png будет добавлено после загрузки assets.
Отчёт «Исключения traceability GitLab»
Отчёт помогает найти разрывы прослеживаемости между Dinext и GitLab. Данные собираются из связей work item с артефактами разработки и актуального состояния артефактов в системе (удалённые артефакты не учитываются).
Выберите режим отчёта:
| Режим | Назначение |
|---|---|
| Задачи без merge request | У work item есть связанные артефакты GitLab, но нет merge request |
| Merge request без задачи | В GitLab есть MR, не привязанный ни к одной задаче или запросу |
| Сбойные pipeline | Pipeline в статусе failed, связанный с work item |
| Зависшие ревью | Merge request в статусе opened или locked длительное время |
| Задачи в релизе без merge | У work item есть release/tag/deployment, но нет слитого MR |
Скриншот: Отчёт «Исключения traceability GitLab». Изображение razrabotki-traceability-isklyucheniya.png будет добавлено после загрузки assets.
Отчёт «Состав релиза»
- Укажите релиз или тег GitLab и связанный проект.
- Получите список work items и артефактов, входящих в состав релиза.
- Используйте отчёт для подготовки release notes и проверки полноты traceability перед публикацией.
Скриншот: Отчёт «Состав релиза». Изображение razrabotki-sostav-reliza.png будет добавлено после загрузки assets.
Настройка интеграции GitLab (администратор)
- Создайте запись GitLab Instance с URL сервера и токеном доступа.
- Настройте маппинг проекта Dinext на репозитории GitLab.
- Зарегистрируйте webhook на стороне GitLab — Dinext принимает события push, merge request, pipeline, deployment и синхронизирует артефакты.
- При необходимости выполните начальную сверку (reconciliation) исторических данных.
Правила и ограничения
- Интеграция требует настройки GitLab Instance и маппинга проекта.
- Создание ветки из карточки задачи использует персональный токен GitLab пользователя.
- Статус разработки вычисляется по активным артефактам; удалённые в GitLab branch и другие артефакты исключаются из отчётов.
- Исторические ключи из других систем поддерживаются через реестр alias.
Результаты / отчетность
- Статусы разработки на списках задач и запросов.
- Рабочее пространство «Разработки» с агрегированной сводкой.
- Отчёты исключений traceability и состава релиза.
- Журнал событий GitLab для диагностики (администраторы).
Типовые вопросы и ошибки (FAQ)
Для чего нужен отчёт «Исключения traceability GitLab»?
Чтобы быстро найти work items и артефакты GitLab, которые не связаны корректно: задачи без MR, MR без задачи, сбойные pipeline, зависшие ревью, задачи в релизе без слияния. Отчёт строится по данным связей и текущему состоянию артефактов в Dinext.
Каким образом отчёт собирается?
Dinext анализирует все связи work item ↔ артефакт разработки и актуальные записи артефактов (ветки, MR, pipeline и т.д.), исключая помеченные как удалённые. Для каждого режима применяются свои правила отбора строк — см. таблицу режимов выше.
Почему статус разработки не обновился после push в GitLab?
Проверьте, что webhook доставляет события на Dinext, ключ задачи указан в branch/MR/commit, а проект замаплен на репозиторий. Администратор может просмотреть журнал событий GitLab.
Можно ли работать без вкладки Development?
Основной пользовательский сценарий — через вкладку Development на задаче/запросе и workspace «Разработки». Связь также возможна при указании ключа Dinext в GitLab вручную.