Learn_System/plans/ai-trainer/ROADMAP_V3.md

ИИ-Тренажёр — План развития v3 (по всем направлениям)

Дата: 2026-06-25. Превращаем рабочий «проверяльщик с генераторами» в полноценного репетитора + тренажёрную платформу под ЦТ/ЦЭ: глубокая педагогика, широкий контент, вовлечение, учительский рабочий процесс, премиальный визуал.

Что уже есть (база v1+v2): движок параметрических генераторов + SimExpr-верификация, 36 генераторов / 12 тем (алгебра+геометрия), kinds solve/compute/roots/simplify/inequality, структурные уровни сложности, умная тренировка + интервальное повторение (SR), LLM-задачи с серверной проверкой, пошаговое решение (checkStep), мат-клавиатура + live-KaTeX, аналитика класса (тепловая карта), авторинг/раздача учителем, конструктор генераторов (админ).

Инвариант (не нарушать): выражения — только SimExpr (⛔ без eval/Function); любая задача из любого источника проходит проверку подстановкой/сэмплингом, неверная ученику не попадает; тексты экранируются; ⛔ без эмодзи (только inline SVG .ic/Lucide); каждая фаза — со смоуками/тестами и коммитом.

---

Направление A — Визуал и UX: «премиум-консоль» ⭐ (мокап готов)

Мокап frontend/trainer-redesign-mockup.html — двухпанельный рабочий стол. Переносим в боевую страницу (все ID/классы уже совпадают → JS-логика почти не меняется, работа в основном по CSS/разметке).

• A1. Каркас: плавающий стеклянный топбар (бренд + предмет-пилюля + умная тренировка-капсула + кольцо сессии + кнопки «Аналитика»/«Конструктор»). Двухпанельная сетка 312px + 1fr.
• A2. Левый рейл: карточка прогресса с кольцом мастерства (освоено N/всего) + плитки «решено»/«серия» (золото); сегмент-контрол Предмет; вертикальный список Тем (точки-маркеры, бейдж класса, звезда освоения / счётчик банка).
• A3. Основная область: бар навыков темы над карточкой-героем (сцена индиго→фиолет с чипом уровня + уравнение serif; верно→изумруд+pop, неверно→красный+shake), рабочая зона (сложность, ввод, клавиатура, превью, фидбэк, действия, шаги, решение, итог сессии).
• A4. Доступность/моб.: ARIA на тумблере/кнопках, видимый фокус, prefers-reduced-motion, брейкпоинты 1080/620 (рейл схлопывается, сайдбар прячется). Озвучка формул (aria-label с словесной формой уравнения) — задел на a11y.
• Риск: страница большая; переносить аккуратно, сверять смоук страницы (36/36) после.

Направление B — Контент и программа (охват ЦТ/ЦЭ)

Расширяем по программе наших учебников и таксономии ЦТ.

• B1. Алгебра-пробелы: Системы 2 лин. ур-ний (НОВЫЙ kind system — пара-ответ x;y, проверка обоих ур-ний подстановкой), линейная функция (найти k/b, точку), модуль |ax+b|=c, разложение на множители, дробно-рациональные (9 кл).
• B2. Геометрия-глубина: углы многоугольника, подобие (коэффициент/стороны), окружность (длина/площадь/дуга), теоремы синусов/косинусов (9), площади трапеции/ромба/параллелограмма.
• B3. 5–6 класс: арифметика, обыкновенные/десятичные дроби, НОД/НОК, отрицательные числа, координатная прямая — мост к младшим (math5/6 учебники).
• B4. Текстовые семьи параметрически (без LLM): движение, работа, смеси/сплавы, проценты-сложные — как генераторы (kind compute/solve) с шаблонным условием и «корень-вперёд».
• B5. ЦТ-привязка: тег ct_code на генераторах → связь с exam-prep таксономией (как tag-exam-textbook); ЦТ-режим (формат А1–А10/В1–В20, бланк ответов, таймер).

Направление C — Репетитор: разбор ошибок + сократические подсказки (P9) ⭐

Главный педагогический скачок — «почему неверно», не выдавая ответ сразу.

• C1. Правиловая детекция типовых ошибок: сравнить ответ ученика с «ответом при типичной ошибке» (потерян знак, забыл поделить на коэффициент, ошибка переноса, арифметика) для linear/quadratic/inequality → конкретная подсказка «похоже, ты не сменил знак при переносе».
• C2. 3 уровня подсказок: намёк (что сделать) → шаг (первое преобразование) → полное решение. Кнопка эскалации; учёт в прогрессе (решил с подсказкой ≠ чистое мастерство).
• C3. Образец перед практикой (worked example) + guided-режим: заполнить пропуски в готовых шагах (reuse checkStep).
• C4. LLM-объяснение «объясни мою ошибку»/«подскажи» через Квантик-ассистента (callLLMFailover) — ТОЛЬКО объяснения (безопасно, не генерация задач), с фолбэком на правиловые подсказки оффлайн.

Направление D — Адаптивность и мастерство

Точнее вести ученика и измерять освоение.

• D1. Граф навыков с пререквизитами: тема/навык открывается, когда освоены предыдущие (как unlockStars в Квантике) — нет прыжков «в сложное без базы».
• D2. Диагностика: входной мини-тест (по 1 задаче на ключевой навык) → стартовая карта сильных/слабых → персональный план.
• D3. Мастерство привязать к структурному уровню: «освоено» = серия верных на ур.3 (а не на ур.1).
• D4. SR-улучшения: подмешивать due-навыки в сессию (сейчас отдельным проходом), кривая забывания, «Повторить всё» по теме.

Направление E — Геймификация и карта навыков (P11)

Вовлечение через готовую инфраструктуру (Квантик), с учётом kill-switch геймификации.

• E1. XP/монеты/достижения за решения/серии/мастерство (reuse Квантик-геймификация и service.js).
• E2. Карта-созвездие навыков (как QuantikMap) — визуальный прогресс по темам/предметам, узлы открываются по пререквизитам (D1).
• E3. Дневная цель + календарь серий; бейджи за освоение темы; (опц.) рейтинг класса.

Направление F — Учительский рабочий процесс (P12)

Поверх раздачи — отслеживаемые задания и управление контентом.

• F1. Задания + журнал: учитель задаёт темы/навыки + цель (N решено / мастерство) + дедлайн → ученики видят, прогресс трекается, учитель видит выполнение (таблица practice_assignments), интеграция с journal/homework. Апгрейд текущего assign (просто уведомление) до задания.
• F2. Управление пулом LLM-задач: очередь ревью (одобрить/править/удалить), генерация пакетом по теме урока/§ учебника.
• F3. Конструктор генераторов — расширение: формы для kinds roots/simplify/inequality/compute/ system; задание структурного level; шаринг/клон генераторов между учителями (как custom-sims).
• F4. Аналитика глубже: помастерство по навыкам, слабые места класса, время на задачу, динамика.

Направление G — Масштаб контента и авторинг

Чтобы банк рос быстро и безопасно.

• G1. LLM-конвейер: генерация пакетами по теме (serverside practiceGenService), серверная проверка → пул → очередь ревью учителя (F2). Дедуп, лимиты.
• G2. Конструктор для всех типов (F3) + импорт из банков ЦТ.

Направление H — Технически / качество

• H1. Производительность: кэш скомпилированных генераторов (есть _cache), ленивый KaTeX, виртуализация длинных списков.
• H2. Офлайн/PWA для параметрики (генераторы работают без сети; синк прогресса при возврате).
• H3. Телеметрия: какие навыки самые трудные, отвал в сессии, эффективность подсказок — в class-stats/новую таблицу.
• H4. Тесты/a11y: расширить движок/страница-смоуки на новые kinds; бэкенд-тесты на assignments; ARIA/клавиатура/reduced-motion/озвучка формул.

---

Рекомендуемая последовательность

Сначала то, что даёт виден результат и опирается на готовое:

1. A — Редизайн (мокап готов, ID совпадают; высокий «вау», низкий риск) — 1 заход.
2. C — Репетитор/подсказки (P9) (главная педагогическая ценность; правиловое ядро + 3 уровня).
3. B1 — Системы ур-ний + текстовые семьи (новый kind system, заметное расширение охвата).
4. F1 — Задания и журнал (P12) (учительский запрос, монетизирует платформу для школ).
5. E — Геймификация + карта навыков (P11) (вовлечение; reuse Квантик).
6. D — Граф навыков/диагностика + B5 — ЦТ-режим/таксономия (подготовка к экзамену).
7. Сквозное H (тесты/a11y/PWA/телеметрия) — на каждой фазе.

Каждая фаза: смоук движка + смоук страницы + бэкенд-тесты (где есть API) + коммит/пуш, эмодзи/eval = 0, lint:routes baseline 0.