Что именно нужно сделать и с какими целями будет использоваться работа?
Требуется полностью написать с нуля Telegram-ассистента «Твой АстроГид» на базе aiogram v3.
Цель — создать ассистента, который помогает пользователям с помощью астрологии, Таро, AI-анализа снов, гороскопов и рефлексии.
Использование любого AI — разрешено (не обязательно Mistral).
Базу данных можно выбрать любую (SQLite, PostgreSQL, MongoDB и т.д.).
Функционал, который нужно реализовать:
Регистрация пользователя
Выбор знака зодиака через клавиатуру
Сохранение в базе данных
Виртуальная валюта — “карты”
У каждого пользователя есть баланс карт
Действия списывают определённое количество карт
Возможность просмотреть баланс
Ежедневный бонус (+10–30 карт, один раз в день)
Реферальная система (пользователь получает 25 карт за друга, присоединившегося по его ссылке)
Расклад Таро
Пользователь пишет вопрос
Выбираются 3 случайные карты
AI генерирует объяснение расклада (короткий содержательный текст)
Толкование сна
Пользователь отправляет свой сон
AI генерирует интерпретацию сна в форме личного обращения
Ежедневный гороскоп
Для каждого знака отдельно
Автоматическая рассылка пользователям по их знакам
Вопросы астрологу
Пользователь пишет вопрос — AI генерирует тёплый и содержательный ответ
Совместимость знаков
Пользователь выбирает свой знак и знак партнёра
AI генерирует описание их энергетического взаимодействия
Архетипический тест
5 вопросов для каждого из двух человек
Определение архетипов
AI генерирует анализ их "совместимости душ"
Астральная привычка дня
Краткая рекомендация-привычка на день (в виде фразы)
Анализ проблемы
Пользователь пишет ситуацию
AI даёт глубокий, серьёзный ответ с финальной афористичной фразой
Музыкальный тест
15 вопросов с вариантами
Вывод результата (жанра или стиля) по ответам
Структура
FSMContext используется во всех сценариях
Код разбит на отдельные файлы: router, handlers, keyboards, database, states, utils
Комментарии к коду обязательны
По каким критериям будет оцениваться результат?
Код полностью написан с нуля
Все функции работают стабильно, без ошибок
Интеграция с любым AI (Mistral / OpenAI / Claude / другие) функционирует
Вся логика с картами реализована
Реализована ежедневная автоматическая рассылка
Архитектура кода понятна, легко поддерживается
Проект развернут на сервере (требуется помощь с деплоем)
Для уточнений — пишите в личные сообщения. Развертывание на сервере также входит в задание.
