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

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

![Доска канбана: колонки по статусам с карточками задач и панель инструментов](https://help.1forma.ru/help-images/kanban/kanban_view_spa2-01-1.png)

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

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

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

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

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

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

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

**Симптом:**

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

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

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

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

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

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

**Симптом:**

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

![Контекстное меню карточки канбана: «Перенести срок», «Переход» (смена статуса) и другие действия](https://help.1forma.ru/help-images/kanban/card_kanban_menu.png)

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

- воспроизводится ли проблема после `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 стабильно не отрабатывает.

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

- [Канбан — администрирование](https://help.1forma.ru/domains/kanban/admin.md)
- [Списки — решение проблем](https://help.1forma.ru/domains/grids/support-guide.md)
- [Маршруты задач — решение проблем](https://help.1forma.ru/domains/tasks/support-guide-routes.md)