🇨🇳 Chinese Learning Telegram Bot

Telegram-бот для изучения китайского языка. 50 структурированных уроков — полный HSK 1 и HSK 2 (~300 слов) с иероглифами, пиньинь, мнемониками и упражнениями.

Запуск

# 1. Создай бота через @BotFather в Telegram, получи токен

# 2. Установи зависимости
pip3 install -r requirements.txt

# 3. Задай токен
export BOT_TOKEN=your_token_here

# 4. Запусти
python3 bot.py

Команды бота

Команда	Действие
/start	Приветствие и инструкция
/lessons	Список всех 50 уроков с прогрессом
/lesson N	Открыть урок N (1–50)
/repeat N	Повторить урок N
/progress	Прогресс-бар и статистика
/test hsk1	Финальный тест HSK 1 (30 вопросов)
/test hsk2	Финальный тест HSK 2 (30 вопросов)

Структура уроков

• HSK 1 (уроки 1–25): 150 слов — приветствия, числа, семья, еда, места, транспорт, время, погода, глаголы, грамматика
• HSK 2 (уроки 26–50): ещё 150 слов — направления, чувства, сравнения, спорт, путешествия, союзы, грамматические конструкции

Каждый урок содержит:

• Слова с иероглифами + пиньинь + перевод
• Мнемоника (образный способ запомнить)
• Этимология (откуда взялся иероглиф)
• Грамматическое объяснение
• 5 упражнений с inline-кнопками

Прогрессия

• Урок N+1 разблокируется после прохождения урока N с результатом ≥50%
• Лучший результат сохраняется в SQLite

Деплой на сервер (systemd)

[Unit]
Description=Chinese Learning Bot

[Service]
WorkingDirectory=/path/to/chinese-bot
ExecStart=/usr/bin/python3 bot.py
Environment=BOT_TOKEN=your_token
Restart=always

[Install]
WantedBy=multi-user.target

Тесты

python3 -m pytest tests/ -v