Диагностика по DTC-кодам OBD
Раздел «Диагностика» позволяет мгновенно расшифровать код неисправности, который выдал OBD-сканер — например P0301. Сначала вы увидите стандартное описание из словаря SAE/вашего собственного справочника, затем по кнопке — объяснение от AI: что сказать клиенту простыми словами, что проверить механику и каковы вероятные причины. При желании код можно сразу превратить в рекомендацию по конкретному автомобилю.
Как открыть
Кабинет → нижняя навигация → Ещё → раздел «Запись и обслуживание» → Диагностика.
URL прямого перехода: /diagnostics.
Экран «Мои коды» (собственный справочник сервиса) доступен оттуда же: кнопка Мои коды в шапке, или прямо по адресу /diagnostics/custom.
Что на экране
Экран «Диагностика» (/diagnostics)
Экран прокручивается сверху вниз; элементы появляются по мере поиска.
1. Шапка (AppBar) Заголовок «Диагностика» и кнопка перехода в собственный справочник кодов.
2. Информационный баннер Подсказка: «Введите код OBD-сканера (напр. P0301) — покажем расшифровку и, по кнопке, AI-объяснение.»
3. Строка ввода кода Поле «Код DTC» + кнопка Найти рядом. Поле принимает только формат SAE J2012 (буква P/B/C/U + 4 символа), приводит ввод к верхнему регистру автоматически.
4. Поле «Автомобиль» Необязательный выбор авто из базы тенанта. Нужен для AI-объяснения с учётом марки/модели и для кнопки «В рекомендацию».
5. Недавние коды (чипы) Появляется после первого успешного поиска. Отображает до 12 последних кодов в виде кнопок-чипов для быстрого повтора.
6. Карточка результата (появляется после поиска) Показывает: код (крупно), чип категории, бейдж «Свой код» если расшифровка из вашего справочника, пометку «Общий (SAE)» если код стандартный, и полное описание неисправности.
7. Кнопка «Объяснить с AI» (появляется после поиска) Запускает AI-расшифровку. Пока AI думает, вместо иконки — индикатор загрузки, кнопка недоступна.
8. Блоки AI-объяснения (появляются после нажатия «Объяснить с AI»)
- Для клиента — простыми словами, без технических терминов
- Для механика — что проверить, технические детали
- Вероятные причины — маркированный список
9. Панель «В рекомендацию» (появляется после поиска) Чипы выбора важности («Наблюдать» / «Срочно») и кнопка создания рекомендации по выбранному авто.
Экран «Мои коды» (/diagnostics/custom)
Собственный справочник DTC-кодов сервиса. Ваши расшифровки перекрывают стандартный словарь SAE — при поиске на экране «Диагностика» ваша версия будет показана первой с бейджем «Свой код».
1. Шапка (AppBar) Заголовок «Мои коды» + кнопки импорта и экспорта.
2. Поле поиска Фильтрует список по коду или описанию прямо на устройстве (без обращения к серверу).
3. Список кодов Каждая строка: код (жирным), чип категории, описание, заметка (если есть). Справа — иконки правки и удаления.
4. Кнопка «Добавить код» (FAB, плавающая кнопка снизу справа) Открывает диалог добавления нового кода.
Каждая кнопка и действие
Экран «Диагностика»
| Элемент | Где | Что делает | Кому доступно |
|---|---|---|---|
| Мои коды (кнопка-ссылка в шапке) | Правый верхний угол | Открывает экран «Мои коды» /diagnostics/custom | Все |
| Поле «Код DTC» | Основная зона | Ввод кода OBD-сканера. Принимает только P/B/C/U + 4 знака; лишние символы отбрасываются автоматически; максимум 5 символов | Все |
| Кнопка Найти | Справа от поля | Ищет код в словаре. Серая (недоступна) пока идёт поиск | Все |
| Поле «Автомобиль» — «Выберите авто (необязательно)» | Под строкой поиска | Открывает диалог выбора авто из базы тенанта | Все |
| Чипы «Недавние коды» | Под полем авто (появляются после первого поиска) | Повторяет поиск по выбранному коду из истории | Все |
| Кнопка «Объяснить с AI» | Под карточкой результата | Запрашивает у AI объяснение: для клиента + для механика + причины. Недоступна (затемнена) пока AI обрабатывает запрос | Все (требует настроенного AI-ключа на уровне платформы) |
| Чип «Наблюдать» | Панель «В рекомендацию» | Выбирает жёлтую (наблюдать) важность будущей рекомендации | Все |
| Чип «Срочно» | Панель «В рекомендацию» | Выбирает красную (срочно) важность будущей рекомендации | Все |
| Кнопка «В рекомендацию» / «Выберите авто (необязательно)» | Панель «В рекомендацию» | Если авто выбрано — создаёт рекомендацию по этому авто с кодом и AI-объяснением; если авто не выбрано — открывает диалог выбора авто | Требует права work_orders:update (механик и выше) |
Диалог «Выбор авто»
| Элемент | Где | Что делает | Кому доступно |
|---|---|---|---|
| Строка поиска авто | Вверху диалога | Фильтрует авто по госномеру, марке, модели | Все |
| Строка авто в списке | Список | Выбирает авто и закрывает диалог | Все |
Экран «Мои коды»
| Элемент | Где | Что делает | Кому доступно |
|---|---|---|---|
| Иконка Импорт (CSV / ODX / PDX) (стрелка вверх) | Шапка, правый угол | Открывает выбор файла. Форматы: CSV, TXT, ODX, ODX-D, PDX | Требует права org_settings:update (владелец) |
| Иконка Экспорт (стрелка вниз) с меню | Шапка, правый угол | Разворачивает меню из двух пунктов | Требует права org_settings:update (владелец) |
| Пункт меню «Экспорт своих кодов» | Меню экспорта | Скачивает CSV только с вашими кодами | Требует права org_settings:update |
| Пункт меню «Шаблон (со стандартными кодами)» | Меню экспорта | Скачивает CSV с вашими кодами + все стандартные SAE-коды — удобно как шаблон для правки | Требует права org_settings:update |
| Поле «Поиск по коду или описанию…» | Под шапкой | Фильтрует список мгновенно без обращения к серверу | Все (просмотр) |
| Иконка карандаша (правка) в строке кода | Справа в каждой строке | Открывает диалог «Правка кода» с заполненными полями | Требует права org_settings:update |
| Иконка мусорной корзины (удалить) в строке кода | Справа в каждой строке | Открывает диалог подтверждения удаления | Требует права org_settings:update |
| Кнопка «Добавить код» (FAB) | Снизу справа | Открывает диалог «Добавить код» с пустыми полями | Требует права org_settings:update |
| Кнопка «Повторить» | Центр экрана (только при ошибке загрузки) | Повторяет запрос списка кодов | Все |
Диалоги и подэкраны
Диалог «Добавить код» / «Правка кода»
Открывается: кнопкой «Добавить код» (FAB) или иконкой карандаша в строке.
| Поле / кнопка | Что делает | Примечания |
|---|---|---|
| Поле «Код DTC» | Ввод кода. Только P/B/C/U + 4 знака, до 5 символов, всё приводится к верхнему регистру. При правке поле заблокировано — код нельзя изменить, только описание | Подсказка: P1234 |
| Поле «Описание» | Краткое название неисправности (обязательно) | Нельзя оставить пустым |
| Чипы «Категория» (Двигатель/трансмиссия, Кузов, Шасси, Сеть/шина) | Выбор одной категории кода | По умолчанию — Двигатель/трансмиссия |
| Поле «Заметка (необязательно)» | Внутренняя заметка: типовая причина, что проверить, ссылка на мануал | Подсказка: «Типовая причина, ремонт, ссылка на инструкцию» |
| Кнопка «Отмена» | Закрывает диалог без сохранения | — |
| Кнопка «Сохранить» | Проверяет поля и сохраняет код. Если код уже существует — обновляет описание | — |
Что не пустит: если код не соответствует формату P/B/C/U + 4 символа, под полем кода появится: «Неверный формат кода. Ожидается буква P/B/C/U и 4 символа, напр. P0301.» Если описание пустое: «Введите описание».
Диалог подтверждения удаления
Открывается: иконкой мусорной корзины в строке кода.
Текст: «Удалить свой код [КОД]?»
| Кнопка | Что делает |
|---|---|
| Отмена | Закрывает без удаления |
| Удалить | Удаляет код из вашего справочника безвозвратно |
Диалог «Импорт завершён»
Появляется автоматически после успешного импорта файла.
Показывает:
- «Загружено: N» — сколько кодов добавлено/обновлено
- «Пропущено: N» (жёлтым) — если часть строк не удалось разобрать. Под ним — первые 10 проблемных строк с номером и причиной пропуска
Причины пропуска в отчёте:
- «неверный формат кода» — код не соответствует шаблону
- «пустое описание» — описание не заполнено
- «повтор кода в файле» — один и тот же код встречается дважды в том же файле (CSV)
- «нет текста расшифровки» — в блоке ODX/PDX нет текстового описания
- «повтор кода» — код уже есть в вашем справочнике (ODX/PDX)
| Кнопка | Что делает |
|---|---|
| OK | Закрывает отчёт |
Что если…
Код введён, но поиск ничего не нашёл
Появится баннер: «Код не найден в словаре. Проверьте ввод или уточните по мануалу производителя.» Убедитесь, что код написан правильно (буква и 4 символа). Если это нестандартный код производителя — добавьте его в «Мои коды» вручную, тогда в следующий раз он будет найден.
Введён код неправильного формата
Под полем появится: «Неверный формат кода. Ожидается буква P/B/C/U и 4 символа, напр. P0301.» Коды начинаются только с P (двигатель), B (кузов), C (шасси) или U (сеть/шина).
AI-объяснение недоступно
Вместо блоков объяснения появится баннер: «AI-объяснение сейчас недоступно. Расшифровка кода выше по-прежнему актуальна.» Расшифровка из словаря при этом работает нормально. Сообщите об этом администратору — возможно, AI-ключ не настроен.
Не удалось создать рекомендацию
Внизу экрана всплывает: «Не удалось создать рекомендацию». Убедитесь, что выбрано конкретное авто — кнопка «В рекомендацию» без авто сначала просит его выбрать. Также проверьте подключение к интернету.
Экран «Мои коды» не загружается
Посередине экрана появляется сообщение об ошибке и кнопка «Повторить». Нажмите её для повтора загрузки.
Импорт файла завершился с ошибкой
Появляется уведомление: «Не удалось импортировать». Убедитесь, что файл имеет расширение CSV, TXT, ODX, ODX-D или PDX и не повреждён. В CSV первая строка должна быть заголовком (code,title,category), данные — с первой строки данных.
Вопрос-ответ
Сканер показал P0301 — где это посмотреть?
Откройте «Ещё» → «Диагностика», введите P0301 в поле «Код DTC» и нажмите Найти. Через секунду появится карточка: что это за неисправность и к какой системе относится. Затем нажмите «Объяснить с AI» — получите объяснение для клиента и для механика.
Что значит бейдж «Свой код» на карточке результата?
Это значит, что описание взято из вашего собственного справочника (экран «Мои коды»), а не из стандартного словаря SAE. Ваша расшифровка важнее — она перекрывает стандартную. Это удобно для кодов, специфичных для марки или для вашего оборудования.
Как добавить рекомендацию клиенту сразу из диагностики?
После поиска кода выберите авто в поле «Автомобиль», затем выберите важность чипами («Наблюдать» — жёлтая, «Срочно» — красная) и нажмите «В рекомендацию». Рекомендация с кодом и AI-объяснением появится в карточке этого авто. Для этого нужны права механика или выше.
Как загрузить коды от производителя авто — у нас есть ODX-файл?
Зайдите в «Мои коды», нажмите иконку загрузки в шапке (Импорт), выберите ваш ODX-файл (или PDX — это упакованный ODX). После загрузки покажется отчёт: сколько кодов добавлено и сколько пропущено с причиной.
Можно ли выгрузить все наши коды, чтобы отредактировать в Excel и загрузить обратно?
Да. В «Мои коды» нажмите иконку скачивания в шапке → «Шаблон (со стандартными кодами)» — получите CSV со всеми стандартными SAE-кодами плюс вашими; или «Экспорт своих кодов» — только ваши. Отредактируйте в Excel, сохраните как CSV и загрузите обратно через импорт.
Почему AI долго думает?
Кнопка «Объяснить с AI» показывает индикатор загрузки — это нормально, AI готовит развёрнутое объяснение (до 90 секунд). Пока AI думает, все остальные функции экрана работают. Если объяснение так и не появилось — возможно, временные проблемы с соединением; попробуйте нажать кнопку повторно.