Що саме потрібно зробити і з якими цілями буде використовуватися робота?
Потрібно повністю написати з нуля 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 / інші) функціонує
Уся логіка з картами реалізована
Реалізована щоденна автоматична розсилка
Архітектура коду зрозуміла, легко підтримується
Проєкт розгорнуто на сервері (потрібна допомога з деплоєм)
Для уточнень — пишіть у приватні повідомлення. Розгортання на сервер також входить у завдання.
