Часть 1. Разработка MVP

М1 (май 2026) · 6 ТЗ · 6 промптов · ответственный — Антон

Развернуть все секции

Аудит готовности TourQual

TourQual SaaS уже работает в проде у Viasun и решает задачу AI-квалификации лидов из онлайн-агрегаторов. Для MAG AI базовая инфраструктура (мультитенантность, биллинг, мессенджер-коннекторы, AI-движок) готова на 70%. Главные доработки — промпты, MAG.Travel API-интеграция, брендинг.

AI-модульГотовоЧто делатьОценка
AI-помощник менеджера 80% Промпт под B2B-менеджера ТА, JSON-схема "сообщение + классификация + следующий шаг" 3–5 дней
AI-квалификатор / подбор тура 90% Проверить интеграцию с MAG.Travel API: создание сделки, получение данных клиента 2–3 дня
AI-реактивация базы 75% Адаптировать сегментацию под структуру MAG, сезонные шаблоны, респекты к non-disturb 4–6 дней
AI-контроль сделок 30% Новый модуль. Только если кастдев подтвердит спрос. Возможно — Phase 2. 10–15 дней
AI-аналитика для РОПа 10% Отложено на Phase 2 после успешного MVP —
Вывод: для MVP достаточно 3 модулей (помощник, квалификатор, реактивация). За М1 успеваем при условии что Антон выделяет 60% времени.

6 ТЗ для разработки

ТЗ-1. Аудит готовности компонентов TourQual ▼

Цель

Зафиксировать что готово, что нужно дописать и где риски при адаптации TourQual под MAG AI.

Что нужно сделать

  • Просмотреть код tourqual/ (ai/, billing/, web/, connectors/, db/)
  • По каждому модулю поставить оценку готовности (%) под задачи MAG AI
  • Выписать что нужно дописать и сколько это займёт
  • Зафиксировать технические риски

Результат

Файл 01_аудит_готовности.md — готов. См. таблицу выше.

ТЗ-2. Брендинг + тарифы MAG AI ▼

Брендинг

  • Название: MAG AI (как надстройка к MAG.Travel)
  • Домен: mag-ai.ru (регистрирует Антон)
  • Цвета: зелёный #5f9b1f + лайм #9bc54a (как у MAG.Travel)
  • Логотип: заказывает Галич (текстовый, минимализм)

Тарифы

ТарифЦенаЭфф. в месСкидка
Помесячно7 990 ₽/мес7 990 ₽0%
6 + 1 (платишь 6, пользуешься 7)47 940 ₽ за 7 мес6 849 ₽14%
9 + 2 (платишь 9, пользуешься 11) ★71 910 ₽ за 11 мес6 537 ₽18%

Технические изменения

  • billing/yukassa.py: переменная PLAN_PRICES берётся из product.config['pricing']
  • config.py: добавить настройки бренда
  • web/templates/: переменные {{ brand_name }}, {{ brand_colors }}
  • nginx/: server-блок для mag-ai.ru
  • widget/: шапка виджета подгружает цвета из тенанта
ТЗ-3. 6 промптов MAG AI ▼

Промпты разрабатываются как отдельные файлы в tourqual/prompts/mag_ai/ и подгружаются по product_code тенанта.

Список промптов

ФайлНазначениеИспользует
manager_assistant.txtПодсказывает менеджеру ответ клиенту, классифицирует обращениеWA/TG-сообщение от туриста
qualifier.txtСама ведёт диалог с клиентом, собирает параметры тураВиджет на сайте ТА или заявка с лидформ
reactivation.txtРеактивирует старых клиентов (последняя сделка > 6 мес назад)База клиентов из MAG
deal_control.txtАнализирует зависшие сделки, даёт рекомендации (Phase 2)Воронка из MAG
kb_objections.txtБаза знаний: 10 типовых возражений + ответыПодгружается во все промпты
kb_destinations.txtБаза знаний: 15 топ-направлений 2026Подгружается в qualifier и manager_assistant

Принципы

  • Промпт = инструкция роли + контекст агентства + база знаний + JSON-схема ответа
  • JSON-ответ всегда содержит: текст для клиента, классификация запроса, рекомендуемый следующий шаг
  • Тон — от лица "Анны" (виртуальный менеджер), но без обмана клиента (мы не скрываем что это ИИ)
ТЗ-4. Расширение коннектора MAG.Travel ▼

Текущий tourqual/connectors/crm/mag.py умеет только создавать сделку. Для MAG AI нужно расширить.

Новые методы

МетодЧто делаетAPI MAG.Travel
get_clients_for_reactivation()Получить клиентов с последней сделкой более N дней назадGET /clients?last_deal_before=X
get_active_deals()Активные сделки (для AI-контроля)GET /deals?status=active
get_deal_messages(deal_id)Все сообщения по сделке (для анализа)GET /deals/{id}/messages
update_deal_stage(deal_id, stage)Сменить этап сделкиPATCH /deals/{id}
get_managers()Список менеджеров агентстваGET /users
get_pipeline_stages()Этапы воронки агентстваGET /pipelines

Webhook

Эндпоинт POST /webhook/mag/{tenant_id} в web/app.py для получения событий MAG.Travel в реальном времени:

  • Новый клиент
  • Новая сделка
  • Новое сообщение в сделке
  • Смена этапа сделки

Документация API: 2015.mag.travel/tourclient/dev/help

ТЗ-5. Метрики использования + NPS ▼

Зачем

Чтобы в М3 принять GO/NO GO решение нужны цифры: пользуются ли пилоты продуктом, какие фичи в топе, что им нравится.

Метрики продукта

  • DAU — сколько пилотов заходило в кабинет хотя бы 1 раз в день
  • AI-запросы / агентство / день — сколько генераций сделал каждый
  • Использование модулей — какой модуль популярнее (помощник vs реактивация)
  • Время до первой генерации — насколько быстрый онбординг

Технически

  • Модель AIUsageLog в БД: tenant_id, user_id, module, tokens_in, tokens_out, latency_ms, ts
  • Модель NPSResponse: tenant_id, score (0–10), comment, ts
  • Дашборд админа в /admin/metrics — графики DAU, разбивка по модулям

NPS-форма

  • Модальное окно в кабинете на 14-й и 30-й день после онбординга
  • Шкала 0–10 + комментарий
  • Цель: NPS ≥ 30 как порог "продукт нравится"

Бизнес-метрики GO/NO GO

  • Конверсия "пилот → платный" (целевой ≥ 50%)
  • Среднее количество ответов AI принятых менеджером
  • NPS на 30-й день
  • Готовность платить (по словам в кастдеве)
ТЗ-6. Onboarding flow для пилотных ТА ▼

Цель

Пилот должен получить ценность за 1 день. Если онбординг — это 3-часовая инструкция, никто не дойдёт до конца.

4 шага онбординга

  1. Подключение CRM (MAG.Travel) — токен из MAG, проверка коннекта
  2. Подключение мессенджера — WhatsApp / Telegram (через Wazzup24 / Telethon)
  3. Первый AI-диалог — пользователь видит как AI генерирует ответ на демо-сообщение
  4. Видео-инструкция — 5-минутный screencast по основным фичам (снимает Антон)

Поддержка

  • Чат поддержки в Telegram (ответ ≤ 4 часов рабочего времени)
  • Скрипт ответов на типовые вопросы у Шевелевой
  • 1-час видео-звонок при подключении (Тарасов)

Метрика

≥ 80% пилотов проходят все 4 шага в 1 день.

6 промптов MAG AI

Все промпты лежат в 03_промпты_MAG/ и при деплое переносятся в tourqual/prompts/mag_ai/.

manager_assistant
AI-помощник менеджера

Получает входящее сообщение от туриста, предлагает менеджеру 2–3 варианта ответа, классифицирует тип запроса (бронь / цена / возражение / вопрос), определяет следующий шаг.

qualifier
AI-квалификатор

Анна — виртуальный менеджер. Сама ведёт диалог: спрашивает направление, бюджет, состав, даты. Превращает свободный текст в JSON-параметры для подбора.

reactivation
Реактивация старых клиентов

Сегментация по дате последней сделки и направлению. Сезонные шаблоны (зима — Тай/ОАЭ, лето — Турция). Не отправляет если клиент уже ответил <30 дней назад.

deal_control
Контроль зависших сделок (Phase 2)

Находит сделки без активности > 5 дней. Анализирует диалог. Даёт рекомендацию менеджеру: что написать клиенту чтобы дожать.

kb_objections
База знаний: возражения

"Дорого", "Подумаю", "У других дешевле", "Сезон ещё далеко". 10 возражений × 3 техники работы каждой.

kb_destinations
База знаний: направления

15 топ-направлений 2026: лучшее время, цены, топ-курорты, виза, фишки. Подключается в qualifier и manager_assistant как контекст.

Календарь М1 (май)

НеделяЧто делаемКто
Неделя 1 (1–7 мая)Аудит TourQual + 6 ТЗ написаныАнтон
Неделя 2 (8–14 мая)Multi-product рефакторинг (БД, конфиги, роутинг). Промпты MAG.Антон
Неделя 3 (15–21 мая)Расширение MAG-коннектора. Брендинг шаблонов. Биллинг.Антон
Неделя 4 (22–28 мая)Метрики, NPS, onboarding. Демо-тенант. Smoke-тест.Антон
30 маяПрезентация команде + выдача onepager-овВсе 5