Telegram бот и Mini App Таро Компаньон + Миранда

Таро Компаньон (DeepCard) - это полнофункциональное коммерческое приложение для Telegram, представляющее собой комплексную платформу для гадания на картах Таро с использованием искусственного интеллекта. Проект полностью готов к продакшену и включает в себя все необходимые компоненты для запуска и монетизации.

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

Основной функционал

1. Интерактивное приложение для работы с картами Таро

В основе проекта лежит Telegram Mini App, построенное на React и TypeScript. Приложение использует библиотеку PixiJS для создания плавных анимаций и интерактивного взаимодействия с картами. Пользователь может выбирать колоды, перемешивать карты с визуальными эффектами, выкладывать расклады и сохранять их.

Интерфейс поддерживает несколько режимов работы: домашний экран с меню, выбор колоды и режим расклада. Все анимации оптимизированы для работы в Telegram WebView, включая ленивую загрузку тяжелых компонентов для ускорения старта приложения.

2. Искусственный интеллект для анализа раскладов

Система поддерживает работу с несколькими провайдерами AI: AITunnel (Grok), OpenAI (GPT-4, GPT-4o), DeepSeek и OpenRouter. Это позволяет гибко выбирать модель в зависимости от требований к качеству, скорости и стоимости.

AI анализирует выбранные карты с учетом их позиций (прямое или перевернутое положение), контекста вопроса пользователя и типа расклада. Для каждого типа специального расклада используется отдельный промпт, что обеспечивает более точную и релевантную интерпретацию.

3. Персональный AI-таролог Миранда

Одной из ключевых особенностей проекта является интеллектуальный бот-компаньон по имени Миранда. Это отдельный Telegram-бот, который ведет диалог с пользователем, понимая контекст беседы и сохраняя историю общения.

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

Агент может не только делать расклады Таро, но и создавать натальные карты, карты совместимости (синастрии), анализировать их и давать персональные рекомендации. Все это происходит в формате естественного диалога.

4. Натальные карты и астрология

Проект включает полноценный функционал для создания натальных карт. Система использует библиотеку Kerykeion для астрологических расчетов и генерации визуальных карт в формате SVG и PNG.

Пользователь может указать дату, время и место рождения, после чего система автоматически определяет координаты через геокодирование, вычисляет астрологические параметры и создает красивую визуализацию карты. AI анализирует натальную карту и предоставляет подробное описание личности, склонностей и потенциала человека.

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

5. Специальные расклады

Помимо стандартных раскладов, система включает набор специальных раскладов для различных жизненных ситуаций:

- Карта дня - ежедневный расклад из одной карты

- Расклады на отношения: "Он - Я - Мы" (3 карты), "Отношения сегодня" (4 карты), "Что между нами?" (5 карт), "Пирамида любви" (6 карт), "Крест любви" (5 карт), "Отношения в перспективе" (6 карт)

- Расклады на карьеру: "Путь карьеры" (6 карт), "Карьерный перекрёсток" (6 карт), "Деньги и изобилие" (6 карт)

- Расклады для личностного роста: "Точка роста" (3 карты), "Внутренний потенциал" (4 карты), "Стадии пробуждения" (5 карт), "Пентаграмма" (6 карт)

Каждый расклад имеет свою структуру позиций и специализированный промпт для AI-анализа.

6. Система подписок и монетизация

Проект включает полноценную систему монетизации с тремя тарифными планами:

- Lite подписка (199 рублей/месяц): 5 трактовок и 5 кристаллов в день, доступ к бесплатным колодам

- Classic подписка (299 рублей/месяц): 10 трактовок и 10 кристаллов в день, доступ к премиальным колодам (открываются постепенно)

- Premium подписка (399 рублей/месяц): 15 трактовок и 15 кристаллов в день, доступ ко всем колодам сразу

Также реализована продажа дополнительных трактовок и кристаллов пакетами (5, 10, 100 штук) для пользователей, которым нужно больше возможностей.

7. Интеграция с платежной системой ЮKassa

Проект полностью интегрирован с ЮKassa для приема платежей. Реализованы все необходимые функции: создание платежей, обработка webhook-событий, автоматическая активация подписок после оплаты, поддержка автопродления через сохраненные способы оплаты.

Система автоматически выставляет чеки с указанием контактных данных пользователя (email или телефон), что соответствует требованиям российского законодательства.

8. Реферальная система

Встроена полнофункциональная реферальная программа. Каждый пользователь получает уникальную реферальную ссылку. При регистрации нового пользователя по этой ссылке оба участника получают бонусы: пригласивший и новый пользователь получают по 5 трактовок и 5 кристаллов.

Система отслеживает цепочку приглашений и позволяет анализировать эффективность реферальной программы.

9. Управление колодами и картами

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

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

10. Сохранение истории раскладов

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

Техническая архитектура

Backend

Backend построен на двух основных фреймворках:

- FastAPI для основного API и обработки webhook-событий от Telegram и платежных систем

- Django для административной панели и управления данными через ORM

Такое разделение позволяет эффективно масштабировать проект: FastAPI обрабатывает высоконагруженные запросы от пользователей, а Django предоставляет удобный интерфейс для управления контентом и настройками.

База данных PostgreSQL хранит всю информацию о пользователях, раскладах, платежах, подписках, натальных картах и истории диалогов с агентом. Redis используется для кэширования и хранения состояний FSM (конечных автоматов) для ботов.

Система полностью асинхронная, что обеспечивает высокую производительность при работе с внешними API (AI-провайдеры, платежные системы, геокодирование).

Frontend

Frontend представляет собой современное React-приложение на TypeScript. Используется Vite как сборщик, что обеспечивает быструю разработку и оптимизированную сборку для продакшена.

Основные технологии:

- React 18 с хуками и функциональными компонентами

- PixiJS для интерактивной графики и анимаций карт

- GSAP и Anime.js для дополнительных анимаций

- Howler.js для звуковых эффектов (если требуется)

- Tailwind CSS для стилизации

- Telegram WebApp SDK для интеграции с Telegram

Приложение оптимизировано для работы в Telegram WebView: используется ленивая загрузка компонентов, оптимизация изображений, кэширование текстур.

Telegram боты

Проект включает два Telegram-бота:

1. Основной бот (Tarot Companion) - предоставляет интерфейс для работы с приложением, управление подписками, выбор раскладов

2. Бот-агент (Миранда) - ведет персональные диалоги с пользователями, создает натальные карты, анализирует расклады в контексте беседы

Оба бота могут работать как через webhook (рекомендуется для продакшена), так и через polling (удобно для разработки и тестирования).

Инфраструктура и развертывание

Проект включает полный набор инструментов для развертывания и управления:

- Docker Compose конфигурация для локальной разработки и тестирования

- Systemd сервисы для продакшн-развертывания на Linux-серверах

- Скрипты автоматизации для Raspberry Pi (проект готов к развертыванию на маломощных устройствах)

- Makefile с набором команд для управления проектом

- Nginx и Caddy конфигурации для reverse proxy и SSL

- Скрипты для ежедневных задач (сброс лимитов, проверка подписок, уведомления)

Система логирования настроена для отслеживания всех важных событий: запросы к API, платежи, ошибки, действия пользователей.

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

Проект включает несколько уровней защиты:

- Проверка подлинности через Telegram WebApp initData

- Валидация webhook-запросов от Telegram и платежных систем

- Защита от перебора запросов (rate limiting)

- Безопасное хранение секретных ключей через переменные окружения

- Проверка IP-адресов для webhook от платежных систем

Масштабируемость

Архитектура проекта позволяет легко масштабировать его:

- Асинхронная обработка запросов позволяет обрабатывать множество одновременных пользователей

- Redis для распределенного кэширования и состояний

- Возможность горизонтального масштабирования через несколько инстансов FastAPI

- Оптимизированные запросы к базе данных с использованием индексов

- Очереди сообщений для предотвращения перегрузки Telegram API

Административная панель

Django Admin предоставляет полный контроль над проектом:

- Управление пользователями и их подписками

- Редактирование колод и карт

- Просмотр и управление платежами

- Настройка лимитов и цен

- Просмотр статистики использования

- Управление натальными картами пользователей

- Просмотр истории диалогов с агентом

Документация и код

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

Все зависимости четко определены: Poetry для Python-зависимостей, pnpm для Node.js-зависимостей. Версии зафиксированы для обеспечения воспроизводимости сборки.

Дополнительные возможности

Проект включает множество дополнительных функций, которые делают его полноценным коммерческим продуктом:

- Система уведомлений пользователей о новых функциях и обновлениях

- Автоматическая проверка заблокированных пользователей Telegram

- Ежедневный сброс лимитов пользователей

- Автоматическое продление подписок

- Генерация изображений раскладов для отправки пользователям

- Поддержка множественных колод с разными визуальными стилями

- Гибкая система настройки лимитов через административную панель

- Логирование всех важных событий для анализа и отладки

Состояние проекта

Проект полностью готов к использованию в продакшене. Все основные функции реализованы и протестированы. Код структурирован, следует лучшим практикам разработки, включает обработку ошибок и логирование.

Инфраструктура для развертывания настроена и готова к использованию. Проект может быть развернут как на облачном сервере, так и на локальном оборудовании, включая маломощные устройства типа Raspberry Pi.

Монетизация

Проект имеет несколько источников дохода:

1. Ежемесячные подписки (три тарифа)

2. Продажа дополнительных трактовок и кристаллов

3. Потенциал для партнерских программ и рекламы

Система платежей полностью автоматизирована и не требует ручного вмешательства.

Заключение

DeepCard представляет собой профессионально разработанный, полнофункциональный проект для монетизации через Telegram. Он сочетает в себе современные технологии, качественный пользовательский опыт и продуманную бизнес-логику.

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

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