Quizzi/README.md

# 📚 Quizzi

Telegram-бот для создания и прохождения тестов с удобным интерфейсом и полным контролем над процессом.

## 🎯 Зачем это нужно

Если вам надоело собирать ответы в Google Forms, вручную считать баллы и рассылать результаты — Quizzi решает эти проблемы. Бот работает прямо в Telegram: студенты проходят тесты там, где им удобно, а преподаватели получают готовую статистику в Excel.

## ✨ Что умеет бот

### Для студентов

Переходите по ссылке или QR-коду — и сразу попадаете в тест. Отвечаете на вопросы кнопками, видите таймер с оставшимся временем, получаете результат мгновенно после завершения. Если разрешено — можете пересдать и улучшить балл.

### Для преподавателей

Создавайте тесты с разными типами вопросов: один правильный ответ, несколько или свободный ввод. Прикрепляйте изображения к вопросам. Настраивайте под свои нужды:

- ⏱️ Лимит времени на весь тест
- � Количество попыток пересдачи  
- 📅 Дату автоматической деактивации
- �  Пароль для доступа
- 🎓 Привязку к конкретной группе

Делитесь тестом через ссылку или QR-код. Смотрите кто прошёл, с каким результатом, какие ответы давал. Выгружайте статистику по группе в Excel — с оценками, процентом сдачи и средним баллом.

## � Установка

```bash
uv sync
cp config.example.toml config.toml
# отредактируйте config.toml
alembic upgrade head
python -m quizzi.application
```

## 📄 Лицензия

GNU AGPLv3