---
name: project_math5_textbook
description: "Новый интерактивный учебник «Математика 5 класс» (Беларусь, Герасимов/Пирютко/Лобанов 2020): план + Phase 0 (фундамент готов), переиспользует движок math6"
metadata:
  node_type: memory
  type: project
  originSessionId: 60467058-b40e-4bd9-9f7f-d1e362e8039a
---

Создаём интерактивный учебник **«Математика. 5 класс»** (Беларусь, Герасимов В. Д., Пирютко О. Н.,
Лобанов А. П., 2020, 2-е изд., в 2 частях). Источник PDF: `G:\Dev\Тесты\Методички\Разное\Книги\`
(`matematika_5kl_ch1_gerasimov_rus_2020 (1).pdf` 181 стр. + `…_ch2_… .pdf` 197 стр.) — это новая папка
учебников, дополнение к [[reference_textbook_sources]]. Контент пишем авторский (свой).

**План:** `plans/textbooks-5/PLAN_MATH_5.md` + `PLAN_MATH_5_VISUAL.md` (карта 22 новых визуал-компонентов
по §). Составлен 2026-06-03 (Opus). Реализация: Opus — фундамент + эталонная Глава 1; Главы 2–3 можно
Sonnet (пользователь: «можно сонетом»).

**Структура (3 главы, 44 содержательных §):**
1. **Натуральные числа** (§1–17, indigo) — как решать задачу, чтение/запись и разряды, сравнение,
   точка/прямая/луч/отрезок, измерение отрезков, координатный луч, округление, +−×÷, степень, деление
   с остатком, делители/НОД/НОК, признаки делимости, простые/составные+разложение, +§15–17 прикладные.
2. **Выражения. Уравнения** (§1–9, teal) — числовые выражения, выражения с переменными, уравнение,
   формулы, решение задач уравнением, **угол (транспортир)**, +§7–9 прикладные.
3. **Обыкновенные дроби** (§1–18, rose) — дроби/доли, осн. свойство, смешанные, сравнение, +−×÷ дробей,
   задачи на дроби, ∥/⟂ прямые, ломаная/многоугольник/периметр, площадь, площадь треуг., среднее
   арифм., диаграммы, параллелепипед/куб, объём. (Геометрия переплетена в число — замысел Герасимова.)
   §17–18 параллелепипед/объём — **2D-изометрия** (НЕ интерактивный 3D; в 6 кл. 3D исключали, тут это
   обязательная программа → включаем плоским SVG + заполнение единичными кубиками).

**АРХИТЕКТУРА — переиспользуем движок «Математики 6» БЕЗ форка.** `math6_engine.js` уже generic
(читает `window.M6` со своими `slug/lsPrefix/xpKey`). Страницы 5 класса подключают те же ассеты
(`math6.css`, `math6_svg.js`=`window.Math6`, `math6_anim.js`=`window.Math6Anim` ПЕРЕД engine,
`math6_engine.js`). Это общая **визуальная библиотека математики**, не «6 класс». Новые компоненты —
либо inline в странице главы (как кастомные интерактивы 6 кл. → даёт параллелизм Sonnet без конфликтов
в shared-файлах), либо в shared math6_svg/anim если переиспользуются между главами. Гочи 6 класса
действуют: ⛔ эмодзи (только `.ic`), ⛔ Grep-tool, KaTeX-запятая `2{,}5`, `applied:true`/`final:true`,
Edit-флака на кириллице → верифицировать зелёным тестом.

**Маппинг → LearnSpace:** хаб `math-5` (`math_5_hub.html`, 3 карточки + курсовой финал 3 боссов +
звание «Математик 5 класса» +150 XP, `localStorage math5_course_done`). Главы: `math-5-ch1/2/3`
(`math_5_chN.html`, ключи `math5_chN_*`, общий XP `math5_xp`). para_count: 18/10/19, хаб TOTAL=47.

**СТАТУС: Phase 0 ГОТОВ (commit c020a2c).** Миграция `050_math5_hub.sql` ПРИМЕНЕНА (хаб + 3 главы,
палитры indigo/teal/rose, sort_order 5). Страница-хаб + 3 КАРКАСА глав (`window.M6` только с `paras` →
движок рисует заглушки, страницы живые, навигация/прогресс/XP/ачивки работают). Тест
`backend/tests/math5-page.test.js` — **8/8** (хаб + 3 главы + ключи math5_* + ачивка + контент ch1).
**ГЛАВА 1 ЗАВЕРШЕНА ЦЕЛИКОМ (commit 12a08e7, ЭТАЛОН для Sonnet):** все §1–17 + финал наполнены, тест
math5 «нет заглушек §1–17» зелёный. Визуалы: разрядная таблица (§2), SVG-фигуры точка/луч/отрезок (§4),
линейка (§5), numberLine ray (§6,§7), прямоугольник из точек (§9), квадрат из клеток (§10), точки-группы
с остатком (§11), делители-чипсы (§12), живой чекер делимости (§13), решето Эратосфена клик-по-простым
(§14), римские цифры (§17). Шаблон билдеров = главы 6 кл.: makeCard(kind,title,num,html) [kind=oral/theory/
rule/example], `.wg` интерактивы, secNav(prev,next)+readBtn(id), feedback(el,bool,html), addXp(n,key),
bumpProgress(id,delta), renderMath(el), boss-arena (.hp-boss/.boss-q, победа→addXp(40,'final')+bumpProgress
('final',100)); helpers `_ri/_pick/_kf/_grp`; «Разбор по шагам» авто-конвертится движком в stepPlayer.
Регистрация в ХВОСТЕ: `var SIDEBARS/TIPS/GLOSSARY/BUILDERS; Object.assign(window.M6,{...})`. Каркас уже
держит полный `paras` массив — НЕ переписывать, только добавить builders/data.
**ГЛАВЫ 2 и 3 ГОТОВЫ (commits 06e9846, 5a2a1be) — Sonnet-агентами по эталону ch1.** Гл.2 «Выражения.
Уравнения» §1–9+финал (SVG-весы уравнения, классификатор углов, формулы). Гл.3 «Обыкновенные дроби»
§1–18+финал (полоса долей, сетка умножения дробей, изометрия параллелепипеда/кубиков; ответы целые,
дробные — через числитель при данном знаменателе). Гл.3-агент сначала упал на лимите вывода 32k → перезапуск
с инструкцией «только инкрементальные Edit батчами, не Write целиком» сработал.
**УЧЕБНИК НАПОЛНЕН ЦЕЛИКОМ: 3 главы, 44 §. Тест `math5-page` 12/12 (все § без заглушек, финалы зажигают
ачивки).** Всё на master. **ОСТАЛОСЬ ТОЛЬКО:** (опционально) обогащение/доп.визуализации; **выдать доступ
ученикам/классам** `/api/access` ([[project_content_access]], хаб закрыт по умолчанию — действие админа).
Браузерная проверка «как выглядит» — за пользователем (canvas/SVG в jsdom не видно). Образец качества §§ — главы 6 класса (`math_6_chN.html`), см. [[project_math6_textbook]].