# QDeck

> QDeck — веб-платформа для интерактивного тестирования знаний с адаптивным подбором вопросов по уровню сложности, мгновенной обратной связью и подробной аналитикой прогресса по темам.

QDeck решает проблему «слепого» самообучения: пользователи учатся, но не знают, что именно они не знают. Платформа показывает пробелы в знаниях, отслеживает прогресс и превращает тестирование в интерактивный процесс с помощью карточек.

## Ключевые возможности

- Адаптивный подбор вопросов по теме и уровню сложности
- Интерактивные карточки вопросов с мгновенной обратной связью
- Подсказки и пояснения к каждому вопросу
- Детальная статистика: история тестов, прогресс по категориям, слабые места
- Игровой формат — снижает стресс от тестирования, повышает вовлечённость

## Ключевые маршруты

- Главная: https://qdeck.tech/
- Регистрация: https://qdeck.tech/register
- Личный кабинет: https://qdeck.tech/user/home
- Категории пользователя: https://qdeck.tech/user/categories
- Вопросы пользователя: https://qdeck.tech/user/questions
- Страница тестирования: https://qdeck.tech/testing/question
- История тестов: https://qdeck.tech/testing/results
- Завершение теста: https://qdeck.tech/testing/complete
- Детали теста: https://qdeck.tech/test/details

## REST API v1

- POST   /api/v1/auth/login        — аутентификация
- POST   /api/v1/auth/register     — регистрация
- POST   /api/v1/auth/logout       — выход
- POST   /api/v1/tests             — создать тест
- GET    /api/v1/tests/current     — активная сессия
- GET    /api/v1/tests/{id}/current — текущий вопрос
- POST   /api/v1/tests/{id}/answer — отправить ответ
- POST   /api/v1/tests/{id}/complete — завершить тест
- GET    /api/v1/tests/history     — история тестов
- GET    /api/v1/tests/{id}        — детали теста
- DELETE /api/v1/tests/{id}        — отмена сессии
- GET    /api/v1/users/me          — профиль пользователя
- GET    /api/v1/users/stats       — статистика

## Для кого

- Системные аналитики, которые хотят понять свои слабые места
- Менторы и аналитики, которым нужна платформа для проверки знаний
- Пользователи, которым важна мгновенная и персонализированная обратная связь
- Выпускники ВУЗов и студенты

## Концепция

QDeck создаётся как альтернатива скучному тестированию: вместо длинных форм — короткие карточки, вместо отложенной проверки — мгновенная обратная связь, вместо неизвестности «что я не знаю» — прозрачная статистика по темам и сложности.

## Контакты

- Сайт: https://qdeck.tech=

## Optional

- Расширенная версия: https://qdeck.tech/llms-full.txt
- robots.txt: https://qdeck.tech/robots.txt