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

- Учебники (11.1): вместо 2 курсов — полный каталог (Матем 5-6, Алгебра/
  Геометрия 7-11, Физика 7-11, Химия 7-9).
- Новые главы: 18 Квантик-ассистент, 19 Флэшкарты, 20 Ещё модули
  (Карта знаний, Теория, Кроссворд, Виселица, Красная книга, Коллекция,
  Мои материалы, Магазин, Родители) + админ-глава A7 Провайдеры ИИ.
- Экзамен (12.3): хаб «Подготовка к экзамену 9» (Темы/Варианты/Практика/
  Пробник) + Квантик-подсказки; ссылка на /exam-prep/math9.
- Фикс сломанных ссылок навигации (s-14-4, s-16-3) + полные списки feature-flags.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

frontend/teacher-guide.html

@@ -1061,12 +1061,14 @@
 
           <div class="tg-section" id="s-11-1">
             <div class="tg-section-title">11.1 Каталог учебников</div>
-            <p>Раздел <b>«Учебники»</b> в боковом меню — полные интерактивные курсы по предметам со встроенными формулами (KaTeX), диаграммами и анимациями. Сейчас доступны:</p>
+            <p>Раздел <b>«Учебники»</b> в боковом меню — полные интерактивные курсы по предметам со встроенными формулами (KaTeX), диаграммами и анимациями. Каталог постоянно расширяется; сейчас доступны курсы по четырём предметам:</p>
             <div class="tg-steps">
-              <div class="tg-step"><div class="tg-step-num">—</div><div class="tg-step-body"><b>Химия 9</b> (Шиманович) — §1–60: строение атома, химическая связь, классы соединений, ОВР, металлы, электролиз.</div></div>
+              <div class="tg-step"><div class="tg-step-num">Σ</div><div class="tg-step-body"><b>Математика</b> — Математика 5–6, Алгебра 7–11, Геометрия 7–11.</div></div>
-              <div class="tg-step"><div class="tg-step-num">—</div><div class="tg-step-body"><b>Физика 9</b> (Исаченкова) — §1–38: механика, кинематика, динамика, законы сохранения, импульс и энергия.</div></div>
+              <div class="tg-step"><div class="tg-step-num">Φ</div><div class="tg-step-body"><b>Физика</b> — Физика 7, 8, 9, 10, 11 (с лабораторными практикумами).</div></div>
+              <div class="tg-step"><div class="tg-step-num">Х</div><div class="tg-step-body"><b>Химия</b> — Химия 7, 8, 9.</div></div>
             </div>
-            <p>На карточке учебника видна шкала прогресса «X из Y параграфов прочитано» и кнопка <b>«Продолжить»</b> — открывает учебник на последнем посещённом параграфе.</p>
+            <p>Большие курсы разбиты на карточки по главам (например, «Алгебра 7 · Степень» или «Геометрия 8 · Площади»). На карточке учебника видна шкала прогресса «X из Y параграфов прочитано» и кнопка <b>«Продолжить»</b> — открывает учебник на последнем посещённом параграфе.</p>
+            <div class="tg-note"><div class="tg-box-icon"><i data-lucide="info"></i></div><div class="tg-box-body"><div class="tg-box-label">Что видят ученики</div>По умолчанию учебники ученикам <b>не</b> показываются, пока администратор не откроет доступ (Глава 17). Учителя и админы видят весь каталог всегда.</div></div>
           </div>
 
           <div class="tg-section" id="s-11-2">
@@ -1122,7 +1124,7 @@
               <div class="tg-chapter-num">Глава 12</div>
               <div class="tg-chapter-title">Экзамен 9 класс — Математика</div>
             </div>
-            <a href="/exam9" class="tg-chapter-try" target="_blank"><i data-lucide="external-link"></i> Экзамен 9</a>
+            <a href="/exam-prep/math9" class="tg-chapter-try" target="_blank"><i data-lucide="external-link"></i> Подготовка 9</a>
           </div>
 
           <div class="tg-section" id="s-12-1">
@@ -1146,6 +1148,18 @@
             <div class="tg-note"><div class="tg-box-icon"><i data-lucide="info"></i></div><div class="tg-box-body"><div class="tg-box-label">Чётные варианты</div>Для чётных (2, 4, … 80) кнопка «Назначить» неактивна — варианты доступны только для самостоятельного просмотра. Это сделано чтобы у вас оставались «свежие» варианты для самостоятельной подготовки учеников.</div></div>
           </div>
 
+          <div class="tg-section" id="s-12-3">
+            <div class="tg-section-title">12.3 Режим подготовки (хаб)</div>
+            <p>Пункт меню <b>«Подготовка к экзамену 9»</b> (<a href="/exam-prep/math9">/exam-prep/math9</a>) — современный хаб подготовки с несколькими режимами:</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> — те самые 80 полных вариантов с разбором.</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> — экзамен на время с итоговым баллом.</div></div>
+            </div>
+            <div class="tg-tip"><div class="tg-box-icon"><i data-lucide="sparkles"></i></div><div class="tg-box-body"><div class="tg-box-label">Квантик на задачах</div>Если администратор включил кнопки помощника (Глава A7), на карточках задач появляются «Подсказка» и «Спросить Квантика» — наводящий шаг или полный разбор. Задачи также связаны с параграфами учебников (deep-link).</div></div>
+          </div>
+
           <div class="tg-chapter-nav">
             <div class="tg-ch-nav-btn prev" onclick="scrollToChapter('ch-11')">
               <div class="tg-ch-nav-icon"><i data-lucide="arrow-left"></i></div>
@@ -1404,6 +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>
             <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>
@@ -1418,7 +1433,7 @@
               <div class="tg-step"><div class="tg-step-num">—</div><div class="tg-step-body"><b>Тренды</b> — canvas-графики нагрузки за последние минуты.</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>Теперь вы знаете все 17 разделов руководства. Удачных уроков!</div></div>
+            <div class="tg-tip"><div class="tg-box-icon"><i data-lucide="arrow-right-circle"></i></div><div class="tg-box-body"><div class="tg-box-label">Дальше</div>Ещё три раздела: Квантик-ассистент (18), Флэшкарты (19) и обзор остальных модулей (20).</div></div>
           </div>
 
           <div class="tg-chapter-nav">
@@ -1426,6 +1441,160 @@
               <div class="tg-ch-nav-icon"><i data-lucide="arrow-left"></i></div>
               <div><div class="tg-ch-nav-label">Предыдущая глава</div><div class="tg-ch-nav-title">Геймификация</div></div>
             </div>
+            <div class="tg-ch-nav-btn next" onclick="scrollToChapter('ch-18')" style="text-align:right">
+              <div class="tg-ch-nav-icon"><i data-lucide="arrow-right"></i></div>
+              <div><div class="tg-ch-nav-label">Следующая глава</div><div class="tg-ch-nav-title">Квантик-ассистент</div></div>
+            </div>
+          </div>
+        </div>
+
+        <!-- ═══ CHAPTER 18 — КВАНТИК-АССИСТЕНТ ═══ -->
+        <div class="tg-chapter" id="ch-18">
+          <div class="tg-chapter-header">
+            <div class="tg-chapter-icon"><i data-lucide="sparkles"></i></div>
+            <div class="tg-chapter-meta">
+              <div class="tg-chapter-num">Глава 18</div>
+              <div class="tg-chapter-title">Квантик-ассистент</div>
+            </div>
+            <a href="/dashboard" class="tg-chapter-try" target="_blank"><i data-lucide="external-link"></i> Открыть</a>
+          </div>
+
+          <div class="tg-section" id="s-18-1">
+            <div class="tg-section-title">18.1 Что умеет Квантик</div>
+            <p><b>Квантик</b> — встроенный ИИ-помощник. Плавающая кнопка-питомец в левом нижнем углу есть на дашборде, в учебниках и на других страницах. Помогает и ученикам, и учителям.</p>
+            <div class="tg-tools-grid">
+              <div class="tg-tool-card"><div class="tg-tool-icon"><i data-lucide="message-circle"></i></div><div><div class="tg-tool-name">Отвечает на вопросы</div><div class="tg-tool-desc">По платформе и школьной программе</div></div></div>
+              <div class="tg-tool-card"><div class="tg-tool-icon"><i data-lucide="book-open-text"></i></div><div><div class="tg-tool-name">Ищет в учебниках</div><div class="tg-tool-desc">RAG: отвечает по тексту учебников и ссылается на §</div></div></div>
+              <div class="tg-tool-card"><div class="tg-tool-icon"><i data-lucide="history"></i></div><div><div class="tg-tool-name">Помнит диалог</div><div class="tg-tool-desc">Учитывает предыдущие реплики беседы</div></div></div>
+              <div class="tg-tool-card"><div class="tg-tool-icon"><i data-lucide="copy"></i></div><div><div class="tg-tool-name">Делает флэшкарты</div><div class="tg-tool-desc">Сгенерирует карточки из текста (Глава 19)</div></div></div>
+            </div>
+            <div class="tg-note"><div class="tg-box-icon"><i data-lucide="quote"></i></div><div class="tg-box-body"><div class="tg-box-label">Источники под ответом</div>Если ответ опирался на учебник, под ним появляются ссылки на параграфы. Ответ можно оценить лайком/дизлайком — это помогает улучшать помощника.</div></div>
+          </div>
+
+          <div class="tg-section" id="s-18-2">
+            <div class="tg-section-title">18.2 Спроси Квантика</div>
+            <div class="tg-steps">
+              <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>
+            <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">
+            <div class="tg-section-title">18.3 Подсказки на экзамене</div>
+            <p>На карточках задач в «Подготовке к экзамену» Квантик умеет работать в двух особых режимах:</p>
+            <div class="tg-steps">
+              <div class="tg-step"><div class="tg-step-num">—</div><div class="tg-step-body"><b>Подсказка</b> — даёт наводящий шаг, <i>не</i> выдавая готовый ответ. Ученик додумывает сам.</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-note"><div class="tg-box-icon"><i data-lucide="toggle-left"></i></div><div class="tg-box-body"><div class="tg-box-label">Включается администратором</div>Сам помощник и кнопки на карточках экзамена включаются/отключаются в админ-панели (раздел «Помощник», Глава A7). На вопросы «какая ты модель» Квантик намеренно не отвечает.</div></div>
+          </div>
+
+          <div class="tg-chapter-nav">
+            <div class="tg-ch-nav-btn prev" onclick="scrollToChapter('ch-17')">
+              <div class="tg-ch-nav-icon"><i data-lucide="arrow-left"></i></div>
+              <div><div class="tg-ch-nav-label">Предыдущая глава</div><div class="tg-ch-nav-title">Доступ к контенту</div></div>
+            </div>
+            <div class="tg-ch-nav-btn next" onclick="scrollToChapter('ch-19')" style="text-align:right">
+              <div class="tg-ch-nav-icon"><i data-lucide="arrow-right"></i></div>
+              <div><div class="tg-ch-nav-label">Следующая глава</div><div class="tg-ch-nav-title">Флэшкарты</div></div>
+            </div>
+          </div>
+        </div>
+
+        <!-- ═══ CHAPTER 19 — ФЛЭШКАРТЫ ═══ -->
+        <div class="tg-chapter" id="ch-19">
+          <div class="tg-chapter-header">
+            <div class="tg-chapter-icon"><i data-lucide="copy"></i></div>
+            <div class="tg-chapter-meta">
+              <div class="tg-chapter-num">Глава 19</div>
+              <div class="tg-chapter-title">Флэшкарты</div>
+            </div>
+            <a href="/flashcards" class="tg-chapter-try" target="_blank"><i data-lucide="external-link"></i> Флэшкарты</a>
+          </div>
+
+          <div class="tg-section" id="s-19-1">
+            <div class="tg-section-title">19.1 Колоды и карточки</div>
+            <p>Раздел <b>«Флэшкарты»</b> — карточки «вопрос → ответ» для заучивания с интервальным повторением.</p>
+            <div class="tg-steps">
+              <div class="tg-step"><div class="tg-step-num">1</div><div class="tg-step-body">Создайте <b>колоду</b> (тема): название и цвет.</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">Запустите повторение — карточки показываются по алгоритму интервального повторения; отмечайте «знаю / не знаю».</div></div>
+            </div>
+            <div class="tg-tip"><div class="tg-box-icon"><i data-lucide="bell"></i></div><div class="tg-box-body"><div class="tg-box-label">Виджет на дашборде</div>На дашборде есть блок «Повтори карточку» — напоминает про карточки, которые пора повторить.</div></div>
+          </div>
+
+          <div class="tg-section" id="s-19-2">
+            <div class="tg-section-title">19.2 Картинки и формулы</div>
+            <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>Формулы KaTeX</b> — в редакторе есть палитра символов и живое превью; формулы оборачивайте в <code>$...$</code> или <code>$$...$$</code>.</div></div>
+            </div>
+          </div>
+
+          <div class="tg-section" id="s-19-3">
+            <div class="tg-section-title">19.3 Массовый импорт и генерация ИИ</div>
+            <div class="tg-steps">
+              <div class="tg-step"><div class="tg-step-num">1</div><div class="tg-step-body"><b>Добавить список</b> — вставьте сразу много пар «вопрос — ответ» (можно с картинками) и создайте десятки карточек за раз.</div></div>
+              <div class="tg-step"><div class="tg-step-num">2</div><div class="tg-step-body"><b>Генерация Квантиком</b> — дайте помощнику текст (например, параграф), и он предложит готовый набор карточек.</div></div>
+            </div>
+            <div class="tg-note"><div class="tg-box-icon"><i data-lucide="toggle-left"></i></div><div class="tg-box-body"><div class="tg-box-label">Feature flag</div>Модуль флэшкартов целиком включается/выключается в админ-панели (Глава 17).</div></div>
+          </div>
+
+          <div class="tg-chapter-nav">
+            <div class="tg-ch-nav-btn prev" onclick="scrollToChapter('ch-18')">
+              <div class="tg-ch-nav-icon"><i data-lucide="arrow-left"></i></div>
+              <div><div class="tg-ch-nav-label">Предыдущая глава</div><div class="tg-ch-nav-title">Квантик-ассистент</div></div>
+            </div>
+            <div class="tg-ch-nav-btn next" onclick="scrollToChapter('ch-20')" style="text-align:right">
+              <div class="tg-ch-nav-icon"><i data-lucide="arrow-right"></i></div>
+              <div><div class="tg-ch-nav-label">Следующая глава</div><div class="tg-ch-nav-title">Ещё модули</div></div>
+            </div>
+          </div>
+        </div>
+
+        <!-- ═══ CHAPTER 20 — ЕЩЁ МОДУЛИ ═══ -->
+        <div class="tg-chapter" id="ch-20">
+          <div class="tg-chapter-header">
+            <div class="tg-chapter-icon"><i data-lucide="grid-3x3"></i></div>
+            <div class="tg-chapter-meta">
+              <div class="tg-chapter-num">Глава 20</div>
+              <div class="tg-chapter-title">Ещё модули платформы</div>
+            </div>
+            <a href="/sitemap" class="tg-chapter-try" target="_blank"><i data-lucide="external-link"></i> Путеводитель</a>
+          </div>
+
+          <div class="tg-section" id="s-20-1">
+            <div class="tg-section-title">20.1 Карта знаний и Теория</div>
+            <p><b>Карта знаний</b> (<a href="/knowledge-map">/knowledge-map</a>) — визуальная карта тем и связей между ними. <b>Теория</b> (<a href="/theory">/theory</a>) — лента опубликованных уроков-конспектов, которые ученики получают из «Редактора уроков» (Глава 7).</p>
+          </div>
+
+          <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>
+          </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>
+          </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> — за монеты (начисляются вместе с 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>
+            <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>
+
+          <div class="tg-chapter-nav">
+            <div class="tg-ch-nav-btn prev" onclick="scrollToChapter('ch-19')">
+              <div class="tg-ch-nav-icon"><i data-lucide="arrow-left"></i></div>
+              <div><div class="tg-ch-nav-label">Предыдущая глава</div><div class="tg-ch-nav-title">Флэшкарты</div></div>
+            </div>
             <div class="tg-ch-nav-btn next" onclick="scrollToChapter('ch-1')" style="text-align:right">
               <div class="tg-ch-nav-icon"><i data-lucide="rotate-ccw"></i></div>
               <div><div class="tg-ch-nav-label">Вернуться к началу</div><div class="tg-ch-nav-title">Быстрый старт</div></div>
@@ -1542,7 +1711,7 @@
             </div>
             <div class="tg-section" id="s-a3-3">
               <div class="tg-section-title">A3.3 Feature Flags</div>
-              <p>Включение/отключение модулей платформы без перезапуска сервера: биохимия, учебники, флэшкарты, доска, live-квиз, экзамен-9, симуляции.</p>
+              <p>Включение/отключение модулей платформы без перезапуска сервера: биохимия, учебники, флэшкарты, доска, live-квиз, экзамен, симуляции, игры (кроссворд, виселица), красная книга, карта знаний, коллекция, питомец и геймификация, Квантик-ассистент.</p>
             </div>
             <div class="tg-chapter-nav">
               <div class="tg-ch-nav-btn prev" onclick="scrollToChapter('ch-a2')">
@@ -1656,13 +1825,59 @@
               <div class="tg-section-title">A6.2 HTTP-статистика</div>
               <p>Самые медленные роуты (avgMs), самые частые, соотношение статус-кодов 2xx/4xx/5xx.</p>
               <div class="tg-tip"><div class="tg-box-icon"><i data-lucide="alert-circle"></i></div><div class="tg-box-body"><div class="tg-box-label">Event Loop Lag &gt; 200ms</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>Вы изучили полное руководство. Все 17 + 6 admin-глав пройдены!</div></div>
+              <div class="tg-tip"><div class="tg-box-icon"><i data-lucide="sparkles"></i></div><div class="tg-box-body"><div class="tg-box-label">Почти всё</div>Остался последний раздел — настройка ИИ-помощника Квантика (Глава A7).</div></div>
             </div>
             <div class="tg-chapter-nav">
               <div class="tg-ch-nav-btn prev" onclick="scrollToChapter('ch-a5')">
                 <div class="tg-ch-nav-icon"><i data-lucide="arrow-left"></i></div>
                 <div><div class="tg-ch-nav-label">Предыдущая глава</div><div class="tg-ch-nav-title">Аудит и безопасность</div></div>
               </div>
+              <div class="tg-ch-nav-btn next" onclick="scrollToChapter('ch-a7')" style="text-align:right">
+                <div class="tg-ch-nav-icon"><i data-lucide="arrow-right"></i></div>
+                <div><div class="tg-ch-nav-label">Следующая глава</div><div class="tg-ch-nav-title">Помощник Квантик (ИИ)</div></div>
+              </div>
+            </div>
+          </div>
+
+          <!-- A7 -->
+          <div class="tg-chapter admin-chapter" id="ch-a7">
+            <div class="tg-chapter-header">
+              <div class="tg-chapter-icon"><i data-lucide="sparkles"></i></div>
+              <div class="tg-chapter-meta">
+                <div class="tg-chapter-num">Глава A7</div>
+                <div class="tg-chapter-title">Помощник Квантик — провайдеры ИИ</div>
+              </div>
+              <a href="/admin" class="tg-chapter-try" target="_blank"><i data-lucide="external-link"></i> Помощник</a>
+            </div>
+            <div class="tg-chapter-admin-header"><i data-lucide="shield"></i> Только для администратора</div>
+            <div class="tg-section" id="s-a7-1">
+              <div class="tg-section-title">A7.1 Провайдеры и авто-перехват</div>
+              <p>Вкладка <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> на следующего провайдера с ключом; в админке появляется баннер «работаю на …» (его можно снять кнопкой).</div></div>
+                <div class="tg-step"><div class="tg-step-num">—</div><div class="tg-step-body">Кнопки на карточке: <b>Сделать активным · Тест · Изменить · Удалить</b>. Форма добавления свёрнута, открывается кнопкой «+ Добавить провайдера».</div></div>
+              </div>
+            </div>
+            <div class="tg-section" id="s-a7-2">
+              <div class="tg-section-title">A7.2 Модели и лимиты</div>
+              <p>Для провайдера Kilo доступен список бесплатных моделей прямо на карточке (переключатель). Кнопка <b>«Загрузить модели провайдера»</b> в форме подтягивает живой список моделей с их лимитами.</p>
+              <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">
+              <div class="tg-section-title">A7.3 RAG, экзамен и статистика</div>
+              <div class="tg-steps">
+                <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>
+              <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>
+            <div class="tg-chapter-nav">
+              <div class="tg-ch-nav-btn prev" onclick="scrollToChapter('ch-a6')">
+                <div class="tg-ch-nav-icon"><i data-lucide="arrow-left"></i></div>
+                <div><div class="tg-ch-nav-label">Предыдущая глава</div><div class="tg-ch-nav-title">System Health</div></div>
+              </div>
               <div class="tg-ch-nav-btn next" onclick="scrollToChapter('ch-1')" style="text-align:right">
                 <div class="tg-ch-nav-icon"><i data-lucide="rotate-ccw"></i></div>
                 <div><div class="tg-ch-nav-label">Вернуться к началу</div><div class="tg-ch-nav-title">Быстрый старт</div></div>
@@ -1704,12 +1919,15 @@
     { id:'ch-9',  label:'Журнал оценок',            icon:'table',           sections:['s-9-1'],                          sLabels:['Таблица и экспорт'] },
     { id:'ch-10', label:'Live-квиз',               icon:'radio',           sections:['s-10-1','s-10-2'],                sLabels:['Создание сессии','Управление'] },
     { id:'ch-11', label:'Учебники',                icon:'book-open-text',  sections:['s-11-1','s-11-2','s-11-3','s-11-4'], sLabels:['Каталог','Чтение и отметки','Назначить как ДЗ','Прогресс класса'] },
-    { id:'ch-12', label:'Экзамен 9 класс',          icon:'clipboard-check', sections:['s-12-1','s-12-2'],                sLabels:['Что внутри','Назначить вариант'] },
+    { id:'ch-12', label:'Экзамен 9 класс',          icon:'clipboard-check', sections:['s-12-1','s-12-2','s-12-3'],       sLabels:['Что внутри','Назначить вариант','Режим подготовки'] },
     { id:'ch-13', label:'Мои ученики',              icon:'user-plus',       sections:['s-13-1','s-13-2','s-13-3','s-13-4'], sLabels:['Когда нужно','Добавить ученика','Назначение','Удаление и заметки'] },
-    { id:'ch-14', label:'Виртуальная лаборатория',  icon:'flask-conical',   sections:['s-14-1','s-14-2','s-14-3','s-14-4'], sLabels:['40 симуляций','Связь с учебниками','Стереометрия 3D','Управление (admin)'] },
+    { id:'ch-14', label:'Виртуальная лаборатория',  icon:'flask-conical',   sections:['s-14-1','s-14-2','s-14-3'], sLabels:['40 симуляций','Связь с учебниками','Стереометрия 3D'] },
     { id:'ch-15', label:'Биохимия',                 icon:'atom',            sections:['s-15-1','s-15-2','s-15-3'],           sLabels:['Молекулярный редактор','Библиотека и свойства','Реакции и пути'] },
-    { id:'ch-16', label:'Геймификация и питомец',   icon:'zap',             sections:['s-16-1','s-16-2','s-16-3'],           sLabels:['XP и достижения','Виртуальный питомец','Начисление XP (admin)'] },
+    { id:'ch-16', label:'Геймификация и питомец',   icon:'zap',             sections:['s-16-1','s-16-2'],                    sLabels:['XP и достижения','Виртуальный питомец'] },
     { id:'ch-17', label:'Доступ к контенту',        icon:'shield-check',    sections:['s-17-1','s-17-2','s-17-3'],           sLabels:['Открытие учебников классу','Feature Flags','System Health'] },
+    { id:'ch-18', label:'Квантик-ассистент',         icon:'sparkles',        sections:['s-18-1','s-18-2','s-18-3'],           sLabels:['Что умеет','Спроси Квантика','Подсказки на экзамене'] },
+    { id:'ch-19', label:'Флэшкарты',                 icon:'copy',            sections:['s-19-1','s-19-2','s-19-3'],           sLabels:['Колоды и карточки','Картинки и формулы','Импорт и генерация ИИ'] },
+    { id:'ch-20', label:'Ещё модули платформы',      icon:'grid-3x3',        sections:['s-20-1','s-20-2','s-20-3','s-20-4'], sLabels:['Карта знаний и Теория','Игры: Кроссворд, Виселица','Красная книга и Коллекция','Материалы, Магазин, Родители'] },
   ];
 
   const ADMIN_CHAPTERS = [
@@ -1719,6 +1937,7 @@
     { id:'ch-a4', label:'Геймификация (admin)',       icon:'zap',              sections:['s-a4-1','s-a4-2','s-a4-3'], sLabels:['Статистика','Начисление XP/монет','Сброс прогресса'] },
     { id:'ch-a5', label:'Аудит и безопасность',      icon:'file-text',        sections:['s-a5-1','s-a5-2','s-a5-3'], sLabels:['Аудит-лог','Разрешения RBAC','Модерация аватаров'] },
     { id:'ch-a6', label:'System Health',              icon:'activity',         sections:['s-a6-1','s-a6-2'],           sLabels:['Метрики сервера','HTTP-статистика'] },
+    { id:'ch-a7', label:'Помощник Квантик (ИИ)',      icon:'sparkles',         sections:['s-a7-1','s-a7-2','s-a7-3'], sLabels:['Провайдеры и failover','Модели и лимиты','RAG и статистика'] },
   ];
 
   const ALL_CHAPTERS = () => isAdmin ? [...CHAPTERS, ...ADMIN_CHAPTERS] : CHAPTERS;