Telegram Mini App do nauki angielskiego, AI-słownik

Pełnostackowy projekt portfolio: osobisty AI słownik języka angielskiego w Telegramie.

Użytkownik wysyła słowo lub frazę do bota (tekstowo lub głosowo) lub dodaje je w Mini Aplikacji — system tworzy kartę do nauki: tłumaczenie, znaczenie, przykłady, synonimy, poziom CEFR. Słowa są przechowywane w osobistej bazie, można je wyszukiwać, filtrować według statusu (new → learning → learned) i powtarzać.

Co zostało zrealizowane:
• Bot Telegram (aiogram 3): tekst, głos (Whisper), komendy /start, /help, /app
• Mini Aplikacja Telegram (React + TypeScript + Vite): UI mobile-first, ciemny/jasny motyw, animacje
• Backend na FastAPI: architektura warstwowa (routes → services → repositories)
• PostgreSQL + migracje Alembic
• Integracja OpenAI dla strukturalnych kart i pytań follow-up
• Codzienny streak, cele i kalendarz aktywności
• Powiązanie słów z filmami/serialami (TMDB) i muzyką (MusicBrainz)
• Bezpieczeństwo: walidacja Telegram initData (HMAC), brak zaufania do client-side user ID w produkcji
• Docker Compose dla lokalnego rozwoju, wdrożenie na Railway, CI na GitHub Actions

Stos: Python 3.11, FastAPI, aiogram, SQLAlchemy 2 async, PostgreSQL, React 18, TypeScript, OpenAI API, Docker, Railway.

Projekt demonstruje pełny cykl: od pomysłu i architektury po wdrożenie, testy i ustawienia gotowe do produkcji.

#telegram #telegrambot #miniapp #python #fastapi #react #typescript #openai #postgresql #fullstack #webdevelopment #ai #english #vocabulary