GitRiver GitRiver
EN
Навигация

Задачи

Создание задач, Kanban-доски, шаблоны, метки, вехи и автоматизация в GitRiver

Задачи (Issues) - основной инструмент для отслеживания работы: баг-репорты, фичи, обсуждения. Каждая задача привязана к репозиторию и может содержать описание, метки, вехи, ответственных и чеклисты.

Создание задачи

  1. Откройте вкладку Задачи в репозитории
  2. Нажмите «Новая задача»
  3. Заполните:
    • Заголовок - краткое описание (обязательно)
    • Описание - подробности в Markdown (необязательно)
    • Ответственный - кто будет выполнять
    • Метки - категоризация (баг, фича, документация)
    • Веха - к какому этапу/релизу относится
    • Проект - на какой Kanban-доске отображать
  4. Нажмите «Создать»

Ссылки на задачи

В описаниях и комментариях можно ссылаться на другие задачи:

  • #42 - ссылка на задачу в текущем репозитории
  • group/repo#42 - ссылка на задачу в другом репозитории
  • Закрывает #42 или Fixes #42 в описании пулл-реквеста - задача автоматически закроется при слиянии

Чеклисты

Внутри описания задачи можно создать чеклист:

- [ ] Написать тесты
- [ ] Обновить документацию
- [x] Исправить баг

Прогресс чеклиста отображается в списке задач.


Шаблоны задач

Чтобы пользователи создавали задачи в едином формате, добавьте шаблоны.

Создание шаблонов

Создайте файлы в директории .gitriver/templates/issue/ репозитория:

<!-- .gitriver/templates/issue/bug-report.md -->
---
name: Баг-репорт
about: Сообщить об ошибке
labels: ["bug"]
---

## Описание бага
Кратко опишите проблему.

## Шаги для воспроизведения
1. Перейдите на ...
2. Нажмите ...
3. Увидите ...

## Ожидаемое поведение
Что должно было произойти.

## Фактическое поведение
Что произошло на самом деле.

## Окружение
- Версия GitRiver:
- Браузер:
- ОС:
<!-- .gitriver/templates/issue/feature-request.md -->
---
name: Запрос фичи
about: Предложить новую функциональность
labels: ["enhancement"]
---

## Описание
Что вы хотите добавить?

## Зачем это нужно
Какую проблему это решает?

## Возможная реализация
Как это может работать (опционально).

При создании задачи пользователь видит список шаблонов и выбирает подходящий.


Метки

Метки - цветные теги для категоризации задач.

Встроенные метки

При создании репозитория автоматически создаются метки:

МеткаЦветНазначение
bugкрасныйОшибка
enhancementсинийУлучшение
documentationзелёныйДокументация
questionжёлтыйВопрос
duplicateсерыйДубликат
wontfixсерыйНе будет исправлено
good first issueфиолетовыйДля новичков

Управление метками

Настройки репозитория -> Метки:

  • Создание новых (название, цвет, описание)
  • Редактирование существующих
  • Удаление (метка снимется со всех задач)

Фильтрация

В списке задач используйте фильтры:

  • По одной или нескольким меткам
  • По ответственному
  • По автору
  • По вехе
  • По состоянию (открытые / закрытые)
  • Свободный текстовый поиск

Вехи

Вехи (Milestones) группируют задачи по этапам или релизам.

Создание вехи

  1. Откройте вкладку Вехи в репозитории
  2. Нажмите «Новая веха»
  3. Укажите:
    • Название (например, v1.2.0)
    • Описание - что входит в этот этап
    • Дата дедлайна (опционально)

Прогресс

Каждая веха показывает:

  • Прогресс-бар - процент закрытых задач
  • Количество открытых / закрытых задач
  • Дней до дедлайна (если указан)

Привязка задач

При создании или редактировании задачи выберите веху в выпадающем списке. Одна задача может быть привязана только к одной вехе.


Kanban-доски (Проекты)

Визуальное управление задачами через Kanban-доски.

Создание проекта

  1. Откройте вкладку Проекты в репозитории (или группе)
  2. Нажмите «Новый проект»
  3. Укажите название и описание
  4. Проект создаётся с тремя колонками по умолчанию:
    • К выполнению (To Do)
    • В работе (In Progress)
    • Готово (Done)

Настройка колонок

  • Добавляйте новые колонки (например: «На ревью», «Тестирование»)
  • Переименовывайте существующие
  • Меняйте порядок перетаскиванием
  • Удаляйте пустые колонки

Работа с карточками

  • Перетаскивание - перемещайте задачи между колонками
  • Привязка задач - нажмите «+» в колонке и выберите задачу
  • Автоматическое перемещение - задача перемещается в «Готово» при закрытии
  • Фильтрация - по меткам, ответственным, приоритету

Проекты на уровне группы

Проект можно создать для всей группы - тогда в него можно добавлять задачи из любых репозиториев группы. Удобно для кросс-командных инициатив.


Комментарии

Форматирование

Комментарии поддерживают полный Markdown:

  • Текст, списки, таблицы
  • Подсветка синтаксиса кода
  • Изображения (drag & drop или вставка из буфера)
  • Математические формулы (KaTeX)
  • Диаграммы (Mermaid)

Упоминания

  • @username - упомянуть пользователя (получит уведомление)
  • @group/team - упомянуть команду
  • #42 - ссылка на задачу

Реакции

Добавляйте реакции (эмодзи) к комментариям вместо +1 комментариев.

Редактирование и удаление

Автор комментария и администратор могут редактировать и удалять комментарии. История редактирования сохраняется.


Автоматизация

Автозакрытие задач

Если в описании или коммите пулл-реквеста указать ключевые слова:

Закрывает #42
Fixes #42
Resolves #42
Close #42

Задача закроется автоматически при слиянии пулл-реквеста.

Уведомления

Участники задачи (автор, ответственный, подписчики) получают уведомления:

  • Новый комментарий
  • Изменение статуса
  • Назначение ответственного
  • Упоминание через @

Каналы уведомлений настраиваются в профиле пользователя.