Learn_System/plans/textbooks-8/PLAN_CHEMISTRY_8.md

План реализации: Химия 8 (Беларусь) — интерактивный наглядный учебник

Цель: создать с нуля интерактивный наглядный учебник по всей программе 8 класса в современной архитектуре hub + главы (как Физика 7–11 / Алгебра / Геометрия — НЕ как легаси-монолит chemistry_9.html), на уровне их качества, с поправкой на содержание 8 класса: количественные понятия (моль, M, Vm, расчёты по уравнениям), классы неорганических соединений, периодический закон, строение атома, химическая связь, ОВР, растворы.

Архитектура (утверждена): chemistry_8_hub.html (хаб-каталог глав) + 7 файлов глав (вводный раздел + 6 глав книги). В БД — родитель chemistry-8 + 7 детей с parent_slug. Каждая глава — самостоятельная страница со своими § (см. карту ниже), модульный CSS/JS на предмет. Единый стандарт с планом Химии 9 (plans/textbooks-9/PLAN_CHEMISTRY_9.md).

---

🎯 Источник

Параметр	Значение
Книга	himiya_8kl_shimanovich_rus_2018 (1).pdf
Авторы	Шиманович И. Е., Красицкий В. А., Сечко О. И., Хвалюк В. Н.
Изд.	Минск, «Народная асвета», 2018, 243 с. (тираж 116 000)
Структура	Вводный раздел + 6 глав, 52 §, 4 лабораторных опыта, 4 практические работы
Справочные таблицы	ПСХЭ Менделеева, таблица растворимости, ряд активности металлов (форзацы)

PDF лежит в G:\Dev\Тесты\Методички\тест_6 класс\Книги\. Оглавление — стр. 238–239 PDF.

Важные отличия от Химии 9:

1. Страниц химии-8 ещё нет — строим с нуля. Каркас берём у современных hub-учебников (physics_9_hub.html + physics_9_chN.html), а НЕ у легаси-монолита chemistry_9.html.
2. Описательной химии металлов/неметаллов в 8 классе нет (это 9 класс) — акцент на количественные расчёты, классификацию веществ, строение атома и химическую связь, ОВР.

Соответствие «раздел книги → файл главы → slug»:

Раздел книги	§	Файл	slug	Цвет
Вводный: Количественные понятия	1–9	chemistry_8_intro.html	chemistry-8-intro	amber
Гл.1 Классы неорг. соединений	10–23	chemistry_8_ch1.html	chemistry-8-ch1	teal
Гл.2 Периодический закон и ПСХЭ	24–28	chemistry_8_ch2.html	chemistry-8-ch2	indigo
Гл.3 Строение атома	29–35	chemistry_8_ch3.html	chemistry-8-ch3	blue
Гл.4 Химическая связь	36–41	chemistry_8_ch4.html	chemistry-8-ch4	green
Гл.5 ОВР	42–45	chemistry_8_ch5.html	chemistry-8-ch5	deep-orange
Гл.6 Растворы	46–52	chemistry_8_ch6.html	chemistry-8-ch6	cyan

Хаб: chemistry_8_hub.html / slug chemistry-8 (родитель в каталоге).

---

📗 ПОЛНАЯ КАРТА СОДЕРЖАНИЯ (52 §)

Колонка «Интерактив» — главный наглядный элемент сверх текста (минимум 1 «звёздный» виджет на §; полный набор — в стандарте ниже).

ВВОДНЫЙ РАЗДЕЛ. Повторение курса 7 класса. Количественные понятия в химии (§§1–9) — amber

§	Тема	Ключ	Интерактив (звёздный виджет)
§1	Атомы. Химические элементы. Относительная атомная масса	Z, символ, A_r	miniPeriodic + поиск A_r по элементу; модель атома
§2	Молекулы. Простые/сложные вещества. Химические формулы. M_r	формула, индексы, M_r=\sum A_r	Конструктор формул + калькулятор M_r (biochem-core)
§3	Химическое количество вещества	понятие «порция», n	Визуализация «порции вещества» (частицы → моль)
§4	Моль — единица количества вещества. Постоянная Авогадро	N=n\cdot N_A, N_A=6{,}02\cdot10^{23}	Счётчик частиц N\leftrightarrow n, масштаб N_A
§5	Молярная масса. Молярный объём газов	M (г/моль), V_m=22{,}4 л/моль (н.у.)	Калькулятор M + газовая модель (V_m)
§6	Вычисление n по m и m по n	n=\dfrac{m}{M}	Треугольник $n$–$m$–$M$ (интерактивный калькулятор-тренажёр)
§7	Вычисление n газа по V и V по n	n=\dfrac{V}{V_m}	Калькулятор V=n\cdot V_m + связка $m$–$n$–$V$–N
§8	Химические реакции	признаки, закон сохранения массы, балансировка	Балансировщик уравнений (анимация коэффициентов) + классификатор типов реакций
§9	Количественные расчёты по уравнениям реакций	стехиометрия, мольные отношения	sim stoichiometry + пошаговый решатель «дано → по уравнению»

Практическая работа 1 (после §7): «Химическое количество вещества».

ГЛАВА 1. Важнейшие классы неорганических соединений (§§10–23) — teal/cyan

§	Тема	Ключ	Интерактив
§10	Оксиды. Состав и классификация	Э_xO_y; осн./кисл./амфот./несолеобр.	Классификатор оксидов (drag формулы → класс) + конструктор формул оксидов по валентности
§11	Химические свойства оксидов	осн.оксид+кислота/вода; кисл.оксид+щёлочь/вода	Матрица реакций оксидов (chemEq, признаки)
§12	Получение и применение оксидов	горение, разложение; применение	Схемы получения + инфографика применения
§13	Кислоты. Состав и классификация	H_xAc; бескисл./кислородсод., основность	Классификатор кислот + indicatorScale (лакмус/метилоранж)
§14	Химические свойства кислот	+ Me (ряд активности), + осн.оксид, + основание, + соль	Реакции кислот (4 типа) + ряд активности + indicatorScale
§15	Получение и применение кислот	кисл.оксид+вода, соль+кислота	Схемы получения + инфографика
§16	Основания	Me(OH)_n; щёлочи/нерастворимые	Конструктор Me(OH)_n + indicatorScale (фенолфталеин малиновый)
§17	Химические свойства оснований	нейтрализация, +кисл.оксид, +соль, разложение	Реакция нейтрализации (анимация) + indicatorScale
§18	Получение и применение оснований	Me+вода, щёлочь+соль	Схемы; Лаб.1: получение нерастворимого основания (testTube $Cu(OH)_2$↓ голубой)
§19	Соли. Состав и классификация	катион×анион; средние/кислые/основные	Конструктор солей (катион×анион) + solubilityTable
§20	Химические свойства солей	РИО (↓↑), соль+Me (ряд активности)	solubilityTable + предсказатель РИО; Лаб.2: соли+металлы
§21	Получение и применение солей	8+ способов получения	Матрица способов получения солей
§22	Взаимосвязь между классами неорг. веществ	генетическая связь Me/неMe → оксид → гидроксид → соль	Генетическая карта-граф (интерактивные переходы)
§23	Решение расчётных задач по теме	расчёты по классам, по уравнениям	sim stoichiometry + тренажёр расчётов

Лаб. опыт 1 (после §18): получение нерастворимого основания. Практическая работа 2 (после §18): изучение реакции нейтрализации. Лаб. опыт 2 (после §20): взаимодействие растворов солей с металлами. Практическая работа 3 (после §22): решение экспериментальных задач.

ГЛАВА 2. Периодический закон и периодическая система (§§24–28) — indigo/violet

§	Тема	Ключ	Интерактив
§24	Систематизация химических элементов	ранние классификации, металлы/неметаллы	Сортировщик элементов (Me/неMe/амфот.)
§25	Понятие об амфотерности	Zn(OH)_2, Al(OH)_3 + кислота и + щёлочь	Амфотерность (testTube, обе реакции); Лаб.3: гидроксид цинка
§26	Естественные семейства элементов	щелочные, ЩЗМ, галогены, инертные	miniPeriodic — подсветка семейств, тренды свойств
§27	Периодический закон Д. И. Менделеева	формулировка, периодичность	Демонстрация периодичности (карточки-раскладка элементов)
§28	Периодическая система химических элементов	период/группа/подгруппа, структура	Интерактивная ПСХЭ (sim periodic) + разбор структуры

Лаб. опыт 3 (после §25): получение гидроксида цинка и изучение амфотерных свойств.

ГЛАВА 3. Строение атома и периодичность свойств (§§29–35) — blue

§	Тема	Ключ	Интерактив
§29	Строение атома. Атомный номер	ядро (p^+,n^0) + e^-, Z	Модель атома (sim bohratom) — сборка по Z
§30	Массовое число атома. Нуклиды	A=Z+N, нуклид	Калькулятор A=Z+N + конструктор нуклида
§31	Изотопы. Явление радиоактивности	одинаковый Z, разный N; распад	Изотопы-конструктор + sim radioactive + расчёт A_r по изотопам
§32	Состояние электронов. Электронное облако. Орбиталь	s,p,d орбитали, форма облака	3D-облака орбиталей (sim orbitals)
§33	Строение электронных оболочек атомов	уровни, 2n^2, конфигурация	Конструктор электронной конфигурации (orbitalDiagram, заполнение)
§34	Периодичность изменения свойств атомов	радиус, ЭО, металличность по периоду/группе	Графики трендов (slider период/группа → свойство)
§35	Характеристика элемента по положению в ПС	алгоритм «паспорта» элемента	Генератор «паспорта элемента» (пошагово)

ГЛАВА 4. Химическая связь (§§36–41) — green

§	Тема	Ключ	Интерактив
§36	Природа химической связи	октет, энергия связи, устойчивость	Анимация «почему атомы соединяются»
§37	Ковалентная связь	общие электронные пары, схемы Льюиса	Конструктор e-пар + структурные формулы (biochem-core)
§38	Неполярная и полярная ков. связь. ЭО	$\Delta$ЭО → полярность, диполь	Slider ЭО → тип связи + диполь; Лаб.4: модели молекул (biochem-core 3D)
§39	Ионная связь	передача e^-, ионная решётка	Анимация $Na\to Cl$ + решётка NaCl
§40	Металлическая связь. Межмолекулярное взаимодействие	«электронный газ», водородная связь	Модель электронного газа + водородная связь
§41	Кристаллическое состояние вещества	4 типа решёток → свойства	4 типа решёток (3D) + связь «тип → свойства»

Лаб. опыт 4 (после §38): составление моделей молекул.

ГЛАВА 5. Окислительно-восстановительные реакции (§§42–45) — deep-orange

§	Тема	Ключ	Интерактив
§42	Степень окисления	правила, расчёт по формуле	Калькулятор степени окисления (любая формула)
§43	Процессы окисления и восстановления	отдача/приём e^-, окислитель/восстановитель	Визуализация переноса e^-
§44	Окислительно-восстановительные реакции	метод электронного баланса	Балансировщик ОВР (пошаговый e-баланс)
§45	ОВР вокруг нас	горение, коррозия, дыхание, батарейки	Инфографика-исследование ОВР в жизни

ГЛАВА 6. Растворы (§§46–52) — cyan

§	Тема	Ключ	Интерактив
§46	Смеси веществ	однородные/неоднородные, разделение	Классификатор смесей + методы разделения
§47	Растворение веществ в воде	гидратация, тепловой эффект	Анимация растворения (dissociationAnim)
§48	Характеристики растворимости веществ	s=f(t), насыщ./ненасыщ.	График растворимости + solubilityTable
§49	Качественные характеристики состава растворов	насыщ./ненасыщ./разб./конц.	Качественная шкала «крепости» раствора
§50	Количественные характеристики. Массовая доля	w=\dfrac{m_{в-ва}}{m_{р-ра}}	Калькулятор $w$ (sim solutions)
§51	Молярная концентрация растворённых веществ	c=\dfrac{n}{V}, разбавление, смешение	Калькулятор $c$ + разбавление/смешение
§52	Вода и растворы в жизни и деятельности человека	значение, очистка, быт	Инфографика-исследование

Практическая работа 4 (после §51): приготовление раствора с заданной w и c.

Итого: 52 §, вводный раздел + 6 глав, 4 лаб. опыта (§18, §20, §25, §38), 4 практические работы (§7, §18, §22, §51).

---

⚗️ ХИМИЧЕСКИЙ СТАНДАРТ КАЧЕСТВА

A. Движки и переиспользуемые активы (всё уже есть в проекте)

Что нужно	Берём из	Файл / id
Парсинг формул, $M$/M_r, формула Хилла	biochem-core	frontend/js/biochem-core.js ✅
2D/3D шаростержневые модели, VSEPR	biochem-core	frontend/js/biochem-core.js ✅
Интерактивная ПСХЭ	sim periodic	реестр _register-all.js ✅
Модель атома (Бор)	sim bohratom	реестр ✅
Орбитали	sim orbitals	реестр ✅
Радиоактивность/изотопы	sim radioactive	реестр ✅
Стехиометрия	sim stoichiometry	реестр ✅
Титрование (нейтрализация)	sim titration	реестр ✅
Качественный анализ	sim qualanalysis	реестр ✅
Растворы / массовая доля	sim solutions	реестр ✅
Песочница реакций	sim chemsandbox	реестр ✅

Монтаж: контейнер <div id="sim-<id>"></div> + openSim('<id>') (или прямой mount через window.LabRegistry), как на остальных страницах.

B. Общий хелпер /js/chem8_svg.js (по образцу geom7_svg.js, alg10_svg.js)

Рекомендация: химические примитивы 8 и 9 классов сильно пересекаются. Реализовать файл так, чтобы его можно было продвинуть в общий /js/chem_svg.js (план Химии 9 ссылается на chem9_svg.js — при совместной разработке свести в один shared-модуль и переиспользовать оба). Молекулы — только через biochem-core.js, не дублировать.

// 1. Рендер уравнения реакции: коэффициенты, состояния (↑↓), стрелки, условия над стрелкой
const chemEq = (src, opts={}) => { /* токенизация формул, верхн./нижн. индексы, →/⇌/→[t°] */ };

// 2. Ион с зарядом:  ionLabel('SO4', -2) → 'SO₄²⁻'
const ionLabel = (formula, charge) => { /* нижние индексы + надстрочный заряд */ };

// 3. Пробирка с осадком/газом/окраской (SVG-анимация)
const testTube = ({fill, precipitate, gas, color, label}) => { /* svg */ };

// 4. Треугольник n–m–M (звёздный виджет §6): кликаешь искомое → формула + калькулятор
const moleTriangle = (mount, {solveFor}) => { /* n=m/M, m=n·M, M=m/n */ };

// 5. Балансировщик уравнений (§8): подбор коэффициентов, проверка баланса атомов
const equationBalancer = (mount, {skeleton}) => { /* матрица атомов, подсветка дисбаланса */ };

// 6. Калькулятор степени окисления (§42): формула → с.о. каждого элемента (правила)
const oxStateCalc = (mount, {formula}) => { /* разбор, правила H+1/O−2/Σ=0 */ };

// 7. Балансировщик ОВР методом e-баланса (§44): полуреакции, НОК, коэффициенты
const redoxBalancer = (mount, {skeleton}) => { /* окислитель/восстановитель, Δe⁻ */ };

// 8. Орбитальная диаграмма (§33): orbitalDiagram('1s2 2s2 2p4') → клетки + ↑↓
const orbitalDiagram = (config) => { /* svg клетки, принцип Хунда/Паули */ };

// 9. Интерактивная таблица растворимости (§19,20,48): подсветка пары катион×анион (Р/Н/М/—)
const solubilityTable = (mount, {highlight}) => { /* из форзаца книги */ };

// 10. Интерактивный ряд активности металлов (§14,20): клик → предсказание реакции
const activitySeries = (mount, opts) => { /* K Ca Na Mg Al Zn Fe ... Au + (H₂) */ };

// 11. Мини-ПСХЭ с подсветкой (§1,26,34): элемент/группа/период/семейство
const miniPeriodic = (mount, {highlight, onClick}) => { /* интерактивная сетка */ };

// 12. Индикатор + шкала pH (§13,14,16,17): лакмус/фенолфталеин/метилоранж
const indicatorScale = (mount, {ph, indicator}) => { /* цвет полоски */ };

// 13. Анимация растворения/гидратации (§47): частицы воды окружают ионы/молекулы
const dissociationAnim = (mount, {substance}) => { /* canvas/SVG-частицы */ };

// 14. Классификатор-DnD (§10,13,16,19,46): drag формулы → класс/тип; проверка
const classifier = (mount, {items, buckets}) => { /* оксиды/кислоты/основания/соли/смеси */ };

// 15. Генетическая карта-граф (§22): Me/неMe → оксид → гидроксид → соль, клик-переходы
const geneticMap = (mount, opts) => { /* SVG-граф классов + рендер реакции перехода */ };

C. Правила рендера химии (обязательны с §1)

1. Формулы веществ — нижние индексы для атомов (H_2O, CaCO_3), верхние для зарядов ионов (SO_4^{2-}) и степеней окисления (\overset{+2}{Ca}); единый рендер через chemEq/ionLabel, не «сырой» текст.
2. Уравнения реакций — всегда сбалансированы; стрелки =/→ (необратимая), ⇌ (обратимая), ↑ (газ), ↓ (осадок), условия над стрелкой (t, кат., эл.ток).
3. Состояние/признак — для качественных реакций показывать цвет осадка, пузырьки газа, изменение окраски индикатора (через testTube/indicatorScale).
4. Количественные расчёты — каждый расчётный § даёт калькулятор/тренажёр с пошаговым решением (дано → формула → подстановка → ответ с единицами), не только готовый ответ.
5. Молекулярные модели — структурная формула + 3D (biochem-core) для каждой изучаемой молекулы (§37–38, §41); для типов решёток — 3D-ячейки.
6. Цвета — химически достоверные: осадки (Cu(OH)_2 голубой, Fe(OH)_3 бурый, Zn(OH)_2 белый); индикаторы (фенолфталеин в щёлочи малиновый, лакмус в кислоте красный, метилоранж в кислоте розовый).
7. Безопасность — где уместно (растворение кислот/щелочей, разбавление) — заметка-«скрепка».
8. KaTeX-эскейпы — в JS-шаблонах двойной backslash (\\to, \\downarrow, \\rightleftharpoons).
9. Drag/слайдеры — window-listeners + {passive:false} + state ВЫШЕ redraw() (стандарт геометрии), touch-action:none на draggable SVG/canvas, без setPointerCapture.
10. Без эмоджи — только inline SVG .ic/.ico (правило проекта feedback_no_emoji).

D. Типы интерактивов по темам 8 класса

Тип темы	Интерактив
Количество вещества (§3–7, 9)	moleTriangle, калькуляторы M/V_m/N, sim stoichiometry
Химические реакции (§8)	equationBalancer, классификатор типов
Классы соединений (§10–21)	classifier, матрицы реакций, indicatorScale, solubilityTable, activitySeries
Генетическая связь (§22)	geneticMap
Периодический закон / ПСХЭ (§24–28, 34)	miniPeriodic, sim periodic, графики трендов
Строение атома (§29–33)	sim bohratom, sim orbitals, sim radioactive, orbitalDiagram
Химическая связь (§36–41)	slider ЭО, biochem-core 3D, ионная/металлич. решётка, 4 типа кристаллов
ОВР (§42–44)	oxStateCalc, redoxBalancer, визуализация переноса e^-
Растворы (§46–52)	dissociationAnim, график растворимости, sim solutions, калькулятор c
Качественные/амфотерность (§18,25)	testTube + уравнение + признак

---

📦 СТРУКТУРА КАЖДОГО § (стандарт наполнения)

Теория (3–4 карточки):

• theory — основное определение/понятие + наглядная SVG/модель
• rule — ключевая закономерность/формула (рамка)
• example — разобранный пример (реакция/расчёт) с пошаговым рендером
• (для прикладных §) apply — применение/значение (инфографика)

Интерактивы (4–6 на §):

1. Звёздный виджет темы (из карты содержания)
2. Конструктор/симулятор (slider / drag / sim из реестра)
3. Калькулятор (M, n, w, c, с.о., по уравнению) — где применимо
4. DnD-классификатор (классы веществ, тип связи/реакции, тип решётки)
5. Тренажёр — 5 задач с inline-наглядностью (формула/уравнение/модель в условии)
6. Босс § — 4 интеграционные задачи (+5 XP каждая)

Дополнительно: пополнение глоссария (термины §, [[ссылки]]), «Вопросы и задания» из учебника (адаптированные, с проверкой), проходящий jsdom-тест страницы.

Финал главы: итоговая шпаргалка (mini-cards), карта связей (SVG-граф понятий), 7 интегрированных боссов (+10 XP), achievement «Мастер главы N» (+50 XP, confetti), кнопка перехода к следующей главе.

---

🚀 ПОРЯДОК РЕАЛИЗАЦИИ (по фазам)

Phase 0 — Фундамент (hub + каркасы глав)

• chemistry_8_hub.html — хаб-каталог 7 глав по образцу physics_9_hub.html: палитра amber, водяной знак «ХИМИЯ», карточки глав с прогрессом (грузится из /api/textbooks/chemistry-8/children), блок «Финал курса» (шпаргалка + боссы — наполняется в Phase 7), achievement-strip «Химик 8 класса», тема (localStorage chemistry8_theme).
• 7 файлов глав chemistry_8_intro.html + chemistry_8_ch1..ch6.html — на Phase 0 валидные каркасы-заглушки (header с водяным знаком, hero, sidebar-оглавление §, контейнер параграфов, XP/tracker-интеграция), наполнение § — в Phase 1–6.
• /js/chem8_svg.js (хелперы B — заглушки → реализация по фазам).
• Подключить biochem-core.js + нужные симуляторы на страницах глав.
• Миграция 041_chemistry8_hub.sql (следующий номер после 040_content_access.sql): INSERT родителя chemistry-8 (html_path='chemistry_8_hub.html', para_count=52, color='amber', parent_slug=NULL) + 7 детей chemistry-8-intro/-ch1..-ch6 (parent_slug='chemistry-8', свои html_path/para_count/color/sort_order) — по образцу 038_physics_9_hub.sql. Применить npm run migrate.
• jsdom-тест-каркас: хаб строится, все 8 файлов парсятся, ссылки глав ведут на существующие slug.

Phase 1 — Вводный раздел «Количественные понятия» (§§1–9) + ПР1 — фундамент расчётов

Базовые движки: калькулятор M_r (biochem-core), moleTriangle, связка $m$–$n$–$V$–N, equationBalancer, sim stoichiometry. Критично — эти расчёты используются во всех главах.

Phase 2 — Глава 1 «Классы неорганических соединений» (§§10–23) + Лаб.1,2 + ПР2,3

Самая объёмная. Закладываем classifier, indicatorScale, solubilityTable, activitySeries, матрицы реакций, testTube (первые качественные/нейтрализация), geneticMap (§22), sim titration.

Phase 3 — Глава 2 «Периодический закон и ПСХЭ» (§§24–28) + Лаб.3

miniPeriodic, sim periodic, амфотерность (Zn(OH)_2 — обе реакции + testTube), демонстрация периодичности.

Phase 4 — Глава 3 «Строение атома» (§§29–35)

sim bohratom, sim orbitals, sim radioactive, orbitalDiagram, графики периодических трендов, генератор «паспорта элемента».

Phase 5 — Глава 4 «Химическая связь» (§§36–41) + Лаб.4

slider ЭО → тип связи, biochem-core 3D-модели, ионная/металлическая решётки, 4 типа кристаллических решёток (3D) и связь «тип → свойства».

Phase 6 — Глава 5 «ОВР» (§§42–45) + Глава 6 «Растворы» (§§46–52) + ПР4

oxStateCalc, redoxBalancer, визуализация переноса e^-; затем dissociationAnim, график растворимости, sim solutions, калькулятор c, ПР4.

Phase 7 — Финалы глав + общий финал учебника

Шпаргалки и карты связей по каждой главе; интегрированные боссы + achievements; большой финал: генетическая карта классов + строение/связь, итоговый босс-квест, ачивка «Химик 8 класса»; глоссарий собран и связан [[ссылками]].

Phase 8 — Качество и админка

Полный прогон jsdom-тестов (каждый § — builder не stub); аудит баланса уравнений и KaTeX/chemEq-эскейпов; синхронизация с админкой (если новые sim в lab.html → обновить ADMIN_SIMS в admin.html — feedback_sims_admin_sync); проверка доступа по классам/ученикам (project_content_access, /api/access).

Рекомендуемый темп: внутри фазы — по 2–3 § за «волну», каждая волна = commit + проходящий jsdom-тест (правило CLAUDE.md: commit изменённых файлов + push).

---

🗄️ ИНТЕГРАЦИЯ С ПРОЕКТОМ

Точка	Действие
БД каталог	chemistry-8 в textbooks отсутствует → миграция 041_chemistry8_hub.sql: INSERT родитель + 7 детей (образец — 038_physics_9_hub.sql). Каталог /api/textbooks показывает только parent_slug IS NULL; хаб тянет детей через /api/textbooks/chemistry-8/children.
Прогресс/XP	Автоматически: textbook-xp-widget.js (+5 XP/§), textbook-tracker.js, LS.xp. Доп. XP за боссов — по образцу phys7_ch1_widgets.js.
Симуляторы	Реестр frontend/js/labs/_register-all.js. Нужные химические sim уже зарегистрированы: periodic, bohratom, orbitals, radioactive, stoichiometry, titration, qualanalysis, solutions, chemsandbox.
Молекулы	biochem-core.js (парсинг, M, 2D/3D, VSEPR).
Бэкенд	Роуты готовы: backend/src/routes/textbooks.js (catalog/progress/bookmarks). Доступ: backend/src/services/contentAccess.js.
Глоссарий	Виджет всплывающих определений на странице (общего нет — реализовать).
Тесты	cd backend && npm test (jsdom). На каждый § — тест: страница строится, builder не stub, уравнения сбалансированы.
Админка	Новые sim в lab.html → синхронно ADMIN_SIMS в admin.html.

---

⚠️ КРИТИЧЕСКИЕ ПРАВИЛА

❌ НЕ делать

• «Сырые» формулы текстом — только chemEq/ionLabel/KaTeX.
• Несбалансированные уравнения (аудит баланса перед commit).
• Дублировать молекулярный движок — использовать biochem-core.js.
• setPointerCapture (теряется после innerHTML-replace) → window-listeners + state-flag.
• \to, \downarrow, \rightleftharpoons без удвоения backslash в JS-шаблонах.
• Slider-диапазоны за пределы химически возможного (концентрации, температуры, V_m).
• Эмоджи — запрещены; только inline SVG .ic.
• Grep tool — запрещён; поиск только ast-index (reference_sqlite_node и правила проекта).

✅ Обязательно

• Каждый commit → jsdom-тест 100% pass.
• Аудит баланса уравнений + KaTeX-эскейпов после каждой волны.
• Расчётный § = калькулятор/тренажёр с пошаговым решением и единицами измерения.
• Качественная реакция = уравнение (молек.+, где есть, ионное) + видимый признак.
• Цвета осадков/индикаторов — химически достоверные.
• Все builder-функции в конце финальной волны главы — НЕ stub'ы.
• Коммитить только изменённые файлы (не git add -A), сразу push.

---

📊 Оценка объёма

Раздел	§	Лаб/ПР	Ожидаемый LOC
Вводный (кол-во вещества)	9	ПР1	~7 000 (+moleTriangle, equationBalancer, stoichiometry)
Гл.1 Классы соединений	14	Лаб1,2 + ПР2,3	~16 000 (+classifier, solubilityTable, activitySeries, geneticMap)
Гл.2 ПЗ и ПСХЭ	5	Лаб3	~5 000 (+miniPeriodic, амфотерность)
Гл.3 Строение атома	7	—	~7 000 (+orbitalDiagram, sim bohratom/orbitals/radioactive)
Гл.4 Химическая связь	6	Лаб4	~6 500 (+3D-модели, 4 решётки)
Гл.5 ОВР	4	—	~4 500 (+oxStateCalc, redoxBalancer)
Гл.6 Растворы	7	ПР4	~7 000 (+dissociationAnim, sim solutions, калькулятор c)
Финалы глав + общий	—	—	~5 000
/js/chem8_svg.js хелперы	—	—	~3 000
Хаб + 7 каркасов глав (Phase 0)	—	—	~3 000
Итого	52	4 лаб + 4 ПР	~64 000 LOC

---

🎬 Запуск

Phase 0: chemistry_8_hub.html (по образцу physics_9_hub.html) + 7 каркасов глав (chemistry_8_intro.html, chemistry_8_ch1..ch6.html) + /js/chem8_svg.js (скелет) + подключение biochem-core.js/симуляторов + миграция 041_chemistry8_hub.sql (родитель + 7 детей)

• npm run migrate + jsdom-каркас. Phase 1: Вводный раздел (§§1–9) — закладываем движки расчётов (moleTriangle, equationBalancer, sim stoichiometry), от которых зависят все главы.

Дальше — последовательно по главам (Phase 2 → 6), затем финалы (Phase 7) и качество (Phase 8).