Канбан: бизнес-логика¶

Контекст¶

Канбан используется как визуальный режим работы с задачами, когда важно:

видеть распределение задач по статусам;
быстро менять статус перетаскиванием карточек;
фильтровать задачи по ролям и параметрам;
контролировать поток работ без перехода в табличный вид.

Бизнес-сценарии¶

1. Канбан категории¶

Базовый сценарий: доска строится по статусам основного маршрута категории.

Ключевые правила:

при наличии основного маршрута колонками являются его статусы;
статусы вне основного маршрута отображаются после основных;
если основной маршрут не настроен, выводятся все статусы категории;
список обновляется автоматически при создании задач и смене статуса.

2. Канбан по Lookup-полю¶

Канбан может быть построен не только по маршруту, но и по значению выбранного Lookup-параметра.

Ключевые правила:

порядок колонок берется из настройки Lookup-поля "Колонка сортировки";
если сортировка не настроена, порядок колонок алфавитный;
при переносе карточки между колонками меняется значение выбранного Lookup в задаче;
есть колонка "Не заполнено" для задач без значения Lookup.

3. Персональный канбан исполнителя¶

Отдельный сценарий в профиле пользователя: доска задач, где пользователь является исполнителем.

Лимиты вывода:

не более 100 задач на сегодня;
не более 100 задач на завтра;
не более 100 ближайших задач по сроку.

4. Пользовательский канбан (произвольные данные)¶

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

Роли и права¶

базовые операции доступны пользователям с правом работы в категории;
принудительная смена статуса доступна пользователям с правом "Администратор задач";
при пользовательском канбане права дополнительно контролируются правами на публикации.

Пользовательские действия¶

открытие полной карточки задачи по клику;
быстрые действия из контекстного меню карточки;
drag-and-drop смена статуса;
сортировка карточек внутри колонки (по сроку, приоритету, дате создания и др.);
фильтрация карточек по ДП;
выбор группировок и агрегатов (если настроено шаблоном).

Сортировка внутри колонки¶

Карточки внутри каждой колонки можно упорядочить по выбранному полю задачи (срок, приоритет, дата создания и др.). Сортировка выполняется на стороне клиента и применяется ко всем колонкам одновременно. По умолчанию сортировка отключена. Настройка сохраняется для текущей категории.

Представление категории «Канбан»¶

В представлении категории Канбан задачи отображаются в виде колонок по статусам основного маршрута. Если основной маршрут не настроен — выводятся все статусы категории.

Масштаб и фильтры¶

Масштаб регулируется кнопками увеличения/уменьшения; сброс к стандартному — по кнопке сброса.
Доступны фильтры: по статусам основного маршрута, по преднастроенным отборам категории, по роли пользователя (исполнитель, заказчик, акцептант, «в параметрах»).
Фильтрация по значениям дополнительных параметров — через чипы над доской.
Настройки фильтров сохраняются для текущей категории между сессиями.

Карточка канбана¶

Администратор может настроить произвольный набор полей в карточке (кроме заголовка) через шаблон карточки канбана.
Исполнители отображаются аватарками; срок — бейджем (просроченные красным).
Приоритет отображается цветовой индикацией и индикатором (5 уровней: критичный, высокий, обычный, низкий, самый низкий).
Цвет колонки статуса соответствует цвету, настроенному администратором. Завершающие статусы всегда зелёные, отклоняющие — красные (для них смена цвета недоступна).

Сортировка и перенос¶

Карточки можно сортировать внутри колонки по сроку, приоритету, дате создания и др. Сортировка клиентская, применяется ко всем колонкам.
Если администратор настроил фиксированный порядок сортировки на уровне вида канбана — перетаскивание внутри колонки недоступно.
Смена статуса — drag-and-drop между колонками. По умолчанию только в разрешённые переходы основного маршрута.
Пользователи с правом «Администратор задач» могут включить режим принудительной смены статуса (меню «Прочее») — тогда перетаскивание работает между любыми статусами.

Канбан по Lookup-полю¶

В меню «Статус» можно выбрать Lookup-параметр категории — тогда колонки строятся по его значениям.
При переносе карточки между колонками меняется значение Lookup в задаче.
Есть специальная колонка «Не заполнено» для задач без значения.

Быстрые действия¶

Клик по карточке открывает полную карточку задачи.
Правый клик открывает контекстное меню: добавить в избранное, изменить исполнителей, перенести срок, перейти по маршруту.

Представление категории «Галерея»¶

В представлении категории Галерея задачи отображаются сеткой карточек одинакового размера.

Администратор может настроить отображение обложки и произвольный набор полей в карточке (кроме заголовка).
Настройка шаблона карточки выполняется администратором отдельно для вида «Галерея».

Связи с другими доменами¶

docs/domains/tasks/ -- жизненный цикл и переходы задач;
docs/domains/categories/ -- включение канбана и галереи как представлений категории;
docs/domains/ext-params/ -- канбан по Lookup и фильтрация по ДП;
docs/domains/grids/ -- тип представления KanbanSubcat и support-кейсы;
docs/domains/users-and-groups/ -- персональный канбан пользователя.