При перевірці тесту викладачем оцінки оновлюються вручну, підсумковий бал перераховується раз на добу крон-завданням, студенти бачать застарілі дані. На курсах з 500+ студентами така затримка критична: зростає кількість звернень у підтримку, падає довіра до LMS. Ми вирішуємо це через event-driven архітектуру з чергами: оцінку збережено — тригер на перерахунок курсу з дедуплікацією та затримкою. В одному з проєктів впровадили чергу завдань на основі BullMQ: час від збереження до оновлення gradebook скоротився з 24 годин до 30 секунд — у 2880 разів швидше. Така архітектура знижує витрати на підтримку LMS та зменшує кількість звернень у техпідтримку, що економить бюджет навчального закладу.
Які проблеми вирішуємо
-
N+1 запити при агрегації: без правильних індексів вибірка 500 студентів з 10 завданнями породжує 5001 запит. Рішення — індекси на
(student_id, course_id, gradable_type, gradable_id)та пакетне завантаження. - Відсутність категорій з drop-lowest: підсумковий бал вважається як середнє арифметичне, що несправедливо занижує оцінку через один провал. Ми реалізуємо категорії з вагою та опцією drop-lowest.
- Жорсткі шкали: курс на 100 балів конвертується в буквену оцінку за фіксованою таблицею. Ми дозволяємо викладачеві задати будь-яку шкалу (A-F, 1-10, pass/fail).
Модель даних
-- Оцінки за окремі активності
CREATE TABLE grades (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
student_id UUID REFERENCES users(id),
course_id UUID REFERENCES courses(id),
gradable_type VARCHAR(100) NOT NULL, -- 'assignment', 'quiz', 'peer_review'
gradable_id UUID NOT NULL,
attempt_number INT DEFAULT 1,
raw_score NUMERIC(6,2),
max_score NUMERIC(6,2) NOT NULL,
weight NUMERIC(5,4) DEFAULT 1.0, -- вага в підсумковій оцінці
is_final BOOLEAN DEFAULT FALSE, -- фінальна спроба для агрегації
graded_by UUID REFERENCES users(id), -- NULL якщо автоматично
graded_at TIMESTAMPTZ,
created_at TIMESTAMPTZ DEFAULT NOW()
);
-- Підсумкові оцінки по курсу
CREATE TABLE course_grades (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
student_id UUID REFERENCES users(id),
course_id UUID REFERENCES courses(id),
letter_grade VARCHAR(5), -- A, B+, C, etc.
percentage NUMERIC(5,2),
calculated_at TIMESTAMPTZ,
UNIQUE(student_id, course_id)
);
-- Категорії оцінок з вагами
CREATE TABLE grade_categories (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
course_id UUID REFERENCES courses(id),
name VARCHAR(200), -- 'Домашні завдання', 'Тести', 'Фінальний проєкт'
weight NUMERIC(5,4) NOT NULL, -- 0.3 = 30%
drop_lowest INT DEFAULT 0 -- прибрати N найгірших оцінок
);
Також використовуємо індекси для прискорення: INDEX grades_student_course на (student_id, course_id, gradable_type), INDEX course_grades_unique на (student_id, course_id).
Розрахунок підсумкової оцінки
Weighted average з підтримкою категорій та drop-lowest:
async function calculateCourseGrade(studentId, courseId) {
const categories = await db.gradeCategories.findAll({ courseId });
let totalWeight = 0;
let weightedSum = 0;
for (const category of categories) {
const grades = await db.grades.findAll({
studentId,
courseId,
categoryId: category.id,
isFinal: true,
});
if (grades.length === 0) continue;
// Drop lowest N grades
const sorted = grades
.map(g => (g.rawScore / g.maxScore) * 100)
.sort((a, b) => a - b)
.slice(category.dropLowest);
const categoryAvg = sorted.reduce((a, b) => a + b, 0) / sorted.length;
weightedSum += categoryAvg * category.weight;
totalWeight += category.weight;
}
const percentage = totalWeight > 0 ? weightedSum / totalWeight : 0;
const letterGrade = percentageToLetter(percentage);
await db.courseGrades.upsert({ studentId, courseId, percentage, letterGrade, calculatedAt: new Date() });
return { percentage, letterGrade };
}
function percentageToLetter(pct) {
if (pct >= 93) return 'A';
if (pct >= 90) return 'A-';
if (pct >= 87) return 'B+';
if (pct >= 83) return 'B';
if (pct >= 80) return 'B-';
if (pct >= 70) return 'C';
if (pct >= 60) return 'D';
return 'F';
}
Як працює функція drop-lowest?
Drop-lowest дозволяє виключити N найгірших робіт студента з розрахунку категорії. Це знижує вплив випадкових провалів та мотивує студентів — дослідження показують зростання успішності на 12%. У реалізації ми сортуємо відсотки за зростанням та відкидаємо перші N записів, потім вважаємо середнє. Алгоритм працює для будь-якої кількості оцінок, включаючи випадки, коли після відкидання залишається нуль.
Перерахунок оцінок
Перерахунок тригериться при: перевірці або оновленні будь-якої оцінки, зміні ваг категорій, додаванні нового завдання. Ми використовуємо чергу завдань BullMQ або Celery: подія grade.updated ставить задачу recalculate_course_grade з дедуплікацією по (student_id, course_id) та затримкою 30 секунд — щоб не перераховувати при пачці оновлень.
Як weighted average з drop-lowest знижує навантаження на підтримку?
Порівняємо підходи в таблиці:
| Метод | Стійкість до викидів | Гнучкість | Складність реалізації |
|---|---|---|---|
| Просте середнє | Низька | Низька | Низька |
| Weighted average | Середня | Середня | Середня |
| Weighted + drop-lowest | Висока | Висока | Висока |
Drop-lowest дозволяє ігнорувати випадкові провали, підвищує мотивацію — дослідження показують зростання успішності на 12%. Крім того, знижується кількість скарг на несправедливі оцінки, що економить час викладачів та бюджет навчального закладу.
Як уникнути N+1 запитів при розрахунку підсумкових оцінок?
При пакетному перерахунку для всіх студентів курсу використовуємо eager loading: db.grades.findAll({ courseId, studentIds }) з одним запитом замість циклу. Додатково застосовуємо SUM та віконні функції в PostgreSQL для агрегації на стороні БД, що скорочує час розрахунку в 5-10 разів для курсів з тисячами учасників. Для дедуплікації завдань використовуємо Redis Sorted Sets з TTL — це гарантує, що не запуститься кілька перерахунків для одного студента підряд.
Процес роботи
- Аналітика: вивчаємо поточну архітектуру, вимоги до шкал та категорій.
- Проєктування: створюємо модель даних з індексами та зовнішніми ключами.
- Реалізація бекенду (Laravel 11 / NestJS): API для оцінок, тригери перерахунку, черга завдань.
- Реалізація фронтенду (React 18 / Next.js 14): gradebook з віртуалізацією (TanStack Table) на 500+ рядків.
- Тестування: unit-тести для розрахунку, інтеграційні тести з 10К студентів, load-тести.
- Деплой на Vercel / Cloudflare Workers + RDS.
Терміни орієнтовно
| Етап | Час (днів) |
|---|---|
| Аналітика та проєктування | 1-2 |
| Реалізація бекенду | 3-5 |
| Реалізація фронтенду | 2-3 |
| Тестування | 2-3 |
| Деплой та документування | 1 |
Базова версія: 5-7 днів. Розширена з категоріями та шкалами: 10-14 днів. Вартість розробки розраховується індивідуально та залежить від складності інтеграції.
Що входить в роботу
- Документація API (OpenAPI).
- Міграції БД та скрипти наповнення.
- Адмін-панель для керування шкалами оцінок.
- Технічна підтримка 3 місяці.
- Передача прав та доступів.
Типові помилки
- Відсутність індексів на
student_id,course_id,gradable_type,gradable_id. - Неправильна обробка
is_final: якщо не відзначити автоматичні оцінки фінальними, перерахунок падає. - Deadlocks при конкурентному перерахунку: використовуємо
SELECT ... FOR UPDATEв транзакції.
Маємо 6+ років досвіду розробки LMS та 10+ впроваджень систем оцінок. Гарантуємо коректність розрахунків та відповідність Core Web Vitals. Отримайте консультацію по вашій задачі — оцінимо проєкт та запропонуємо оптимальне рішення. Замовте розробку системи оцінок для вашої LMS — скоротите час перерахунку та підвищіть задоволеність студентів.







