docs(teacher-guide): актуализация под текущее состояние системы

Добавлено/обновлено в руководстве для учителей:
- Квантик-ассистент: режим «Тест в банк» (генерация вопросов в банк), контекст
  страницы/урока; админ-глава A7 — сканер моделей, keyless-провайдер (Pollinations),
  сократический режим, авто-проверка провайдеров, «Знания о системе» (индексация).
- Глава «Ещё модули»: игра «Квантик: Законы Мира» (/quantik), трекер пожеланий
  (/wishes), Путеводитель (/sitemap); уточнено описание Коллекции (карточки-темы,
  бронза→платина); Мои материалы — папки и теги.
- Перечни фича-флагов дополнены новыми модулями + заметка про админ-оверрайд.

Только teacher-guide.html. Inline-скрипт валиден (node --check).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
Maxim Dolgolyov
2026-06-24 21:56:03 +03:00
parent 81bf5d75eb
commit 368cf30d58
+16 -5
View File
@@ -1418,7 +1418,7 @@
<div class="tg-step"><div class="tg-step-num"></div><div class="tg-step-body"><b>Учебники</b> — отключить раздел учебников.</div></div>
<div class="tg-step"><div class="tg-step-num"></div><div class="tg-step-body"><b>Флэшкарты, Live-квиз</b> — включить/выключить по необходимости.</div></div>
<div class="tg-step"><div class="tg-step-num"></div><div class="tg-step-body"><b>Экзаменационные тесты</b> — модуль с 80 вариантами по математике 9 класса.</div></div>
<div class="tg-step"><div class="tg-step-num"></div><div class="tg-step-body"><b>И другие</b> — Доска, Классы, Питомец и геймификация, Карта знаний, Красная книга, Кроссворд, Виселица, Коллекция, Квантик-ассистент: каждый модуль скрывается своим флагом.</div></div>
<div class="tg-step"><div class="tg-step-num"></div><div class="tg-step-body"><b>И другие</b> — Доска, Классы, Питомец и геймификация, Карта знаний, Красная книга, Кроссворд, Виселица, Коллекция, Live-квиз, Онлайн-урок, Квантик-ассистент, игра «Квантик: Законы Мира», Конструктор симуляций, Путеводитель, трекер пожеланий: каждый модуль скрывается своим флагом. Админ при этом видит и открывает любой модуль, даже выключенный.</div></div>
</div>
<div class="tg-note"><div class="tg-box-icon"><i data-lucide="shield"></i></div><div class="tg-box-body"><div class="tg-box-label">Только для администратора</div>Изменение feature flags и доступа к контенту доступно только пользователям с ролью <b>admin</b>. Учителя видят только то, к чему у их класса есть доступ.</div></div>
</div>
@@ -1477,8 +1477,9 @@
<div class="tg-step"><div class="tg-step-num">1</div><div class="tg-step-body">Нажмите кнопку-питомца → откроется окно с полем ввода.</div></div>
<div class="tg-step"><div class="tg-step-num">2</div><div class="tg-step-body">Задайте вопрос: «объясни теорему Виета», «как создать класс», «реши …». Можно продолжать беседу — Квантик помнит контекст.</div></div>
<div class="tg-step"><div class="tg-step-num">3</div><div class="tg-step-body">В учебнике выделите фрагмент текста — появится кнопка <b>«Объяснить выделенное»</b>.</div></div>
<div class="tg-step"><div class="tg-step-num">4</div><div class="tg-step-body">Режим <b>«Тест в банк»</b> (виден учителю/админу): напишите тему — Квантик сгенерирует вопросы с вариантами, вы проверите и сохраните прямо в <b>банк вопросов</b> (с выбором предмета и темы). Тема при этом создаётся автоматически.</div></div>
</div>
<div class="tg-tip"><div class="tg-box-icon"><i data-lucide="graduation-cap"></i></div><div class="tg-box-body"><div class="tg-box-label">Для учителей</div>Квантик понимает учительские задачи: попросите составить вопросы по теме, план урока или объяснить, как работает инструмент платформы.</div></div>
<div class="tg-tip"><div class="tg-box-icon"><i data-lucide="graduation-cap"></i></div><div class="tg-box-body"><div class="tg-box-label">Для учителей</div>Квантик понимает учительские задачи: попросите составить вопросы по теме, план урока или объяснить, как работает инструмент платформы. Он также знает, на какой странице/уроке находится ученик, и отвечает в этом контексте.</div></div>
</div>
<div class="tg-section" id="s-18-3">
@@ -1573,19 +1574,22 @@
<div class="tg-section" id="s-20-2">
<div class="tg-section-title">20.2 Игры: Кроссворд и Виселица</div>
<p>Учебные игры для закрепления терминов: <b>Кроссворд</b> (<a href="/crossword">/crossword</a>) и <b>Виселица</b> (<a href="/hangman">/hangman</a>). За прохождение начисляется XP (Глава 16). Включаются/отключаются feature-флагами.</p>
<p><b>Квантик: Законы Мира</b> (<a href="/quantik">/quantik</a>) — физическая игра-головоломка: уровни на 2D-механике, звёзды и прогресс по карте-созвездию. Уровни можно создавать в Конструкторе симуляций (Глава 21) и раздавать классу.</p>
</div>
<div class="tg-section" id="s-20-3">
<div class="tg-section-title">20.3 Красная книга и Коллекция</div>
<p><b>Красная книга</b> (<a href="/red-book">/red-book</a>) — модуль по экологии и биоразнообразию: виды, биомы, экосистемы и игры-квесты. <b>Коллекция</b> (<a href="/collection">/collection</a>) — собранные учеником материалы и награды.</p>
<p><b>Красная книга</b> (<a href="/red-book">/red-book</a>) — модуль по экологии и биоразнообразию: виды, биомы, экосистемы и игры-квесты. <b>Коллекция</b> (<a href="/collection">/collection</a>) — карточки по всем темам предметов: ученик «прокачивает» их уровни (бронза → платина), правильно отвечая на вопросы темы. Новые темы появляются в коллекции автоматически, как только в них есть вопросы.</p>
</div>
<div class="tg-section" id="s-20-4">
<div class="tg-section-title">20.4 Мои материалы, Магазин и Родители</div>
<div class="tg-steps">
<div class="tg-step"><div class="tg-step-num"></div><div class="tg-step-body"><b>Мои материалы</b> (<a href="/my-materials">/my-materials</a>) — ученик сохраняет к себе доску (PNG) и заметки из онлайн-урока; копия остаётся даже после удаления сессии.</div></div>
<div class="tg-step"><div class="tg-step-num"></div><div class="tg-step-body"><b>Мои материалы</b> (<a href="/my-materials">/my-materials</a>) — ученик сохраняет к себе доску (PNG), вырезки учебника и заметки; копия остаётся даже после удаления сессии. Можно раскладывать по <b>папкам</b> и помечать <b>тегами</b>, искать и фильтровать по ним. Учитель может раздать материал классу.</div></div>
<div class="tg-step"><div class="tg-step-num"></div><div class="tg-step-body"><b>Магазин наград</b> — за монеты (начисляются вместе с XP) ученик покупает предметы и награды.</div></div>
<div class="tg-step"><div class="tg-step-num"></div><div class="tg-step-body"><b>Родительские аккаунты</b> (<a href="/parent">/parent</a>) — родитель привязывается к ученику и видит его прогресс и уведомления.</div></div>
<div class="tg-step"><div class="tg-step-num"></div><div class="tg-step-body"><b>Трекер пожеланий</b> (<a href="/wishes">/wishes</a>) — любой пользователь предлагает улучшения платформы; админ их видит и сортирует по статусу. Приватный (автор + админ), а не публичная доска.</div></div>
<div class="tg-step"><div class="tg-step-num"></div><div class="tg-step-body"><b>Путеводитель</b> (<a href="/sitemap">/sitemap</a>) — карта-обзор всех разделов платформы со ссылками.</div></div>
</div>
<div class="tg-success"><div class="tg-box-icon"><i data-lucide="check-circle"></i></div><div class="tg-box-body"><div class="tg-box-label">Почти всё</div>Дальше — мощный «Конструктор симуляций» (создание своих интерактивных сцен), а за ним — главы для администраторов (видны только под ролью admin).</div></div>
</div>
@@ -1839,7 +1843,7 @@
</div>
<div class="tg-section" id="s-a3-3">
<div class="tg-section-title">A3.3 Feature Flags</div>
<p>Включение/отключение модулей платформы без перезапуска сервера: биохимия, учебники, флэшкарты, доска, live-квиз, экзамен, симуляции, игры (кроссворд, виселица), красная книга, карта знаний, коллекция, питомец и геймификация, Квантик-ассистент.</p>
<p>Включение/отключение модулей платформы без перезапуска сервера: биохимия, учебники, флэшкарты, доска, live-квиз, онлайн-урок, экзамен, симуляции и Конструктор симуляций, игры (кроссворд, виселица), игра «Квантик: Законы Мира», красная книга, карта знаний, коллекция, питомец и геймификация, Квантик-ассистент, Путеводитель, трекер пожеланий. Админ видит и открывает любой модуль независимо от флага.</p>
</div>
<div class="tg-chapter-nav">
<div class="tg-ch-nav-btn prev" onclick="scrollToChapter('ch-a2')">
@@ -1990,6 +1994,10 @@
<div class="tg-section" id="s-a7-2">
<div class="tg-section-title">A7.2 Модели и лимиты</div>
<p>Для провайдера Kilo доступен список бесплатных моделей прямо на карточке (переключатель). Кнопка <b>«Загрузить модели провайдера»</b> в форме подтягивает живой список моделей с их лимитами.</p>
<div class="tg-steps">
<div class="tg-step"><div class="tg-step-num"></div><div class="tg-step-body"><b>Сканировать модели</b> — кнопка находит на шлюзе все бесплатные модели, прогоняет каждую тест-запросом на русском и показывает отчёт (новые / исчезнувшие / % русского / скорость); «Применить выбранные» обновляет рабочий список.</div></div>
<div class="tg-step"><div class="tg-step-num"></div><div class="tg-step-body"><b>Без ключа</b> — шлюз Pollinations работает без API-ключа (бейдж «без ключа»), годится как бесплатный запасной провайдер.</div></div>
</div>
<div class="tg-tip"><div class="tg-box-icon"><i data-lucide="gauge"></i></div><div class="tg-box-body"><div class="tg-box-label">Лимиты моделей</div>Под моделью показывается «контекст · ответ до N токенов · бесплатно/платно» — данные тянутся автоматически из API провайдера (работает и для Gemini, и для новых моделей).</div></div>
</div>
<div class="tg-section" id="s-a7-3">
@@ -1998,6 +2006,9 @@
<div class="tg-step"><div class="tg-step-num"></div><div class="tg-step-body"><b>RAG по учебникам</b> — тумблер «Искать ответы по учебникам» + кнопка «Переиндексировать учебники».</div></div>
<div class="tg-step"><div class="tg-step-num"></div><div class="tg-step-body"><b>Кнопки на экзамене</b> — тумблер показа «Подсказка / Спросить Квантика» на карточках задач (Глава 18).</div></div>
<div class="tg-step"><div class="tg-step-num"></div><div class="tg-step-body"><b>Статистика</b> — запросы к ИИ / из кэша / FAQ за день и за 30 дней, лайки и дизлайки.</div></div>
<div class="tg-step"><div class="tg-step-num"></div><div class="tg-step-body"><b>Сократический режим</b> — тумблер: для учеников Квантик объясняет теорию полно, но конкретные задачи не решает «под ключ» (даёт метод и наводящий шаг). Авто-включается при просьбе «реши за меня».</div></div>
<div class="tg-step"><div class="tg-step-num"></div><div class="tg-step-body"><b>Авто-проверка провайдеров</b> — фоновый пинг каждые 15 мин + кнопка «Проверить сейчас»; упавший активный провайдер сам уступает место здоровому (цветной индикатор на карточке).</div></div>
<div class="tg-step"><div class="tg-step-num"></div><div class="tg-step-body"><b>Знания о системе</b> — кнопка «Проиндексировать систему» снимает срез включённых модулей + ваше «Описание системы», чтобы Квантик знал актуальное состояние платформы и не предлагал отключённое. Снимок сам обновляется при смене фича-флагов.</div></div>
</div>
<div class="tg-success"><div class="tg-box-icon"><i data-lucide="check-circle"></i></div><div class="tg-box-body"><div class="tg-box-label">Готово!</div>Вы изучили полное руководство — все разделы для учителей и администраторов.</div></div>
</div>