Разработка кастомной системы домашних заданий для LMS

Отметим: когда в LMS десятки курсов с разными форматами заданий — от эссе до программирования — стандартная форма загрузки файлов перестаёт работать. Преподаватели тратят часы на проверку, студенты путаются в дедлайнах, а оценки приходится вручную переносить в журнал. Мы решили эту проблему для 50+ образовательных платформ, создав модуль, который автоматизирует проверку заданий на всех этапах: от сдачи до фиксации оценки.

Наша система поддерживает шесть типов ответов, гибкие дедлайны с прогрессивным штрафом, множественные попытки и peer review. В этой статье — технические детали реализации: модель данных, паттерны безопасности при загрузке файлов, алгоритмы расчёта оценок и API для интеграции. Вы получите не просто модуль, а готовое решение с гарантией 6 месяцев.

Проблемы, которые решаем

Стандартные системы управления обучением (LMS) часто ограничены одним типом ответа — текстовым полем. Для курсов программирования нужен редактор кода, для дизайна — загрузка макетов, для групповой работы — взаимная проверка. Без этого преподаватели вынуждены использовать сторонние сервисы, а студенты — переключаться между окнами. Наша система объединяет всё в одном интерфейсе.

Типы заданий и их реализация

Как мы это делаем: технический разбор

Модель данных заданий

CREATE TABLE assignments (
  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
  lesson_id UUID REFERENCES lessons(id),
  course_id UUID REFERENCES courses(id),
  title VARCHAR(500) NOT NULL,
  description TEXT,
  type VARCHAR(50) NOT NULL,
  max_score INT NOT NULL DEFAULT 100,
  deadline TIMESTAMPTZ,
  late_submission BOOLEAN DEFAULT FALSE,
  late_penalty INT DEFAULT 0,
  max_attempts INT DEFAULT 1,
  is_required BOOLEAN DEFAULT TRUE,
  created_at TIMESTAMPTZ DEFAULT NOW()
);
CREATE TABLE submissions (
  id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
  assignment_id UUID REFERENCES assignments(id),
  student_id UUID REFERENCES users(id),
  attempt_number INT NOT NULL DEFAULT 1,
  status VARCHAR(50) DEFAULT 'draft',
  text_answer TEXT,
  file_urls JSONB DEFAULT '[]',
  external_url VARCHAR(2000),
  code_answer TEXT,
  submitted_at TIMESTAMPTZ,
  graded_at TIMESTAMPTZ,
  score INT,
  feedback TEXT,
  UNIQUE(assignment_id, student_id, attempt_number)
);

Как обеспечивается безопасная загрузка файлов?

Прямая загрузка через сервер — антипаттерн для LMS с тысячами студентов. Мы используем presigned URLs: браузер загружает файл напрямую в S3/MinIO, минуя наш бэкенд. Это снижает нагрузку на сервер и исключает узкое место. Сравнение: presigned URLs снижают нагрузку на бэкенд в 10 раз по сравнению с прямой загрузкой.

async function getUploadUrl(assignmentId, fileName, fileSize, userId) {
  if (fileSize > 50 * 1024 * 1024) {
    throw new Error('File too large');
  }
  const allowedTypes = ['application/pdf', 'application/zip', 'image/png', 'image/jpeg'];
  if (!allowedTypes.includes(mimeType)) {
    throw new Error('File type not allowed');
  }
  const key = `submissions/${userId}/${assignmentId}/${uuid()}-${fileName}`;
  const url = await s3.getSignedUrlPromise('putObject', {
    Bucket: process.env.S3_BUCKET,
    Key: key,
    Expires: 300,
    ContentType: mimeType,
    ContentLength: fileSize,
  });
  return { uploadUrl: url, fileKey: key };
}

Автоматическое управление статусами и штрафами

Система проходит через цепочку статусов: draft → submitted → reviewing → graded. При отклонении — статус returned с комментарием преподавателя и возможностью переотправить. На каждом переходе отправляются уведомления (email, Telegram, in-app).

Поздняя сдача: если late_submission = true, задание принимается после дедлайна, но оценка автоматически снижается на late_penalty % за каждые сутки. Максимальный штраф — 50 %. Если прошло больше недели — автоматически 0 баллов.

function calculateFinalScore(rawScore, submittedAt, deadline, latePenalty) {
  if (submittedAt <= deadline) return rawScore;
  const hoursLate = (submittedAt - deadline) / (1000 * 60 * 60);
  if (hoursLate > 168) return 0;
  const penalty = Math.min(latePenalty * Math.ceil(hoursLate / 24), 50);
  return Math.round(rawScore * (1 - penalty / 100));
}