Интеграции и внешние кабинеты

Диагностика ошибок и обращение в поддержку

Порядок проверки прав, организации, сети, кэша, интеграции, файлов и идентификатора запроса перед обращением.

Для чего нужен

  • Порядок проверки прав, организации, сети, кэша, интеграции, файлов и идентификатора запроса перед обращением.
  • Дать сотруднику точный порядок действий и ожидаемый результат: Проблема либо устраняется безопасной проверкой, либо передаётся разработчику с достаточными доказательствами.
  • Закрепить единый рабочий сценарий для команды, руководителя и администратора.
Когда использовать: При ошибке интерфейса, запрете действия, пропавших данных, сбое интеграции или загрузки файла.

Кто работает

  • Сотрудник фиксирует сценарий.
  • Администратор проверяет права и настройки.
  • Поддержка исследует request_id и логи.

Порядок работы

  1. 1

    Зафиксируйте сценарий

    Раздел, карточка, действие, ожидаемый и фактический результат.

  2. 2

    Повторите безопасно

    Обновите данные и повторите одно действие без массовых операций.

  3. 3

    Проверьте контекст

    Активная компания, организация, роль, исполнитель и архивный статус.

  4. 4

    Определите класс

    403 - права, 404 - ресурс или область, 409 - конфликт версии, 422 - данные, 500 - сервер.

  5. 5

    Соберите доказательства

    Время, URL, request_id, снимок, устройство и название сущности.

  6. 6

    Передайте обращение

    Опишите один воспроизводимый дефект без паролей, токенов и персональных секретов.

Возможности

  • Error taxonomy.
  • Request ID.
  • Recovery steps.
  • Safe cache reset.
  • Integration health.
  • Support checklist.

Связи с другими модулями

  • Audit показывает действия.
  • Integrations содержит delivery log.
  • Superadmin errors связывает request_id.
  • Status страницы показывает инфраструктуру.

Что происходит дальше

  • Проблема либо устраняется безопасной проверкой, либо передаётся разработчику с достаточными доказательствами.
  • Изменение фиксируется в истории и становится доступно только участникам с подходящими правами.
  • Связанные модули получают событие и обновляют свои списки, уведомления или показатели.

Пример: Диагностика ошибок и обращение в поддержку

При ошибке интерфейса, запрете действия, пропавших данных, сбое интеграции или загрузки файла.

  1. Зафиксируйте сценарий: Раздел, карточка, действие, ожидаемый и фактический результат.
  2. Повторите безопасно: Обновите данные и повторите одно действие без массовых операций.
  3. Проверьте контекст: Активная компания, организация, роль, исполнитель и архивный статус.
  4. Определите класс: 403 - права, 404 - ресурс или область, 409 - конфликт версии, 422 - данные, 500 - сервер.
  5. Соберите доказательства: Время, URL, request_id, снимок, устройство и название сущности.
  6. Передайте обращение: Опишите один воспроизводимый дефект без паролей, токенов и персональных секретов.
Результат: Проблема либо устраняется безопасной проверкой, либо передаётся разработчику с достаточными доказательствами.

Проверка перед запуском

  • Сценарий воспроизводится.
  • Активная компания указана.
  • Время и URL есть.
  • Request ID сохранён.
  • Секреты скрыты.
  • Ожидаемое поведение описано.

Частые вопросы

Когда сбрасывать локальный кэш?

После обычной перезагрузки и проверки статуса. Сброс удаляет локальные настройки устройства, поэтому используйте его как отдельный диагностический шаг.