Канбан — Решение проблем

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

Порядок работы с кейсами и чеклист первичной диагностики проблем канбана

Для каждого кейса:

1. уточнить контекст (категория / пользовательский канбан);
2. собрать симптомы;
3. пройти чеклист проверки;
4. принять решение.

Чеклист первичной диагностики

1. Тип канбана: категория / персональный / пользовательский.
2. URL и параметры (subcatId, userId, publicationAlias).
3. Что именно не работает: открытие / фильтрация / перетаскивание / обновление.
4. Это массово или у одного пользователя.
5. Воспроизводится ли после refresh.

Кейсы открытия, пустой доски и обновления статуса канбана

1. Канбан не открывается или пустой

Симптом:

• у пользователя нет пункта канбана;
• доска открывается без карточек.

Что проверить:

• включено ли представление "Канбан" в настройках категории;
• есть ли у пользователя доступ к категории;
• не применен ли слишком узкий фильтр;
• корректный ли URL (особенно для пользовательского канбана по публикации).

Когда обращаться в поддержку 1Ф:

• если права и настройки корректны, но доска системно не загружается.

2. Канбан не обновляется после смены статуса

Симптом:

• статус задачи изменили через форму/ПКМ, но карточка не переместилась;
• требуется ручное обновление страницы.

Что проверить:

• воспроизводится ли проблема после F5;
• есть ли запись о переходе в истории задачи;
• работает ли SignalR-соединение;
• соответствуют ли колонки маршруту категории.

Решение:

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

Когда обращаться в поддержку 1Ф:

• если перетаскивание стабильно не обновляет карточки.

Кейсы долгой загрузки и перетаскивания в канбане

3. Долгая загрузка канбана

Симптом:

• доска открывается заметно дольше нормы.

Что проверить:

• количество задач в категории;
• выбранную группировку (по исполнителю часто тяжелее, чем по статусу), а также сгруппирована ли доска вообще и по какому полю;
• включенные фильтры.

Решение:

• сузить выборку фильтрами;
• использовать более легкую группировку.

Когда обращаться в поддержку 1Ф:

• если даже на суженной выборке стабильная деградация.

4. Проблемы со сменой статуса перетаскиванием

Симптом:

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

Что проверить:

• доступен ли переход маршрутом;
• не построен ли канбан по Lookup (где логика отличается от статусов маршрута);
• включен ли режим принудительной смены статуса (для администратора задач);
• не задан ли в шаблоне задач категории ключ readonly в секции настроек контекста kanban: при значении true перетаскивание отключено для всех пользователей, и это штатное поведение, а не ошибка прав или маршрута;
• вернулась ли карточка на исходное место: однократный возврат с пересчётом счётчиков — штатная реакция на ошибку серверной операции, смена статуса или исполнителя в истории задачи при этом не появляется. Расхождение счётчиков с содержимым после переноса штатным не является;
• включена ли на доске группировка: подмена числа в шапке колонки числом одной строки-группы возможна только на сгруппированной доске;
• сходится ли шапка после перезагрузки страницы: если да, доска не успела пересчитать агрегат колонки после переноса.

Когда обращаться в поддержку 1Ф:

• если переход разрешен и права есть, но перенос не работает.

Кейсы обновления карточек на сгруппированной доске

7. Карточка пропала с доски, появилась вторая группа с тем же названием или счётчик группы не сходится с числом карточек

Симптом:

• после изменения задачи карточка пропала с доски, а счётчик у заголовка группы остался прежним;
• на доске две строки группы с одинаковым названием: исходная пустая со старым счётчиком, рядом — с одной карточкой;
• число в заголовке группы не совпадает с числом карточек в ней, хотя карточка переехала верно;
• после прокрутки группы до конца одна карточка не показалась.

Что проверить:

• включена ли на доске группировка и по какому полю: по справочному полю, по Сроку, по Дате создания, по Дате изменения;
• восстанавливается ли правильная картина после перезагрузки страницы: если да, задача в системе на месте, а доска не успела обработать событие обновления;
• разошёлся ли счётчик только у заголовка группы или ещё и в шапке колонки: в шапке колонок пересчёт идёт отдельно от заголовков групп;
• менялось ли значение поля группировки у задачи, которой на экране не было (она лежит в непрокрученном хвосте группы): такие изменения доска считает приращениями, и после долгой сессии счётчик может разойтись — это принятое ограничение, точное значение возвращает перезагрузка доски;
• менял ли задачу другой пользователь: изменения других пользователей доска не отражает, это ожидаемое поведение, а не ошибка.

Решение:

• если карточка пропала или счётчик разошёлся разово и после перезагрузки картина верна — доска перечитает данные при следующем обновлении;
• если карточка системно исчезает, дублируется строка группы или счётчик расходится и после перезагрузки — это дефект обновления сгруппированной доски, оформлять задачу.

Когда обращаться в поддержку 1Ф:

• если после перезагрузки карточка на месте, а на доске она системно пропадает или дублируется группа.

Кейсы порядка колонок и статусов вне маршрута

Колонка статуса вне маршрута стоит не там, где ожидали, или после перехода карточка исчезла

Симптом: колонка статуса, которого нет в основном маршруте, находится между колонками маршрута, а не в конце доски; после перехода задачи в статус, колонки которого на доске не было, карточка пропала с экрана, а колонка не появилась; после смены фильтра или группировки порядок колонок отличается от того, что был раньше.

Что проверить:

• открыт ли канбан категории по статусам, а не канбан по дополнительному параметру: там порядок колонок задаётся настройкой и перестановкой заголовков;
• есть ли в статусе задачи, попадающие в текущий отбор: колонка статуса вне маршрута показывается только при этом, и её отсутствие — штатное поведение, а не сбой;
• не скрывает ли отбор целевой статус: переход в закрытый статус на доске с фильтром «Открытые» и наоборот убирает карточку с доски и не создаёт колонку — это согласовано с перезагрузкой страницы;
• совпадает ли картина с тем, что было до перезагрузки страницы: если да, доска отработала корректно;
• не открыт ли устаревший вариант доски: он строит порядок колонок по маршруту и новый расчёт не использует;
• не менялся ли основной маршрут или состав статусов категории незадолго до проверки: порядок считается по текущему графу переходов.

Решение: порядок колонок по статусам рассчитывает система и вручную он не настраивается — изменить его можно только перестройкой переходов в настройках категории. Карточка, ушедшая с доски при переходе, не попадает в текущий отбор, и после перезагрузки страницы она тоже не появится.

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

Кейсы Lookup и пользовательского канбана на публикациях

5. Канбан по Lookup отображается некорректно

Симптом:

• неожиданный порядок колонок;
• задачи попадают в "Не заполнено".

Что проверить:

• заполненность соответствующего Lookup у задач;
• настройку "Колонка сортировки" для этого Lookup.

Решение:

• настроить сортировку Lookup;
• проверить, что значение параметра реально сохраняется при переносе.

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

Симптом:

• доска открывается, но перетаскивание недоступно или не приводит к результату.

Что проверить:

• задан ли moveWebRequest в структуре;
• есть ли права на публикацию перемещения;
• корректен ли ответ публикации после move.

Когда обращаться в поддержку 1Ф:

• если публикации настроены и права выданы, но move стабильно не отрабатывает.

Связанные документы

• Канбан — администрирование
• Списки — решение проблем
• Маршруты задач — решение проблем