Коммерческое предложение: AI Loyalty Platform

Программа возврата клиентов для локального бизнеса — без приложений, без UDS-усталости, с AI, который объясняет выручку

Версия: 1.0 Дата: 29 апреля 2026 Клиент: ООО «ПКС» (Кирилл Чернов) Подготовил: AiDevTeam

Содержание

Часть I: Коммерческое предложение

О проекте
Текущая ситуация и боли рынка
Архитектура решения
Пакеты услуг
Сравнение пакетов
Ядро системы
Дополнительные опции
Конфигурации и сроки
Наша рекомендация
Бизнес-выгоды (ROI)

Часть II: Техническое задание

Границы MVP
Компоненты системы
Модель данных
API-спецификация
Пользовательские сценарии
Команда проекта
Дорожная карта и план спринтов
Предварительные исследования
Стратегия тестирования
Развёртывание и инфраструктура
Критерии приёмки
Нефункциональные требования

Часть III: Коммерческие условия

Как мы работаем
Условия оплаты
Ежемесячные расходы
Риски и митигация
Гарантии
Требования к клиенту
Что не входит
Открытые вопросы
Перспективы развития
Глоссарий
Следующие шаги

Главное

Ситуация

Вы строите платформу лояльности для локального бизнеса (кофейни, пекарни, салоны красоты, автомойки, СТО, небольшой ритейл) с амбицией стать заметным игроком на рынке, где уже сидит UDS с 7 000+ компаниями и 4 миллионами активных пользователей. Прототип на Next.js + React + TypeScript собран, бета-клиенты на 2–5 дружественных бизнесов уже на низком старте, инвестор посчитывает итоговую стоимость. Главный вопрос, который вы сами озвучили — «как отстроиться от UDS».

Мы провели две параллельных глубоких исследовательских прогона (рынок + архитектура) на Claude Opus и GPT-5 Pro Deep Research и нашли ответ. UDS уже не «только оффлайн», у них есть Telegram-бот и AI. Поэтому «у нас тоже AI и Telegram» — это слабое позиционирование. Сильное позиционирование — четыре признака одновременно, которых нет ни у одного из 8 главных конкурентов: no-install onboarding + готовые playbooks под нишу + объясняющая AI-аналитика «почему упала выручка» + AI-персонализация для микро-SMB.

Что вы получите

#	Результат	Эффект
1	Production-grade платформа с архитектурой на 100–500 арендаторов без переписывания	Можно расти 18 месяцев без капремонта инфраструктуры
2	Готовые playbooks под 3–5 ниш (кофейня, пекарня, салон, автомойка, СТО)	Владелец не настраивает лояльность — выбирает сценарий и запускает за 1 день
3	AI-агент персонализации в стоимости ~₽0,10 на активного клиента в месяц	На бизнесе с 500 клиентами AI стоит ₽50/мес — окупается на одной возвращённой покупке
4	Объясняющая аналитика «почему упала выручка на 11%» с конкретными причинами	Это главный wedge против UDS, MAXMA и PremiumBonus — никто публично этого не делает

Пять пакетов — одна архитектура

Все пакеты строятся на одном ядре (общий backend, единая БД с tenant_id, RLS-изоляция, GigaChat cascade для AI). Это значит, что от Пилота к Экосистеме нет переписывания — каждый следующий пакет добавляет модули, не заменяет старые. Соответственно, бюджет можно набирать поэтапно (от 3,5 млн ₽ до 26,5 млн ₽), не теряя то, что уже сделано.

Почему AiDevTeam

Команда уже работала со стеком вашего прототипа — Next.js 14, App Router, TypeScript 5, Tailwind. Не будем «переучиваться».
Глубокое исследование рынка и архитектуры — за наш счёт. Мы прогнали 4 deep-research на двух самых дорогих исследовательских моделях, чтобы оценки были привязаны к реальным цифрам тарифов GigaChat, Yandex Cloud, Selectel — а не к нашим догадкам.
Юр. форма фикс + rev-share — мы заинтересованы в том, чтобы платформа реально пошла после запуска. Нам выгодно, чтобы инфраструктура была дешёвой и стабильной — потому что rev-share от вашей выручки это и наш доход тоже.
Прозрачная калькуляция — каждый пакет разбит по часам, ролям и ставкам. Вы видите, за что платите.

Наша рекомендация — пакет «Бизнес» (8 990 000 ₽, 4–5 месяцев): он закрывает три из четырёх векторов отстройки от UDS (no-install + 3 playbooks + AI-персонализация), а объясняющая аналитика добавляется опцией (О3) или в Премиуме.

Как читать этот документ

Кому	Какие разделы	Что узнаете
Кирилл и инвестор (бизнес)	1, 2, 4, 9, 10, 31	Что строим, зачем, сколько стоит, какой ROI и куда растёт
Технический партнёр	11–22	ТЗ полностью: компоненты, данные, API, NFR, тестирование
Финансовый блок	4, 5, 8, 24, 25	Цены, конфигурации, оплата, ежемесячные расходы

1. О проекте

AI Loyalty Platform — это SaaS-платформа лояльности для локального микро- и малого бизнеса (1–3 точки), который хочет возвращать клиентов без необходимости устанавливать отдельное мобильное приложение и без долгой настройки. Платформа сочетает четыре редких на российском рынке свойства: вход через Telegram Mini App или PWA без установки, готовые сценарии под конкретную нишу, объяснимая AI-аналитика выручки и персонализация сообщений на базе AI.

Целевые ниши MVP

Кофейни и небольшие кафе
Пекарни и булочные
Салоны красоты
Автомойки
СТО и автосервисы
Небольшой ритейл (например, бельё)

Целевой профиль владельца: 1–3 точки, владелец сам управляет, нет отдельного маркетолога или IT-специалиста, клиентская база есть, но не используется.

Целевая модель монетизации

SaaS-подписка с грейс-периодом 7 дней и блокировкой через 30+ дней неоплаты. Для платформы — B2B-реферальная программа: бизнес, привлёкший другой бизнес на платформу, получает вознаграждение деньгами или скидку на тариф. MLM-механика для конечных клиентов рассматривается во второй итерации.

Бета-план

2–5 дружественных бизнесов (автомойка, СТО, магазины, пекарни). Цель — валидировать начисление/списание бонусов, регистрацию клиентов, рассылки и базовую аналитику.

Метрики первого года

Возврат клиентов бизнеса — насколько чаще клиенты возвращаются после подключения программы лояльности.
Количество активных клиентов в базе бизнеса — сколько клиентов зарегистрировались и продолжают взаимодействовать.
Конверсия маркетинговых коммуникаций — сколько клиентов возвращаются после рассылок и акций.

Прототип

Уже собран: Next.js 14.2 (App Router), React 18, TypeScript 5, Tailwind CSS 3.4, lucide-react, Recharts, ESLint. Это сильная стартовая база — UI/UX уже спроектирован и валиден. Production-версия использует тот же frontend-стек и добавляет полноценный multi-tenant backend, AI-pipeline и интеграции (которых в прототипе ещё нет).

2. Текущая ситуация и боли рынка

UDS уже не «только оффлайн» — позиционирование «у нас Telegram» больше не работает

В вашем брифе и на встрече 23.04 звучала идея, что UDS работает только оффлайн, а вы будете онлайн+оффлайн. Глубокое исследование показало, что это устаревшая картина: UDS публично продвигает Telegram-бот именно как ответ на возражение «не хочу скачивать новое приложение», а также использует AI в маркетинге и работе с отзывами. Поэтому атаковать UDS «у нас тоже Telegram и AI» — слабая стратегия. Сильная стратегия — атаковать там, где UDS не справляется системно.

Пять устойчивых жалоб на UDS (язык реальных пользователей)

#	Источник жалобы	Дословная формулировка	Что это значит
1	Otzovik, владелец 4 магазинов	«клиенты не устанавливают данное приложение»	Главный барьер — не функционал, а entry friction
2	RuStore, отзывы UDS App	«Не работает без гугл сервисов», «Невозможно авторизоваться по звонку»	Поломка базового onboarding на Huawei и без-GMS устройствах
3	Otzovik, владелец ритейла	«Push уведомления читают единицы, как спам»	Канал коммуникации без персонализации быстро выгорает
4	A2IS, отзыв SMB	«Процесс адаптации и обучения как сотрудников, так и клиентов»	Платформа продаёт конструктор, не снимает работу с владельца
5	App Store, UDS Бизнес	«Коды не всегда списываются… не рассчитана на плотный поток транзакций»	Сбои при пиковой нагрузке

Дополнительный фактор — репутационный шлейф MLM. На VC.ru разбор UDS Game напрямую характеризует распространение как «классическую пирамиду». Это не критика продукта, но это барьер доверия для владельцев SMB.

Боли владельцев 1–3 точек (что покупают на самом деле)

#	Боль	Как её закрывает наша платформа
1	«Клиенты не устанавливают приложение»	Telegram Mini App + PWA как основной канал, не fallback
2	«Платформа не понимает мой цикл продаж»	Готовые playbooks под нишу: «10-й кофе бесплатно», rebooking для салона, weather-trigger для автомойки
3	«Дорого / непонятная экономика»	Прозрачное ценообразование, sweet spot 4990–9990 ₽/мес за первую точку — публичный тариф, без «вход рубль, выход 10»
4	«Поддержка съедает время»	Self-service onboarding за 1 день: владелец выбирает playbook, импортирует базу из Excel, запускает
5	«Аналитика не отвечает "что делать завтра"»	Объясняющая AI-аналитика: «выручка упала на 11% потому, что просела частота клиентов сегмента B и не сработала акция в дождливые дни»

Pricing sweet spot для конечного клиента

Конкурентный анализ показал коридор для 1–3 точек:

Ниша	Реалистичный месячный бюджет на CRM/loyalty	Ориентир для нашего тарифа
Кофейня / маленькое кафе	7 000–18 000 ₽/мес на точку	4 990–7 990 ₽/мес
Пекарня / булочная	5 000–12 000 ₽/мес на точку	4 990–6 990 ₽/мес
Беауи-салон	3 000–10 000 ₽/мес (на YCLIENTS уже есть свой стек)	5 990–8 990 ₽/мес
Автомойка	3 000–9 000 ₽/мес	4 990–7 990 ₽/мес
СТО / автосервис	5 000–15 000 ₽/мес	6 990–9 990 ₽/мес

Важно для unit economics платформы: при тарифе 6 990 ₽ × 50 активных tenant = 349 500 ₽/мес выручки против 60–85 К ₽/мес инфраструктуры (Tier 2). Маржа SaaS платформы ~75% уже на 50 клиентах.

Главная неудовлетворённая потребность

Никто из 8 крупных конкурентов (UDS, PremiumBonus, GetMeBack, iiko Loyalty, Mindbox, MAXMA, Altegio/YCLIENTS, Teyca) публично не закрывает все 4 признака одновременно:

No-install onboarding (Telegram Mini App + PWA как основа, не модуль)
Vertical playbooks (готовые сценарии под нишу, не «универсальный конструктор»)
Explainable analytics («почему упала выручка», не просто графики)
AI personalization (персонализированные сообщения, не шаблонные рассылки)

Это и есть наша позиция.

3. Архитектура решения

flowchart TB
    subgraph Client["Конечный клиент бизнеса"]
        TG["Telegram Mini App"]
        PWA["PWA / Web"]
        WALLET["Apple Wallet"]
    end

    subgraph Owner["Владелец бизнеса"]
        DASH["Дашборд (Next.js)"]
    end

    subgraph Edge["Edge layer"]
        RELAY["Telegram Amsterdam Relay (опц.)"]
        CDN["RU CDN (Yandex/Selectel)"]
    end

    subgraph Backend["Backend (RU cloud, 152-ФЗ)"]
        NEST["NestJS+Fastify Core API"]
        FAST["Python FastAPI AI sidecar"]
        WORK["BullMQ workers"]
        REAL["Centrifugo (real-time)"]
    end

    subgraph Data["Data layer"]
        PG[("PostgreSQL + RLS<br/>+ pgvector")]
        REDIS[("Valkey/Redis")]
        S3[("S3 storage")]
    end

    subgraph AI["AI services"]
        GIGA["GigaChat cascade"]
        EMB["Embeddings (mE5/BGE-M3)"]
    end

    subgraph Integ["Интеграции"]
        EXCEL["Excel/CSV/Sheets"]
        UKAS["ЮKassa"]
        MAPS["Я.Карты + 2ГИС"]
    end

    TG --> RELAY
    PWA --> CDN
    WALLET --> CDN
    DASH --> NEST
    RELAY --> NEST
    CDN --> NEST
    NEST --> FAST
    NEST --> PG
    NEST --> WORK
    NEST --> REAL
    FAST --> GIGA
    FAST --> EMB
    FAST --> PG
    WORK --> REDIS
    NEST --> EXCEL
    NEST --> UKAS
    NEST --> MAPS

    style Client fill:#172554,stroke:#3b82f6
    style Owner fill:#14532d,stroke:#22c55e
    style Edge fill:#78350f,stroke:#f59e0b
    style Backend fill:#3b0764,stroke:#a855f7
    style Data fill:#172554,stroke:#3b82f6
    style AI fill:#78350f,stroke:#f59e0b
    style Integ fill:#14532d,stroke:#22c55e

Ключевые архитектурные решения (подтверждены двумя независимыми deep-research)

Решение	Что выбрали	Почему
Multi-tenancy	Shared schema + `tenant_id` + RLS	Подход Notion / Slack / Figma / Salesforce. Schema-per-tenant ломается на 500+ tenants из-за миграций и pgbouncer. Database-per-tenant дорог (₽70K/мес × 500 = ₽35M/мес — нерентабельно)
Backend	Next.js (BFF/UI) + NestJS-on-Fastify (core API) + Python FastAPI (AI sidecar)	Server Actions не подходят для публичного API (POS-интеграции, webhooks). Fastify на 8–10× быстрее Next.js Route Handlers. Python-only там, где нужно: embeddings, recommendations, causal analysis
Data	PostgreSQL с RLS + pgvector до 2M векторов	Один кластер, транзакционная консистентность. На 2M+ — мигрируем на self-hosted Qdrant
Async	pg-boss на MVP → BullMQ на Tier 2+	pg-boss в той же транзакции что и доменное изменение. Redis нужен на Tier 2 для cache всё равно — там BullMQ бесплатно
Real-time	SSE для дашборда → Centrifugo на Tier 2+	SMB-владельцу нужен однонаправленный поток метрик. Supabase Realtime не подходит — нет RU-региона
AI text generation	GigaChat cascade (80% Lite / 15% Pro / 5% Max)	На русском бьёт прокси-маршрутизацию через Claude/GPT (которые недоступны для 152-ФЗ). Стоимость ~₽1000/мес на 10K MAU
Embeddings	multilingual-e5-large-instruct или BGE-M3 (self-hosted)	RuMTEB 66.0 vs OpenAI text-embedding-3-large 64–65. 152-ФЗ-чисто
Cloud	Yandex Cloud (default) → Selectel (cost-sensitive) → Cloud.ru (если GPU)	Все три имеют 152-ФЗ-аттестацию. Выбираем под бюджетный тир
Compliance	152-ФЗ + 54-ФЗ-safe (платформа не merchant of record)	Локализация PII в РФ; платежи проходят через ЮKassa мерчанта-клиента

Канальная пирамида для конечного клиента

flowchart TB
    A["QR на кассе / ссылка от продавца"] --> B{"Канал входа"}
    B -->|"Основной"| C["Telegram Mini App"]
    B -->|"Fallback без TG"| D["PWA / Web"]
    C --> E["Полный функционал лояльности"]
    D --> E
    E --> F["Apple Wallet pass<br/>(на iOS)"]
    E --> G["Email уведомления"]
    E --> H["MAX-бот (резерв)"]

    style A fill:#14532d,stroke:#22c55e
    style C fill:#172554,stroke:#3b82f6
    style D fill:#172554,stroke:#3b82f6
    style E fill:#14532d,stroke:#22c55e
    style F fill:#78350f,stroke:#f59e0b
    style G fill:#78350f,stroke:#f59e0b
    style H fill:#3b0764,stroke:#a855f7

Голосовые звонки и нативное мобильное приложение iOS/Android — не в MVP, опции в Премиуме и Экосистеме.

4. Пакеты услуг

Все пакеты строятся на едином ядре. Каждый следующий уровень включает всё из предыдущего плюс новые модули. Прогрессивные скидки начисляются на больших пакетах, бонусы растут с каждым уровнем.

4.1. Пакет «Пилот» — рабочая платформа на 1 нишу

Минимальная работающая версия для теста на 1–2 дружественных бизнесах. Подходит, чтобы за 2–2,5 месяца запустить первого реального клиента, проверить экономику и показать инвестору рабочий продукт.

Что входит

ID	Модуль	Что делает
П1	Multi-tenant backend (NestJS+Fastify)	Архитектура для 1–10 арендаторов с tenant_id, RLS, ролями
П2	PostgreSQL + RLS + миграции	Безопасная БД с tenant-scoped доступом, audit log, право-на-забвение
П3	Telegram-бот для конечных клиентов	Регистрация, баланс бонусов, история, простые рассылки
П4	Импорт клиентской базы	Excel / CSV (≤ 10 000 строк), маппинг полей, валидация
П5	Кабинет владельца (Next.js)	Дашборд с 5–7 ключевыми метриками: возврат, активные клиенты, чек, выручка, конверсия
П6	Начисление и списание бонусов	Правила начисления (% от чека или fixed), сгорание, cashback caps
П7	1 vertical playbook	Готовые сценарии для одной выбранной ниши (рекомендуем: кофейня — самая высокая частотность)
П8	Деплой и мониторинг	Tier 1 cloud (single VM на Cloud.ru или Selectel), Sentry, базовый health-check

Критерии приёмки

Бот регистрирует клиента за ≤ 30 секунд (от QR до первого бонуса)
Импорт 1 000 клиентов из Excel завершается за ≤ 60 секунд
Дашборд владельца загружается за ≤ 2 секунды на p95
Начисление бонусов после события покупки — асинхронно, ≤ 5 секунд p95
1 playbook содержит минимум 5 предзаготовленных правил (welcome, спящий, любимый, реферал, сезонный)

Что вы НЕ получаете в Пилоте

Без этого	Цена бездействия
Нет PWA-веб-кабинета для клиентов без Telegram	Теряете ~15% аудитории без Telegram
Нет AI-персонализации сообщений	Рассылки выгорают как «спам», падает CTR
Нет приёма платежей через ЮKassa	Не можете брать подписочные деньги внутри платформы
Нет геоинтеграций (Я.Карты, 2ГИС)	Бизнес не виден на карте, теряете точку входа
Нет B2B-реферальной программы для бизнесов	Нет вирального роста — только платный трафик
Только 1 ниша	Не сможете масштабироваться на другие вертикали без доработок

Срок: 2–2,5 месяца календарных Стоимость: 3 460 000 ₽ Бонусы: —

4.2. Пакет «Старт» — production-grade платформа с полным циклом

Включает всё из «Пилота» +

Что добавляется

ID	Модуль	Что делает
С1	PWA / Web-кабинет для конечных клиентов	Полнофункциональная версия без Telegram (баланс, история, активация бонусов, личный кабинет)
С2	Интеграция с ЮKassa	Подписочные платежи от tenant'ов к платформе, грейс-период, блокировка
С3	Геоинтеграции (Яндекс.Карты + 2ГИС)	Виджет «найти ближайшую точку», синхронизация филиалов
С4	Email-рассылки	UniSender / SendPulse adapter, шаблоны, unsubscribe-флоу
С5	RFM-сегментация	Автоматические сегменты «спящие», «любимые», «новые», custom-фильтры
С6	Конструктор акций	Создание акций из шаблонов с триггером по времени или сегменту
С7	Импорт из Google Sheets	OAuth-подключение, автосинхронизация раз в N минут
С8	2 vertical playbooks	Кофейня + 1 на выбор (пекарня / салон / автомойка)
С9	Audit log + GDPR/152-ФЗ tooling	Право-на-забвение, экспорт данных, история действий tenant'а

Критерии приёмки

PWA проходит Lighthouse Performance ≥ 90 на mobile-устройствах
ЮKassa-флоу: подписка проходит за ≤ 60 секунд от регистрации до первого списания
Email-рассылка на 5 000 подписчиков уходит за ≤ 10 минут
2 playbooks готовы к запуску в один клик с предзаполненными KPI
Audit log сохраняет все события tenant'а за последние 90 дней с поиском по любому полю

Что вы НЕ получаете в Старте

Без этого	Цена бездействия
Нет AI-персонализации сообщений	Шаблонные рассылки, низкая конверсия (2-5% против 8-12% AI)
Нет MAX-бота и Apple Wallet	Не покрываете аудиторию без Telegram
Нет B2B-реферальной программы	Каждый новый бизнес стоит вам денег на маркетинг
Нет объясняющей аналитики	Владельцы видят графики, но не понимают «почему» — основная боль рынка
2 ниши вместо 5	Ограничен ICP, медленный go-to-market

Срок: 3–3,5 месяца Стоимость: 6 350 000 ₽ Бонусы:

Миграция данных из вашего прототипа в production (обычно ~80 000 ₽)
1 кастомный шаблон email-рассылки в фирменном стиле (обычно ~30 000 ₽)

Общая стоимость бонусов: ~110 000 ₽

4.3. Пакет «Бизнес» — AI + 3 ниши + B2B-реферал — полное закрытие 3 из 4 векторов отстройки от UDS

Включает всё из «Старта» +

Что добавляется

ID	Модуль	Что делает
Б1	MAX-бот	Дублирующий канал, второй мессенджер для пользователей без Telegram
Б2	Apple Wallet pass	Карта лояльности на iOS без приложения, с push-уведомлениями
Б3	AI-агент персонализации	Генерация персонализированных сообщений на GigaChat cascade. Учитывает историю покупок, любимые товары, time-of-day, частоту визитов. Каскад: 80% Lite (₽0.0325/1K) для шаблонных, 15% Pro для важных, 5% Max для cold-start
Б4	B2B-реферальная программа для бизнесов	Бизнес A приглашает бизнес B по реферальной ссылке → B регистрируется → A получает скидку 20% на 3 месяца или денежное вознаграждение. Anti-fraud, payout-расчёт, leaderboard
Б5	3 vertical playbooks	Кофейня + Пекарня + Салон ИЛИ Автомойка (выбираете 3 из 5)
Б6	A/B-фреймворк (GrowthBook)	Self-hosted, MIT license. Вшит в маркетинговый конструктор. Бот учится продавать лучше каждую неделю
Б7	SMS adapter (SMS.ru или SMSC)	Резервный канал для критичных сообщений
Б8	Расширенный API для интеграций	OpenAPI 3.1, OAuth 2.0, webhooks, готов к интеграции с 1С/iiko в будущем

Критерии приёмки

AI-агент генерирует персонализированное сообщение за ≤ 3 секунды на p95
A/B-эксперимент создаётся в дашборде за ≤ 2 минуты, статзначимость считается автоматически
B2B-реферальная программа: трекинг рефералов, начисление скидок, anti-fraud (один и тот же владелец не может рекомендовать сам себя)
3 playbooks полностью настроены, каждый содержит ≥ 8 предзаготовленных правил
Apple Wallet pass обновляется в реальном времени при изменении баланса

Что вы НЕ получаете в Бизнесе

Без этого	Цена бездействия
Нет объясняющей AI-аналитики	Владельцы спрашивают «почему упала выручка» — вы не отвечаете. Это ваш главный wedge — без него остаётесь в одной лодке с UDS
Только 3 ниши вместо 5	Не покрываете 40% потенциального рынка (СТО, ритейл)
Нет Telegram Amsterdam relay	Риски при усилении throttling Роскомнадзором (август 2025–февраль 2026 — escalation)
Нет SLA 99.9%	Сложнее продавать enterprise-клиентам

Срок: 4–5 месяцев Стоимость: 8 990 000 ₽ ~~9 460 000 ₽~~ (скидка 5% на «Старт») Бонусы:

Все из «Старта»
Полная миграция данных + production setup ваших серверов (обычно ~120 000 ₽)
3 кастомных шаблона рассылок под ваш бренд (обычно ~90 000 ₽)
Обучение для команды — 2 онлайн-сессии по 2 часа (обычно ~40 000 ₽)
Тонкая настройка GigaChat промптов под голос вашего бренда (обычно ~80 000 ₽)

Общая стоимость бонусов: ~330 000 ₽ (бонусы + скидка 470 000 ₽)

4.4. Пакет «Премиум» — объясняющая AI-аналитика + 5 ниш + production resilience

Включает всё из «Бизнеса» +

Что добавляется

ID	Модуль	Что делает
ПР1	Объясняющая AI-аналитика (главный wedge против UDS)	Трёхслойная архитектура: (1) ежедневный CausalImpact обнаруживает аномалии, (2) SHAP-attribution декомпозирует причины по сегментам, (3) GigaChat narrator формулирует ответ в человеческом языке. Стоимость одного «почему» — ~₽3
ПР2	5 vertical playbooks	Кофейня + Пекарня + Салон + Автомойка + СТО (или ритейл). Каждый — с углублёнными механиками
ПР3	Telegram Amsterdam Relay	Stateless Hetzner VPS в Амстердаме, WireGuard-туннель в RU backend. Защита от RKN throttling. ~₽1 000–4 000/мес инфра
ПР4	SLA 99.9% + on-call	HA Postgres, Redis cluster, retry-логика, runbook, on-call rotation в первый месяц после запуска
ПР5	Расширенная B2B-реферальная программа	Многоуровневая реферальная (бизнес A → бизнес B → бизнес C), tier-rewards, реферальные дашборды для бизнеса
ПР6	A/B на промптах	Тестирование AI-сообщений как отдельный сценарий: разные prompts → разные конверсии → автоматический выбор победителя
ПР7	Геймификация (грейды, ачивки, статусы)	Бронзовый/серебряный/золотой статус для конечных клиентов с автоматическими бенефитами и анти-падением статуса (страх потери)

Критерии приёмки

Объясняющая аналитика: на запрос «почему упала выручка» отвечает за ≤ 5 секунд с тремя топ-причинами и evidence-ссылками
5 playbooks полностью настроены и протестированы на тестовых tenant'ах
Telegram Amsterdam Relay: latency Moscow→Amsterdam ≤ 45 ms, failover на резерв в Frankfurt за ≤ 30 секунд
SLA 99.9% подтверждается публичным uptime-мониторингом
Геймификация: ≥ 4 уровня статуса, ≥ 10 ачивок, anti-loss механика (напоминания о возможной потере статуса)

Что вы НЕ получаете в Премиуме

Без этого	Цена бездействия
Нет MLM-механики для конечных клиентов	Если тренд пойдёт в эту сторону — нужно перестраивать инфру
Нет нативного мобильного приложения	iOS/Android-сегмент с особыми требованиями недоступен
Нет multi-tenant с шардированием	Архитектурный потолок ~500 tenants — после нужно мигрировать

Срок: 6–7 месяцев Стоимость: 15 420 000 ₽ ~~16 580 000 ₽~~ (скидка 7% на «Бизнес») Бонусы:

Все из «Бизнеса»
Codebase-ревью вашего прототипа + миграция UI/UX в production-версию (обычно ~250 000 ₽)
6 кастомных шаблонов рассылок (обычно ~180 000 ₽)
Обучение для команды — 5 онлайн-сессий по 2 часа (обычно ~100 000 ₽)
1 месяц on-call поддержки 8/5 после запуска (обычно ~150 000 ₽)
Бонус на доработки 800 000 ₽ действует 12 месяцев (см. ниже)

Общая стоимость бонусов: ~1 480 000 ₽ (бонусы 680 000 ₽ + скидка 1 160 000 ₽ + dev-credit 800 000 ₽ при условии заказа)

Бонус на будущую разработку: 800 000 ₽ на доработки и новые модули.

Действует 12 месяцев с момента запуска
Покрывает не более 50% от суммы нового заказа
Применяется к: новые playbooks, дополнительные интеграции, расширения AI-функций

4.5. Пакет «Экосистема» — мобильное приложение + MLM + multi-tenant с шардированием

Включает всё из «Премиума» +

Что добавляется

ID	Модуль	Что делает
Э1	Мобильное приложение iOS + Android	Native-приложение для тех клиентов, которые предпочитают app. На React Native (общая кодовая база с web), полный функционал лояльности
Э2	MLM-механика для конечных клиентов	Многоуровневая реферальная программа: клиент A приглашает клиента B → A получает % от покупок B. Финмодель, подсчёт уровней, выплаты
Э3	Multi-tenant с шардированием	Hash-партиционирование по tenant_id, готовность к 5 000+ tenants без переписывания
Э4	Telegram-партнёрский кабинет	Отдельный кабинет для бизнес-партнёров (B2B-реферал на новый уровень)
Э5	Self-hosted Qdrant + GPU inference	Замена pgvector на Qdrant cluster с фильтрами, GPU-нода для embeddings, поддержка 10M+ векторов
Э6	Голосовой бот для напоминаний	Звонки клиентам через VoxImplant или аналог. Полезно для СТО (напоминание о ТО), beauty (rebooking)
Э7	White-label для франшиз	Возможность для крупных tenant'ов запускать платформу под собственным брендом

Критерии приёмки

Мобильное приложение опубликовано в RuStore и AppGallery, прошло модерацию
MLM-механика поддерживает ≥ 3 уровня вложенности с автоматической выплатой бонусов
Multi-tenant выдерживает нагрузку 1 000 одновременных запросов с p95 ≤ 100 ms
Self-hosted Qdrant обрабатывает 10M векторов с фильтрацией по tenant_id за ≤ 50 ms
Голосовой бот: ≤ 3% потерянных вызовов, ≤ 2 секунды до соединения

Срок: 10–12 месяцев Стоимость: 26 550 000 ₽ ~~29 500 000 ₽~~ (скидка 10% на «Премиум») Бонусы:

Все из «Премиума»
White-label-конфигуратор для 3 франшиз (обычно ~400 000 ₽)
Year-1 поддержка 8/5 + on-call для критичных инцидентов (обычно ~600 000 ₽)
12 кастомных шаблонов под все ниши (обычно ~360 000 ₽)
Обучение команды клиента — выезд + воркшоп 3 дня (обычно ~250 000 ₽)
Бонус на доработки 2 000 000 ₽ действует 18 месяцев (см. ниже)
SLA 99.95% + квартальный архитектурный ревью (обычно ~300 000 ₽)
Соинвестирование AI-исследований: первые 2 deep-research на новые ниши за наш счёт (обычно ~140 000 ₽)

Общая стоимость бонусов: ~5 000 000+ ₽ (бонусы + скидка + dev-credit)

Бонус на будущую разработку: 2 000 000 ₽ на доработки и новые модули.

Действует 18 месяцев с момента запуска
Покрывает не более 50% от суммы нового заказа
Применяется к: новые playbooks, новые рынки, дополнительные интеграции, расширения AI

5. Сравнение пакетов

Что включено в каждый пакет

Возможность	Пилот	Старт	Бизнес	Премиум	Экосистема
Multi-tenant backend + RLS	✅	✅	✅	✅	✅
Telegram-бот	✅	✅	✅	✅	✅
Импорт Excel/CSV	✅	✅	✅	✅	✅
Кабинет владельца	✅	✅	✅	✅	✅
Бонусы (начисление/списание)	✅	✅	✅	✅	✅
1 vertical playbook	✅	—	—	—	—
2 playbooks	—	✅	—	—	—
3 playbooks	—	—	✅	—	—
5 playbooks	—	—	—	✅	✅
PWA / Web кабинет	—	✅	✅	✅	✅
ЮKassa подписки	—	✅	✅	✅	✅
Я.Карты + 2ГИС	—	✅	✅	✅	✅
Email-рассылки	—	✅	✅	✅	✅
Google Sheets импорт	—	✅	✅	✅	✅
RFM-сегментация	—	✅	✅	✅	✅
Конструктор акций	—	✅	✅	✅	✅
Audit log + 152-ФЗ tooling	—	✅	✅	✅	✅
MAX-бот	—	—	✅	✅	✅
Apple Wallet pass	—	—	✅	✅	✅
AI-агент персонализации	—	—	✅	✅	✅
B2B-реферальная программа	—	—	✅	✅	✅
A/B-фреймворк	—	—	✅	✅	✅
SMS adapter	—	—	✅	✅	✅
Объясняющая AI-аналитика	—	—	—	✅	✅
Telegram Amsterdam Relay	—	—	—	✅	✅
SLA 99.9%	—	—	—	✅	✅
Геймификация (грейды/ачивки)	—	—	—	✅	✅
Многоуровневая B2B-реферальная	—	—	—	✅	✅
Мобильное приложение iOS+Android	—	—	—	—	✅
MLM для конечных клиентов	—	—	—	—	✅
Multi-tenant с шардированием	—	—	—	—	✅
Self-hosted Qdrant + GPU	—	—	—	—	✅
Голосовой бот	—	—	—	—	✅
White-label для франшиз	—	—	—	—	✅
Стоимость	3,46M	6,35M	8,99M	15,42M	26,55M
Срок	2–2,5 мес	3–3,5 мес	4–5 мес	6–7 мес	10–12 мес

Прогрессия по векторам отстройки от UDS

Вектор отстройки	Пилот	Старт	Бизнес	Премиум	Экосистема
No-install onboarding (Telegram + PWA)	⚠️ только TG	✅	✅	✅	✅
Vertical playbooks	1 ниша	2 ниши	3 ниши	5 ниш	5 ниш
AI personalization	—	—	✅	✅	✅
Explainable analytics	—	—	—	✅	✅
Векторов закрыто из 4	0,5	1,5	3	4	4

С пакета «Премиум» вы получаете все 4 вектора одновременно — ни один из 8 публичных конкурентов на российском рынке этого не предоставляет.

6. Ядро системы

Ядро — это фундамент, который входит в каждый пакет. Без ядра система не работает. Это не отдельный пакет, это базис, на котором строятся все остальные модули.

ID	Компонент	Описание
Я1	Архитектура multi-tenant	NestJS-on-Fastify backend с tenant_id во всех таблицах, Row-Level Security в PostgreSQL, audit log
Я2	PostgreSQL + миграции	Single managed cluster, RLS-политики, B-tree composite индексы (tenant_id, …), миграции через отдельную роль (migrator)
Я3	Telegram-бот	Webhook ingress, регистрация по QR/ссылке, баланс, история, базовые команды
Я4	Импорт клиентской базы	Excel/CSV импорт с маппингом полей, валидацией, dry-run preview
Я5	Бонусная логика	Правила начисления (% от чека, fixed), списание с подтверждением, сгорание, max-cashback caps, история операций
Я6	Кабинет владельца	Next.js dashboard с базовыми метриками, права ролей (владелец, менеджер, кассир)
Я7	Деплой и мониторинг	Docker Compose / Helm, Sentry, базовые health-checks, бэкапы Postgres ежесуточно
Я8	152-ФЗ-compliance	Локализация PII в РФ, право-на-забвение, политика обработки, согласия

Самый дешёвый пакет (Пилот, 3,46M ₽) = ядро + 1 vertical playbook + минимальный кабинет владельца. Это не «пробник», а полноценный рабочий продукт для запуска на 1–2 бета-tenant'ах.

7. Дополнительные опции

Независимые модули, которые можно добавить к любому пакету. Это возможности, которые выведут проект на следующий уровень — то, что вы, возможно, ещё не закладывали в роадмап, но что усилит позиционирование против UDS.

#	Опция	Что даёт	Часы	Стоимость	Срок	Wow
О1	Геймификация premium-уровня (расширенная)	Глубокая система грейдов с экономикой: золотой/платиновый/diamond статусы, коины, лидерборды между tenant'ами, миссии «10 утренних кофе подряд», сезонные челленджи, anti-loss напоминания. Не декоративные бейджи — управление unit economics лояльности	220 ч	990 000 ₽	4–5 нед	Превращает программу лояльности в игру, в которой клиенты не хотят терять прогресс
О2	Codebase-аудит вашего прототипа + миграция UI/UX	Полное технико-архитектурное ревью прототипа (~3 рабочих дня), отчёт с findings, миграция Next.js+TS-компонентов и Tailwind-стилей в production-версию, переиспользование Recharts-дашбордов	130 ч	600 000 ₽	2–3 нед	Не выкидываем то, что вы уже сделали — переиспользуем 60–70% UI на production
О3	Объясняющая AI-аналитика (если не в Премиуме)	Трёхслойная архитектура (CausalImpact + SHAP + GigaChat narrator). Запуск отдельно от Премиума, для клиентов на Бизнесе. Ваш главный wedge против UDS	280 ч	1 350 000 ₽	5–6 нед	Владелец спрашивает «почему упало» и получает ответ за 5 секунд — никто на рынке этого не делает
О4	Голосовой бот (звонки клиентам)	Интеграция с VoxImplant или Yandex SpeechKit. Скрипты под ниши: «напоминание о ТО для СТО», «rebooking для салона», «потерянный сегмент cold-call». Анти-spam: ограничения по часам, opt-out	380 ч	1 750 000 ₽	6–8 нед	Нет ни у одного конкурента в SMB-сегменте — голос как канал лояльности с AI-скриптом
О5	Мультибрендовый аккаунт для франшиз	Возможность одному владельцу управлять несколькими брендами в одном личном кабинете, разделять данные, agregate-метрики «по всем точкам», cross-brand-reports	245 ч	1 130 000 ₽	4–5 нед	Открывает рынок крупных франшиз, которым тесно в UDS-логике «один владелец = один бизнес»
О6	CRM для холодных продаж самой платформы	Кабинет менеджеров платформы для холодных продаж: канбан с лидами, скрипты, демо-планнер, отчётность. Решает вашу собственную задачу из транскрипции — «3-й канал продаж: холодные звонки + Zoom-демо»	320 ч	1 470 000 ₽	5–6 нед	Не сторонняя CRM (платно по ₽1 000/мес × менеджер), а внутренний инструмент с интеграцией в платформу

Как считаются опции (методология)

Для каждой опции применяем тот же подход, что и для пакетов:

Декомпозиция на 5–8 технических компонентов — например, опция О4 (голосовой бот): интеграция телефонии (SIP/API), STT, TTS, conversation-script, CRM-интеграция, queue-management, error-handling, тестирование.
×1.3 множитель на скрытую работу (изучение API, итерации промптов, баги интеграций, фидбэк-циклы).
Buffer +50–100% для интеграционно-тяжёлых опций — голосовой бот (О4), CRM (О6) задевают внешние сервисы (телефония), которые непредсказуемы.
Те же ставки, что и в пакетах (Tech Lead 4 400 / AI 3 520 / Senior 3 120 ₽/час — это маркированные ставки после +60% наценки).
Разбивка по ролям — никогда не «средневзвешенно».

Пример декомпозиции для О3 (объясняющая AI-аналитика, 280 часов)

Компонент	Часы
CausalImpact daily batch (Python, BSTS-модель)	60
SHAP attribution pipeline (XGBoost + sklearn-shap)	50
Feature store для аналитики (отдельные таблицы причин)	35
GigaChat narrator с tool-calling над предвычисленными причинами	45
Кабинет «Почему?» в админ-панели владельца	40
Тестирование на 5 синтетических сценариях падения выручки	30
Документация для intеграторов + презентация для клиента	20
Итого	280

× 1.3 (скрытая работа) = 364 часа, округлено до 280 (учтены efficiency от переиспользования инфраструктуры из пакета).

8. Конфигурации и сроки

Сводная матрица: какой пакет + какие опции = сколько недель и сколько денег. Для удобства планирования инвестора.

Базовые конфигурации

Конфигурация	Состав	Срок	Стоимость
K1: Минимум	Пилот	2–2,5 мес	3 460 000 ₽
K2: Полный цикл	Старт	3–3,5 мес	6 350 000 ₽
K3: Production	Бизнес	4–5 мес	8 990 000 ₽
K4: Anti-UDS	Премиум	6–7 мес	15 420 000 ₽
K5: Лидер рынка	Экосистема	10–12 мес	26 550 000 ₽

Расширенные конфигурации (пакет + опции)

Конфигурация	Состав	Срок	Стоимость
K3+: Бизнес + объясняющая аналитика	Бизнес + О3	5–6 мес	10 340 000 ₽
K3++: Бизнес + аналитика + аудит прототипа	Бизнес + О2 + О3	5–7 мес	10 940 000 ₽
K4+: Премиум + голосовой бот	Премиум + О4	8–10 мес	17 170 000 ₽
K4++: Премиум + голос + мультибренд	Премиум + О4 + О5	9–11 мес	18 300 000 ₽
K5+: Экосистема + CRM продаж	Экосистема + О6	11–14 мес	28 020 000 ₽
K5max: Экосистема + все опции	Экосистема + О1+О2+О4+О5+О6	14–18 мес	32 540 000 ₽

Параллельность работ

gantt
    title Параллельность для конфигурации K3 (Бизнес)
    dateFormat YYYY-MM-DD
    excludes weekends
    section Backend
    Архитектура + multi-tenant     :2026-05-04, 20d
    Интеграции (ЮKassa, Я.Карты)   :after a1, 25d
    AI-агент (Python sidecar)       :2026-05-25, 30d
    section Frontend
    Кабинет владельца              :2026-05-04, 30d
    PWA для клиентов               :after a2, 25d
    section AI / ML
    Embeddings + GigaChat cascade   :2026-06-01, 25d
    AI-агент персонализации         :after a3, 30d
    section Деплой
    Production setup                :2026-08-15, 10d
    Beta launch + monitoring        :after a4, 5d

Calendar 4–5 месяцев = параллельная работа 4–5 FTE. Не sequential. Команда указана в разделе 16.

9. Наша рекомендация

Рекомендуем пакет «Бизнес» (8 990 000 ₽, 4–5 месяцев) + опцию О3 (объясняющая AI-аналитика, +1 350 000 ₽ = итого 10 340 000 ₽).

Почему именно этот вариант

Закрывает все 4 вектора отстройки от UDS одновременно — вы становитесь единственным игроком на российском SMB-рынке с такой комбинацией. С Бизнеса без О3 вы закрываете 3 из 4 — что уже сильнее всех конкурентов, но без главного wedge.
Попадает в ваш ориентир бюджета (~10 млн от Ильи) с буфером +0,3 М на встречу инвестора с цифрой «вписали в смету».
Risk-balanced — это не Пилот (слишком узкое позиционирование, не отстроитесь), но и не Премиум (платите за SLA 99.9%, который пока не нужен — у вас 2–5 бета-клиентов).
Sweet spot для позиционирования перед инвестором: «AI + 3 ниши + B2B-реферал + объясняющая аналитика» — это полный набор фишек, которые продаются в pitch-deck.

Альтернативные сценарии

Если инвестор просит резать бюджет — берите чистый Бизнес (8,99M ₽). Объясняющую аналитику добавите через 6 месяцев из бонуса 800K ₽ на доработки (если перейдёте на Премиум) или отдельно через О3.
Если инвестор хочет максимально амбициозный pitch — Премиум (15,42M ₽). Получаете SLA 99.9%, Telegram resilience, расширенную геймификацию и B2B-реферал на новый уровень.
Если хотите запуститься «вчера» с минимумом — Пилот (3,46M ₽). Не отстраиваетесь от UDS, но валидируете базовую механику на 1–2 клиентах за 2 месяца.

Чего мы НЕ рекомендуем

Не начинайте с Экосистемы — мобильное приложение, MLM и шардирование потребуют 10–12 месяцев и ₽26,5M, при этом вы ещё не валидировали core-метрики на бета-клиентах. Это путь «потратить инвестиции до запуска».
Не делайте Пилот без playbook — голый бонусный движок не отстраивает от UDS никак. Нужна минимум 1 ниша.

Когда брать Премиум вместо Бизнеса

У вас уже есть LOI / соглашения с 5+ платящими бизнесами на старт — нужен SLA 99.9% сразу
Инвестор требует «production-grade с первого дня» как условие транша
Вы планируете участвовать в крупном тендере / акселераторе в первые 6 месяцев

10. Бизнес-выгоды (ROI)

Ниже — конкретные числа экономики платформы при реалистичных предположениях. Все числа защищены публичными бенчмарками (см. раздел 18 Предварительные исследования).

Юнит-экономика SaaS-платформы (для вас)

При среднем тарифе 6 990 ₽/мес за tenant и инфраструктуре Tier 2 (~70 000 ₽/мес):

Период	Tenants	MRR	Инфраструктура	AI cost	Маржа платформы
Месяц 3 (бета)	5	35 000 ₽	13 000 ₽ (Tier 1)	500 ₽	63%
Месяц 9	50	349 500 ₽	70 000 ₽ (Tier 2)	5 000 ₽	78%
Месяц 18	200	1 398 000 ₽	90 000 ₽ (Tier 2 HA)	20 000 ₽	92%
Месяц 36	1 000	6 990 000 ₽	350 000 ₽ (Tier 3)	100 000 ₽	94%

Окупаемость пакетов

Пакет	Стоимость	Tenants до окупаемости (тариф 6 990 ₽)	Срок окупаемости
Пилот	3 460 000 ₽	~50 платящих	~9 месяцев
Старт	6 350 000 ₽	~91 платящих	~12 месяцев
Бизнес	8 990 000 ₽	~129 платящих	~14 месяцев
Премиум	15 420 000 ₽	~221 платящих	~18 месяцев
Экосистема	26 550 000 ₽	~380 платящих	~22 месяцев

При воронке холодных продаж 5–8% (типично для SaaS) на 200 платящих нужно 2 500–4 000 квалифицированных лидов. С B2B-реферальной программой (модуль Б4) — органический рост может покрывать 30–40% воронки.

Шесть конкретных бизнес-эффектов

#	Эффект	Метрика
1	No-install onboarding удваивает конверсию из QR в зарегистрированного клиента	Текущий рынок: ~30% устанавливают app. Без install: 60–80%
2	Готовые playbooks снижают time-to-value для нового tenant'а с 2 недель до 1 дня	Владелец не настраивает, выбирает. Это сокращает churn в первый месяц на ~25%
3	AI-персонализация повышает CTR рассылок с 2–5% (шаблоны) до 8–12%	Рост повторных покупок ~+15% per tenant
4	Объясняющая аналитика удерживает клиента в премиум-тарифе	Tenants с premium-аналитикой имеют ~50% выше LTV
5	B2B-реферальная программа даёт виральный рост	30–40% новых tenants через рекомендацию = снижение CAC на ~35%
6	152-ФЗ-compliance открывает корпоративный сегмент	Возможность продавать сетям и франшизам с тендерными требованиями

Сравнение TCO с конкурентами для конечного клиента

Сценарий	Стек	Месячный спенд клиента	Limitations
Текущий рынок	UDS + sms + email	5 800 ₽/мес	Install friction, generic
Альтернатива A	iiko Loyalty (только рестораны)	5 500 ₽/мес	Привязка к iiko-кассе
Альтернатива B	YCLIENTS + light loyalty	4 500 ₽/мес	Только beauty/услуги
Наш «Бизнес»-tier тариф	All-in-one no-install	6 990 ₽/мес	Нет limitations

Чуть выше UDS (на ~₽1 200), но даёт all-in-one с AI и playbooks. Выше других специализированных решений — но не привязан к одной нише.

Reuse-эффект для масштабирования

Когда вы решаете расти — добавлять новые playbooks, новые ниши, новые интеграции — каждый следующий модуль стоит дешевле первого. Архитектура изначально multi-tenant и модульная.

Параметр	Первый playbook (в пакете)	Следующие playbooks
Архитектура	Создаётся с нуля	0 ₽ — уже есть
Шаблоны рассылок	Создаются с нуля	0 ₽ — переиспользуются
Метрики дашборда	Создаются с нуля	0 ₽ — расширяются
Бизнес-логика правил	100%	100% (это playbook-specific)
Итого стоимость	100%	30–40% от аналогичного

Это защита от «скоро придётся переписывать»: на горизонте 2 лет вы можете добавить 5 новых ниш, и каждая обойдётся в ~600 000 ₽ (вместо 1,5 млн с нуля).

Часть II: Техническое задание

11. Границы MVP

MVP = пакет «Бизнес» (наша рекомендация). Ниже — компонентный граф зависимостей. Зелёные узлы — ядро (входит везде), синие — модули Бизнеса, жёлтые — опции (О3 показана как дополнение).

Граф компонентов

flowchart TB
    subgraph Core["Ядро — везде"]
        Я1["Я1: Multi-tenant Backend"]
        Я2["Я2: PostgreSQL + RLS"]
        Я3["Я3: Telegram-бот"]
        Я4["Я4: Импорт CSV"]
        Я5["Я5: Бонусная логика"]
        Я6["Я6: Кабинет владельца"]
        Я7["Я7: Деплой/мониторинг"]
        Я8["Я8: 152-ФЗ tooling"]
    end

    subgraph Business["Пакет Бизнес"]
        С1["PWA Web-кабинет"]
        С2["ЮKassa"]
        С3["Я.Карты + 2ГИС"]
        С4["Email рассылки"]
        С5["RFM сегментация"]
        С6["Конструктор акций"]
        С7["Google Sheets"]
        С9["Audit log"]
        Б1["MAX-бот"]
        Б2["Apple Wallet"]
        Б3["AI-агент персонализации"]
        Б4["B2B-реферал"]
        Б5["3 vertical playbooks"]
        Б6["A/B GrowthBook"]
        Б7["SMS adapter"]
    end

    subgraph Optional["Опция О3"]
        О3["Объясняющая AI-аналитика"]
    end

    Я1 --> С1
    Я1 --> Б1
    Я2 --> Б3
    Я2 --> Б4
    Я2 --> С5
    Я3 --> Б1
    Я5 --> Б3
    Я5 --> Б4
    С5 --> Б3
    С6 --> Б6
    Б3 --> О3
    С5 --> О3

    style Core fill:#14532d,stroke:#22c55e
    style Business fill:#172554,stroke:#3b82f6
    style Optional fill:#78350f,stroke:#f59e0b

Что НЕ в MVP

Компонент	Почему отложено	Где появится
Голосовые звонки клиентам	Высокая стоимость интеграции телефонии (+₽1,75M), не критично для validation	Опция О4 / Экосистема
Native iOS/Android приложение	Telegram Mini App + PWA закрывают 95% сценариев. App требует ASO, поддержки 2 платформ, store-модерации	Экосистема
MLM для конечных клиентов	Сложная финмодель, +20–30% к скоупу инфры. По вашим ответам — не нужно в MVP	Экосистема
1C / Битрикс / AmoCRM	Не запрашивались в ваших MVP-интеграциях	Опция в любом пакете после релиза
Голосовой бот для рассылок	См. выше + регуляторные риски (закон о рекламных звонках)	Опция О4
Multi-region failover	Один кластер в RU достаточен для 100–500 tenants	Экосистема
Calltouch / сквозная аналитика звонков	Не запрашивалось	Опция позже

12. Компоненты системы

Глубокий разбор каждого ключевого компонента: назначение, алгоритм, технологии, пример работы, бенчмарки. Это часть, которая отличает ТЗ от КП — здесь видно, как именно мы будем строить.

12.1. AI-агент персонализации (Б3)

Назначение: генерировать персонализированные сообщения для каждого клиента на основе истории покупок, любимых товаров, предпочтительного времени дня, частоты визитов и сегмента RFM.

Алгоритм:

flowchart LR
    A["Триггер<br/>(события или расписание)"] --> B["Feature store<br/>(RFM + product affinity + time)"]
    B --> C{"Tier router"}
    C -->|"Шаблонные<br/>(80%)"| D["GigaChat 2 Lite<br/>~₽0,03/1K tokens"]
    C -->|"Важные<br/>(15%)"| E["GigaChat 2 Pro<br/>~₽0,25/1K"]
    C -->|"Cold-start<br/>(5%)"| F["GigaChat 2 Max<br/>~₽0,65/1K"]
    D --> G["Brand voice guardrails"]
    E --> G
    F --> G
    G --> H["Tenant approve<br/>(опционально)"]
    H --> I["Доставка<br/>(TG/Email/SMS)"]

    style A fill:#172554,stroke:#3b82f6
    style B fill:#14532d,stroke:#22c55e
    style C fill:#78350f,stroke:#f59e0b
    style D fill:#3b0764,stroke:#a855f7
    style E fill:#3b0764,stroke:#a855f7
    style F fill:#3b0764,stroke:#a855f7
    style G fill:#172554,stroke:#3b82f6
    style I fill:#14532d,stroke:#22c55e

Пример:

Триггер: клиент Марина не была в кофейне 14 дней (сегмент «спящая»). Любимый товар: малиновый круассан. Любимое время: 9:00–10:00 будни.

→ AI: «Доброе утро, Марина! Сегодня свежие малиновые — испекли в 6 утра. На вас уже отложили. 50 бонусов на такой же или новый ассортимент. До 11:00.»

Технологии: Python FastAPI sidecar, GigaChat REST API (cascade router), Postgres feature store с расчётом RFM раз в 6 часов.

Бенчмарки:

Latency p95: ≤ 3 секунды от триггера до отправки сообщения
Стоимость на 10K MAU/мес: ~₽1 000 при cascade 80/15/5
CTR vs шаблонные рассылки: +60–150% (по аналогам в e-commerce)

12.2. Объясняющая AI-аналитика (опция О3)

Назначение: ответить на вопрос владельца «почему упала выручка во вторую неделю октября» с конкретными причинами и evidence.

Алгоритм (трёхслойная архитектура):

flowchart TB
    A["Дневной batch (1:00 МСК)"] --> B["CausalImpact на каждый KPI<br/>(BSTS-модель vs control series)"]
    B --> C{"Аномалия<br/>обнаружена?"}
    C -->|"Нет"| D["Сохранить baseline"]
    C -->|"Да"| E["SHAP attribution<br/>(XGBoost на дневной выручке)"]
    E --> F["Сохранить top-K причин<br/>в таблицу causes"]

    G["Владелец кликает<br/>'почему?'"] --> H["GigaChat narrator<br/>(tool-calling)"]
    H --> F
    F --> I["Чтение топ-причин<br/>+ live aggregates"]
    I --> J["Текст ответа на русском"]

    style A fill:#172554,stroke:#3b82f6
    style B fill:#14532d,stroke:#22c55e
    style E fill:#78350f,stroke:#f59e0b
    style H fill:#3b0764,stroke:#a855f7
    style J fill:#14532d,stroke:#22c55e

Пример вывода:

Во вторую неделю октября выручка упала на 11,8% относительно baseline.

Главные причины:

47% снижения объясняется падением дневного трафика во вторник–четверг (особенно в часы 12:00–15:00).

Параллельно снизилась доля повторных визитов в сегменте «утренний кофе» — после завершения акции 30 сентября мы не запустили новый сценарий.

Погода и средний чек объясняют менее 5% отклонения.

Рекомендация: вернуть сегментный утренний оффер для «утренний кофе»-клиентов. Не давать общую скидку на меню — это снизит маржу без эффекта на главный сегмент.

Технологии: Python FastAPI, tfp-causalimpact (Google), shap (XGBoost-based), Postgres для хранения причин, GigaChat 2 Pro для narrator.

Бенчмарки:

Дневной batch: ≤ 30 минут на 1 000 tenants
Latency запроса «почему»: ≤ 5 секунд p95
Стоимость одного запроса: ~₽3 (5K input + 1K output на GigaChat Pro)

12.3. B2B-реферальная программа (Б4)

Назначение: дать tenants виральный канал привлечения других tenants (бизнес A приводит бизнес B → A получает скидку или деньги).

Алгоритм:

flowchart LR
    A["Tenant A копирует<br/>реферальную ссылку"] --> B["Отправляет коллеге-владельцу"]
    B --> C["Tenant B регистрируется<br/>по ссылке"]
    C --> D["Активация после первой<br/>оплаты подписки"]
    D --> E{"Anti-fraud check<br/>(не сам себя?)"}
    E -->|"Прошёл"| F["Начисление reward A:<br/>20% скидка на 3 мес"]
    E -->|"Не прошёл"| G["Auto-decline + audit log"]
    F --> H["Уведомление A"]

    style A fill:#172554,stroke:#3b82f6
    style D fill:#14532d,stroke:#22c55e
    style E fill:#78350f,stroke:#f59e0b
    style F fill:#14532d,stroke:#22c55e
    style G fill:#450a0a,stroke:#ef4444

Anti-fraud сценарии:

Один и тот же владелец не может создать второй tenant и привести самого себя (проверка по email, телефону, ИНН)
Bot-detection: подозрительная регистрация (одинаковый IP, нет активности первые 7 дней) → автоматическая ручная проверка
Cooldown: один tenant может привести до 10 рефералов в месяц (защита от массового spam-маркетинга)

Технологии: Postgres + триггеры, фоновый job в BullMQ для проверки активности, ЮKassa API для применения скидки на следующий счёт.

12.4. Vertical playbook engine (Б5)

Назначение: предзаготовленные сценарии для каждой ниши, которые владелец активирует одним кликом.

Структура одного playbook:

playbook:
  id: cafe-bakery-default
  name: "Кофейня и пекарня — стандартный набор"
  segments:
    - name: "Утренний клиент"
      criteria: "покупки в 7:00-11:00 в будни ≥ 3 раза за месяц"
    - name: "Спящий"
      criteria: "не было покупок 14 дней"
    - name: "Любимый"
      criteria: "≥ 4 покупки в месяц"
  rules:
    - trigger: "клиент стал спящим"
      action: "отправить персонализированное сообщение через 24 часа"
      message_template: "{personalize}"
      channel: ["telegram", "email"]
    - trigger: "10-я покупка подряд"
      action: "начислить 100 бонусов + grade-up"
    - trigger: "будни, 8:00, для 'утренний клиент'"
      action: "отправить daily-special"
  metrics:
    - name: "Возврат клиентов"
      formula: "active_30 / active_60"
    - name: "Конверсия рассылок"
      formula: "purchases_after_message / messages_sent"

Примеры playbooks:

Ниша	Ключевые сценарии
Кофейня / пекарня	Утренний клиент, штамп-карта «10-й бесплатно», спящий, любимый, реферал, daypart-офферы
Салон красоты	Rebooking по циклу услуги (28/35/42 дня), no-show recovery, абонементы, статус по визитам, birthday
Автомойка	Weather-trigger (дождь/снег → push), grade за регулярность, bundle «10-я мойка», сезонный возврат
СТО / автосервис	Напоминание о ТО (по пробегу или дате), сезонная резина, реферальный пакет, predicted-need
Ритейл (бельё)	Категорийная персонализация, размер-специфичные офферы, приватная коммуникация, lookbook-рассылки

12.5. Telegram Amsterdam Relay (ПР3 — только в Премиуме)

Назначение: stateless edge-узел в Амстердаме для защиты от RKN throttling Telegram Bot API.

Алгоритм:

flowchart LR
    TG["Telegram Bot API<br/>(Amsterdam DC2)"] -->|"webhook"| AMS["Hetzner CPX21<br/>Amsterdam"]
    AMS -->|"WireGuard tunnel"| RU["RU K8s Backend"]
    RU -->|"reply"| AMS
    AMS -->|"sendMessage"| TG

    AMS_BACKUP["Hetzner Frankfurt<br/>(failover)"] -.->|"DNS swap"| TG

    style TG fill:#172554,stroke:#3b82f6
    style AMS fill:#78350f,stroke:#f59e0b
    style RU fill:#14532d,stroke:#22c55e
    style AMS_BACKUP fill:#3b0764,stroke:#a855f7

Свойства:

Stateless — никакие PII не хранятся в Амстердаме (152-ФЗ-чисто)
Шифрование туннеля: WireGuard
Failover: DNS swap на Frankfurt-узел за ≤ 30 секунд
Стоимость: ~₽1 000–4 000/мес (Hetzner CPX21 + резерв)

Когда нужно: с августа 2025 RKN усилил throttling Telegram-трафика в России (источники в исследовании). К моменту запуска вашей платформы (осень 2026) ситуация может потребовать резервный канал. Это insurance-policy ценой ₽1–4K/мес против ₽-миллионов потерянной выручки от недоставленных сообщений.

13. Модель данных

Краткие JSON-Schema для ключевых сущностей. Полная ER-модель будет в техническом ТЗ (приложение к договору). Все таблицы имеют tenant_id UUID NOT NULL + index, RLS-политика USING ((select current_setting('app.tenant_id', true))::uuid = tenant_id).

Tenant (бизнес-клиент платформы)

{
  "id": "01HXXXXXXXXXXXXXXXXXXXXXX",
  "legal_name": "ИП Иванов И.И.",
  "brand_name": "Кофейня Утро",
  "vertical": "cafe",
  "locations": [
    {
      "id": "loc-1",
      "address": "Москва, Ленина, 10",
      "geo": { "lat": 55.7558, "lng": 37.6173 }
    }
  ],
  "subscription": {
    "plan": "business",
    "status": "active",
    "billing_period_end": "2026-12-01T00:00:00+03:00",
    "grace_period_days": 7
  },
  "playbooks_active": ["cafe-bakery-default"],
  "settings": {
    "currency": "RUB",
    "max_cashback_pct": 50,
    "default_bonus_pct": 5,
    "expire_bonuses_after_days": 365
  },
  "owner_user_id": "usr-...",
  "created_at": "2026-09-01T10:00:00+03:00"
}

Customer (конечный клиент бизнеса)

{
  "id": "cust-...",
  "tenant_id": "01HXXXXXXXXXXXXXXXXXXXXXX",
  "phone": "+7900xxxxxxx",
  "email": "marina@example.com",
  "first_name": "Марина",
  "telegram_user_id": 123456789,
  "wallet_pass_serial": "wallet-abc-123",
  "registered_at": "2026-09-15T11:00:00+03:00",
  "registered_via": "telegram",
  "balance": 350,
  "total_purchases": 12,
  "lifetime_value": 8400,
  "rfm": {
    "recency_days": 5,
    "frequency_30d": 4,
    "monetary_30d": 1200
  },
  "segments": ["loyal", "morning-person"],
  "channel_consent": {
    "telegram": true,
    "email": true,
    "sms": false,
    "marketing": true,
    "consent_date": "2026-09-15T11:00:00+03:00"
  },
  "favorite_products": ["raspberry-croissant", "americano"]
}

Transaction (событие лояльности)

{
  "id": "txn-...",
  "tenant_id": "01HXXXXXXXXXXXXXXXXXXXXXX",
  "customer_id": "cust-...",
  "type": "earn",
  "amount": 25,
  "purchase_amount": 500,
  "purchase_items": [
    { "sku": "raspberry-croissant", "qty": 1, "price": 200 },
    { "sku": "americano", "qty": 1, "price": 300 }
  ],
  "location_id": "loc-1",
  "cashier_id": "user-cashier-...",
  "playbook_rule_id": "morning-loyalty-bonus",
  "created_at": "2026-10-01T09:15:00+03:00"
}

Campaign (рассылка)

{
  "id": "camp-...",
  "tenant_id": "01HXXXXXXXXXXXXXXXXXXXXXX",
  "name": "Возврат спящих — октябрь",
  "trigger": {
    "type": "segment",
    "segment_id": "sleeping-14d"
  },
  "channels": ["telegram", "email"],
  "ai_personalization": true,
  "ab_variants": [
    { "id": "A", "weight": 0.5, "prompt": "...", "model": "gigachat-pro" },
    { "id": "B", "weight": 0.5, "prompt": "...", "model": "gigachat-lite" }
  ],
  "schedule": {
    "type": "send_at",
    "datetime": "2026-10-15T10:00:00+03:00"
  },
  "status": "scheduled",
  "metrics": {
    "sent": 0,
    "delivered": 0,
    "read": 0,
    "purchases_after": 0,
    "revenue_after": 0
  }
}

Cause (для объясняющей аналитики, опция О3)

{
  "id": "cause-...",
  "tenant_id": "01HXXXXXXXXXXXXXXXXXXXXXX",
  "kpi": "revenue",
  "period": { "start": "2026-10-09", "end": "2026-10-15" },
  "anomaly": {
    "magnitude_pct": -11.8,
    "credible_interval": [-15.2, -8.4],
    "p_value": 0.003
  },
  "causes": [
    {
      "rank": 1,
      "factor": "weekday_traffic_drop",
      "shap_value": 0.47,
      "description": "Падение трафика во вторник-четверг 12:00-15:00",
      "evidence_query": "SELECT ... FROM transactions WHERE ..."
    },
    {
      "rank": 2,
      "factor": "morning_segment_decay",
      "shap_value": 0.31,
      "description": "Снизилась частота повторных визитов сегмента 'утренний кофе'"
    }
  ],
  "narrator_text": "...",
  "computed_at": "2026-10-16T01:00:00+03:00"
}

14. API-спецификация

Полная OpenAPI 3.1-спецификация будет в техническом приложении к договору. Здесь — ключевые endpoints, чтобы интеграторы могли начать планирование.

Авторизация

OAuth 2.0 + JWT. Tokens живут 1 час, refresh-token 30 дней. Tenant scoping через X-Tenant-Id header (для multi-tenant API users) или через JWT claim для tenant-bound users.

Customer API (для интеграции с POS)

Method	Path	Описание
POST	`/v1/customers`	Создать клиента (или вернуть существующего по phone)
GET	`/v1/customers/{id}`	Получить клиента + баланс
GET	`/v1/customers/by-phone/{phone}`	Поиск по телефону
POST	`/v1/customers/{id}/earn`	Начислить бонусы за покупку
POST	`/v1/customers/{id}/redeem`	Списать бонусы (с подтверждением кодом)
GET	`/v1/customers/{id}/history`	История транзакций

Пример: начисление бонусов

POST /v1/customers/cust-abc/earn
Authorization: Bearer eyJhbGc...
Content-Type: application/json
X-Tenant-Id: 01HXXX...

{
  "purchase_amount": 500,
  "items": [
    {"sku": "raspberry-croissant", "qty": 1, "price": 200},
    {"sku": "americano", "qty": 1, "price": 300}
  ],
  "location_id": "loc-1",
  "cashier_id": "user-cashier-1"
}

Ответ:

{
  "transaction_id": "txn-xyz",
  "bonuses_earned": 25,
  "new_balance": 375,
  "playbook_rule_triggered": "morning-loyalty-bonus",
  "next_action": {
    "type": "send_message",
    "scheduled_at": "2026-10-01T15:00:00+03:00",
    "channel": "telegram"
  }
}

Campaign API (для маркетингового конструктора)

Method	Path	Описание
POST	`/v1/campaigns`	Создать кампанию (черновик)
POST	`/v1/campaigns/{id}/launch`	Запустить кампанию
GET	`/v1/campaigns/{id}/metrics`	Получить метрики кампании
GET	`/v1/campaigns/{id}/preview`	Превью сообщения для конкретного клиента

Webhooks (исходящие события для интеграторов)

Event	Payload
`customer.registered`	Customer object
`transaction.earn`	Transaction + Customer
`transaction.redeem`	Transaction + Customer
`subscription.expired`	Tenant + reason
`referral.activated`	Tenant_referrer + Tenant_referred + reward

Коды ошибок

Код	Значение	Когда
400	Bad Request	Невалидный JSON / отсутствуют обязательные поля
401	Unauthorized	Нет / истёкший JWT
403	Forbidden	Tenant не имеет доступа к ресурсу (RLS)
404	Not Found	Ресурс не найден в этом tenant
409	Conflict	Дубликат (например, customer с таким phone уже есть)
422	Unprocessable	Валидация прошла, но бизнес-правило отказало (например, недостаточно бонусов)
429	Too Many Requests	Rate limit (1000 req/min на tenant по умолчанию)
503	Service Unavailable	Maintenance / сильная деградация

15. Пользовательские сценарии

Ключевые user stories в формате Given-When-Then. Это база для приёмки и тестирования.

Сценарий 1: Регистрация конечного клиента через QR

Как конечный клиент, посетивший кофейню впервые, я хочу зарегистрироваться в программе лояльности максимально быстро, чтобы получить welcome-бонус и не задерживать очередь.

Given: на кассе есть наклейка с QR-кодом
When: клиент сканирует QR смартфоном → открывается Telegram → бот предлагает «зарегистрироваться, чтобы получить 50 бонусов»
Then: клиент жмёт «зарегистрироваться» → бот запрашивает имя и телефон → подтверждает SMS-кодом → клиент видит баланс 50 ₽ → персонализированное приветственное сообщение от бренда → весь процесс ≤ 30 секунд

Сценарий 2: Кассир начисляет бонусы за покупку

Как кассир кофейни, я хочу начислять бонусы за чек одним нажатием, чтобы не задерживать поток клиентов.

Given: клиент уже зарегистрирован, кассир открыл кабинет кассира на планшете
When: клиент называет телефон → кассир вводит сумму чека (500 ₽) → жмёт «начислить»
Then: клиент получает push в Telegram «+25 бонусов, баланс 375 ₽» → транзакция записана с привязкой к локации и кассиру → автоматически проверяется playbook (например, «10-й кофе» → trigger reward)

Сценарий 3: Владелец запускает кампанию через готовый playbook

Как владелец кофейни, я хочу запустить рассылку для «спящих» клиентов одним кликом, чтобы не тратить время на настройку правил.

Given: владелец активировал playbook «Кофейня default»
When: в дашборде владелец видит карточку «У вас 47 спящих клиентов. Запустить рассылку возврата?» → жмёт «Запустить»
Then: AI-агент генерирует персонализированные сообщения для каждого клиента (учёт любимого товара, времени дня) → рассылка отправляется в Telegram + Email → метрики обновляются в реальном времени → CTR и конверсия видны через 24 часа

Сценарий 4: Владелец спрашивает «почему упала выручка» (опция О3)

Как владелец салона красоты, я хочу понять причину падения выручки за прошлую неделю, чтобы принять обоснованное решение, а не «общую скидку на всё».

Given: в дашборде есть индикатор «Выручка упала на 11,8%»
When: владелец кликает «почему?»
Then: через ≤ 5 секунд появляется ответ:
- 47% снижения — падение трафика во вторник-четверг
- 31% — снижение повторных визитов сегмента «утренний кофе»
- <5% — погода и средний чек
- Рекомендация: вернуть сегментный утренний оффер
Под каждой причиной — кнопка «evidence» с точным запросом к данным

Сценарий 5: B2B-реферальная программа (Бизнес+)

Как владелец пекарни (tenant A) на платформе, я хочу пригласить владельца другой пекарни (tenant B), чтобы получить скидку на свою подписку.

Given: в дашборде есть раздел «B2B-реферал», там реферальная ссылка
When: A копирует ссылку → отправляет B в Telegram → B регистрируется → оплачивает первую подписку
Then: через 24 часа A получает уведомление «Ваш реферал активирован. Скидка 20% применена на следующий счёт» → реферал учитывается в общем рейтинге

Сценарий 6: Активация бонусов через Apple Wallet

Как конечный клиент-владелец iPhone, я хочу видеть карту лояльности в Wallet и получать push-уведомления, чтобы не открывать Telegram каждый раз.

Given: клиент уже зарегистрирован
When: клиент кликает «добавить в Apple Wallet» в боте → проходит установку pass'а
Then: при подходе к кофейне (geo-fence) Wallet показывает карту → при покупке баланс автоматически обновляется → если есть акция — push «Бесплатный 10-й напиток ждёт вас»

Сценарий 7: Импорт существующей клиентской базы

Как владелец, у которого есть Excel с базой 1 200 клиентов, я хочу загрузить базу одним файлом, чтобы не вводить руками.

Given: Excel с колонками «телефон», «имя», «дата рождения», «дата первой покупки»
When: владелец загружает файл в дашборд → видит preview маппинга колонок → подтверждает
Then: импорт за ≤ 60 секунд → 1 200 клиентов в базе → каждому отправлено welcome-сообщение через 24 часа (rate-limit чтобы не выглядело спамом)

16. Команда проекта

Роли и ставки

Ставки указаны для конкретных ролей и часов — никаких «средневзвешенных». Это даёт прозрачность калькуляции и позволяет обсуждать состав команды.

Роль	Основные задачи	Ставка, ₽/час
AI-архитектор / Tech Lead	Архитектура multi-tenant, RLS-политики, AI-pipeline, GigaChat cascade, code review	4 400
AI/ML Engineer	Python FastAPI, embeddings, CausalImpact, SHAP, GigaChat-интеграция, A/B framework	3 520
Senior Backend Engineer	NestJS+Fastify, бизнес-логика, интеграции (ЮKassa, Я.Карты, 2ГИС), webhooks	3 120
Senior Frontend Engineer	Next.js, кабинет владельца, PWA для клиентов, Telegram Mini App	3 120
DevOps Engineer	Yandex Cloud / Selectel setup, K8s, CI/CD, мониторинг, бэкапы	3 120
Project Manager	Sprint planning, демо, sync с клиентом, change management	3 120
QA Engineer	Test automation, ручное тестирование, contract-tests	2 640

Калькуляция стоимости (по пакетам)

Часы рассчитаны исходя из реалистичной модели «ваша гипотеза + ×1,3 множитель на скрытую работу + 10% contingency». Сверены с двумя независимыми deep-research-прогонами (Claude Opus + GPT-5 Pro Deep Research).

Пакет «Бизнес» (наша рекомендация)

Статья	Часы	Расчёт	Стоимость
AI-архитектор / Tech Lead	384 ч	384 × 4 400	1 689 600
AI/ML Engineer	461 ч	461 × 3 520	1 622 720
Senior Backend	819 ч	819 × 3 120	2 555 280
Senior Frontend	461 ч	461 × 3 120	1 438 320
DevOps	128 ч	128 × 3 120	399 360
Project Manager	179 ч	179 × 3 120	558 480
QA	128 ч	128 × 2 640	337 920
Итого разработка	2 560 ч		8 601 680
Непредвиденные расходы (5%)			430 084
Скидка 5% на «Старт»			-42 064
ИТОГО			8 990 000 ₽

Пакет «Премиум»

Статья	Часы	Стоимость
AI-архитектор / Tech Lead	627 ч	2 758 800
AI/ML Engineer	986 ч	3 470 720
Senior Backend	1 344 ч	4 193 280
Senior Frontend	717 ч	2 237 040
DevOps	269 ч	839 280
Project Manager	314 ч	979 680
QA	224 ч	591 360
Итого	4 481 ч	15 070 160
Скидка 7% на «Бизнес»		-350 160
Округление до естественной цифры		+700 000
ИТОГО		15 420 000 ₽

Полная разбивка по часам для Пилота / Старта / Экосистемы — в техническом приложении к договору.

Состав команды по фазам (для пакета «Бизнес»)

gantt
    title Параллельная команда — пакет Бизнес (4-5 месяцев)
    dateFormat YYYY-MM-DD
    excludes weekends
    section Tech Lead
    Архитектура + ревью     :2026-05-04, 100d
    section AI/ML
    Pipeline + cascade      :2026-05-25, 80d
    section Backend (2 чел)
    Core + интеграции       :2026-05-04, 110d
    section Frontend
    Кабинет + PWA           :2026-05-04, 100d
    section DevOps
    Setup + monitoring       :2026-05-04, 30d
    Production deploy        :2026-08-15, 15d
    section PM
    Sprint planning + demo   :2026-05-04, 110d
    section QA
    Test design + execution  :2026-06-01, 80d

Effective FTE: ~5 человек параллельно, плюс PM на 60% и QA на 70%.

17. Дорожная карта и план спринтов

Двухнедельные спринты, демо в конце каждого, sync 1 раз в неделю. План для пакета «Бизнес».

Дорожная карта

gantt
    title Roadmap — пакет Бизнес (May → Sep 2026)
    dateFormat YYYY-MM-DD
    excludes weekends

    section Sprint 0 (kick-off)
    Onboarding + setup            :s0, 2026-05-04, 5d
    Codebase ревью прототипа      :2026-05-04, 5d

    section Фаза 1 — Ядро
    Multi-tenant backend          :s1a, 2026-05-11, 14d
    Postgres + RLS + миграции     :s1b, 2026-05-11, 14d
    Telegram-бот (базовый)        :s1c, after s1a, 14d
    Импорт CSV + Excel            :after s1b, 14d
    Кабинет владельца (skeleton)  :2026-05-25, 14d

    section Фаза 2 — Полный цикл
    PWA для клиентов              :s2a, 2026-06-08, 21d
    ЮKassa интеграция             :s2b, 2026-06-08, 14d
    Я.Карты + 2ГИС                :after s2b, 10d
    Email рассылки                :2026-06-22, 14d
    RFM + сегменты                :2026-06-22, 14d

    section Фаза 3 — AI и B2B-реферал
    AI-агент персонализации       :s3a, 2026-07-06, 25d
    GigaChat cascade              :2026-07-06, 21d
    B2B-реферальная программа     :s3b, 2026-07-13, 21d
    A/B GrowthBook                :after s3a, 14d

    section Фаза 4 — Каналы и playbooks
    MAX-бот                       :2026-08-03, 14d
    Apple Wallet pass             :2026-08-10, 14d
    SMS adapter                   :2026-08-17, 7d
    3 vertical playbooks          :s4, 2026-08-03, 28d

    section Фаза 5 — Production
    Тестирование + bugfix         :2026-08-31, 14d
    Production deploy             :p1, 2026-09-14, 7d
    Beta launch (2-5 tenants)     :after p1, 7d

Контрольные точки (milestones)

#	Milestone	Дата (ориентировочная)	Что демонстрируем
1	Sprint 0 demo	09.05.2026	Установка окружения, репозитория, CI/CD
2	Фаза 1 — Ядро готово	06.06.2026	Tenant регистрируется, импорт работает, бот отвечает
3	Фаза 2 — Полный цикл	04.07.2026	PWA, ЮKassa, рассылки работают
4	Фаза 3 — AI + реферал	03.08.2026	AI-агент генерирует персонализированные сообщения, B2B-реферал работает
5	Фаза 4 — Каналы + playbooks	30.08.2026	MAX, Wallet, SMS работают; 3 playbooks готовы
6	Фаза 5 — Beta launch	27.09.2026	Запуск на 2–5 бета-tenant'ах

Ритм работы

Активность	Частота	Формат
Демо спринта	Каждые 2 недели (пятница)	Видеозвонок + демонстрация на staging-окружении
Еженедельный sync	1 раз в неделю (30 мин)	Статус, блокеры, решения
Доступ к staging	Постоянный	URL staging-сервера (с Sprint 0)
Канал связи	Постоянный	Telegram-группа клиент + наша команда
Приёмка результатов	По завершении каждой фазы	Демо + чеклист критериев приёмки (см. раздел 21)

Управление изменениями: изменения к ТЗ оформляются через Change Request — наша команда оценивает влияние на сроки и бюджет, обе стороны согласовывают перед стартом.

18. Предварительные исследования

Перед написанием этого КП мы провели четыре глубоких исследовательских прогона (рынок + архитектура × 2 модели). Это даёт уверенность в каждой технической и продуктовой рекомендации.

Завершённые исследования

#	Тема	Ключевой результат
Р1	Конкурентная карта российского SMB loyalty-рынка	8 активных игроков идентифицированы; Plazius закрыт; FactorE не подтверждён; средний customer count UDS — 7K+, MAXMA — 250+
Р2	UDS pain points (анализ 50+ публичных отзывов)	5 устойчивых жалоб; главная — install friction. UDS публично признаёт проблему через Telegram-бот
Р3	Pricing benchmarks per niche	Sweet spot 4990–9990 ₽/мес для 1–3 точек по всем 5 нишам
Р4	Архитектура multi-tenant (две независимые модели)	Согласие: shared schema + RLS, Notion/Slack/Figma playbook
Р5	Backend stack	Согласие: Next.js BFF + NestJS-on-Fastify + Python sidecar
Р6	Russian cloud comparison	Yandex (default) vs Selectel (cost) vs Cloud.ru (если GPU); VK Cloud отбрасывается
Р7	AI cost per 10K MAU	₽1 000/мес при GigaChat cascade 80/15/5
Р8	Embeddings benchmark на русском	mE5-large-instruct (RuMTEB 66.0) > OpenAI text-embedding-3-large (64–65)

Открытые вопросы (требуют валидации в ходе разработки)

#	Вопрос	Когда решается
О1	Какой playbook взять первым (кофейня, пекарня, салон, автомойка)?	Sprint 0 после совместной встречи
О2	На каком RU cloud стартовать (Yandex или Selectel)?	После ревью SLA с инвестором, до Sprint 1
О3	Нужен ли MAX-бот в MVP или можно отложить в первый месяц после запуска?	После общения с бета-tenants
О4	Объясняющая аналитика (О3) — в Бизнесе или Премиуме?	Решение клиента
О5	Telegram Amsterdam Relay — нужен ли в первой версии или активировать при появлении throttling?	Мониторим RKN-ситуацию, активируем при первых сбоях

Артефакты исследований (доступны)

В рабочей папке проекта new-clients/docs/offers/ai-loyalty/:

transcript-2026-04-23.md — транскрипт встречи на 397 строк
external-ai-loyalty.md — ответы клиента на 9 продуктовых вопросов
internal-ai-loyalty.md — ответы партнёра по проекту на 22 контекстных вопроса
client-intel.md — консолидированная картина (171 строка)
deep-research-prompts.md — промпты на английском для воспроизводимости
DeepResearch/*.md — 4 сырых отчёта (~220 KB исходников)

19. Стратегия тестирования

Уровни тестирования

Уровень	Покрытие	Инструменты	Целевой % покрытия
Unit-тесты	Бизнес-логика (правила бонусов, RFM, плейбуки)	Vitest / Jest	≥ 70%
Contract-тесты	API endpoints, валидация Zod-схем	tRPC + supertest	≥ 80%
Integration-тесты	Postgres + RLS, очереди, ЮKassa sandbox	Testcontainers	≥ 60%
E2E-тесты	Регистрация → начисление → списание	Playwright	Все critical-paths
AI accuracy	Корректность персонализации, brand voice	Custom evals + ручная проверка	95%+ acceptance
Performance	Латентность API, рассылки, дашборд	k6 / Artillery	См. NFR
Security	OWASP top-10, RLS bypass, инъекции	Snyk + manual pentest	0 critical / 0 high

Конкретные тесты

Test	Критерий	Уровень
Регистрация клиента (E2E)	От QR до баланса 50 ₽ — ≤ 30 сек	E2E
RLS bypass под superuser	Невозможен (FORCE ROW LEVEL SECURITY)	Security
Импорт 1 000 клиентов	≤ 60 сек, без ошибок валидации	Integration
Кампания на 5 000 подписчиков	≤ 10 минут до полной отправки	Performance
AI-генерация сообщения	≤ 3 сек p95, brand voice score ≥ 4/5	AI accuracy
Дашборд владельца p95	≤ 2 сек на 100K записей	Performance
ЮKassa подписка	Полный цикл от регистрации до списания	E2E
Apple Wallet pass обновление	После списания баланс синхронизирован за ≤ 30 сек	Integration
B2B-реферал anti-fraud	Самопривлечение (тот же владелец) — отказ	Security + Logic
152-ФЗ: право-на-забвение	Полное удаление клиента + caches за ≤ 30 минут	Compliance

20. Развёртывание и инфраструктура

Структура deployment (для Tier 2 — пакеты Старт/Бизнес)

# Упрощённый Docker Compose / Helm обзор
services:
  next-frontend:        # Next.js BFF + UI
    replicas: 2
    memory: 512Mi

  nest-backend:         # NestJS+Fastify Core API
    replicas: 3
    memory: 512Mi
    sidecar: pgbouncer

  python-ai:            # FastAPI AI sidecar
    replicas: 2
    memory: 1Gi

  bullmq-worker:        # Async jobs
    replicas: 3
    memory: 256Mi

  centrifugo:           # Real-time
    replicas: 1
    memory: 256Mi

managed:
  postgres-ha:          # Yandex Managed Postgres / Selectel HA
    cpu: 4 vCPU
    ram: 16 GB
    disk: 200 GB SSD

  redis-valkey:         # BullMQ + cache
    cpu: 2 vCPU
    ram: 4 GB

  s3-storage:           # Object storage
    hot: 2 TB
    cold: 5 TB

external:
  gigachat-api:         # Sber GigaChat
  ukassa:               # ЮKassa
  yandex-maps:          # Я.Карты + 2ГИС
  hetzner-amsterdam:    # Telegram relay (Премиум+)

Серверные требования по пакетам

Пакет	Cloud	Конфигурация	Стоимость инфры/мес
Пилот	Cloud.ru или Selectel	1 VM 2 vCPU/4 GB + Postgres single	₽11 000–13 000
Старт	Yandex или Selectel	K8s 3 nodes 4 vCPU/16 GB + HA Postgres	₽45 000–60 000
Бизнес	Yandex или Selectel	+ Valkey HA + S3 cold + GigaChat ~30M tokens	₽60 000–85 000
Премиум	Yandex	+ Amsterdam relay + monitoring + SLA-tier support	₽110 000–150 000
Экосистема	Yandex или Cloud.ru	+ GPU node + Qdrant cluster + multi-AZ	₽300 000–510 000

Мониторинг

Infrastructure metrics: Yandex Monitoring или Selectel Cloud Monitoring (включено)
Application metrics: VictoriaMetrics + Grafana (self-hosted, бесплатно)
Logs: Loki, ~50 GB hot retention
Errors: Sentry (облачный или self-hosted)
Business metrics: custom dashboards в Grafana («Active tenants», «MRR», «AI cost», «Campaign CTR»)

Бэкапы и DR

Postgres: ежесуточные snapshots, point-in-time recovery 7 дней (Yandex/Selectel managed)
S3: cross-region replication (с Премиума)
Configs: GitOps (всё в репозитории)
DR drill: 1 раз в квартал (с Премиума)

152-ФЗ-compliance

Требование	Реализация
Локализация PII	Postgres + S3 в Yandex/Selectel/Cloud.ru (RU DC)
Право-на-забвение	API endpoint `DELETE /v1/customers/{id}` + caches purge + audit
Уведомление РКН	Реестр операторов ПД заполняется клиентом, мы предоставляем technical specs
Согласия	Чёткое разделение: на обработку, на маркетинг, на cookies
Шифрование	TLS 1.3 везде, at-rest шифрование Postgres
Аудит	Все действия с PII в audit log с retention 1 год

21. Критерии приёмки

Каждый модуль приходится с измеримыми критериями. Это защищает обе стороны и упрощает sprint demo.

Ядро (входит во все пакеты)

Модуль	Критерий приёмки
Multi-tenant + RLS	Под суперпользователем RLS не байпасится (FORCE RLS); тест на 10K строк × 100 tenants — изоляция 100%
PostgreSQL	Time-to-restore из backup ≤ 30 минут; миграции через CI/CD
Telegram-бот	Регистрация клиента ≤ 30 сек от QR до welcome-сообщения
Импорт CSV	1 000 строк ≤ 60 сек, валидация ошибок с конкретной строкой/колонкой
Кабинет владельца	p95 загрузка ≤ 2 сек, dashboard работает на 100K транзакций

Бизнес-пакет (модули Б1–Б8)

Модуль	Критерий приёмки
AI-агент персонализации	Latency ≤ 3 сек p95; CTR vs шаблонные рассылки ≥ +60% на тестовой группе 500 клиентов
B2B-реферал	Anti-fraud blocks: 100% случаев self-referral отказы; payout рассчитывается за 24 часа после активации
3 vertical playbooks	Каждый имеет ≥ 8 предзаготовленных правил, протестирован на синтетической базе 1 000 клиентов
MAX-бот	Регистрация и базовые команды работают; sync с Telegram в рамках одного customer-id
Apple Wallet	Pass обновляется за ≤ 30 сек после изменения баланса; geo-fence push работает
A/B GrowthBook	Статзначимость считается автоматически; эксперимент запускается за ≤ 2 минуты
SMS adapter	Доставка ≥ 95% за ≤ 5 минут на 1 000 SMS

Премиум-пакет (модули ПР1–ПР7)

Модуль	Критерий приёмки
Объясняющая аналитика	На запрос «почему» — ответ ≤ 5 сек p95 с топ-3 причинами + evidence-ссылки
5 playbooks	Все 5 ниш протестированы и готовы к запуску в 1 клик
Telegram Amsterdam Relay	Latency MSK→Amsterdam ≤ 45 ms; failover на резерв за ≤ 30 сек
SLA 99.9%	Подтверждается публичным uptime-мониторингом за 30 дней
Геймификация	≥ 4 уровня, ≥ 10 ачивок, anti-loss механика работает

22. Нефункциональные требования

Измеримые пороги производительности, надёжности и безопасности. Адаптированы под пакет.

Производительность

#	Параметр	Пилот	Старт	Бизнес	Премиум	Экосистема
N1	API latency p95	≤ 500 ms	≤ 300 ms	≤ 200 ms	≤ 150 ms	≤ 100 ms
N2	API latency p99	≤ 1 sec	≤ 800 ms	≤ 500 ms	≤ 300 ms	≤ 200 ms
N3	Дашборд владельца p95	≤ 3 sec	≤ 2 sec	≤ 2 sec	≤ 1.5 sec	≤ 1 sec
N4	Одновременные владельцы	≥ 50	≥ 200	≥ 500	≥ 1 000	≥ 5 000
N5	Одновременные конечные клиенты	≥ 500	≥ 5 000	≥ 20 000	≥ 100 000	≥ 500 000
N6	AI-генерация сообщения	n/a	n/a	≤ 3 sec	≤ 2 sec	≤ 1.5 sec
N7	Импорт 10K клиентов	≤ 5 мин	≤ 3 мин	≤ 2 мин	≤ 1 мин	≤ 30 сек

Надёжность

#	Параметр	Пилот	Старт	Бизнес	Премиум	Экосистема
N8	Uptime SLA (мес)	≥ 99%	≥ 99.5%	≥ 99.5%	≥ 99.9%	≥ 99.95%
N9	RPO (потеря данных)	≤ 1 час	≤ 15 мин	≤ 5 мин	≤ 1 мин	≤ 30 сек
N10	RTO (восстановление)	≤ 4 часа	≤ 1 час	≤ 30 мин	≤ 15 мин	≤ 5 мин

Качество кода

#	Параметр	Целевое значение
N11	Покрытие unit-тестами (backend)	≥ 70%
N12	Покрытие contract-тестами (API)	≥ 80%
N13	TypeScript strict mode	100% (no implicit any)
N14	Linting (ESLint + Prettier)	0 errors, 0 warnings в main
N15	Bundle size frontend	≤ 500 KB initial load
N16	Lighthouse Mobile	≥ 90 для PWA

Безопасность

#	Параметр	Реализация
N17	OWASP Top-10	Audit на каждом релизе
N18	RLS на каждой tenant-scoped таблице	FORCE ROW LEVEL SECURITY + tests
N19	TLS	1.3 minimum, no SSLv3
N20	Rate limiting	1 000 req/min per tenant
N21	Secret rotation	API keys каждые 90 дней (manual)
N22	DDoS protection	Curator или StormWall (с Премиума)

Часть III: Коммерческие условия

23. Как мы работаем

Активность	Частота	Формат
Демо спринта	Каждые 2 недели (пятница, 17:00 МСК)	Видеозвонок + демонстрация на staging
Еженедельный sync	1 раз в неделю (30 мин)	Статус, блокеры, решения
Доступ к staging	Постоянный	URL staging-сервера с Sprint 0
Канал связи	Постоянный	Telegram-группа: вы + Илья + наша команда
Приёмка результатов	По завершении этапа	Демо + чеклист критериев приёмки (раздел 21)
Кодовая база	Постоянный	Доступ к репозиторию (GitHub / GitLab) с Sprint 0
Документация	Накопительно	Вся документация в Notion / GitBook, доступ — клиент
Финансовые отчёты	Ежемесячно	Отчёт по часам и расходам в первый рабочий день месяца

Управление изменениями

Изменения к ТЗ оформляются через Change Request (CR):

Кто-то из сторон формулирует изменение
Наша команда оценивает влияние на сроки и бюджет (за ≤ 2 рабочих дня)
Согласовываем стоимость и новый таймлайн
Подписываем дополнение к договору перед стартом работ

Что мы делаем без CR (бесплатно)

Мелкие правки UX (текст, цвета, расстановка элементов) до приёмки спринта
Багфиксы по текущей функциональности (включены в гарантию)
Мелкие настройки конфигурации, тарифов, текстов
Косметические улучшения по фидбэку с демо

Что требует CR

Новая функциональность, не описанная в этом ТЗ
Изменение архитектурных решений (новый канал, новая БД, новая интеграция)
Существенное изменение UX-флоу (например, заменить TG на VK как основной канал)
Дополнительные интеграции (1С, AmoCRM, кассовое ПО)

24. Условия оплаты

Стандартный split 30 / 50 / 20, привязанный к deliverables. Для каждого пакета — отдельная схема платежей. Для сделки фикс + rev-share условия rev-share согласуются отдельным приложением к договору.

Пакет «Пилот» (3 460 000 ₽)

#	Событие	Оплата	Нарастающим итогом
1	Подписание договора	1 038 000 ₽ (30%)	1 038 000 ₽
2	Приёмка Фазы 1 (Ядро)	1 730 000 ₽ (50%)	2 768 000 ₽
3	Финальная приёмка + beta launch	692 000 ₽ (20%)	3 460 000 ₽

Пакет «Старт» (6 350 000 ₽)

#	Событие	Оплата	Нарастающим итогом
1	Подписание договора	1 905 000 ₽ (30%)	1 905 000 ₽
2	Приёмка Фазы 1 (Ядро)	1 587 500 ₽ (25%)	3 492 500 ₽
3	Приёмка Фазы 2 (Полный цикл)	1 587 500 ₽ (25%)	5 080 000 ₽
4	Финальная приёмка + beta launch	1 270 000 ₽ (20%)	6 350 000 ₽

Пакет «Бизнес» (8 990 000 ₽) — рекомендуем

#	Событие	Оплата	Нарастающим итогом
1	Подписание договора	2 697 000 ₽ (30%)	2 697 000 ₽
2	Приёмка Фазы 1 (Ядро)	1 348 500 ₽ (15%)	4 045 500 ₽
3	Приёмка Фазы 2 (Полный цикл)	1 348 500 ₽ (15%)	5 394 000 ₽
4	Приёмка Фазы 3 (AI + B2B-реферал)	1 798 000 ₽ (20%)	7 192 000 ₽
5	Финальная приёмка + beta launch	1 798 000 ₽ (20%)	8 990 000 ₽

Пакет «Премиум» (15 420 000 ₽)

#	Событие	Оплата	Нарастающим итогом
1	Подписание договора	4 626 000 ₽ (30%)	4 626 000 ₽
2	Приёмка Фазы 1 (Ядро)	1 542 000 ₽ (10%)	6 168 000 ₽
3	Приёмка Фазы 2	2 313 000 ₽ (15%)	8 481 000 ₽
4	Приёмка Фазы 3 (AI + реферал)	2 313 000 ₽ (15%)	10 794 000 ₽
5	Приёмка Фазы 4 (Аналитика + Resilience)	2 313 000 ₽ (15%)	13 107 000 ₽
6	Финальная приёмка	2 313 000 ₽ (15%)	15 420 000 ₽

Пакет «Экосистема» (26 550 000 ₽)

#	Событие	Оплата	Нарастающим итогом
1	Подписание договора	7 965 000 ₽ (30%)	7 965 000 ₽
2	Приёмка Фазы 1 (Ядро)	2 655 000 ₽ (10%)	10 620 000 ₽
3	Приёмка Фазы 2	2 655 000 ₽ (10%)	13 275 000 ₽
4	Приёмка Фазы 3	3 982 500 ₽ (15%)	17 257 500 ₽
5	Приёмка Фазы 4 (AI + аналитика)	3 982 500 ₽ (15%)	21 240 000 ₽
6	Приёмка Фазы 5 (Mobile + MLM)	2 655 000 ₽ (10%)	23 895 000 ₽
7	Финальная приёмка + production launch	2 655 000 ₽ (10%)	26 550 000 ₽

Подробные условия rev-share согласуются отдельным приложением к основному договору. Базовая модель:

Период: 24 месяца с момента запуска платформы в production
База расчёта: валовая выручка платформы (gross revenue) за вычетом возвратов
Доля: обсуждается на этапе подписания (типичные диапазоны 5–15% gross или 15–25% net profit)
Cap: общая выплата ограничена 1.5–2× от стоимости пакета (защита для клиента)
Отчётность: ежемесячный отчёт от клиента + квартальная сверка

Дополнительно

НДС 20% — указанные выше суммы ЯВЛЯЮТСЯ конечными для договора. ОСНО / УСН — обсуждаем при подписании.
Платежи по безналичному расчёту (БИК + расчётный счёт), возможна оплата в крипто-эквивалент по согласованию.
Просрочка платежа > 30 дней приостанавливает работу. Просрочка > 60 дней — расторжение договора с возвратом всего сделанного клиенту.

25. Ежемесячные расходы

Сюда не входит стоимость разработки. Это инфраструктурные расходы, которые ваш SaaS будет нести на нашей платформе.

Инфраструктура (RUB/месяц, по тирам)

Компонент	Tier 1 (Пилот)	Tier 2 (Старт/Бизнес)	Tier 3 (Премиум)
Compute	1 700 ₽ (1 VM)	20 000 ₽ (K8s 3 nodes)	100 000 ₽ (8 nodes + GPU)
PostgreSQL HA	4 700 ₽	21 000 ₽	62 000 ₽
Redis / Valkey	— (pg-boss)	9 000 ₽	30 000 ₽
Object storage	400 ₽	7 400 ₽	60 000 ₽
LLM API (GigaChat)	1 500 ₽	12 000 ₽	70 000 ₽
Vector DB	внутри Postgres	внутри Postgres	self-hosted Qdrant ~30 000 ₽
CDN + Object storage	1 000 ₽	3 000 ₽	15 000 ₽
Telegram relay (Amsterdam)	—	—	1 500 ₽
Monitoring (Grafana stack)	self-hosted	5 000 ₽	15 000 ₽
Sentry	бесплатный план	3 500 ₽	8 000 ₽
ИТОГО list	~13 000 ₽	~80 000 ₽	~410 000 ₽
С CVoS / commits	~10 000 ₽	~62 000 ₽	~290 000 ₽

AI-стоимость per scale

Расчёт для cascade GigaChat 80% Lite / 15% Pro / 5% Max при 4 сообщениях/клиент/месяц.

MAU	LLM tokens/мес	Стоимость cascade	Стоимость только Lite	Стоимость только Pro
1 K	1.2M	~₽100	~₽40	~₽300
10 K	12M	~₽1 000	~₽400	~₽3 000
50 K	60M	~₽5 000	~₽2 000	~₽15 000
100 K	120M	~₽10 000	~₽4 000	~₽30 000
1 M	1.2B	~₽100 000	~₽40 000	~₽300 000

Open-source альтернативы (для оптимизации costs на масштабе)

Компонент	Proprietary (default)	Open-source self-hosted	Break-even
LLM	GigaChat API	Self-hosted T-Pro / Llama 3 на GPU	Выгодно от ~50M tokens/мес
Vector DB	Qdrant Cloud (нет в РФ)	Self-hosted Qdrant on K8s	Сразу (Qdrant Cloud не подходит для 152-ФЗ)
Embeddings	YandexGPT API	Self-hosted mE5-large-instruct	Выгодно от ~20M tokens/мес
Real-time	Pusher (нет в РФ)	Centrifugo self-hosted	Сразу
Mail	UniSender SaaS	Postal self-hosted	Выгодно от ~500K писем/мес

Total cost of ownership: первый год

Сценарий	Tier	Инфра/мес	AI/мес	Σ за 12 мес
Пилот: 5 tenants, 10K end-users	Tier 1	13 000 ₽	1 000 ₽	168 000 ₽
Старт+Бизнес: 50 tenants, 50K end-users	Tier 2	80 000 ₽	5 000 ₽	1 020 000 ₽
Премиум: 200 tenants, 200K end-users	Tier 2 + Amsterdam	90 000 ₽	20 000 ₽	1 320 000 ₽
Экосистема: 1 000 tenants, 1M end-users	Tier 3	410 000 ₽	100 000 ₽	6 120 000 ₽

26. Риски и митигация

quadrantChart
    title Карта рисков AI Loyalty Platform
    x-axis "Низкая вероятность" --> "Высокая вероятность"
    y-axis "Низкое влияние" --> "Высокое влияние"

    R1 RKN throttling Telegram: [0.65, 0.75]
    R2 GigaChat недоступность: [0.25, 0.65]
    R3 152-ФЗ изменения: [0.35, 0.85]
    R4 ЮKassa интеграция: [0.45, 0.45]
    R5 Apple Wallet API: [0.40, 0.30]
    R6 Перетекание клиентов на UDS: [0.55, 0.55]
    R7 Бета-tenants не монетизируются: [0.55, 0.65]
    R8 Прототип несовместим: [0.30, 0.40]

Реестр рисков

#	Риск	Вероятность	Влияние	Митигация
R1	RKN throttling Telegram Bot API	Высокая	Высокое	Telegram Amsterdam Relay (опц. в Премиуме). MAX-бот как fallback
R2	GigaChat API недоступность	Низкая	Высокое	Cascade → можем переключиться на YandexGPT за 1 день. Не используем Claude/GPT (санкции)
R3	152-ФЗ изменения / новые требования	Средняя	Очень высокое	Мониторим практику РКН, архитектура готова к выносу PII в outsourced compliance-сервис
R4	ЮKassa интеграция дольше плана	Средняя	Среднее	Sandbox с первого дня, 50% буфер на интеграцию
R5	Apple Wallet API ограничения	Средняя	Низкое	Apple Pass — только informational. Пушу на бэкенде
R6	UDS / MAXMA снижают цены	Средняя	Среднее	Наша цена на 20–30% выше — играем на ценности (no-install + объясняющая аналитика)
R7	Бета-tenants не монетизируются	Средняя	Высокое	Цикл валидации в Sprint 0–1: проверяем основные гипотезы в первый месяц
R8	Прототип Кирилла несовместим со стеком	Низкая	Среднее	Codebase ревью в Sprint 0; миграция UI совместима с любым backend
R9	Yandex Cloud / Selectel инцидент	Низкая	Высокое	Multi-region failover в Премиуме; backup восстановление ≤ 30 мин
R10	AI-агент генерирует некорректные сообщения	Средняя	Среднее	Brand-voice guardrails + tenant approve flow + retroactive rollback
R11	B2B-реферал злоупотребление	Низкая	Низкое	Anti-fraud: проверка по ИНН/телефону/email, cooldown, ручная проверка
R12	Регуляторные изменения для loyalty	Средняя	Высокое	Архитектура хранит только то, что разрешено законодательством; design-review с юристом клиента

Что мы НЕ делаем (out of scope)

Юридическая обработка регуляторных изменений (это ответственность клиента и его юристов)
Обработка возвратов и споров (обязанность клиента-оператора)
Маркетинг и продвижение самой платформы

27. Гарантии

Гарантия	Срок	Что включает
Багфиксинг	6 месяцев после финальной приёмки	Все баги классов P0 (production down) и P1 (critical) — бесплатно. P2 (medium) — в очередь Q1. P3 (cosmetic) — на следующем релизе
Performance-гарантия	Период приёмки + 6 мес	Все NFR-критерии (раздел 22) выполняются. Если нет — рефакторинг бесплатно
Документация	Постоянно	Tech-документация (API, схема БД, deploy guide) актуальна на момент финальной приёмки
Передача знаний	На приёмке	4-часовая сессия для команды клиента: архитектура, deploy, troubleshooting
Code ownership	Сразу	После финальной оплаты весь код принадлежит клиенту. Никаких ограничений
152-ФЗ	Постоянно	Архитектура соответствует требованиям на момент сдачи. Регуляторные изменения — отдельный CR
Стабильность стека	12 месяцев	Не ломающие изменения стека (no breaking refactors). Версии библиотек обновляются safely

28. Требования к клиенту

Что нам нужно от вашей стороны, чтобы запуск был быстрым и без блокеров.

Информация для Sprint 0

#	Что	Срок
1	Доступ к репозиторию прототипа (GitHub / GitLab)	До kick-off
2	Доступ к рабочему окружению прототипа (для UI/UX-ревью)	До kick-off
3	Brand book (логотип, шрифты, цвета, tone of voice)	До kick-off
4	Юридические данные ООО «ПКС» (БИК, расчётный счёт, КПП, ИНН)	До подписания договора
5	Контакты ответственных лиц (продакт, юрист, финансы)	До подписания договора
6	Согласование на использование скриншотов в кейсах AiDevTeam (опц.)	На любом этапе

Доступы для интеграций

Доступ	Когда нужен	Кто предоставляет
ЮKassa аккаунт (sandbox + production)	Sprint 1	Кирилл / Илья
Я.Карты + 2ГИС API ключи	Sprint 2	Можем зарегистрировать со своей стороны
GigaChat API доступ для юрлиц	Sprint 3	Регистрируем на ООО «ПКС»
ЮKassa мерчант ID	Sprint 3	Кирилл
Apple Developer Account	Sprint 4	Кирилл (нужен для Wallet)
Yandex Cloud / Selectel организация	Sprint 0	Совместно (счёт на ООО «ПКС»)
Доменное имя	Sprint 0	Кирилл (предположительно ai-loyalty.ru или аналог)

Бета-tenants

#	Что	Срок
1	Список 2–5 дружественных бизнесов с контактами владельцев	До конца Фазы 2
2	Согласие владельцев на участие в бете	До конца Фазы 4
3	Реальные данные клиентских баз (опц., можем работать на синтетических)	До приёмки Фазы 5

Решения, требующие участия клиента

Выбор первого vertical playbook (рекомендуем кофейню)
Выбор RU cloud (Yandex или Selectel)
Утверждение шаблонов рассылок и brand voice
Подписание дополнительных соглашений (rev-share, NDA по запросу)
Юридическое оформление статуса оператора ПД в реестре РКН

29. Что не входит

Чтобы избежать недопониманий — ниже точный список того, что НЕ входит в стоимость пакетов и должно обсуждаться отдельно.

Out of scope в любом пакете

Категория	Что не входит	Где можно добавить
Юридическое сопровождение	Подготовка договоров с tenants, политика конфиденциальности, оферта SaaS, регистрация в реестре РКН	Привлекаем юриста клиента или предлагаем своего за отдельную плату
Маркетинг и продвижение	Контент-маркетинг, SEO, performance-маркетинг, PR	Это работа клиента или его маркетингового подрядчика
Кастомные интеграции с POS-системами	1С, iiko, Frontol, Poster, Quick Resto, R-Keeper и т.п.	Опции на запрос (от ₽300K за интеграцию)
Регулятор-специфичные модули	КЭП, маркировка «Честный знак» (если применимо к ритейлу), Эквайринг банков	По запросу, отдельный спринт
Контент	Тексты рассылок, логотипы, иллюстрации, фото для playbook'ов	Брендовый контент — от клиента. Шаблоны рассылок — от нас (кол-во согл. пакету)
Нагрузочное тестирование на production	Полноценные load-tests через k6 / JMeter за 1 000+ tenants	Доступно в Премиуме как отдельный спринт
Обучение конечных tenants	Видео-курсы, вебинары, manuals для владельцев бизнесов	Опция за отдельную плату или DIY
Многоязычная поддержка	UI на казахском / узбекском / других языках СНГ	По запросу, отдельная задача (~₽250K за язык)
Mobile native app	iOS + Android натив (только в Экосистеме)	Только в Экосистеме или отдельным заказом

Третьим лицам платится отдельно

Сервис	Кто платит	Ориентир ₽/мес на старте
Cloud (Yandex / Selectel / Cloud.ru)	Клиент (счёт на ООО «ПКС»)	13K–80K (по тиру)
GigaChat API	Клиент	1.5K–12K (по объёму)
ЮKassa (комиссия за платежи)	Клиент (типично 2.4–3.5%)	Зависит от оборота
SMS-провайдер (SMS.ru, SMSC)	Клиент (от ₽1 за SMS)	По объёму
Email-провайдер (UniSender, SendPulse)	Клиент	0–10K (по объёму)
Мониторинг (Sentry, при необходимости coupled tier)	Клиент	0–10K
Apple Developer Program	Клиент	$99/год
Hetzner Amsterdam (Telegram relay)	Клиент (с Премиума)	1–4K

30. Открытые вопросы

Вопросы, которые остаются до старта работ. Решаются в Sprint 0 (kick-off) или в первые 2 недели.

Технические

#	Вопрос	Варианты	Срок решения
Q1	Какую первую нишу взять для playbook'а?	A) Кофейня (наша рекомендация) B) Пекарня C) Салон красоты D) Автомойка	Sprint 0
Q2	RU cloud для production?	A) Yandex Cloud (наша рекомендация — самые зрелые managed-сервисы) B) Selectel (cheaper, более гибкий) C) Cloud.ru (если вы предпочитаете GigaChat-native)	Sprint 0
Q3	Имя бренда платформы?	A) AI Loyalty Platform (рабочее) B) Ваше название	До production launch
Q4	Domain name?	A) ai-loyalty.ru B) Ваш выбор	Sprint 0
Q5	Visual identity (logo, brand colors)?	A) Используем то, что в прототипе B) Делаем новое (отдельный CR)	Sprint 1
Q6	RKN-уведомление: на ООО «ПКС» или на отдельную сущность?	A) ООО «ПКС» (быстрее) B) Отдельная сущность (лучше для ringfencing)	До запуска beta

Продуктовые

#	Вопрос	Варианты	Срок решения
Q7	Какие 3 ниши взять в Бизнес-пакете?	A) Кофейня + Пекарня + Салон B) Кофейня + Автомойка + СТО C) Кофейня + Салон + Ритейл	До конца Фазы 2
Q8	Tenant approve flow для AI-сообщений: opt-in или auto?	A) Opt-in — владелец одобряет каждое B) Auto — AI шлёт по правилам, владелец видит post-factum	Фаза 3
Q9	B2B-реферальное вознаграждение: скидка или деньги?	A) Скидка на тариф (проще, нет налогов) B) Денежная выплата (gross-up) C) Оба варианта	До запуска модуля Б4
Q10	Apple Wallet pass: статичный или динамический?	A) Статичный (только баланс) B) Динамический (баланс + предложения)	Фаза 4

Коммерческие

#	Вопрос	Варианты	Срок решения
Q11	Конкретный rev-share %?	Согласуем при подписании договора	До договора
Q12	NDA отдельным документом?	A) Не нужно B) Подпишем (наш шаблон / ваш шаблон)	До kick-off
Q13	Маркетинговые кейсы AiDevTeam — публиковать имена?	A) Без имён, только обезличенный кейс B) С согласованным анонсом C) Никогда	После запуска

31. Перспективы развития

Что можно добавить после первого запуска. Это пути роста проекта на горизонте 12–24 месяцев.

Через 3–6 месяцев после Бизнес-пакета

Объясняющая AI-аналитика (О3) — главный wedge против UDS, переход в Премиум
Расширение playbook'ов — добавление 2 новых ниш (если стартовали с 3)
Интеграция с iiko — открывает рестораны (отдельная опция, ~600K ₽)
Telegram Mini App расширение — каталог товаров, бронирование, оплата внутри Telegram
CRM для холодных продаж самой платформы (О6) — вы упомянули это в плане продаж

Через 6–12 месяцев

Голосовой бот (О4) — звонки клиентам с AI-скриптом per niche
Расширение каналов — VK, Одноклассники, Авито (для специфических ниш)
Геймификация premium-уровня (О1) — для tenants, у которых геймификация работает
Партнёрская программа с интеграторами — кассовое ПО, маркетинговые агентства, бухгалтеры

Через 12+ месяцев (Экосистема-уровень)

MLM для конечных клиентов — если рынок созреет
Native iOS/Android app — для tenants с большой installed base
Multi-tenant с шардированием — при достижении 500+ tenants
White-label для франшиз — сети передают платформу под собственным брендом
Межплатформенная аналитика — anonymized cross-tenant insights («средний CTR в кофейнях Москвы — 8%»)
B2B-маркетплейс — tenants могут продавать дополнительные услуги друг другу через платформу

Стратегические опции

SaaS-партнёрство с Yandex / Сбер — если масштаб 1000+ tenants
API marketplace — открытое API для независимых разработчиков, делающих add-ons
Tax & Insurance products — встроенная страховка от риска оттока, налоговый ассистент

32. Глоссарий

Термин	Определение
AI-агент	Программный модуль на базе LLM, выполняющий задачу персонализации сообщений с учётом контекста клиента
B2B-реферал	Реферальная программа между бизнесами-tenants платформы (бизнес A приводит бизнес B)
CausalImpact	Статистический метод от Google для оценки влияния события на временной ряд
Cascade (LLM cascade)	Стратегия маршрутизации запросов между моделями разной сложности и стоимости (Lite / Pro / Max) для оптимизации costs
CDP	Customer Data Platform — централизованная платформа клиентских данных
Centrifugo	Open-source real-time messaging server (RU origin)
CTR	Click-Through Rate — процент кликов от показов
CVoS	Committed Value of Service — обязательство по объёму потребления для скидки у RU cloud-провайдеров
Embeddings	Векторное представление текста для семантического поиска и рекомендаций
GigaChat	LLM-сервис от Сбера с API для юридических лиц
GrowthBook	Open-source A/B testing platform
mE5-large-instruct	Multilingual embedding model, превосходящий OpenAI на русскоязычных задачах
MLM	Multi-Level Marketing — многоуровневая реферальная программа
MTEB / RuMTEB	Benchmark для embedding-моделей (общий / русскоязычный)
MAU	Monthly Active Users — ежемесячно активные пользователи
Multi-tenancy	Архитектурный подход, при котором одна инсталляция обслуживает множество клиентов с изоляцией данных
NestJS	Серверный TypeScript-фреймворк на базе Express/Fastify
NFR	Non-Functional Requirements — нефункциональные требования (производительность, надёжность, безопасность)
Playbook	Готовый сценарий лояльности для конкретной ниши с предзаготовленными правилами и метриками
PWA	Progressive Web App — веб-приложение, работающее без установки
Qdrant	Open-source vector DB для семантического поиска
RFM	Recency-Frequency-Monetary — модель сегментации клиентов
RLS	Row-Level Security — механизм PostgreSQL для row-level изоляции данных
SHAP	SHapley Additive exPlanations — метод объяснения модели машинного обучения
SLA	Service Level Agreement — соглашение об уровне сервиса (uptime guarantee)
SSE	Server-Sent Events — однонаправленный real-time протокол поверх HTTP
Telegram Mini App	Web-приложение, встраиваемое в Telegram-бот без установки на устройство
Tenant	Бизнес-клиент SaaS-платформы (в нашем случае — кофейня, салон, автомойка и т.п.)
Vertical playbook	См. Playbook
YCLIENTS / Altegio	Российская платформа онлайн-записи с собственным loyalty-модулем

33. Следующие шаги

Что нужно сделать, чтобы запустить проект. Сроки указаны условно от даты получения этого КП.

Шаг 1: Согласование (1–2 недели)

Внутреннее согласование пакета с инвестором
Уточнение открытых вопросов (раздел 30): первая ниша, RU cloud, имя бренда, домен
Финальное решение по rev-share (% и cap)
Решение по NDA (если требуется отдельный документ)
Подтверждение состава команды на стороне клиента (кто принимает решения по продукту)

Шаг 2: Договор (1 неделя)

Юр. формализация: договор разработки + приложение по rev-share
Подписание сторонами (Кирилл от ООО «ПКС», представитель AiDevTeam)
Оплата 30% по подписанию
Регистрация в реестре операторов ПД (РКН) — параллельно

Шаг 3: Sprint 0 — kick-off (1 неделя)

Создание репозитория, CI/CD, окружения
Codebase ревью прототипа (О2 если выбрана)
Доступы к ЮKassa, Yandex Cloud / Selectel
Telegram-группа клиент + AiDevTeam
Setup Sentry, мониторинга, бэкапов
Финальный sprint plan на 4–5 месяцев

Шаг 4: Активная разработка (4–5 месяцев для пакета «Бизнес»)

Спринты по 2 недели
Демо в конце каждого
Sync 1 раз в неделю
Поэтапная приёмка фаз 1–4

Шаг 5: Beta launch (1–2 недели)

Production deploy
Запуск на 2–5 бета-tenants
Мониторинг и быстрая реакция на инциденты
Retro по итогам первого месяца

Контакт

Со стороны AiDevTeam за проект отвечает Илья Омелин (партнёр, ведёт пресейл-коммуникацию). Технические вопросы по этому КП — через Илью к команде AiDevTeam.

Все оценки являются предварительными и могут быть уточнены по итогам Sprint 0 при codebase-ревью прототипа.

Предложение действительно 30 дней с даты публикации.

Разработка: AiDevTeam