From 2354353e93dfa05ca2c5b7b124c71cc75debe1a0 Mon Sep 17 00:00:00 2001 From: Maxim Dolgolyov Date: Sun, 31 May 2026 08:26:51 +0300 Subject: [PATCH] =?UTF-8?q?docs(teacher-guide):=20=D0=B3=D0=BB=D0=B0=D0=B2?= =?UTF-8?q?=D1=8B=2014=E2=80=9317=20=E2=80=94=20=D0=BB=D0=B0=D0=B1=D0=BE?= =?UTF-8?q?=D1=80=D0=B0=D1=82=D0=BE=D1=80=D0=B8=D1=8F,=20=D0=B1=D0=B8?= =?UTF-8?q?=D0=BE=D1=85=D0=B8=D0=BC=D0=B8=D1=8F,=20=D0=B3=D0=B5=D0=B9?= =?UTF-8?q?=D0=BC=D0=B8=D1=84=D0=B8=D0=BA=D0=B0=D1=86=D0=B8=D1=8F,=20?= =?UTF-8?q?=D0=B4=D0=BE=D1=81=D1=82=D1=83=D0=BF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit + Глава 14: Виртуальная лаборатория (40 симуляций, deep-link, стереометрия 3D, связь с учебниками, управление в админке) + Глава 15: Биохимия (молекулярный редактор 2D/3D, VSEPR, SMILES, валентность, библиотека, реакции с ΔH, метаболические пути) + Глава 16: Геймификация (XP/уровни/достижения, питомец эволюция/цвет/настроение, начисление XP через панель, сброс прогресса) + Глава 17: Доступ к контенту (allowlist учебников/экзаменов по классам, feature flags, System Health) ~ Ch-13: nav → ch-14 вместо ch-1; убран «Готово! 13 глав» ~ CHAPTERS array: 13 → 17 записей, прогресс-бар пересчитается автоматически Co-Authored-By: Claude Sonnet 4.6 --- frontend/teacher-guide.html | 238 +++++++++++++++++++++++++++++++++++- 1 file changed, 237 insertions(+), 1 deletion(-) diff --git a/frontend/teacher-guide.html b/frontend/teacher-guide.html index 11dccab..654a188 100644 --- a/frontend/teacher-guide.html +++ b/frontend/teacher-guide.html @@ -1190,7 +1190,7 @@
—
Иконка корзины — убрать ученика из списка. Уже созданные задания НЕ удаляются — ученик продолжит их видеть.
—
Счётчик «Заданий» показывает, сколько вы лично выдали этому ученику.
-
Готово!
Теперь вы знаете все 13 разделов руководства. Удачных уроков и репетиторских часов!
+
Продолжайте изучение
Следующие главы: Лаборатория (14), Биохимия (15), Геймификация (16), Доступ к контенту (17).
@@ -1198,6 +1198,238 @@
Предыдущая глава
Экзамен 9 класс
+ + + + + +
+
+
+
+
Глава 14
+
Виртуальная лаборатория
+
+ Лаборатория +
+ +
+
14.1 Что это и зачем
+

Виртуальная лаборатория — 40 интерактивных симуляций по физике, химии, математике и биологии. Всё работает прямо в браузере, никаких установок не нужно.

+
+
Физика (14)
Маятник, волны, оптика, электричество, газы…
+
Химия (14)
Орбитали, кристаллы, реакции, периодическая таблица…
+
Математика (9)
Графики, планиметрия, стереометрия 3D, вероятность…
+
Биология (2)
Деление клетки, фотосинтез
+
+
Deep-link на конкретную симуляцию
Откройте нужную симуляцию и скопируйте адрес — в нём уже будет параметр ?sim=название. Вставьте ссылку в задание или чат урока, и ученик попадёт прямо в неё.
+
+ +
+
14.2 Связь с учебниками
+

В учебниках рядом с нужными параграфами появляется кнопка «В лабораторию» с числом связанных симуляций. Нажмите — откроется лаборатория с уже выбранной симуляцией по теме.

+
+
1
Откройте учебник → нужный параграф.
+
2
Нажмите кнопку с иконкой колбы в правом углу параграфа.
+
3
Браузер откроет лабораторию и автоматически запустит нужную симуляцию.
+
+
+ +
+
14.3 Стереометрия 3D
+

Симуляция «Стереометрия» — интерактивные объёмные тела: куб, пирамида, призма, конус, цилиндр, сфера, правильные многогранники и усечённые фигуры.

+
+
—
Вращение — зажмите кнопку мыши и тяните. Фигура крутится в 3D.
+
—
Производные точки — середины рёбер, центры граней, засечки.
+
—
Deep-link на фигуру — например, /lab?sim=stereo:cube откроет сразу куб.
+
+
На онлайн-уроке
Откройте симуляцию в соседней вкладке и включите демонстрацию экрана — ученики увидят 3D-вращение в реальном времени. Или используйте режим аннотации прямо поверх симуляции на доске.
+
+ +
+
14.4 Управление симуляциями (для администратора)
+

В панели администратора → вкладка «Симуляции»:

+
+
—
Включить/выключить конкретную симуляцию из каталога.
+
—
Отметить симуляцию как «Рекомендованную» (featured).
+
—
Связать симуляцию с параграфами учебников (редактор связей).
+
+
+ +
+ + +
+
+ + +
+
+
+
+
Глава 15
+
Биохимия
+
+ Биохимия +
+ +
+
15.1 Молекулярный редактор
+

Страница /biochem — интерактивный редактор молекул. Собирайте молекулы из атомов и связей, платформа мгновенно вычисляет свойства.

+
+
Атомы
C, H, O, N, S, P, галогены, металлы
+
Связи
Одинарные, двойные, тройные
+
3D VSEPR
Настоящая 3D-геометрия по теории ОЭПВО
+
Заряды δ±
Тепловая карта, стрелка диполя
+
+

В панели свойств автоматически отображаются: молярная масса, DBE (степень ненасыщенности), гибридизация, форма молекулы, дипольный момент, полярность, функциональные группы.

+
Валентность в реальном времени
Если превысить валентность атома — появится подсказка: «Углерод (C): занято 5 связей, максимум 4 — убери 1». Сохранение заблокируется до исправления.
+
+ +
+
15.2 Библиотека и свойства
+

/biochem-library — 105+ молекул с карточками и 2D/3D-превью. Можно сравнивать несколько молекул и экспортировать таблицу в CSV.

+

/biochem-properties — сравнение молекул: столбчатый график молярных масс, массовые доли элементов.

+
SMILES и экспорт
В редакторе можно ввести SMILES-строку (например, CC(=O)O — уксусная кислота), молекула построится автоматически. Готовую молекулу можно экспортировать как PNG или JSON.
+
+ +
+
15.3 Реакции и метаболические пути
+

/biochem-reactions — 27 реакций с автоматической балансировкой (показывает коэффициенты) и энергодиаграммой (экзо-/эндотермические с ΔH).

+

/biochem-pathways — метаболические пути (гликолиз, цикл Кребса и др.) с пошаговым Learn-режимом. За прохождение начисляется XP.

+
+ +
+ + +
+
+ + +
+
+
+
+
Глава 16
+
Геймификация и питомец
+
+ Питомец +
+ +
+
16.1 XP, уровни и достижения
+

Каждое действие ученика приносит опыт (XP): тесты, лаборатория, чтение учебников, ежедневная активность, ответы на уроке.

+
+
8 уровней
Новичок → Легенда, у каждого своя модель питомца
+
38+ достижений
Стрики, лаборатория, тесты, биохимия, топ-10
+
Стрики
Серия дней подряд — бонусный XP
+
Ежедневная цель
Лёгкая / Средняя / Тяжёлая
+
+
+ +
+
16.2 Виртуальный питомец
+

У каждого ученика есть личный питомец — существо, которое растёт вместе с прогрессом. Ухаживайте за ним: кормите, гладьте.

+
+
—
Имя — ученик выбирает сам при первом посещении /pet.
+
—
Цвет — 6 вариантов (фиолетовый, голубой, золотой, красный, зелёный, синий).
+
—
Эволюция — с ростом XP появляются уши (ур. 2), антенны (3), крылья (4), корона (5+).
+
—
Настроение — зависит от стрика и частоты визитов: бодр, в духе, скучает, голоден.
+
+
Радужный ошейник
При стрике 7+ дней подряд питомец получает анимированный радужный ошейник. Отличный мотиватор для регулярной работы!
+
+ +
+
16.3 Начисление XP администратором
+

В панели администратора → вкладка «Геймификация» → раздел «Начислить XP / Монеты»:

+
+
1
Выберите ученика из списка (есть фильтр по имени).
+
2
Задайте XP и/или монеты с помощью пресетов (0/+10/+25/+50/+100/+250) или вручную. Значение 0 — эта валюта не начисляется.
+
3
Укажите причину (быстрые кнопки: «Мероприятие», «Урок», «Бонус» или своя).
+
4
Нажмите «Начислить». Ученик получит XP/монеты мгновенно.
+
+
Сброс прогресса
Раздел ниже — «Сбросить прогресс пользователя». Удаляет весь XP, монеты и достижения. Действие необратимо, потребует подтверждения.
+
+ +
+ + +
+
+ + +
+
+
+
+
Глава 17
+
Доступ к контенту
+
+ Админ-панель +
+ +
+
17.1 Открытие учебников и экзаменов классу
+

По умолчанию ученики видят только те учебники и экзамены, к которым им открыт доступ. Это настраивается через allowlist — белый список.

+
+
1
Откройте Админ-панель → вкладка «Доступ к контенту».
+
2
Выберите учебник или экзамен из списка.
+
3
Добавьте класс — все ученики класса получат доступ. Или выберите конкретного ученика — доступ только у него.
+
+
Приоритеты
Доступ ученика выше доступа класса: если классу учебник закрыт, но конкретному ученику открыт — он его увидит.
+
+ +
+
17.2 Feature Flags — включение модулей
+

В Админ-панели → «Настройки» можно включать и отключать целые модули платформы:

+
+
—
Биохимия — полностью скрыть модуль для учеников.
+
—
Учебники — отключить раздел учебников.
+
—
Флэшкарты, Live-квиз — включить/выключить по необходимости.
+
—
Экзаменационные тесты — модуль с 80 вариантами по математике 9 класса.
+
+
Только для администратора
Изменение feature flags и доступа к контенту доступно только пользователям с ролью admin. Учителя видят только то, к чему у их класса есть доступ.
+
+ +
+
17.3 System Health
+

Администраторам доступна вкладка «System Health» в панели с метриками сервера в реальном времени:

+
+
—
CPU и RAM — текущая нагрузка процессора и память.
+
—
Event loop lag — задержка обработки запросов.
+
—
HTTP-статистика — количество запросов, самые медленные и частые роуты.
+
—
Тренды — canvas-графики нагрузки за последние минуты.
+
—
Журнал ошибок — последние ошибки сервера с трейсом.
+
+
Готово!
Теперь вы знаете все 17 разделов руководства. Удачных уроков!
+
+ +
+