Skip to content

Страница /tests ​

Должен быть запрос на получение карточек тестов с фильтрацией (тематика, сложность), поиском по имени и пагинацией. Делать лучше через квери параметры, в том числе пагинацию.

Поля и свойства могут быть с любыми вашими названиями, поменять не проблема. Главное чтоб хватало для функциональности.

ts
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 теста в зависимости от попыток:

На клиенте это модалка, отрисовывающая инфу о тесте и кнопки управления, по типу там начать заново, продолжить прохождение, редактирование и тд в зависимости от статуса, ну как с карточками крч только больше инфы о тесте.

Нужен запрос с получением деталей определенного теста БЕЗ ВОПРОСОВ.

Формат примерно такой:

ts
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} ​

Тестик открывается, таймер устанавливается и тд.

  1. Запрос на получение теста с основной информацией и со всеми вопросами и сохраненными ответами. Лишнего не нужно!

Вот примерный формат, длительность или текущее время будет по другому, просто выдавайте время завершения и я отрисую:

ts
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[]; // См. тип выше
}
  1. Запрос на сохранение, чтоб ответ при переключении на следующий можно было сохранить. Представляйте как на екземе и елерне. Вообще блин весь сайт представляйте как на елерне.
  2. Запрос на завершение теста.

Результаты по тесту /tests/{id}/results ​

Запрос на получение всех завершенных попыток прохождения теста.

ts
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} ​

Запрос на получение определенной попытки с названием теста и заголовком теста.

ts
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 ​

  1. Запрос на получение текущих вопросов с количеством баллов, вариантов ответа, с верными ответами на вопрос. Также в запросе нужно название теста, сложность и тематика.

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

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

Вопрос один ответ ​

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

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

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

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

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

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

Предпросмотр созданного теста /tests/manage/1/preview ​

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

Статистика по тесту ​

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