Co dokładnie trzeba zrobić i do jakich celów będzie używana ta praca?
Należy całkowicie napisać od podstaw Telegramowego asystenta „Twój Astrogid” na bazie aiogram v3.
Cel — stworzyć asystenta, który pomaga użytkownikom za pomocą astrologii, Tarota, analizy snów AI, horoskopów i refleksji.
Użycie dowolnego AI — dozwolone (niekoniecznie Mistral).
Bazę danych można wybrać dowolną (SQLite, PostgreSQL, MongoDB itp.).
Funkcjonalność, którą trzeba zaimplementować:
Rejestracja użytkownika
Wybór znaku zodiaku za pomocą klawiatury
Zapis do bazy
Wirtualna waluta — „karty”
Każdy użytkownik ma saldo kart
Działania odliczają określoną liczbę kart
Możliwość sprawdzenia salda
Codzienny bonus (+10–30 kart, raz dziennie)
System poleceń (użytkownik otrzymuje 25 kart za znajomego, który dołączył przez jego link)
Rozkład Tarota
Użytkownik pisze pytanie
Wyciągane są 3 losowe karty
AI generuje wyjaśnienie rozkładu (krótki, treściwy tekst)
Interpretacja snu
Użytkownik przesyła swój sen
AI generuje interpretację snu w formie osobistego zwrócenia się
Codzienny horoskop
Dla każdego znaku osobno
Automatyczne wysyłanie do użytkowników zgodnie z ich znakiem
Pytania do astrologini
Użytkownik pisze pytanie — AI generuje ciepłą i treściwą odpowiedź
Kompatybilność znaków
Użytkownik wybiera swój znak i znak partnera
AI generuje opis ich energetycznej interakcji
Test archetypów
5 pytań dla każdej z dwóch osób
Określenie archetypów
AI generuje analizę ich „zgodności dusz”
Astrologiczna rutyna dnia
Krótka rekomendacja-rutyna na dzień (w formie frazy)
Analiza problemu
Użytkownik pisze sytuację
AI daje głęboką, poważną odpowiedź z końcowym aforyzmem
Muzyczny test
15 pytań z opcjami
Wynik (gatunek lub styl) na podstawie odpowiedzi
Struktura
FSMContext używany we wszystkich scenariuszach
Kod podzielony na osobne pliki: router, handlers, keyboards, database, states, utils
Komentarze do kodu obowiązkowe
Na jakich kryteriach będzie oceniany wynik?
Kod w pełni napisany od podstaw
Wszystkie funkcje działają stabilnie, bez błędów
Integracja z dowolnym AI (Mistral / OpenAI / Claude / inne) działa
Cała logika z kartami zaimplementowana
Zrealizowana codzienna automatyczna wysyłka
Architektura kodu zrozumiała, łatwa w utrzymaniu
Projekt wdrożony na serwerze (wymagana pomoc z deploymentem)
W razie pytań — pisz w prywatnych wiadomościach. Wdrożenie na serwerze również wchodzi w zakres zadania.
