Update local changes after pull

monetization_plan.md

@@ -0,0 +1,46 @@
+# План монетизации для Telegram бота
+
+## Выбранные модели монетизации (4 модели)
+На основе исследования и анализа проекта выбраны следующие модели, учитывая ограничения Telegram API, существующие компоненты (игры, платежи через Stripe/YooKassa, донаты) и геймификацию через ранги:
+
+1. **Донаты** (уже реализованы, расширение на новые форматы)
+2. **Премиум-функции** (unlock дополнительных игр и AI-функций)
+3. **Внутриигровые покупки** (виртуальные предметы в играх)
+4. **Партнёрские программы** (рефералы с вознаграждениями)
+
+## Интеграция в текущие функции
+- **Донаты**: Расширение WelcomeService для персонализированных донатов в приветствиях; интеграция с game_handlers.py для донатов за игровые достижения.
+- **Премиум-функции**: Добавление unlock в game_handlers.py (премиум-игры как Тетрис, AI-подсказки через GigaChat); использование payment_models.py для обработки платежей.
+- **Внутриигровые покупки**: Интеграция в игровые сессии (бонусы в 2048, жизни в Морском бое) через DonationService; хранение инвентаря в базе данных.
+- **Партнёрские программы**: Добавление реферальных ссылок в welcome_service.py; начисление рангов за приглашения друзей.
+
+## Целевые метрики
+- **ARPU**: $0.5-2 в месяц (донаты + покупки)
+- **Конверсия**: 5-10% пользователей на премиум-функции; 20-30% активных игроков на внутриигровые покупки
+- **Дополнительные**: Уровень удержания (retention rate) >70% после внедрения; рост DAU на 15-20% от рефералов
+
+## Риски и стратегии минимизации
+- **Риски**: Отток пользователей от pay-to-win элементов; ограничения Telegram на платежи; непредсказуемый доход от донатов.
+- **Стратегии**: Баланс игры (премиум как удобство, не преимущество); тестирование A/B для платежей; диверсификация доходов; мониторинг вовлеченности.
+
+## Roadmap внедрения
+1. **Месяц 1**: Расширение донатов (интеграция с играми) + MVP премиум-функций
+2. **Месяц 2-3**: Внутриигровые покупки + партнёрские программы; метрики и тестирование
+3. **Месяц 4-6**: Оптимизация по данным; добавление Telegram Stars если возможно; масштабирование
+
+## Будущие расширения
+### Сервисы заказа как опциональное направление диверсификации доходов
+В качестве дополнительного потока монетизации рассматривается введение премиум-функций по заказу услуг (запись в парикмахерскую, ремонт авто, доставка еды из магазинов типа Пятерочка/Магнит и ресторанов) через ежемесячную подписку или комиссию с заказов. Это направление не связано напрямую с игровым контентом, но может привлекать пользователей, заинтересованных в удобстве, и диверсифицировать доходы без разбавления основной концепции бота.
+
+#### Потенциал
+- **ARPU**: 750-1500 руб. при ежемесячной подписке 500-2000 руб. для 1000 премиум-пользователей.
+- **Комиссия**: Дополнительный доход 5-15% с заказов, особенно от доставки еды.
+- **Аудитория**: Русскоязычные пользователи Telegram, с потенциалом привлечения через существующие игры и ранги, но требующим маркетинга.
+
+#### Риски
+- **Юридические**: Необходимость договоров с партнерами, соблюдение законов о защите данных (аналоги GDPR в РФ), ответственность за невыполнение заказов, риски штрафов от Telegram за скрытую коммерческую активность (требуется маркировка как "реклама" и отказ от прямых продаж через бота).
+- **Технические**: Зависимость от стабильности внешних API, обработка ошибок, защита от фрода, риск перегрузки при росте нагрузки.
+- **Бизнес-риски**: Конкуренция с Yandex.Eda, Avito; низкий спрос среди игровой аудитории; сложность привлечения партнеров.
+
+#### Интеграция в будущем
+Сервисы могут быть реализованы как отдельный премиум-модуль или бот, интегрированный с существующими механизмами (DonationService для подписок, payment_models.py для обработки платежей). Начало с пилотного проекта (доставка еды), расширение при успехе. Синергия с играми: премиум-подписка дает бонусные очки или повышенные ранги. Реклама в welcome_service.py. Избегать полного слияния с игровым ботом для сохранения фокуса; позиционировать как информационного посредника без обработки платежей за заказы.