maxim.dolgolyov/Learn_System
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(teacher-guide): дополнено руководство — 3 новые главы + раздел 4.4

Browse Source 
Глава 4 — добавлен раздел 4.4 «Кому: класс / ученик / личный список»:
  - Покрывает все 4 режима выпадашки «Кому» при создании задания
  - Объясняет связь с «Моими учениками» (Глава 13)

Глава 11 — Учебники (новая):
  11.1 Каталог: Шиманович химия 9, Исаченкова физика 9
  11.2 Чтение и отметки «Прочитано», закладки выделением текста
  11.3 Назначение чтения как ДЗ (классу / ученику, диапазоны §)
  11.4 Учительский прогресс класса по учебнику

Глава 12 — Экзамен 9 класс (новая):
  12.1 80 вариантов, тёмная сетка с прогрессом
  12.2 Импорт нечётных в банк, назначение как ДЗ
        + объяснение «почему чётные — только для просмотра»

Глава 13 — Мои ученики (новая):
  13.1 Когда нужно: репетиторство, доп-занятия, подготовка к ЦТ
  13.2 Добавить по email (если ученика нет — ссылка на регистрацию)
  13.3 Назначения — через /textbooks и в общем поиске
  13.4 Удаление (задания не удаляются), счётчик заданий

TOC обновлён: CHAPTERS массив с 10 → 13 глав, счётчик «0 из 13».
Все навигационные кнопки prev/next перепрошиты под новую цепочку:
ch-10 → ch-11 → ch-12 → ch-13 → ch-1 (вернуться к началу).

Проверка: 13 chapters with matching id="ch-N", 40 sections с id=s-N-M,
все ссылки в CHAPTERS массиве соответствуют HTML-якорям.
This commit is contained in:
Maxim Dolgolyov
2026-05-16 17:06:24 +03:00
parent eeb79246db
commit d93664946e
1 changed files with 192 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files
frontend/teacher-guide.html
+192 -2
View File
@@ -402,7 +402,7 @@
<div class="tg-nav-title">Содержание</div>
<div class="tg-progress-wrap">
<div class="tg-progress-bar-outer"><div class="tg-progress-bar-inner" id="tg-prog-bar"></div></div>
<div class="tg-progress-text" id="tg-prog-text">0 из 10 глав прочитано</div>
<div class="tg-progress-text" id="tg-prog-text">0 из 13 глав прочитано</div>
</div>
</div>
<div class="tg-nav-search">
@@ -698,6 +698,18 @@
<div class="tg-note"><div class="tg-box-icon"><i data-lucide="bar-chart-2"></i></div><div class="tg-box-body"><div class="tg-box-label">Статистика по вопросам</div>Процент правильных ответов по каждому вопросу. Вопросы с низким процентом подсвечены красным — они требуют дополнительного объяснения на уроке.</div></div>
</div>
<div class="tg-section" id="s-4-4">
<div class="tg-section-title">4.4 Кому: класс, ученик, личный список</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> — каждый ученик в составе класса получает задание, прогресс — общий «X / N сдано».</div></div>
<div class="tg-step"><div class="tg-step-num">2</div><div class="tg-step-body"><b>Нескольким классам…</b> — открывает список ваших классов с чекбоксами. Удобно для параллелей одного потока.</div></div>
<div class="tg-step"><div class="tg-step-num">3</div><div class="tg-step-body"><b>Имя ученика (лично)</b> — пункты с пометкой «(лично)» в конце выпадашки. Список собран из участников <em>текущего класса</em>.</div></div>
<div class="tg-step"><div class="tg-step-num">4</div><div class="tg-step-body"><b>Ученику из «Мои ученики»</b> — для тех, кого нет в ваших классах (репетиторство, индивидуальные занятия). Сначала добавьте их в Главе 12, затем используйте раздел <b>«Учебники»</b> или назначайте напрямую.</div></div>
</div>
<div class="tg-tip"><div class="tg-box-icon"><i data-lucide="lightbulb"></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-3')">
<div class="tg-ch-nav-icon"><i data-lucide="arrow-left"></i></div>
@@ -1011,6 +1023,181 @@
<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-11')">
<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 11 — TEXTBOOKS ═══ -->
<div class="tg-chapter" id="ch-11">
<div class="tg-chapter-header">
<div class="tg-chapter-icon"><i data-lucide="book-open-text"></i></div>
<div class="tg-chapter-meta">
<div class="tg-chapter-num">Глава 11</div>
<div class="tg-chapter-title">Учебники</div>
</div>
<a href="/textbooks" class="tg-chapter-try" target="_blank"><i data-lucide="external-link"></i> Учебники</a>
</div>
<div class="tg-section" id="s-11-1">
<div class="tg-section-title">11.1 Каталог учебников</div>
<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>Физика 9</b> (Исаченкова) — §1–38: механика, кинематика, динамика, законы сохранения, импульс и энергия.</div></div>
</div>
<p>На карточке учебника видна шкала прогресса «X из Y параграфов прочитано» и кнопка <b>«Продолжить»</b> — открывает учебник на последнем посещённом параграфе.</p>
</div>
<div class="tg-section" id="s-11-2">
<div class="tg-section-title">11.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">Навигация по параграфам — pills в верхней части (§1, §2, …). Активный параграф подсвечивается.</div></div>
<div class="tg-step"><div class="tg-step-num">3</div><div class="tg-step-body">Рядом с заголовком каждого § есть кнопка <b>«Прочитано»</b> — отмечайте по мере изучения. Параграфы получают зелёный индикатор на pill.</div></div>
<div class="tg-step"><div class="tg-step-num">4</div><div class="tg-step-body">Выделите любой текст (8–400 символов) → появится плавающая кнопка <b>«+ Закладка»</b>. Сохраните с заметкой — закладки списком в overlay слева вверху.</div></div>
<div class="tg-step"><div class="tg-step-num">5</div><div class="tg-step-body">Кнопка <b>«← Учебники»</b> в левом верхнем углу — возврат к каталогу.</div></div>
</div>
<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>Прогресс и закладки сохраняются как в браузере, так и на сервере (если вы залогинены). Открывайте учебник на телефоне — увидите всё то же, что отметили на компьютере.</div></div>
</div>
<div class="tg-section" id="s-11-3">
<div class="tg-section-title">11.3 Назначить чтение как ДЗ</div>
<p>Учитель и админ могут назначить чтение глав ученику или классу.</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">В модалке выберите вкладку <b>«Классу»</b> или <b>«Ученику»</b>.<br>• <b>Классу</b> — чекбоксы для нескольких классов сразу.<br>• <b>Ученику</b> — поиск по имени/email (включая «Моих учеников» из Главы 13).</div></div>
<div class="tg-step"><div class="tg-step-num">3</div><div class="tg-step-body">Укажите диапазон параграфов: <code>1-5</code> или список <code>1,3,7</code>. Пусто = весь учебник.</div></div>
<div class="tg-step"><div class="tg-step-num">4</div><div class="tg-step-body">Опционально — срок сдачи. Нажмите <b>«Назначить»</b>.</div></div>
</div>
<div class="tg-tip"><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-section" id="s-11-4">
<div class="tg-section-title">11.4 Прогресс класса по учебнику</div>
<p>В правом верхнем углу каталога — кнопка <b>«Прогресс класса»</b> (только для учителей). Откроет страницу с таблицей: каждый ученик класса, шкала прогресса, последний прочитанный параграф и дата последнего чтения.</p>
<div class="tg-steps">
<div class="tg-step"><div class="tg-step-num">—</div><div class="tg-step-body">Сортировка автоматическая: сначала те, кто прочитал больше.</div></div>
<div class="tg-step"><div class="tg-step-num">—</div><div class="tg-step-body">Селекторы вверху позволяют переключать учебник × класс — удобно сравнивать.</div></div>
</div>
</div>
<div class="tg-chapter-nav">
<div class="tg-ch-nav-btn prev" onclick="scrollToChapter('ch-10')">
<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">Live-квиз</div></div>
</div>
<div class="tg-ch-nav-btn next" onclick="scrollToChapter('ch-12')">
<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">Экзамен 9 класс</div></div>
</div>
</div>
</div>
<!-- ═══ CHAPTER 12 — EXAM 9 ═══ -->
<div class="tg-chapter" id="ch-12">
<div class="tg-chapter-header">
<div class="tg-chapter-icon"><i data-lucide="clipboard-check"></i></div>
<div class="tg-chapter-meta">
<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>
</div>
<div class="tg-section" id="s-12-1">
<div class="tg-section-title">12.1 Что внутри</div>
<p>Раздел <b>«Экзамен 9 класс»</b> — банк из <b>80 экзаменационных вариантов</b> по математике за 9 класс. Каждый вариант — 10 задач: 3 с выбором ответа, 7 открытых. У каждой задачи есть полное пошаговое решение с формулами (KaTeX) и иллюстрациями.</p>
<div class="tg-steps">
<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">Прогресс отмечается прямо на сетке: зелёный — все решения посмотрены, жёлтый — часть.</div></div>
<div class="tg-step"><div class="tg-step-num">—</div><div class="tg-step-body">Возвращаясь на страницу, автоматически открывается последний просмотренный вариант.</div></div>
</div>
</div>
<div class="tg-section" id="s-12-2">
<div class="tg-section-title">12.2 Назначить вариант как ДЗ</div>
<p>Каждый <b>нечётный</b> вариант (1, 3, 5, …, 79) импортирован в банк вопросов как готовый тест из 10 задач. Их можно назначать как обычные тесты:</p>
<div class="tg-steps">
<div class="tg-step"><div class="tg-step-num">1</div><div class="tg-step-body">Откройте нужный вариант на странице <b>«Экзамен 9»</b>.</div></div>
<div class="tg-step"><div class="tg-step-num">2</div><div class="tg-step-body">Над заголовком — кнопка <b>«Назначить как ДЗ»</b> (видна учителям/админам).</div></div>
<div class="tg-step"><div class="tg-step-num">3</div><div class="tg-step-body">Выберите классы и срок — задание создаётся как обычный тест, ученики проходят через стандартный test-runner.</div></div>
</div>
<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-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>
<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-13')">
<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 13 — MY STUDENTS ═══ -->
<div class="tg-chapter" id="ch-13">
<div class="tg-chapter-header">
<div class="tg-chapter-icon"><i data-lucide="user-plus"></i></div>
<div class="tg-chapter-meta">
<div class="tg-chapter-num">Глава 13</div>
<div class="tg-chapter-title">Мои ученики (без класса)</div>
</div>
<a href="/my-students" class="tg-chapter-try" target="_blank"><i data-lucide="external-link"></i> Мои ученики</a>
</div>
<div class="tg-section" id="s-13-1">
<div class="tg-section-title">13.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>
<p>Это альтернатива классу из одного человека: меньше бюрократии, никаких приглашений по коду — только email.</p>
</div>
<div class="tg-section" id="s-13-2">
<div class="tg-section-title">13.2 Добавить ученика</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> введите email — он должен совпадать с email регистрации ученика на платформе.</div></div>
<div class="tg-step"><div class="tg-step-num">3</div><div class="tg-step-body">Опционально — заметка (например, «9Б, физика, СБ 16:00»). Видна только вам.</div></div>
<div class="tg-step"><div class="tg-step-num">4</div><div class="tg-step-body">Нажмите <b>«Добавить»</b>. Ученик получит уведомление «Вас добавил учитель».</div></div>
</div>
<div class="tg-tip"><div class="tg-box-icon"><i data-lucide="user-check"></i></div><div class="tg-box-body"><div class="tg-box-label">Если ученика нет на платформе</div>Сначала отправьте ему ссылку на регистрацию (/login → создать аккаунт), пусть зарегистрируется с тем email, который вы хотите добавить.</div></div>
</div>
<div class="tg-section" id="s-13-3">
<div class="tg-section-title">13.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> — на <a href="/textbooks">/textbooks</a> → кнопка «+» → вкладка «Ученику» → начинайте набирать имя/email — ученик появится в результатах.</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-check"></i></div><div class="tg-box-body"><div class="tg-box-label">Безопасность</div>Учитель может назначать задания только тем ученикам, которые либо в его классе, либо в его списке «Мои ученики». Списки видят только сами учителя — никто другой.</div></div>
</div>
<div class="tg-section" id="s-13-4">
<div class="tg-section-title">13.4 Удаление и заметки</div>
<p>Каждая строка списка — отдельный ученик. Доступные действия:</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">Счётчик «Заданий» показывает, сколько вы лично выдали этому ученику.</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>Теперь вы знаете все 13 разделов руководства. Удачных уроков и репетиторских часов!</div></div>
</div>
<div class="tg-chapter-nav">
<div class="tg-ch-nav-btn prev" onclick="scrollToChapter('ch-12')">
<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">Экзамен 9 класс</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>
@@ -1037,13 +1224,16 @@
{ id:'ch-1', label:'Быстрый старт', icon:'rocket', sections:['s-1-1','s-1-2','s-1-3','s-1-4'], sLabels:['Первый вход','Интерфейс','Первый класс','Чеклист'] },
{ id:'ch-2', label:'Управление классами', icon:'graduation-cap', sections:['s-2-1','s-2-2','s-2-3','s-2-4'], sLabels:['Создание класса','Приглашение','Состав и удаление','Обновление кода'] },
{ id:'ch-3', label:'Банк вопросов', icon:'database', sections:['s-3-1','s-3-2','s-3-3'], sLabels:['Создание вопроса','Типы вопросов','Дублирование и импорт'] },
{ id:'ch-4', label:'Задания и тесты', icon:'clipboard-check', sections:['s-4-1','s-4-2','s-4-3'], sLabels:['Создание задания','Параметры','Результаты и статистика'] },
{ id:'ch-4', label:'Задания и тесты', icon:'clipboard-check', sections:['s-4-1','s-4-2','s-4-3','s-4-4'], sLabels:['Создание задания','Параметры','Результаты и статистика','Кому: класс / ученик / личный список'] },
{ id:'ch-5', label:'Онлайн-урок', icon:'presentation', sections:['s-5-1','s-5-2','s-5-3','s-5-4','s-5-5','s-5-6'], sLabels:['Запуск и завершение','Инструменты доски','Страницы и шаблоны','Zoom и темы','Чат и видеосвязь','Гостевая ссылка'] },
{ id:'ch-6', label:'Библиотека материалов', icon:'book-open', sections:['s-6-1','s-6-2'], sLabels:['Загрузка файлов','Папки и доступ'] },
{ id:'ch-7', label:'Редактор уроков', icon:'file-edit', sections:['s-7-1','s-7-2'], sLabels:['Создание урока','Типы блоков'] },
{ id:'ch-8', label:'Аналитика', icon:'bar-chart-2', sections:['s-8-1','s-8-2'], sLabels:['Дашборд аналитики','Профиль ученика'] },
{ 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-13', label:'Мои ученики', icon:'user-plus', sections:['s-13-1','s-13-2','s-13-3','s-13-4'], sLabels:['Когда нужно','Добавить ученика','Назначение','Удаление и заметки'] },
];
/* ── Render nav ── */