Перейти к содержимому
GitRiverGitRiver
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

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

Уведомления

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

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

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