Реализован MVP телеграм бота для изучения языков

Основные компоненты:
- База данных (PostgreSQL) с моделями User, Vocabulary, Task
- Интеграция с OpenAI API для перевода слов
- Команды: /start, /add, /vocabulary, /help
- Сервисы для работы с пользователями, словарем и AI

Реализовано:
✅ Регистрация и приветствие пользователя
✅ Добавление слов в словарь с автоматическим переводом
✅ Просмотр личного словаря
✅ Архитектура проекта с разделением на слои

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

database/db.py

@@ -0,0 +1,29 @@
+from sqlalchemy.ext.asyncio import create_async_engine, async_sessionmaker, AsyncSession
+from config.settings import settings
+from database.models import Base
+
+# Создание движка базы данных
+engine = create_async_engine(
+    settings.database_url,
+    echo=settings.debug,
+    future=True
+)
+
+# Фабрика сессий
+async_session_maker = async_sessionmaker(
+    engine,
+    class_=AsyncSession,
+    expire_on_commit=False
+)
+
+
+async def init_db():
+    """Инициализация базы данных (создание таблиц)"""
+    async with engine.begin() as conn:
+        await conn.run_sync(Base.metadata.create_all)
+
+
+async def get_session() -> AsyncSession:
+    """Получение сессии базы данных"""
+    async with async_session_maker() as session:
+        yield session

database/models.py

@@ -0,0 +1,83 @@
+from datetime import datetime
+from typing import Optional
+
+from sqlalchemy import String, BigInteger, DateTime, Integer, Boolean, JSON, Enum as SQLEnum
+from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column
+import enum
+
+
+class Base(DeclarativeBase):
+    """Базовая модель"""
+    pass
+
+
+class LanguageLevel(str, enum.Enum):
+    """Уровни владения языком"""
+    A1 = "A1"
+    A2 = "A2"
+    B1 = "B1"
+    B2 = "B2"
+    C1 = "C1"
+    C2 = "C2"
+
+
+class WordSource(str, enum.Enum):
+    """Источник добавления слова"""
+    MANUAL = "manual"  # Ручное добавление
+    SUGGESTED = "suggested"  # Предложено ботом
+    CONTEXT = "context"  # Из контекста диалога
+    IMPORT = "import"  # Импорт из текста
+    ERROR = "error"  # Из ошибок в заданиях
+
+
+class User(Base):
+    """Модель пользователя"""
+    __tablename__ = "users"
+
+    id: Mapped[int] = mapped_column(primary_key=True)
+    telegram_id: Mapped[int] = mapped_column(BigInteger, unique=True, nullable=False)
+    username: Mapped[Optional[str]] = mapped_column(String(255))
+    language_interface: Mapped[str] = mapped_column(String(2), default="ru")  # ru/en
+    learning_language: Mapped[str] = mapped_column(String(2), default="en")  # en
+    level: Mapped[LanguageLevel] = mapped_column(SQLEnum(LanguageLevel), default=LanguageLevel.A1)
+    timezone: Mapped[str] = mapped_column(String(50), default="UTC")
+    daily_task_time: Mapped[Optional[str]] = mapped_column(String(5))  # HH:MM
+    streak_days: Mapped[int] = mapped_column(Integer, default=0)
+    created_at: Mapped[datetime] = mapped_column(DateTime, default=datetime.utcnow)
+    last_active: Mapped[datetime] = mapped_column(DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
+
+
+class Vocabulary(Base):
+    """Модель словарного запаса"""
+    __tablename__ = "vocabulary"
+
+    id: Mapped[int] = mapped_column(primary_key=True)
+    user_id: Mapped[int] = mapped_column(Integer, nullable=False, index=True)
+    word_original: Mapped[str] = mapped_column(String(255), nullable=False)
+    word_translation: Mapped[str] = mapped_column(String(255), nullable=False)
+    transcription: Mapped[Optional[str]] = mapped_column(String(255))
+    examples: Mapped[Optional[dict]] = mapped_column(JSON)  # JSON массив примеров
+    category: Mapped[Optional[str]] = mapped_column(String(100))
+    difficulty_level: Mapped[Optional[LanguageLevel]] = mapped_column(SQLEnum(LanguageLevel))
+    source: Mapped[WordSource] = mapped_column(SQLEnum(WordSource), default=WordSource.MANUAL)
+    times_reviewed: Mapped[int] = mapped_column(Integer, default=0)
+    correct_answers: Mapped[int] = mapped_column(Integer, default=0)
+    last_reviewed: Mapped[Optional[datetime]] = mapped_column(DateTime)
+    created_at: Mapped[datetime] = mapped_column(DateTime, default=datetime.utcnow)
+    notes: Mapped[Optional[str]] = mapped_column(String(500))  # Заметки пользователя
+
+
+class Task(Base):
+    """Модель задания"""
+    __tablename__ = "tasks"
+
+    id: Mapped[int] = mapped_column(primary_key=True)
+    user_id: Mapped[int] = mapped_column(Integer, nullable=False, index=True)
+    task_type: Mapped[str] = mapped_column(String(50), nullable=False)  # translate, sentence, fill, etc.
+    content: Mapped[dict] = mapped_column(JSON, nullable=False)  # Содержание задания
+    correct_answer: Mapped[Optional[str]] = mapped_column(String(500))
+    user_answer: Mapped[Optional[str]] = mapped_column(String(500))
+    is_correct: Mapped[Optional[bool]] = mapped_column(Boolean)
+    ai_feedback: Mapped[Optional[str]] = mapped_column(String(1000))
+    completed_at: Mapped[Optional[datetime]] = mapped_column(DateTime)
+    created_at: Mapped[datetime] = mapped_column(DateTime, default=datetime.utcnow)