Назад к blog
documentation

Issues — базовые сущности

Issue — основная единица работы в Laraue Boards. Любая задача, запрос, баг-репорт или пункт действия — это issue. Отличие Laraue Boards в том, откуда берутся issues: большинство из них создаются из сообщений Telegram.

Что входит в issue

У каждого issue есть:

  • Содержимое — текст сообщения или текст, введённый вручную
  • Отправитель — кто написал исходное сообщение в Telegram
  • Статус — в какой колонке доски issue находится сейчас
  • Номер issue — уникальный идентификатор вида WRK-42
  • Исполнитель — на кого назначен issue
  • Атрибуты — любые кастомные поля, настроенные для доски
  • Медиа — прикреплённые фото, видео или альбомы из исходного сообщения

Экран деталей issue в Laraue Boards: содержимое, статус, номер issue, кастомный атрибут

Номера issues

Каждый issue получает номер на основе своего спейса, а не доски: три буквы из названия спейса и число, сквозное в пределах этого спейса, — например WRK-1, WRK-2, MOB-14. Перемещение issue между досками внутри одного спейса номер не меняет. Изменить его может только перенос в другой спейс.

Номер issue позволяет ссылаться на задачу в переписке. Напишите «см. WRK-42» в сообщении Telegram — и всей команде сразу понятно, о какой задаче речь, без необходимости делиться ссылкой.

У каждого issue есть и прямая ссылка, составленная из организации и номера:

https://boards.laraue.com/organizations/{OrgKey}/issues/{IssueKey}

Рядом с номером на самом issue есть иконка ссылки — нажмите её, чтобы скопировать эту ссылку, не набирая её вручную.

Иконка ссылки рядом с номером issue, используется для копирования прямой ссылки

Делитесь ссылкой, когда хотите привести человека сразу к issue, а не просто назвать его.

Создание issues

Из сообщения Telegram — перешлите любое сообщение боту Laraue Boards. Оно сохранится и попадёт в бэклог дефолтного спейса. Бот подтвердит это реакцией 👍.

Сейчас все issues, созданные так, попадают в вашу личную организацию, независимо от того, из какого чата пришло сообщение. Привязка конкретных групповых чатов к конкретным организациям — например, чтобы сообщение из чата с клиентом сразу попадало в организацию этого клиента, — запланирована в одной из будущих версий.

Вручную — нажмите кнопку + Добавить задачу. Она доступна из любого места в приложении, а не только с доски. Если открыть её с доски, спейс и доска уже заполнены; если открыть на уровне организации, все поля пустые — и вы сами выбираете спейс, доску и статус.

Форма добавления issue

Перенос issue на другую доску

Новые issues от бота попадают на доску по умолчанию, чтобы сохранение оставалось лёгким, — не нужно выбирать доску перед отправкой сообщения. Если хотите разместить issue в другом месте, откройте Бэклог, найдите issue в списке и смените его доску прямо в деталях issue.

Перенос issue между досками внутри одного спейса сохраняет номер issue. Перенос в другой спейс даёт issue новый номер, поскольку номера считаются в пределах спейса.

Перемещение issue между статусами

Перетащите карточку из одной колонки в другую. Номер issue не меняется — перемещение между колонками меняет только статус.

Медиа в issues

Если исходное сообщение Telegram содержало фото, видео или альбом, они сохраняются в issue. Файлы не хранятся отдельно — они запрашиваются из Telegram при открытии, в исходном качестве. На карточке доски миниатюр нет — вложения видны на странице деталей issue, где нажатие на миниатюру открывает полное изображение.

Редактирование issue

Если отредактировать исходное сообщение в Telegram, issue обновится вместе с ним. Реакция бота сменится на ❤, подтверждая, что правка обработана.

Комментарии

У каждого issue есть свои комментарии, отдельные от исходного сообщения. Откройте issue и используйте вкладку Comments, чтобы обсудить его с командой.

В комментариях поддерживаются вложения-изображения — вставьте картинку прямо через Ctrl+V или выберите файл для загрузки.

История изменений

Вкладка History у issue показывает, что изменилось, когда и кто это сделал, — в виде понятного лога, а не сырых данных. Смена статуса выглядит как Status: New → In progress, перенос на другую доску — как Board: Sprint 2 (Active) → Sprint 3, а новое вложение — как Added attachment: image.png. Она покрывает изменения содержимого issue, статуса, доски, комментариев и вложений.

Вкладка History у issue: смена статуса, перенос на доску и добавленное вложение

Связанные страницы