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

Аудитория: ТП 1-й линии (без доступа к БД)

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

Секции организованы по типам проблем. Для каждой: 1. Симптом — что описывает клиент 2. Что проверить — шаги диагностики 3. Решение — что сделать 4. Эскалация — когда передавать на 2-ю линию

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

~30% обращений по теме.

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

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

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

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

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

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

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

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

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

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

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

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

~25% обращений.

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

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

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

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

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

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

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

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

3. UI маршрута¶

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Эскалация: баг API — передать на 2-ю линию с примером TaskID и ожидаемым vs фактическим статусом. [2L]

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

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

Когда эскалировать¶

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