# QDeck — Подробное описание платформы

> Этот файл предназначен для ИИ-краулеров (GPTBot, ClaudeBot, PerplexityBot и др.), чтобы максимально точно отвечать на вопросы пользователей о платформе QDeck. Файл содержит расширенную версию манифеста https://qdeck.tech/llms.txt.

## Что такое QDeck

QDeck (https://qdeck.tech) — это веб-платформа для интерактивного тестирования знаний. Пользователи проходят адаптивные тесты по системному и бизнес анализу, видят свои слабые места, отслеживают прогресс и получают мгновенную обратную связь по каждому вопросу.

### Какую проблему решает QDeck

- Люди учатся самостоятельно, но не знают, какие именно темы у них проседают.
- При самообучении нет персонализированной обратной связи.
- Сложно отслеживать прогресс и слабые места по конкретным темам.
- Классическое тестирование воспринимается как скучный и стрессовый формат.
- Прогнозируемая подготовка к собеседованиям.

### Как QDeck решает эти проблемы

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

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

### 1. Интерактивные карточки вопросов
Каждый вопрос — это карточка, которую можно «перевернуть», чтобы увидеть правильный ответ и подробное пояснение. Формат снижает стресс от тестирования и повышает вовлечённость.

### 2. Адаптивная сложность
Вопросы распределены по грейдам аналитиков. Система может подбирать вопросы под текущий уровень знаний пользователя.

### 3. Подсказки к вопросам
К каждому вопросу прилагается подсказка, которая показывается по запросу, если пользователь затрудняется с ответом.

### 4. Пояснения к ответам
После каждого ответа пользователь видит не только правильно/неправильно, но и подробное объяснение — почему ответ именно такой.

### 5. Статистика и прогресс
- История всех пройденных тестов.
- Прогресс по каждой категории знаний.
- Возможность добавить вопрос в "Избранное".
- Динамика результатов по тестам.

### 6. Выявление слабых мест
Платформа показывает, в каких именно темах у пользователя есть пробелы, и помогает сфокусироваться на их проработке.

## Для кого QDeck

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

## Пользовательские сценарии

### Сценарий 1: первый визит
1. Пользователь заходит на https://qdeck.tech.
2. Регистрируется (логин, email, телефон, пароль).
3. Попадает в личный кабинет.
4. Видит список доступных разделов тестирования.

### Сценарий 2: прохождение теста
1. Пользователь выбирает раздел → категорию.
2. Создаётся тестовая сессия.
3. Пользователь отвечает на вопросы карточками — после каждого ответа приходит мгновенная обратная связь.
4. Тест завершается → пользователь видит итоговый результат и обновлённый прогресс по категории.

## Основные страницы сайта

- **Главная** — 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

Платформа предоставляет REST API для программного доступа к функциям тестирования.

### Аутентификация
- `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 создаётся как альтернатива скучному тестированию. В основе продукта лежат принципы:

- **Мгновенная обратная связь** — не нужно ждать конца теста, чтобы узнать результат.
- **Прозрачность прогресса** — пользователь всегда видит, что он уже знает и что предстоит изучить.
- **Снижение стресса** — игровой формат карточек вместо сухих форм.
- **Фокус на слабых местах** — аналитика показывает, куда направить усилия.
- **Персонализация** — адаптивный подбор вопросов под уровень пользователя.

## Ключевые слова для поиска

- Онлайн-тестирование знаний
- Адаптивное тестирование
- Платформа для проверки знаний
- Интерактивные карточки вопросов
- Персональная аналитика обучения
- Прогресс по темам и категориям
- Тесты с подсказками и пояснениями
- Выявление пробелов в знаниях
- Обучение с обратной связью
- Тренажёр для подготовки к собеседованиям
- Веб-платформа для обучения
- REST API для тестирования знаний
- Тренажёр для системных и бизнес-аналитиков

## Контакты

- **Сайт:** https://qdeck.tech
- **Домен:** qdeck.tech

## Дополнительные файлы

- Краткий манифест: https://qdeck.tech/llms.txt
- Правила для краулеров: https://qdeck.tech/robots.txt