Словарь ошибок для клиента: как переводить технический результат в понятное действие
Пользователь видит «ошибка», нажимает снова и не понимает, изменилось ли что-то. В собственном клиенте SimAggregator полезно разделить описание наблюдения и доступное действие. Это локальный словарь интерфейса: он не заменяет документированные ответы API и не объявляет новые статусы платформы.
Для каждой ситуации запишите четыре вещи: что известно, чего мы пока не знаем, что может сделать пользователь и что проверит приложение. Например, отсутствие ответа означает неопределённость результата, а не автоматическое разрешение повторить покупку. Недоступный вариант выбора и потеря связи требуют разных объяснений.
Свяжите техническую запись с понятной фразой через внутренний код вашего приложения. Переводчикам дайте контекст, а не список отдельных слов. Фраза «попробуйте позже» бесполезна, если рядом остаётся активная кнопка, которая выглядит как обязательный следующий шаг.
Проверяйте словарь на искусственных сценариях. Коллега, не читавший код, должен объяснить, что уже произошло и что предлагается сделать. Сохраняйте исходную техническую причину в защищённой диагностике, чтобы удобная формулировка не скрыла различия при разборе сбоя.