quiz_test/docs/QUICKSTART.md

Quiz Bot

📱 Готовый к использованию телеграм-бот для викторин

✅ Что уже готово:

• ✅ Асинхронная архитектура для множества пользователей
• ✅ База данных SQLite с полной схемой
• ✅ 100 готовых вопросов по корейскому языку (5 уровней × 20 вопросов)
• ✅ Два режима работы (гостевой и тестирование)
• ✅ Система статистики и результатов
• ✅ CSV-импорт новых тестов
• ✅ Полная документация и примеры

🚀 Быстрый старт:

# 1. Создайте бота у @BotFather в Telegram
# 2. Скопируйте токен в .env файл
echo "BOT_TOKEN=ваш_токен_здесь" > .env

# 3. Запустите бота
python src/bot.py

🎮 Возможности:

Гостевой режим:

• 5 случайных вопросов
• Без сохранения результатов
• Быстрое прохождение

Режим тестирования:

• 10 вопросов по выбранному уровню
• Сохранение в базу данных
• Подробная статистика

📚 Готовые тесты:

🇰🇷 Корейский язык:

• Уровень 1: Базовые слова (안녕하세요, 감사합니다, etc.)
• Уровень 2: Повседневное общение (погода, еда, время)
• Уровень 3: Средняя грамматика (условия, сложные конструкции)
• Уровень 4: Продвинутый уровень (сравнения, предположения)
• Уровень 5: Высокий уровень (абстракции, профессиональная лексика)

🔧 Утилиты:

python demo.py          # Демонстрация без Telegram
python test_quiz.py     # Интерактивный тест в консоли
python setup.py         # Проверка готовности к запуску

📁 Добавление новых тестов:

1. Создайте CSV файл в папке data/:

Вопрос,Ответ1,Ответ2,Ответ3,Ответ4,Правильный_ответ
"What is hello in English?","Hello","Goodbye","Please","Thank you",1

2. Загрузите в базу данных:

python load_questions.py

📊 Архитектура:

src/
├── bot.py              # Основной бот
├── database/           # Работа с БД
├── services/           # CSV загрузчик
└── handlers/           # Расширения (будущее)

data/
├── quiz_bot.db         # База данных
└── *.csv              # Файлы с тестами

config/
└── config.py          # Настройки

---

🎯 Готов к продакшну! Просто добавьте токен бота и запускайте.