Маршруты и статусы задач — Решение проблем

Справочник для инженеров поддержки: типовые проблемы с маршрутами и статусами задач, их диагностика и решение. Документ организован по типам проблем — от расхождения статусов до ошибок API, каждая секция содержит симптомы, шаги проверки, решение и критерии эскалации. В конце — чеклист первичной диагностики и правила передачи обращения в поддержку 1Ф.

1. Расхождение статусов

Статус в списке не совпадает со статусом в задаче

Симптом: «в общем списке задач один статус, а при открытии задачи — другой», «расхождение статусов в списке и в заявке».

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

• Кеш / обновление страницы — устарели ли данные в списке задач
• Денормализация — обновились ли денормализованные поля
• Конкурентное обновление — не изменил ли другой пользователь статус

Эскалация: если после обновления страницы расхождение сохраняется — проблема денормализации.

Статус визуально не меняется после принудительной смены

Симптом: «принудительно сменил статус задачи, но визуально он не изменился».

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

• Обновить страницу
• SignalR — работает ли обновление в реальном времени
• Лог — прошёл ли переход фактически (проверить историю задачи)

Решение: обновить страницу. Если в истории задачи переход зафиксирован, но список задач не обновился — проблема SignalR или денормализации.

Канбан не обновляется при смене статуса

Симптом: «меняю статус через ПКМ или через форму задачи, но на канбане задача не перемещается».

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

• Обновить страницу
• SignalR-соединение
• Настройки канбана — соответствуют ли колонки статусам

---

2. Ошибки маршрута и папок избранного

Ошибка при движении по маршруту

Симптом: «ошибка отработки маршрута», «неверная работа передвижения заявки по маршруту».

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

• Скриншот / текст ошибки
• Конкретный переход — из какого статуса в какой
• Условия перехода — нет ли смарт-условий, блокирующих переход
• Обязательные поля — все ли заполнены
• Обязательный комментарий — настроен ли

Эскалация: если маршрут настроен корректно, поля заполнены, но ошибка воспроизводится — баг.

Нет доступа к кнопке перехода

Симптом: «не вижу кнопку перехода в маршруте», «нет доступа к кнопке "Создать иск"».

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

• Роль пользователя — разрешён ли переход для этой роли
• Условия видимости перехода — нет ли смарт-выражений
• Текущий статус — доступен ли переход из текущего статуса

Решение: проверить настройки маршрута: Администрирование → Категории → Маршрут → Переходы → Права.

Ошибка при входе в папку избранного «Маршрутизатор»

Симптом: «ошибка при открытии папки избранного, привязанной к маршрутизатору».

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

• Существует ли ещё маршрут / категория, на которую ссылается папка
• Права пользователя
• Версия системы

---

3. Интерфейс маршрута и API

Шевроны маршрута стали кликабельны

Симптом: «почему шевроны маршрута стали кликабельны?»

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

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

Симптом: «создал статус, добавил переход с ним, но новый статус не виден в списке для выбора».

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

• Кеш — обновить страницу / перелогиниться
• Маршрут — сохранён ли после добавления перехода
• Активность статуса — не деактивирован ли

Запрос комментария при переходе из статуса

Симптом: «как настроить запрос комментария при переходе?»

Решение: в настройках перехода (Маршрут → Переходы → конкретный переход) есть опция «Обязательный комментарий». При включении — переход невозможен без ввода комментария.

feedsBySP некорректно выдаёт статус согласования

Симптом: «API /api/tasks/feedsBySP возвращает некорректный статус согласования задачи».

Эскалация: баг API — обратиться в поддержку 1Ф с примером TaskID, ожидаемым и фактическим статусом.

---

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

При любом обращении по маршрутам и статусам соберите базовую информацию:

1. Тип проблемы — расхождение статусов, ошибка перехода, интерфейс маршрута, доступ, API
2. Категория и подкатегория
3. Конкретный переход — из какого статуса в какой
4. Версия системы
5. Контекст — список задач, канбан, форма задачи, API
6. Скриншот / текст ошибки

Передайте обращение в поддержку 1Ф, если столкнулись с одним из следующих случаев:

• Расхождение статусов сохраняется после обновления (денормализация)
• Маршрут настроен корректно, но переход даёт ошибку (баг)
• API возвращает некорректный статус
• Принудительная смена статуса не отрабатывает