BRD Widget 8.7.2 Оформление ошибок
Направление работ: Widget Код раздела: 8.7.2 Раздел: Общие работы > Архитектура и инфраструктура > Оформление ошибок Статус: черновик Ответственный: Панкова Л.А. Версия: 0.1 Обновлено: 21.07.26
1. Назначение
Раздел описывает, как виджет оформляет ошибки: сообщения в контексте действия, уведомления по кодам статуса и единый результат при ошибке запроса.
Документ описывает клиентское оформление ошибок. Показ уведомлений — раздел 8.6; вызовы методов и авторизация — раздел 8.7.1; backend-коды и события — Back 7.
Раздел зависит от Back: 7.2 Процессинг и каналы доставки уведомлений.
2. Ключевые понятия
Ошибка — состояние, о котором виджет сообщает клиенту.
Код статуса — серверный код, по которому формируется сообщение об ошибке.
Единый текст ошибки — обобщённая формулировка, не раскрывающая детали (например, при неверных данных входа).
3. Scope
Входит
S1: Показ ошибок в контексте действия
S2: Показ ошибок уведомлениями по кодам статуса
S3: Обработка ошибок запросов и авторизации
Не входит
- Widget: 8.6 Общие работы > Уведомления в виджете
- Widget: 8.7.1 Общие работы > Архитектура и инфраструктура > Используемые методы
- Back: 7.2 backend-коды статусов и события
4. BR
Указаны в пункте 4 раздела Back: 7.2 Процессинг и каналы доставки уведомлений.
5. Функциональные требования (UC + FR)
FR — functional requirements, что интерфейс должен уметь делать по определенному UC.
| ID | Сценарий | Функциональное требование | BR | Вес | Статус |
|---|---|---|---|---|---|
| S1: #FR8.7.2-1 | Ошибка в контексте действия | Интерфейс показывает ошибки в контексте действия — например, единую ошибку «Неверный логин или пароль» при входе и ошибку расчёта заказа рядом с формой. | 1 | ||
| S2: #FR8.7.2-2 | Ошибка по коду статуса | Интерфейс показывает ошибки уведомлениями, сформированными по кодам статуса от сервера (раздел 8.6). | 2 | ||
| S3: #FR8.7.2-3 | Ошибка запроса | При ошибке запроса виджет возвращает единый результат с признаком неуспеха и сообщением; при истечении авторизации показывает сообщение о необходимости авторизации. | 2 |
6. Открытые вопросы
| ID | Источник | Вопрос | Кому | Статус |
|---|---|---|---|---|
| #OQ8.7.2-1 | Код | Часть ошибок логируется в консоль без показа клиенту: ошибки входа и создания заказа обрабатываются через console.error без пользовательского уведомления. Подтвердить, какие ошибки должны показываться клиенту и как. \ features/auth/ui/Authorization.vue:301-309, widgets/booking/ui/OrderBaseForm.vue:331 | Разработка | Open |