Osvitly

Що було технічно складним

Журнал має бути чесним щодо семестру, який пройшов лише наполовину. Наївна версія ділить на все заплановане, тож учень на третьому тижні курсу виглядає як той, хто не встигає, а батько, який бачить це число, діє за ним. Підсумки тут збирають лише ті роботи, за які в учня справді є оцінка; відвідуваність рахується від уроків, які справді відмітили, тож непозначений урок ніколи не працює проти людини, а поважна причина відсутності не карає. Друга половина — швидкість: кожен екран журналу складається зі сталої кількості запитів незалежно від того, скільки учнів у класі, і тест стежить за цією кількістю, щоб пізніша зміна не повернула тихцем запит на кожного учня.

Як це побудовано

Django 5.2 і DRF на PostgreSQL, Celery із Redis для асинхронної роботи, JWT для SPA і API-ключі для машинного доступу. React 19 із shadcn/ui і Tailwind на фронтенді, лендинг на Astro, Stripe для підписок і MCP-сервер, щоб навчальний контент можна було готувати зі ШІ-асистентом на основі власної програми школи.

Одне рішення, і чому

Оцінки завжди зберігаються як десяткові бали, а шкала оцінювання — це пресет відображення, а не формат зберігання. Українська 12-бальна шкала — це те, що очікує побачити більшість шкіл, і очевидна реалізація зберігає дванадцятибальні значення напряму — рівно до того моменту, як клас змінює шкалу й кожну історичну оцінку треба мігрувати, або два класи в одній школі мають показувати різне з тих самих даних. Конвертація під час читання коштує перерахунку на кожному екрані; вона купує журнал, у якому зміна вигляду оцінки ніколи не змінює того, чим вона є.