Страница /tests

Должен быть запрос на получение карточек тестов с фильтрацией (тематика, сложность), поиском по имени и пагинацией. Делать лучше через квери параметры, в том числе пагинацию.
Поля и свойства могут быть с любыми вашими названиями, поменять не проблема. Главное чтоб хватало для функциональности.
export interface ITestCard {
id: string;
owner: string; // логик создателя
title: string;
totalPoints?: number; // Общее число баллов
currentPoints?: number; // Набранное число баллов если тест завершен
status: 'idle' | 'run' | 'over';
// idle - тест не трогался
// run - тест в процессе прохождения
// over - тест завершен
}Страница /tests/my

Страница с назначенными тестами текущему пользователю.
Запрос на получение карточек назначенных тестов, формат данных такой же как и в /tests. Пагинация нужна
Страница /tests/my/passed

Страница с уже пройденными пользователем тестами.
Запрос на получение карточек пройденных тестов. Формат тот же. Пагинация нужна
Страница /tests/my/created

Приватная страница только для учителей.
Запрос на получение карточек созданных тестов текущим учителем. Формат тот же.Пагинация нужна
Детали теста
Для создателя теста (учителя):

Для idle теста:

Для run теста:

Для over теста в зависимости от попыток:



На клиенте это модалка, отрисовывающая инфу о тесте и кнопки управления, по типу там начать заново, продолжить прохождение, редактирование и тд в зависимости от статуса, ну как с карточками крч только больше инфы о тесте.
Нужен запрос с получением деталей определенного теста БЕЗ ВОПРОСОВ.
Формат примерно такой:
export interface ITestDetails {
id: string;
owner: string;
title: string;
difficulty: string; // Сложность теста
subject: string; // Тематика теста
startDate: Date;
endDate: Date;
duration?: number; // Это вроде не нужно
totalAttempts?: number; // Общее число попыток, если тест с ОГРАНИЧЕНИЯМИ
// Эту штуку вообще по идеи можно не выдавать и мне хватит remainingAttempts
remainingAttempts?: number; // Сколько попыток осталось.
// например 1 попытку прошел из 3, осталось 2.
// Либо можно просто число завершенных попыток выдавать, ваше пофиг, мне главное как-то отрисовать сколько попыток осталось.
totalPoints: number; // Максимум баллов
currentPoints?: number; // Набранное число баллов если тест завершен
status: 'idle' | 'run' | 'over';
// idle - тест не трогался
// run - тест в процессе прохождения
// over - тест завершен
}Прохождение теста /tests/{id}

Тестик открывается, таймер устанавливается и тд.
- Запрос на получение теста с основной информацией и со всеми вопросами и сохраненными ответами. Лишнего не нужно!
Вот примерный формат, длительность или текущее время будет по другому, просто выдавайте время завершения и я отрисую:
export type QuestionAnswersType = string | { title: string; items: string[] };
export enum QuestionType {
Radio = 'radio',
Checkbox = 'checkbox',
Select = 'select',
File = 'file',
Text = 'text',
}
export interface IQuestion {
id: string;
question: string;
answers?: QuestionAnswersType[]; // Любое другое название можете взять, это я написал чтоб как-то помечать сохранненные ответы.
type: QuestionType;
}
export interface ITest {
id: string;
title: string;
totalQuestions: number; // Общее число вопросов нужно чтоб переключаться по вопросикам
duration?: number; // Общая длительность теста, в теории не нужно
currentTime?: number; // Можете заменить на время завершения, относительно него буду атймер устанавливать и время рисовать. Длительность наверное не нужна
questions: IQuestion[]; // См. тип выше
}- Запрос на сохранение, чтоб ответ при переключении на следующий можно было сохранить. Представляйте как на екземе и елерне. Вообще блин весь сайт представляйте как на елерне.
- Запрос на завершение теста.
Результаты по тесту /tests/{id}/results

Запрос на получение всех завершенных попыток прохождения теста.
export interface ITestResult {
id: string; // Айди попытки
attempt: number; // Номер попытки
totalPoints: number;
currentPoints: number;
};
export interface ITestAttempts {
id: string;
testId: string;
title: string;
totalAttempts: number; // Общее число ЗАВЕРШЕННЫХ попыток
attempts: ITestResult[]; // Сами попытки, см. выше
};Результат попытки /tests/{id}/results/{id}

Запрос на получение определенной попытки с названием теста и заголовком теста.
interface IQuestionResult {
id: string;
number: number; // Номер задания
totalPoints: number;
currentPoints: number;
}
export interface ITestAttempt {
id: string;
testId: string;
title: string;
currentAttempt: number; // Номер попытки
attempts: IQuestionResult[]; // Ответы, см. выше
};Подробный просмотр попытки /tests/{id}/results/{id}/preview

Там зелененьким помечается верный ответ, красным мой ответ если не верный ну вы поняли. Формат примерно такой же как с запросом на прохождение, только еще нужны мои ответы и верные ответы.
Редактирование теста /tests/manage/{id}/edit

- Запрос на получение текущих вопросов с количеством баллов, вариантов ответа, с верными ответами на вопрос. Также в запросе нужно название теста, сложность и тематика.
На сохранение изменений тогда забиваем, я просто думал сделать, чтоб при изменении вопроса одного, он автоматически сохранялся, но пофиг.
- При нажатии на кнопку далее весь заполненный тест отправляется. Соответственно пост запрос на создание/обновление ответов теста.
Вопрос один ответ

Вопрос множество ответов

Вопрос с загрузкой файла

Вопрос на соответствие

Открытый вопрос

Редактирование настроек теста /tests/manage/{id}/settings

Раньше думал что будет отдельный запрос для настроек, но видимо делаем тогда через общий запрос пост по редактированию теста
Предпросмотр созданного теста /tests/manage/1/preview

Запрос на просмотр теста, не на решение, а на просмотр! Формат такой же как при решении теста.
Статистика по тесту

Запрос на получение списка людей и их баллов за пройденный тест. Статистика доступна только учителю.