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

Как пользоваться этим документом¶

Секции организованы по типам проблем. Для каждой:

Симптом — что описывает клиент
Что проверить — шаги диагностики
Решение — что сделать
Эскалация — когда обращаться в поддержку 1Ф

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2. Ошибки маршрута¶

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

5. API маршрутов¶

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

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

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

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

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

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

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

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

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