QuizMaster

Веб-приложение для создания и прохождения викторин с поддержкой ограничения времени, подсказок и отслеживания результатов.

Возможности

• Управление викторинами — создание, редактирование и удаление викторин
• Система вопросов — добавление вопросов с несколькими вариантами ответов (до 4)
• Ограничение времени — опциональный таймер для прохождения викторины
• Подсказки — возможность добавить подсказки к ответам
• Результаты — отслеживание результатов с процентом правильных ответов
• Поиск — поиск викторин по названию
• Массовый импорт — добавление нескольких вопросов через JSON

Технологии

• Backend: Flask 3.1, Python 3
• Database: SQLite3
• Frontend: Bootstrap 5.3, Jinja2
• Icons: Bootstrap Icons

Установка

1. Клонируйте репозиторий:

git clone https://github.com/username/quizmaster.git
cd quizmaster

2. Создайте виртуальное окружение:

python -m venv env

3. Активируйте виртуальное окружение:

# Windows
env\Scripts\activate

# Linux/macOS
source env/bin/activate

4. Установите зависимости:

pip install -r requirements.txt

Запуск

python run.py

Приложение будет доступно по адресу: http://localhost:5000

Структура проекта

QuizMaster/
├── core/
│   ├── __init__.py          # Инициализация Flask
│   ├── db.py                # Модели и запросы к БД
│   ├── logger.py            # Конфигурация логирования
│   ├── routes.py            # Маршруты приложения
│   └── templates/           # HTML-шаблоны
│       ├── base.html        # Базовый шаблон
│       ├── index.html       # Главная страница
│       ├── create_quiz.html # Создание викторины
│       ├── quiz.html        # Прохождение викторины
│       └── result.html      # Результаты
├── logs/                    # Логи приложения
├── quiz.db                  # База данных SQLite
├── requirements.txt         # Зависимости Python
└── run.py                   # Точка входа

API маршруты

Метод	Путь	Описание
GET	/	Список всех викторин
GET/POST	/create_quiz	Создание викторины
GET/POST	/quiz/<id>	Прохождение викторины
GET/POST	/edit_quiz/<id>	Редактирование викторины
POST	/delete_quiz/<id>	Удаление викторины
GET/POST	/create_ques	Добавление вопросов
GET/POST	/edit_question/<id>	Редактирование вопроса
GET	/quiz_results/<id>	Результаты викторины

Лицензия

MIT