Andrey K. Choi
b0346e4bd7
Some checks reported errors
continuous-integration/drone/push Build encountered an error
88 lines
3.1 KiB
Markdown
88 lines
3.1 KiB
Markdown
# Quiz Bot
|
||
|
||
## 📱 Готовый к использованию телеграм-бот для викторин
|
||
|
||
### ✅ Что уже готово:
|
||
|
||
- ✅ Асинхронная архитектура для множества пользователей
|
||
- ✅ База данных SQLite с полной схемой
|
||
- ✅ 100 готовых вопросов по корейскому языку (5 уровней × 20 вопросов)
|
||
- ✅ Два режима работы (гостевой и тестирование)
|
||
- ✅ Система статистики и результатов
|
||
- ✅ CSV-импорт новых тестов
|
||
- ✅ Полная документация и примеры
|
||
|
||
### 🚀 Быстрый старт:
|
||
|
||
```bash
|
||
# 1. Создайте бота у @BotFather в Telegram
|
||
# 2. Скопируйте токен в .env файл
|
||
echo "BOT_TOKEN=ваш_токен_здесь" > .env
|
||
|
||
# 3. Запустите бота
|
||
python src/bot.py
|
||
```
|
||
|
||
### 🎮 Возможности:
|
||
|
||
**Гостевой режим:**
|
||
- 5 случайных вопросов
|
||
- Без сохранения результатов
|
||
- Быстрое прохождение
|
||
|
||
**Режим тестирования:**
|
||
- 10 вопросов по выбранному уровню
|
||
- Сохранение в базу данных
|
||
- Подробная статистика
|
||
|
||
### 📚 Готовые тесты:
|
||
|
||
**🇰🇷 Корейский язык:**
|
||
- **Уровень 1**: Базовые слова (안녕하세요, 감사합니다, etc.)
|
||
- **Уровень 2**: Повседневное общение (погода, еда, время)
|
||
- **Уровень 3**: Средняя грамматика (условия, сложные конструкции)
|
||
- **Уровень 4**: Продвинутый уровень (сравнения, предположения)
|
||
- **Уровень 5**: Высокий уровень (абстракции, профессиональная лексика)
|
||
|
||
### 🔧 Утилиты:
|
||
|
||
```bash
|
||
python demo.py # Демонстрация без Telegram
|
||
python test_quiz.py # Интерактивный тест в консоли
|
||
python setup.py # Проверка готовности к запуску
|
||
```
|
||
|
||
### 📁 Добавление новых тестов:
|
||
|
||
1. Создайте CSV файл в папке `data/`:
|
||
```csv
|
||
Вопрос,Ответ1,Ответ2,Ответ3,Ответ4,Правильный_ответ
|
||
"What is hello in English?","Hello","Goodbye","Please","Thank you",1
|
||
```
|
||
|
||
2. Загрузите в базу данных:
|
||
```bash
|
||
python load_questions.py
|
||
```
|
||
|
||
### 📊 Архитектура:
|
||
|
||
```
|
||
src/
|
||
├── bot.py # Основной бот
|
||
├── database/ # Работа с БД
|
||
├── services/ # CSV загрузчик
|
||
└── handlers/ # Расширения (будущее)
|
||
|
||
data/
|
||
├── quiz_bot.db # База данных
|
||
└── *.csv # Файлы с тестами
|
||
|
||
config/
|
||
└── config.py # Настройки
|
||
```
|
||
|
||
---
|
||
|
||
**🎯 Готов к продакшну!** Просто добавьте токен бота и запускайте.
|