A9 · Планы развития

Куда движется Грейдум — детально

📖Как читать

Развитие Грейдума идёт итерациями. Каждая версия (v0.21, v0.22, v0.23, ...) — небольшой набор улучшений. Релизы выходят регулярно — обычно раз в 1–2 недели.

Четыре статуса

  • ✅ Сделано — работает в проде.
  • 🔄 В работе — делается прямо сейчас.
  • 📅 Скоро — запланировано на ближайший релиз (v0.23).
  • 🔮 Потом — обсуждается, сроки не определены.
Основной документ показывает только ключевое. Здесь — детально: что именно сделано, что в плане, из чего выбираем.
История релизов — в CHANGELOG-ARCHIVE.md. Идеи и техдолг — в IDEAS.md.

✅Что уже сделано

За время развития — большой путь. От первого прототипа до полноценной платформы с админкой, авторизацией, безопасным HTML и редактором курсов.

Контент и обучение

  • Несколько курсов по школьной программе — математика, русский, физика, геометрия, алгебра, спецмат.
  • Билеты с теорией — определения, теоремы с доказательствами, примеры, SVG-рисунки.
  • Сотни вопросов в викторине.
  • Три режима викторины: «Спринт» (с таймером), «Разбор» (с пояснениями), «Размышление» (варианты скрыты до кнопки).
  • Улучшенный финал викторины — названия билетов в блоке «Стоит повторить», счёт ошибок «N из M мимо».
  • Звания — зависят от курса и результата.

Пользователи и прогресс

  • Авторизация через Яндекс — в один клик.
  • Прогресс сохраняется в БД, синхронизируется между устройствами.
  • Две темы оформления — тёмная и светлая.
  • Telegram-канал — свежие анонсы в мессенджере.
  • Журнал изменений — видно, что нового.
  • Поиск по билетам, метки «прочитано», счётчики.

Админка

  • Дашборд — метрики проекта, график игр за 7 дней, автообновление.
  • Редактор курсов и тем — создание курса и тем прямо в админке, без SQL.
  • Генератор SVG-обложек — обложка курса одной кнопкой.
  • Доступ по уникальной ссылке — приватные курсы с токеном.
  • Управление билетами — создание, редактирование, фильтры.
  • Редактор блоков контента — наполнение билетов через интерфейс.
  • Массовая вставка блоков — вставить текст билета целиком, система разобьёт на блоки.
  • Редактор вопросов викторины — создание, редактирование, удаление.
  • Массовая вставка вопросов — по маркеру [Вопрос].
  • Справка по HTML-тегам — прямо в форме вопроса.
  • Журнал — создание записей, отправка в Telegram, закрепление.

Безопасность и надёжность

  • Безопасный HTML в вопросах — форматирование, таблицы, SVG-графики.
  • SVG-маркеры — стрелки на осях графиков.
  • Пять уровней доступа к курсам — от публичного до скрытого.
  • Доступ по ссылке с токеном — для отдельных групп.
  • Санитизация публичного API — /api/questions тоже защищён.
  • Авторство контента — кто создал, кто последний правил.
  • Привязка игр и журнала к пользователю.
  • Переименование проекта и смена домена — «Грейдум · Платформа обучения», грейдум-платформа.рф.

Инженерная культура

  • Стандарт оформления кода — CODE-STYLE.md.
  • Автотесты — скрипты проверок (фронтенд, API, документация, размеры, конфиг).
  • Резервные копии — backup.sh, «один назад», без секретов.
  • Версионирование — bump-version.sh, решение проблемы кэша.
  • Обмен методологией с соседним проектом.
  • Нейросеть-/человеко-независимость — проект продолжит любой исполнитель.
Подробнее о функционале — в приложении A1. Функционал.
О технологиях — в приложении A6. Технологии.
О безопасности — в приложении A5. Безопасность.

🔄Что в работе

Прямо сейчас — ничего в работе. Релиз v0.22 закрыт полностью.

Это нормально. Мы работаем итерациями: сначала — закрываем релиз целиком, потом — планируем следующий. Не смешиваем «доделки» с новыми фичами.

Следующая итерация — v0.23. Планирование завершено, состав — в следующем разделе.

📅Что скоро (v0.23)

Состав v0.23 — 6 пунктов. Пять пользовательских, один технический.

Пользовательские

Генератор диплома.
По итогам курса — подтверждение квалификации. В двух форматах: HTML и PDF. Особенно важно для корпоративного сегмента — подтверждение квалификации инженеров.
Профиль игрока (свой).
Пользователь заходит в профиль — видит свои игры за последнее время. Простой график «игры за 7 дней», статистика за сегодня: сколько игр, лучший результат, лучший ранг.
Профиль игрока в админке.
Админ выбирает игрока — видит его статистику: игры, лучший результат, историю. Помогает при разборе и при работе с конкретным учеником.
Модалки с деталями метрик на дашборде.
Клик по метрике — открывается модалка с деталями. Пример: «85 билетов» → список билетов, распределение по курсам, график появления.
Осмысленные значения порядка курсов.
Сейчас sort_order у курсов — техническое поле. В v0.23 — настроить осмысленную сортировку на витрине: сначала для младших классов, потом для старших, или по популярности.

Технические

Блоки контента на белый список санитайзера.
Сейчас белый список применяется к вопросам и публичному API. В v0.23 — распространяем его на блоки билетов (сейчас там чёрный список — слабее). Это делает безопасность сквозной, а не точечной.
Почему это важно. Партнёр видит: безопасность — не «галочка», а последовательная работа. Каждый релиз — плюс к надёжности.

🔮Что потом

Направления, которые обсуждаются и планируются. Сроки не определены — но вектор ясен.

Геймификация

  • Достижения и медали — деревянная, бронзовая, серебряная, золотая, платиновая, бриллиантовая.
  • Ежедневные задачи — задания на день с наградами.
  • Марафоны — пройти N вопросов подряд.
  • Персональные рекомендации — ИИ подбирает материал под ученика.

Отчёты для родителей

  • Веб-отчёт — как учится ребёнок: прогресс, игры, слабые места.
  • Экспорт в PDF — для печати и архива.

Друзья и сообщество

  • Друзья — социальные связи, сравнение достижений.
  • Идеи и голосование — сообщество решает, что делать дальше.
  • Правки от пользователей — предложения по улучшению контента.

ИИ-функции

  • Генерация вопросов нейросетью — черновики + модерация.
  • Дуэль с ИИ — соревнование с виртуальным соперником.
  • Объяснение деталей в билете — кнопка «объясни подробнее».
  • Свободный ввод ответа — с оценкой через ИИ.

Интеграции

  • Сервис-дески компаний — видеть квалификацию инженеров.
  • HR-системы — связка обучения с кадровым учётом.
  • LMS — обмен данными с корпоративными системами.
  • API для учителей и разработчиков — публичный доступ к данным.

Супергеймификация

  • Игровой режим «герой» — ученик проходит обучение как приключение: с очками, жизнями, боссами.
  • Игровая валюта — очки за викторины и задачи.
  • Магазин усилений — тратить заработанное.
  • Локации и уровни — прогрессия по курсам.

Контент

  • Задания с реальных олимпиад — отдельная структура.
  • Роль учителя — классы, задания, отчёты.
  • Дополнительные курсы — 5, 8, 9, 10, 11 классы.
  • Мини-игры по темам — например, «Движение» (физика 7).

Монетизация

  • Подписка для родителей — расширенные отчёты.
  • Премиум-курсы — углублённые программы.
  • Партнёрства со школами — пакетные предложения.
  • Донаты — поддержка проекта.
Монетизация — только после того, как есть что продавать. Сначала — качественный продукт, потом — способы его распространения.
Полный список идей и техдолга — в IDEAS.md.
Подробнее о скорости разработки — в приложении A7. Скорость создания контента.

🧭Принципы развития

Развитие Грейдума — не «делаем всё, что придумаем». Есть принципы, которые держат фокус.

1. Итерации, а не «большие релизы»

  • Небольшие шаги. Каждый релиз — 3–7 улучшений, не 20.
  • Регулярность. Раз в 1–2 недели. Платформа меняется быстрее, чем устаревает.
  • Полное закрытие. Релиз закрыт целиком — потом планируем следующий.

2. Пользователь — в центре

  • Пользовательские фичи — приоритет. Редактор курсов, доступ по ссылке, профиль игрока — это то, что видит и чувствует ученик или админ.
  • Технические фичи — не в Питч. Разбивка JS-файлов, перевод блоков на белый список — делаем, но в Питче не выпячиваем.
  • Обратная связь. Жалобы на вопросы, идеи пользователей — учитываются.

3. Инженерная культура — не «когда-нибудь», а сейчас

  • Стандарт кода — с самого начала.
  • Автотесты — после каждой правки.
  • Резервные копии — перед каждой опасной операцией.
  • Документация — актуальна всегда.

4. Нейросеть-/человеко-независимость

  • Проект не привязан к конкретному исполнителю.
  • Новый разработчик — продолжит за дни.
  • Контекст не теряется. Всё в docs/.

5. Гибкость под партнёра

  • Пять уровней доступа к курсам — под любой сценарий.
  • Приватные курсы по ссылке — для отдельных групп.
  • Обложка под бренд — генератор или своя SVG.
  • Смена палитры — под фирменные цвета.
Итог. Грейдум развивается стабильно и предсказуемо. Не «рывками», не «по вдохновению», а по плану.

Подробнее о технологиях — в приложении A6. Технологии.
О документации — в приложении A10. Документация.
О развёртывании — в приложении A8. Развёртывание.