# ИИ-Тренажёр — План развития 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.