Mini-app_Aiviora_Beta_Telegram

1.

AIVIORA · QA
Мини-апп Aiviora Beta в Telegram
на базе существующего бота @aiviora_test_bot
Что переносим из чат-бота, как будет выглядеть, что нужно разработке и как принимаем
Версия 1.0 · QA Lead · 29.10.2026 · задача AIV-177

2.

ЗАЧЕМ
Бот уже есть — почему переходим на Мини-апп
Сейчас: чат-бот AivioraTestBot
Будет: Мини-апп внутри Telegram
✕ Анкета — цепочка из 12+ сообщений, чат засоряется
✓ Анкета — экраны по одному вопросу, прогресс и «Назад»
✕ Ответ нельзя поправить: «Назад» ломает порядок вопросов
✓ Черновик на сервере: продолжить с места остановки
✕ Дату и модель вводят текстом — много ошибок формата
✓ Маска даты, плитки, галочки — ошибки ввода невозможны
✕ Мультивыбор и проверка ответов неудобны в кнопках
✓ Экран «Проверьте ответы» с правкой любой строки
✕ Баг-репорт — 9 шагов переписки, файлы до 20 МБ
✓ Баг-репорт — одна форма, файлы напрямую на сервер
✕ Таймер задачи — сообщения, которые теряются в ленте
✓ Задачи и таймер — отдельный экран, время ведёт сервер
✕ Тестовые стикеры и шуточные ответы видны участникам
✓ Бот остаётся: вход, решения, напоминания, сигналы
Логика, админка и Jira не меняются. Меняется только интерфейс тестера: переписка → экраны. Ошибки из аудита бота закрываются самим форматом.
2

3.

СХЕМА
Что остаётся в боте, а что переезжает в Мини-апп
Действие
Сейчас (бот)
Будет
Где
Вход по ссылке с меткой канала
/start src_inst
t.me/aiviora_test_bot/app?startapp=src_inst или /start → «Открыть
приложение»
Бот + Мини-апп
Согласие и анкета (12 вопросов)
Сообщения и кнопки
Экраны с прогрессом, черновик, проверка ответов
Мини-апп
Решение: принят / резерв / отказ
Сообщение
Сообщение с кнопкой «Открыть соглашение»
Бот
NDA и установка сборки
Сообщения
Экран соглашения, ссылка по платформе, «Я установил(а)»
Мини-апп
Задачи и таймер
Сообщения с кнопками
Список, карточка, таймер, оценка 1–5
Мини-апп
Баг-репорт и идеи
9 шагов в чате
Одна форма, похожие баги, «Мои баги»
Мини-апп
Сборка, баллы, профиль, выход
Пункты меню
Нижнее меню приложения
Мини-апп
Рассылки, напоминания, тихие часы
Бот
Без изменений; кнопка ведёт на нужный экран
Бот
Сигналы QA Lead и BA Lead
Бот
Без изменений
Бот
Сообщение автору бага
Бот
Сообщение с кнопкой «Ответить» → «Мои баги»
Бот + Мини-апп
3

4.

СХЕМА
Как связаны бот, Мини-апп, сервер, админка и Jira
Участник
Бот @aiviora_test_bot
Админ-панель
Telegram на iOS / Android
Вход, уведомления, сигналы
«Тестовые группы», 11 разделов
Сервер (тот же backend)
API, проверка initData, таймеры,
файлы, очередь Jira
Точки входа
• ссылка с меткой канала
• /start в боте
• кнопка меню чата
• кнопки в сообщениях бота
Мини-апп
Jira AIV
Экраны тестера: HTTPS,
библиотека Telegram
Ошибка / История, webhook
статусов
Главное: Мини-апп ходит в тот же сервер, что и бот. Квоты, баллы К1–К6, тексты «Локализации», отправка в Jira и сигналы — общие. Писать человеку сам Мини-апп не
может, поэтому все уведомления идут через бота.
4

5.

ПУТЬ УЧАСТНИКА
От ссылки до первого бага — 8 шагов
1. Ссылка → бот
2. Согласие
3. Анкета
4. Проверка и отправка
Метка канала сохраняется. Бот
здоровается и даёт кнопку
«Открыть приложение»
Без «Даю согласие» анкета не
открывается, данные не
сохраняются
11 вопросов по одному, черновик
на сервере, «Назад» без потери
ответов
Правка любой строки, сервер
считает К1–К4, анкета в
«Кандидатах»
5. Решение в бот
6. NDA и установка
7. Задачи и баги
8. Баллы и обратная связь
QA Lead ставит К5–К6: принять,
резерв, отказ — бот сразу пишет
Экран соглашения, T-ID, ссылка на
сборку по платформе, ссылки в
канал
Таймер, оценка, баг-репорт одной
формой → Jira AIV
«Мои баллы», «Мои баги», ответы
автору через бота
Зелёным — экраны Мини-аппа, белым — сообщения бота.
5

6.

КАК БУДЕТ ВЫГЛЯДЕТЬ
Макеты Мини-аппа (1/6)
Вход: из бота в приложение, согласие, дата рождения
1. Бот
/start → приветствие и кнопка «Открыть
приложение». Других вопросов в чате нет
2. Согласие
Шаг 1 из 12. Краткий текст и ссылка на полный.
«Не сейчас» — данные не сохраняются
3. Дата рождения
Маска ДД.ММ.ГГГГ и цифровая клавиатура.
Ошибка — подсказка под полем, «Далее»
неактивна. Младше 18 — отказ
Бот
Согласие
Дата рождения
6

7.

КАК БУДЕТ ВЫГЛЯДЕТЬ
Макеты Мини-аппа (2/6)
Анкета: телефон, скриншот, мультивыбор
1. Телефон
Плитки с одним выбором — ячейка квоты и К1.
Huawei/Honor → «Есть Google Play?»
2. Скриншот
Загрузка фото; модель, Android и память
попадают в профиль — в багах их больше не
вводят
3. Мультивыбор
Галочки в две колонки и счётчик «Выбрано: N».
Для «Ничего» — снимает остальные
Телефон
Скриншот
Мультивыбор
7

8.

КАК БУДЕТ ВЫГЛЯДЕТЬ
Макеты Мини-аппа (3/6)
Проверка, отправка и допуск
1. Проверка ответов
12 строк, нажатие открывает вопрос. Главная
кнопка «Отправить анкету»
2. Отправлено
Статус «На рассмотрении», срок ответа.
Решение придёт в бот
3. NDA
После «Принять» — T-ID, текст соглашения и
срок ответа. Затем ссылка на сборку
Проверка ответов
Отправлено
NDA
8

9.

КАК БУДЕТ ВЫГЛЯДЕТЬ
Макеты Мини-аппа (4/6)
Работа тестера: главная, задача, уведомления
1. Главная
T-ID, уровень, сборка и устройство, плашка
известных проблем, задачи по статусам,
нижнее меню
2. Задача
Что проверить, таймер (ведёт сервер), «Пауза»,
«Баг» из задачи, «Готово» → оценка 1–5
3. Бот
Решения, новые задачи, ответы по багам —
каждое сообщение с кнопкой на нужный экран
Главная
Задача
Бот
9

10.

КАК БУДЕТ ВЫГЛЯДЕТЬ
Макеты Мини-аппа (5/6)
Баг-репорт: форма, похожие баги, номер EXT
1. Форма
Ошибка / Идея, модуль, шаги, факт, ожидание,
файлы, критичность. Предупреждение о
тестовых данных
2. Похожие
Открытые баги модуля: «У меня тоже»
добавляет комментарий в задачу, а не новый
баг
3. Отправлено
Номер EXT сразу, даже если Jira недоступна.
Окружение подставлено из профиля
Форма
Похожие
Отправлено
10

11.

КАК БУДЕТ ВЫГЛЯДЕТЬ
Макеты Мини-аппа (6/6)
Баллы, профиль и тёмная тема
1. Баллы
Итог, уровень, место в цикле, история
начислений с причинами. Без обещаний
выплат
2. Профиль
Устройство, сборка, «Сменился телефон»,
«Мои баги», уведомления, выход и удаление
данных
3. Тёмная тема
Цвета берутся из темы Telegram автоматически
— отдельный дизайн не нужен
Баллы
Профиль
Тёмная тема
11

12.

ЧАТ-БОТ
Что меняем в существующем боте
Функция бота сейчас
Что меняем
/start и вопросы анкеты в чате
/start → приветствие и одна кнопка «Открыть приложение»; вопросы удаляем из бота
Меню тестера в чате
Кнопка меню чата открывает Мини-апп; текстовое меню убираем
Баг-репорт по шагам в чате
Убираем; команда /bug открывает форму в Мини-аппе
Таймер задачи сообщениями
Таймер — в карточке задачи; бот присылает только «Ещё тестируете?» через 90 мин
Решения по анкете
Остаются; «Принят» — с кнопкой «Открыть соглашение»
Рассылки, напоминания 24 ч / 48 ч / 3 дня
Остаются; кнопка в сообщении открывает нужный экран
Сигналы QA Lead, сводка 18:00
Без изменений
/stop
Остаётся; то же действие есть в «Профиле»
Тексты qabot_*
Остаются в «Локализации»; для экранов добавляем ключи qaapp_*
Разрешение писать человеку
Если вход был не через /start — Мини-апп запрашивает разрешение до отправки анкеты
12

13.

JIRA
Баг из Мини-аппа в Jira AIV — поля те же, что у бота
Поле в Jira AIV
Обязательно
Откуда в Мини-аппе
Значение
Проект
Да · Jira
Автоматически
AIV
Тип задачи
Да · Jira
Переключатель «Ошибка / Идея»
Ошибка / История
Тема
Да · Jira
Модуль и поле «Факт»
[EXT-042] {модуль}: {начало факта}
Описание
Да · регламент
Поля формы + профиль
Шаги · Факт · Ожидание · Окружение (из анкеты и «Сборок») · Автор TID
Приоритет
Да · регламент
Плитки критичности
Highest / High / Medium / Low; История — Medium
Description of high priority
При Highest / High
Автоматически
«Критичность от тестера: …»
Customer Manager
Да · регламент
«Настройки» админки
BA Lead
Вложения
Нет
Файлы формы
Скриншоты и видео (лимит в «Настройках»)
Не отправляем: Environment, Affects Version/s, Component/s, Labels — их нет на экране создания AIV. Повторы: 1, 5, 15, 60 мин; ошибка полей — сразу сигнал QA Lead.
Отправка без дублей по EXT-номеру.
13

14.

КАК СОЗДАТЬ
Что нужно сделать разработке — 8 шагов
1. BotFather
2. Хостинг
3. Фронтенд
4. Вход пользователя
Создать Мини-апп у бота
@aiviora_test_bot: короткое имя
(app), URL, иконка, кнопка меню
чата
HTTPS на домене компании: боевой
адрес и тестовый стенд aiviora-test
Веб-приложение + библиотека
Telegram (telegram-web-app.js):
главная кнопка, «Назад», тема,
виброотклик
Сервер проверяет подпись initData
ключом бота и срок давности;
Telegram ID → кандидат / T-ID
5. API
6. Бот
7. Админка
8. Тест и запуск
Профиль, анкета, NDA, задачи, баги
и файлы, сборка, баллы, выход и
удаление — поверх текущей логики
бота
Убрать анкету и меню из чата,
добавить кнопки web_app в
сообщения, /bug и /stop
«Настройки»: адрес приложения,
лимит файлов, срок initData; ключи
qaapp_* в «Локализации»
Матрица устройств, пилот на 5
внутренних тестерах, затем первый
внешний цикл
Переиспользуем: сервер бота, раздел «Тестовые группы», «Локализацию», интеграцию с Jira и, по возможности, компоненты дизайн-системы Aiviora.
14

15.

СЕРВЕР И АДМИНКА
Безопасность и доработки админ-панели
Требование
Как
Раздел админки
Что добавить
Кто зашёл
Только по Telegram ID из проверенных данных запуска
(initData); без проверки — 401
Настройки
Адрес Мини-аппа (боевой и тестовый), лимит файлов,
срок initData, Customer Manager
Кто что видит
Тестер — только свои данные; права проверяет сервер
(задачи без допуска недоступны)
Кандидаты
«Есть разрешение писать в бот», дата и версия согласия
Файлы
На сервере компании; проверка типа и размера; ссылки с
ограниченным сроком
Участники
«Сменился телефон» — на подтверждение QA Lead
Персональные данные
Имя, контакты, дата рождения и скриншот не уходят в Jira
и логи
Баги тестеров
Вложения; статус отправки: отправлен / в очереди / не
отправлен + «Отправить ещё раз»
Нагрузка
Ограничение частоты запросов; отправка в Jira
идемпотентна
Локализация
Ключи qaapp_* для экранов; qabot_* для сообщений бота
Нефункциональные: первый экран ≤ 3 с на 4G; черновики не теряются на слабом интернете; крупный шрифт не ломает вёрстку; подписи для VoiceOver/TalkBack;
контраст WCAG AA; зоны нажатия от 44 px; светлая и тёмная тема Telegram.
15

16.

ПЛАН
Сдача по этапам и приёмка
Сдача
Что готово
Тест-кейсы
Матрица проверки
☐ iPhone · Samsung · Xiaomi/POCO · другой Android
1
Вход по ссылке, initData, согласие, анкета, проверка ответов,
«Кандидаты», «Квоты», тексты
☐ Huawei без Google Play
TC-MA-01…20
☐ Светлая и тёмная тема
☐ Обычный и крупный шрифт
2
NDA, главная, «Сборка», «Задачи» с таймером, напоминания в боте
TC-MA-21…35
3
Баг-репорт, файлы, «У меня тоже», Jira, повторы, «Мои баги», ответ
автору
TC-MA-36…50
4
«Баллы», «Профиль», выход и удаление, рассылки, сигналы QA Lead
TC-MA-51…65
☐ Wi-Fi и медленная сеть
☐ Вход не через /start
☐ Повторное открытие, обрыв связи
Принято = все кейсы высокого приоритета пройдены, открытых критичных багов нет. Пилот — 5 внутренних тестеров, затем первый внешний цикл.
16

17.

ВОПРОСЫ
Что уточнить у разработки до старта
☐ 1. Стек фронтенда; можно ли взять компоненты дизайн-системы Aiviora
☐ 2. Домен и хостинг Мини-аппа, тестовый стенд
☐ 3. Можно ли собрать анкету на механизме «Опросников» (AIV-151)
☐ 4. Максимальный размер вложения в Jira AIV — от него лимит файлов
☐ 5. Кто регистрирует Мини-апп в BotFather, заводит сервисный аккаунт Jira и webhook
☐ 6. Срок хранения анкет и скриншотов, состав данных при удалении — юрист
☐ 7. Нужна ли поддержка Telegram Desktop
Риски
Старые Android и iOS
Встроенный браузер работает по-разному → матрица устройств
Слабый интернет
Форма тяжелее сообщения → черновики и повторы
Нет разрешения писать
Решение не дойдёт → запрос разрешения до отправки
Модель телефона
Мини-апп видит только платформу → скриншот остаётся
17