Розробка кастомної системи домашніх завдань для 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)); }