Как я собрал школьный тренажёр на Django: архитектура, генераторы задач и 213 тестов

Обсудить
Как я собрал школьный тренажёр на Django: архитектура, генераторы задач и 213 тестов
Реклама. АО «ТаймВэб». erid: 2W5zFHAoQ9x

Я делаю EduTrainer – бесплатный тренажёр для школьников 1-11 классов. Идея простая: ученик выбирает тему, решает задачу, сразу получает проверку и разбор ошибки. Без репетитора, без подписки и без «100500 презентаций».

За несколько месяцев проект вырос до: 

  • 603 тем;
  • 25 заданий ОГЭ;
  • 1 144 формул в справочнике;
  • 213 автоматических тестов.

В этой статье – не реклама, а разбор технических решений: как устроен генератор заданий, почему пришлось переписать проверку ответов и какие SEO-грабли чуть не убили проект на старте.

Стек: без микросервисов и тяжёлого фронтенда

Проект – классический Django-монолит:

Python 3.12
Django 5.2
PostgreSQL
Redis
Daphne + Nginx

Почему так:

  • SSR вместо SPA. Страницы должны открываться быстро и индексироваться поисковиками. Django-шаблоны отдают готовый HTML, а JavaScript отвечает только за интерактив.
  • Один процесс вместо зоопарка. Для текущей нагрузки не нужны микросервисы, очереди и Kubernetes. Их добавление усложнило бы разработку, но не дало бы пользователю ничего.
  • Redis для кэша и rate limit. Примеры задач и некоторые страницы кэшируются, чтобы генерация не жгла CPU на каждом запросе.
  • Daphne и Nginx. Nginx держит статику, SSL и сжатие, Daphne – ASGI-приложение.

Проект не привязан к конкретному хостингу: Django-приложение с PostgreSQL и Redis разворачивается на обычном VPS. У меня это Nginx + Daphne + systemd.

Как устроен генератор задач

Каждая задача – не заранее написанный текст, а результат работы генератора. Базовая модель выглядит так:

python

from dataclasses import dataclass, field

@dataclass
class Step:
    n: int
    text: str
    formula: str = ""

@dataclass
class Solution:
    steps: list[Step]
    hint: str = ""

@dataclass
class Task:
    id: str
    prompt: str
    answer: str
    answer_type: str  # number | text | choice
    solution: Solution
    options: list[str] = field(default_factory=list)
    topic_id: str = ""

Генератор получает grade, level и seed. Из seed детерминированно строятся числа, правильный ответ и шаги решения. ID задачи содержит ключ генератора, класс, уровень и seed: math_frac2__5__2__12345.

Это даёт два преимущества:

  1. Задачу можно воспроизвести по ID – удобно для жалоб «у меня неверный ответ».
  2. Один и тот же пример не выдаётся повторно в рамках сессии.

Дальше работает реестр тем:

python

TOPICS = {
    "math-fractions": {
        "title": "Обыкновенные дроби",
        "grades": [5, 6],
        "generator": "math_frac2",
    },
    ...
}

Абстракция простая, но именно она позволила добавить сотни тем без сотен отдельных шаблонов.

Почему почти всё стало «выбором варианта»

Изначально часть задач требовала ввести ответ вручную. На практике возникли проблемы:

  • ученик пишет 1/2, а в ответе 0,5;
  • ответ x = 5 не совпадает с 5;
  • в английском I've и I have – один смысл, но разный текст;
  • мобильная клавиатура часто вставляет лишние пробелы.

Поэтому для большинства тем был сделан автоматический режим choice: генератор создаёт правильный ответ и несколько правдоподобных дистракторов. Это не идеал для обучения, но резко снизило число ложных «неверно».

Минус тоже понятен: выбор варианта можно угадать. Для части тем нужен свободный ввод, и это следующий шаг.

Проверка задач: самое дорогое место

Сгенерировать 600 тем легко. Проверить, что в каждой из них нет бреда, – намного дороже.

Я прогнал 603 темы × 3 уровня = 1 809 заданий и проверял:

  • есть ли ответ;
  • входит ли ответ в варианты;
  • нет ли дублей вариантов;
  • есть ли шаги решения;
  • нет ли отрицательных ответов там, где их не должно быть;
  • нет ли сырого LaTeX в условии.

Нашлись реальные ошибки.

1. Отрицательные дроби в 5 классе

Генератор мог выдать: 1/5 − 8/6 = −17/15. Формально верно, но для 5 класса – нет. Исправил: при вычитании первая дробь всегда больше второй.

2. Несокращённый ответ

Было: 2x + 4 > 4. Ответ: x > (0)/2. Ученик, написавший x > 0, получал «неверно». Теперь ответ сокращается через gcd, а вместе с ним убираются 1x, -1x и конструкции + -3.

3. Сырой LaTeX в вариантах

В интерфейсе появлялось: \frac{1}{2}, \text{не определён}. Причина: фильтр обрабатывал только формулы в $...$, а генераторы отдавали TeX без обёртки. Пришлось менять рендер вариантов, подсказок и шагов решения.

4. Физика: условие плавания

В справочнике было: Условие плавания: F_A > F_тяж. Это условие всплытия. Плавание – когда силы равны: F_A = F_тяж. Такие ошибки не ловятся обычным «тест прошёл». Нужна предметная проверка.

Почему 213 тестов – не роскошь

Тесты делятся на несколько групп:

контракт генераторов
проверка ответов
доступ к классам и результатам
SEO-маршруты
формулы и справочники
контактные формы и антиспам

Самые полезные тесты – не на «страница вернула 200», а на инварианты:

  • ответ всегда входит в варианты;
  • в 5 классе нет отрицательных ответов;
  • неразрывный ответ не принимается как верный;
  • чужой учитель не откроет чужой класс;
  • родитель не увидит ребёнка без привязки;
  • все 25 страниц ОГЭ открываются и содержат задания.

Именно тесты поймали часть ошибок, которые не видны при беглом просмотре.

Скриншоты продукта

Тренажёр

Одна задача, варианты ответа, подсказка и разбор – без перехода в отдельное приложение.

Одна задача, варианты ответа, подсказка и разбор – без перехода в отдельное приложение.

Задание ОГЭ

На странице задания сразу 10 задач с проверкой, а не три кнопки «Теория / Тренажёр».

На странице задания сразу 10 задач с проверкой, а не три кнопки «Теория / Тренажёр».

Справочник формул

Формулы отдаются обычным текстом, без дублирования MathML и LaTeX в сниппете.

Формулы отдаются обычным текстом, без дублирования MathML и LaTeX в сниппете.

SEO: 1 500 URL на старте – плохая идея

Сначала я сделал «как правильные SEO-сайты»: много тем, много страниц, большой sitemap. Получилось 1 547 URL у домена возрастом меньше месяца.

Результат предсказуемый:

  • поисковик обходит только часть;
  • в индекс попадает около 100 страниц;
  • тонкие страницы конкурируют друг с другом;
  • новый домен не получает доверия.

Пришлось сокращать: 1 547 → 453 URL.

Что сделал:

  • оставил в sitemap приоритетные темы и 50 практических страниц;
  • закрыл noindex динамические страницы, которые не должны конкурировать с теорией;
  • убрал дубли URL;
  • перевёл блог на латинские адреса;
  • добавил канонические адреса и 301 для старых ссылок;
  • отправил приоритетные URL через IndexNow.

Главный вывод: на молодом домене лучше 50 сильных страниц, чем 1 500 страниц «на всякий случай».

Что показали первые недели

Первые недели – это не про трафик.

Домен новый, ИКС не присвоен, внешних ссылок почти нет. Поисковые системы ведут себя осторожно:

  • Яндекс обходит сайт, но не спешит ранжировать;
  • Google может вообще не приходить, пока сайт не добавлен в Search Console и не получил внешние ссылки;
  • первые посетители приходят не из поиска, а из прямых ссылок и сообществ.

Технически сайт доступен, быстро отвечает и отдаёт HTML. Но доступность ≠ трафик.

Если бы я начинал заново, то сделал бы так:

  1. 10-15 страниц под конкретные запросы, а не 600 тем.
  2. Google Search Console и Яндекс.Вебмастер – до запуска.
  3. 10 внешних ссылок – до того, как добавлять новые URL.
  4. Метрика и анализ поведения – до первых доработок.
  5. Ручная проверка задач по каждому предмету – до публикации.

Что в итоге

EduTrainer – не «сайт с ответами», а попытка сделать практику, которая объясняет ошибку. Технически это Django-монолит с генераторами, PostgreSQL, Redis и 213 тестами. Организационно – проект, который учится на своих ошибках: от отрицательных дробей в 5 классе до 1 500 лишних URL.

Проект бесплатный: edutrainer.ru. Если вы делаете образовательный сервис, главный совет простой: сначала проверяйте задания и входы, потом масштабируйте количество страниц. Генератор можно написать за вечер. Доверие к нему – за заметно большее время.

Изображение на обложке: скриншот главной страницы

Hello World! Гайды и обзоры для девелоперов разных мастей.

Комментарии

С помощью соцсетей
У меня нет аккаунта Зарегистрироваться
С помощью соцсетей
У меня уже есть аккаунт Войти
Инструкции по восстановлению пароля высланы на Ваш адрес электронной почты.
Пожалуйста, укажите email вашего аккаунта
Ваш баланс 10 ТК
1 ТК = 1 ₽
О том, как заработать и потратить Таймкарму, читайте в этой статье
Чтобы потратить Таймкарму, зарегистрируйтесь на нашем сайте