Канбан — Решение проблем¶
Аудитория: ТП 1-й линии
Как пользоваться¶
Для каждого кейса:
- уточнить контекст (категория/пользовательский канбан/кастомный канбан);
- собрать симптомы;
- пройти чеклист проверки;
- принять решение или эскалировать.
1. Канбан не открывается или пустой¶
Симптом: - у пользователя нет пункта канбана; - доска открывается без карточек.
Что проверить: - включено ли представление "Канбан" в настройках категории; - есть ли у пользователя доступ к категории; - не применен ли слишком узкий фильтр; - корректный ли URL (особенно для кастомного канбана по публикации).
Эскалация: - если права и настройки корректны, но доска системно не загружается.
2. Канбан не обновляется после смены статуса¶
Симптом: - статус задачи изменили через форму/ПКМ, но карточка не переместилась; - требуется ручное обновление страницы.
Что проверить:
- воспроизводится ли проблема после F5;
- есть ли запись о переходе в истории задачи;
- работает ли SignalR-соединение;
- соответствуют ли колонки маршруту категории.
Решение: - при единичных случаях допустима задержка обновления; - если переход есть в истории, а UI не обновился -- вероятна проблема real-time обновления.
Эскалация: - если drag-and-drop стабильно не обновляет карточки.
3. Долгая загрузка канбана¶
Симптом: - доска открывается заметно дольше нормы.
Что проверить: - количество задач в категории; - выбранную группировку (по исполнителю часто тяжелее, чем по статусу); - включенные фильтры.
Решение: - сузить выборку фильтрами; - использовать более легкую группировку.
Эскалация: - если даже на суженной выборке стабильная деградация.
4. Проблемы со сменой статуса drag-and-drop¶
Симптом: - карточка не переносится в нужную колонку.
Что проверить: - доступен ли переход маршрутом; - не построен ли канбан по Lookup (где логика отличается от статусов маршрута); - включен ли режим принудительной смены статуса (для администратора задач).
Эскалация: - если переход разрешен и права есть, но перенос не работает.
5. Канбан по Lookup отображается некорректно¶
Симптом: - неожиданный порядок колонок; - задачи попадают в "Не заполнено".
Что проверить: - заполненность соответствующего Lookup у задач; - настройку "Колонка сортировки" для этого Lookup.
Решение: - настроить сортировку Lookup; - проверить, что значение параметра реально сохраняется при переносе.
6. Кастомный канбан на публикациях не двигает карточки¶
Симптом: - доска открывается, но перетаскивание недоступно или не приводит к результату.
Что проверить:
- задан ли moveWebRequest в структуре;
- есть ли права на публикацию перемещения;
- корректен ли ответ публикации после move.
Эскалация: - если публикации настроены и права выданы, но move стабильно не отрабатывает.
Чеклист первичной диагностики¶
- Тип канбана: категория / персональный / кастомный.
- URL и параметры (
subcatId,userId,publicationAlias). - Что именно не работает: открытие / фильтрация / drag / обновление.
- Это массово или у одного пользователя.
- Воспроизводится ли после refresh.
Связанные документы¶
docs/domains/kanban/admin.mddocs/domains/kanban/data-flow.mddocs/domains/grids/support-guide.mddocs/domains/tasks/support-guide-routes.md