Таро бот с исскуственным интеллектом

Дополнительная информация

Обзор продукта (user‑facing) • Бот делает расклады Таро (типовой формат — 5 карт) с интерпретацией ИИ и персонализацией по анкете. • Функции: генерация расклада, разбиение длинных ответов на части, follow‑up вопросы, история раскладов/удаление/очистка, профиль пользователя, подписки/оплата. • Поддерживаемые колоды: «Таро Райдера–Уэйта», «Таро Неистовых Желаний (18+)», «Divine (Божественное)». Источник: storage/ decks_meta.json, storage/decks_data/*.json. Основные сценарии: - Меню → выбор колоды → ввод вопроса → генерация → выдача ответа частями → follow‑up → история/профиль/подписка. - Гейт профиля: при отсутствии обязательных полей (имя, пол) предлагается заполнение либо пропуск. Админ‑возможности • Режим админа в боте: быстрые тесты персонализации, разовые «5 минут безлимита», сегментные рассылки, статистика, симуляции автоплатежей, редактор контента колод. • Веб‑консоль администратора (FastAPI): авторизация (логин/пароль, cookie‑сессии), PIN‑проверка (bcrypt), экспорт/массовые операции, аудит действий (admin_actions). Запуск через uvicorn. Архитектура и технологии • Язык/рантайм: Python 3.9+. • Основные библиотеки: aiogram 3.x, OpenAI (v1 SDK), SQLAlchemy 2.x, Alembic, Redis (asyncio), RQ, FastAPI (веб‑консоль), YooKassa. Источники: requirements.txt, pyproject.toml. • Логическая структура: o handlers — сценарии и навигация (пользователь/профиль/история); o services — интеграции и бизнес‑логика (OpenAI, платежи, Redis‑состояние, кэш, лимитер, память и др.); o models — ORM‑модели; o storage — контент колод и утилиты. • Точки входа/процессы: o Основной бот: aiogram, режим polling (удаление webhook перед запуском + dp.start_polling). o Фоновые задачи: RQ worker (queue_worker.py) и очереди для генерации/доставки (tasks.py). o Веб‑консоль админа: FastAPI (console_premium.py), запуск через uvicorn. Контент колод (выполненные работы) • Колоды приобретены и отсканированы, изображения приведены к единому формату. • Подготовлены и загружены таблицы значений карт для интеграции (JSON‑файлы). • На подготовку контента (сканирование, обработка, загрузка) ушло ≈ 1 неделя. • Подключение контента в репозитории: storage/decks_data/*.json, storage/deck_loader.py, storage/decks.py. o Примеры файлов JSON: storage/decks_data/waite.json (78 карт), desires.json (~80), archetypes.json (~74). Данные / БД (кратко) • Основные сущности: users, user_profiles, subscriptions, payment_methods, payment_packages, auto_payments, auto_payment_attempts, tarot_sessions, spreads, conversation_entries, memories, user_segments, admin_profiles, admin_actions, trial_gifts. • Индексы: на активные подписки, историю сессий, методы оплаты, память по ключу, историю диалогов; у spreads — по user_id и created_at. Интеграции (OpenAI, YooKassa), retry/лимиты • OpenAI: AsyncOpenAI, персонализация промптов (профиль/память), ретраи (экспоненциальные), лимитер по RPM/TPM через Redis, фильтрация запрещённых символов/лексики, разбиение длинных ответов на части. • YooKassa: создание платежей (редирект), фискальные чеки, metadata (привязка к user_id/telegram_id/username), сохранение payment_method для безлимита; автоплатежи с повторными попытками и уведомлениями; ретраи при сетевых/429 ошибках.