Mini App нужно проверять внутри разных клиентов Telegram, а не только в обычной вкладке браузера. Поведение экрана, клавиатуры и возврата к процессу влияет на возможность закончить задачу. Серверные состояния и права проверяются отдельно от внешнего вида.
Соберите матрицу проверки
Выберите поддерживаемые мобильные и настольные клиенты, светлую и тёмную тему, несколько размеров экрана. Запишите версии, на которых проводилась проверка. Это помогает воспроизвести замечание.
| Условие | Что проверить |
|---|---|
| Небольшой экран | Читаемость и доступность действий |
| Открытая клавиатура | Видимость поля и следующего шага |
| Смена темы | Контраст текста и состояний |
| Возврат после закрытия | Сохранённый процесс |
| Медленная сеть | Загрузка, ошибки и повторы |
| Десктоп | Указатель, клавиатура и размеры |
Набор определяется аудиторией проекта. Один успешный запуск на телефоне разработчика не подтверждает все заявленные условия.
Проверьте поля и нижние действия
Откройте клавиатуру в каждом важном поле. Основная кнопка не должна неожиданно исчезать за системной областью. Длинная форма должна позволять понять текущую ошибку и добраться до действия.
Проверьте увеличение текста, доступные подписи и видимый фокус. Цвет не должен быть единственным способом объяснения отказа или успешного результата. Для интерфейса нужно предсказуемое поведение при изменении доступной высоты.
Пройдите возврат к незавершённой задаче
Начните сценарий, закройте приложение и откройте снова. Определите, какие сведения должны сохраняться. Сохранение черновика и создание завершённого заказа — разные события.
Если сеанс больше не принимается сервером, интерфейс должен объяснить дальнейшее действие. Не оставляйте пользователя на рабочем экране, где все запросы молча отклоняются.
Проверьте сетевые состояния
Имитируйте задержку ответа, временный отказ и повторное нажатие. Пользователь должен видеть, выполняется ли действие, и находить его результат после восстановления соединения.
Проверьте работу загрузки и повторной попытки на тестовой среде. Критичные данные не должны исчезать при обновлении страницы. Для повторяемых операций нужны согласованные серверные правила.
Запишите замечания как сценарии
Укажите клиент Telegram, версию, размеры, тему, исходные данные и шаги. Приложите материал, который показывает фактическое поведение. Сформулируйте ожидаемый результат отдельно.
После исправления повторяйте тот же сценарий. Журнал должен различать ошибки интерфейса, серверной проверки и интеграции. Тогда команда сможет найти причину и подтвердить результат исправления.
Такую матрицу полезно согласовать при разработке Telegram Mini App. Она связывает требования к интерфейсу с конкретными условиями использования.
