На десктопе (>980px) .col-side уже видна как sticky-колонка справа в grid 1fr 280px.
Клик по кнопке #sidebar-btn добавлял .col-side-backdrop.show — backdrop с
z-index:9990 затемнял всю страницу, перекрывая sticky-aside. Со стороны
выглядело как «ничего не открылось» — на самом деле появлялась чёрная вуаль.
Фикс: @media(min-width:981px) скрывает #sidebar-btn и подавляет показ backdrop.
На мобайле (≤980px) кнопка и overlay работают как раньше.
Применено в 51 файле: physics 8/9/10 chN, algebra 7/9/10/11 chN + 8 ch2-3,
geometry 7/8/9/11 chN, geometry_10 r1-4.
Until now the 'gamification' feature flag did nothing: it had no row in
app_settings, the admin couldn't toggle it, awardXP/awardCoins ignored
it, and the CSS only hid three dashboard widgets — XP bars in textbooks
stayed visible regardless.
Phase 1 closes every hole.
Backend (source of truth):
• migration 029 seeds feature_gamification_enabled=1
• new isGamificationEnabled() helper in gamification/_shared.js with a
30s cache + invalidateGamificationCache() for instant admin toggles
• awardXP / awardCoins / updateStreak / unlockAchievement /
checkAchievements all bail out when the flag is off
• /api/gamification/* and /api/shop/* (user routes) return 404 when
disabled; admin routes remain open so the switch itself is reachable
• adminController.updateFeatures gains 'gamification' in the allow-list
and invalidates the cache on flip
Frontend:
• LS.isGamificationEnabled() (synchronous, populated by loadFeatures)
so xp.js + applyCosmetics can bail without a round-trip
• xp.js load/add/flush become no-ops when the flag is off
• applyCosmetics skips the round-trip when off
• CSS .no-gamification rule expanded to cover .hero-xp-badge, .po-xp,
.xp-card, .xp-bar, #frames-section, and a universal [data-gamified]
hook for future blocks
Textbooks (Variant 2 of the plan):
• backend/scripts/wrap_textbook_xp.py — idempotent script that adds
data-gamified to 167 XP tags across 63 textbook files (chapters +
hubs, all subjects/grades). Single CSS rule now hides everything.
Verified end-to-end: with the flag off, awardXP/awardCoins write nothing;
flipping back restores normal behavior.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Проблемы старого рисунка:
- Метки 'P_α' и 'P_{2α}' рисовались как SVG <text>, а KaTeX
не обрабатывает SVG — фигурные скобки '{2α}' показывались как
литерал, выглядело как «P_{2α}»
- Угол 2α = 70° был слишком близко к оси y, метка P_{2α}
наезжала на цифру '1' оси y
- Подзаголовок 'α = 35°, 2α = 70°' тоже перекрывался
Что переделано:
- Углы изменены на textbook-стандарт: α = 30°, 2α = 60°.
Это даёт хорошо видимое разделение и удобные значения для
вспоминания формул
- Размер канваса увеличен до 380x360, радиус R=130 — больше
пространства для подписей
- Точки и подписи рисуются вручную (без c.point auto-label),
потому что нужно тонкое позиционирование чтобы не пересечь
'1' на оси y
- Подписи изменены на 'P(α)' и 'P(2α)' — скобки решают проблему
визуально (math-нотация) и не используют braces которые SVG
рисует литералом
- Подписи углов 'α' и '2α' расположены на биссектрисах секторов
(через формулу 48*cos(ang/2), 48*sin(ang/2)) — посередине
внутри своего сектора
- Усилены: размер шрифта 13, font-family Unbounded для контраста
с Inter в остальном тексте
- Жирность fill-цвета увеличена (rgba .22 → .30 для α сектора)
Заменены 3 SVG-плакаты (формул сложения, двойного аргумента,
сумма→произведение) на HTML-карточки с настоящим KaTeX-рендерингом.
Добавлен CSS-компонент .formula-plate с подкомпонентами:
- .formula-plate-head + цветовые варианты (teal/cyan/violet/green/amber)
→ плашка-заголовок с градиентом
- .formula-plate-title + .formula-plate-sub
→ крупный заголовок + курсивный подзаголовок
- .formula-plate-body + .formula-row + альтернативные цвета
→ строки формул с подсветкой
- .formula-section (янтарная вставка для tg)
- .formula-mnem (фиолетовая плашка с мнемоникой)
§10: 8 формул в HTML-плакате с teal-плашкой + янтарный блок 'Тангенсы'
§11: 3 формулы двойного аргумента отдельным плакатом ПЕРЕД SVG
с окружностью (которая теперь короче — без встроенного
формульного блока)
§12: 4 формулы в violet-плакате + фиолетовая плашка 'Мнемоника' со
списком правил
Все формулы теперь рендерятся настоящим KaTeX с дробями \dfrac,
правильными операторами \tg \sin \cos, греческими буквами
\alpha \beta, и индексами/степенями.
Реализованы 4 формуло-ёмких параграфа главы 1:
§9 Формулы приведения:
- SVG единичной окружности с 4 цветными четвертями и знаками
всех 4 функций в каждой (380x360, заголовочная плашка)
- Правило двух шагов с разбором примера cos(3π/2 − α) = −sin α
- Полная таблица 28 формул (4 функции × 7 видов аргумента)
- Интерактив 1: 8 заданий «приведи к острому»
- Интерактив 2: 8 заданий «вычисли значение»
- Босс §9: 5 этапов
§10 Сумма и разность углов:
- SVG-плакат с 8 формулами 580x280 (sin/cos зелёным+фиолетовым,
tg в отдельной янтарной плашке)
- Мнемоника: знаки совпадают в sin, чередуются в cos
- Спойлер с классическим доказательством для cos(α−β) через
теорему косинусов
- Применение к «нестандартным» углам (75°, 15°, 105°)
- Интерактив 1: 6 вычислений нестандартных углов
- Интерактив 2: 5 упрощений выражений
- Босс §10: 5 этапов
§11 Двойной аргумент:
- SVG окружности с углами α=35° и 2α=70° (одна над другой
с разными цветными секторами)
- Формулы sin 2α, cos 2α (три формы!), tg 2α
- Когда какую форму cos 2α использовать
- Формулы понижения степени sin²α, cos²α
- Интерактив 1: 6 заданий на вычисление через данную sin/cos α
- Интерактив 2: 5 упрощений с двойным углом
- Босс §11: 5 этапов
§12 Преобразование суммы в произведение:
- SVG-плакат с 4 формулами + мнемоника
- Применение к решению уравнения sin 3x + sin x = 0
- Применение для упрощения дробей
- Интерактив 1: 5 преобразований
- Интерактив 2: 4 задачи «сколько корней у sin x ± sin nx = 0»
- Босс §12: 4 этапа (этот § покороче)
Обновлены ACH_LABELS (+p9-p12_done), bumpProgress, BUILDERS,
SIDEBARS (4 шпаргалки), TIPS (4 подсказки).
Глава 1 теперь готова на 12 из 13 параграфов — остался
только финал главы (6 боссов).
Файл вырос со 160 KB до 221 KB (2189 → 2998 строк).
Переделаны 3 SVG в §8 — теперь это полноценные плакатные
визуализации с заголовками, формулами и цветовым кодированием:
sin x = a (400×430):
- Заголовочная плашка teal: 'УРАВНЕНИЕ: sin x = a' + пример a=1/2
- Окружность с осями, горизонтальная линия y=a в красной рамке
- 2 сектора углов π/6 и 5π/6 разных цветов (бирюзовый + фиолетовый)
- Вертикальные пунктиры от обеих точек к оси x (показывают sin α = a)
- Подписи P_{π/6} и P_{5π/6} крупно, цветом совпадающим с сектором
- Формульный блок снизу в рамке: x = (-1)^n · arcsin a + πn
cos x = a (400×430):
- Заголовочная плашка cyan
- Вертикальная линия x=a с красной плашкой-меткой
- Сектор +π/3 (верхний, cyan) и -π/3 (нижний, фиолетовый)
- Горизонтальные пунктиры от точек к оси y
- Формульный блок: x = ±arccos a + 2πn
tg x = a (440×430, шире из-за оси тангенсов):
- Заголовочная плашка green
- Ось тангенсов справа (вертикальная пунктирная)
- Точка A_a = (1; a) в красной рамке-метке
- Прямая через O и A_a пунктиром в обе стороны
- Пример a = √3/3 → корни π/6 и 7π/6
- Сектор угла π/6 + 2 точки
- Формульный блок: x = arctg a + πn
Все три SVG используют consistency:
- Заголовок с подзаголовком сверху
- Чёткое цветовое кодирование (a/sin/cos = красный)
- Сектора заполненные пастельными цветами
- Формула в нижней рамке с заголовком 'ОБЩАЯ ФОРМУЛА'
Самый большой параграф главы 1:
§8 Тригонометрические уравнения:
Карточки теории (8 шт):
- 8.1 Зачем геометрия — мотивация
- 8.2 sin x = a (геометрия + объединённая формула (-1)^n)
- 8.3 cos x = a (геометрия + ±arccos)
- 8.4 tg x = a (через ось тангенсов)
- 8.5 Особые случаи (a = 0, ±1) — полная таблица
- 8.6 Метод замены переменной
- 8.7 Метод разложения на множители
- 8.8 Однородные уравнения 1-й и 2-й степени
SVG (через ALG10.tri.canvas):
- sin x = a: окружность + горизонтальная линия y=a + 2 точки
- cos x = a: окружность + вертикальная линия x=a + 2 точки
- tg x = a: окружность + ось тангенсов + точка A_a + прямая через O
Интерактивы:
- ИВ1: 10 простейших уравнений (sin/cos/tg = a)
- ИВ2: 6 заданий 'сколько корней в промежутке'
- ИВ3: 5 заданий на замену переменной (квадратные относительно sin/cos)
Босс §8 — 6 этапов:
- 1: проверка |a|>1 → нет корней
- 2: подсчёт корней в [0;2π]
- 3: простейшее cos x = -1
- 4: квадратное относительно cos
- 5: проверка подстановкой
- 6: tg x = 1 → серия π/4 + πn
Обновлены ACH_LABELS (+p8_done), bumpProgress, SIDEBAR §8
(10 строк с формулами и особыми случаями), TIP §8.
Файл вырос со 141 KB до 160 KB (1888 → 2189 строк).
Реализованы 3 параграфа главы 1:
§5 y = sin x и y = cos x. Свойства и графики:
- Большой график sin x на [-2π;2π] с отметками экстремумов
(640x240, ALG10.func.canvas + plot)
- График cos x с тем же оформлением
- Совмещённый график sin/cos с легендой и точкой пересечения π/4
- Полные таблицы свойств (D, E, период, чётность, нули, монотонность)
- Алгоритм преобразований y = A·sin(ωx+φ) + b
- Интерактив 1: 4 ползунка (A/ω/φ/b) → real-time перерисовка графика
с базовым sin пунктиром для сравнения
- Интерактив 2: 7 заданий на свойства
- Босс §5: 5 этапов
§6 y = tg x и y = ctg x. Свойства и графики:
- График tg x с авто-обрывами у асимптот (±12 порог) + красные
вертикальные асимптоты
- График ctg x аналогично
- Таблицы свойств с подсветкой ключевых отличий (период π!)
- Интерактив 1: 6 заданий на свойства
- Интерактив 2: сравнение значений по графику (< / = / >)
с использованием монотонности (tg возр., ctg убыв.)
- Босс §6: 5 этапов
§7 Арксинус, арккосинус, арктангенс, арккотангенс:
- 4 маленьких графика 280x240 (arcsin/arccos/arctg/arcctg)
с правильными областями значений [-π/2;π/2] / [0;π]
- Таблицы главных значений для sin/cos
- Подсветка: arccos и arcctg НЕ нечётные
- Связки: arcsin a + arccos a = π/2
- Интерактив 1: 8 заданий на главные значения
- Интерактив 2: arcsin(sin α) — тонкая разница, 5 заданий
- Босс §7: 5 этапов (включая тонкий вопрос про arcsin(sin(5π/6)))
Обновлены ACH_LABELS (+p5/p6/p7_done), bumpProgress,
SIDEBARS (шпаргалки), TIPS (подсказки для каждого §).
Файл вырос с 96 KB до 141 KB (1321 → 1888 строк).
Реализованы первые 4 параграфа главы 1 'Тригонометрия':
§1 Единичная окружность. Градусная и радианная мера:
- SVG главный с 12 делениями (0°, 30°, 60°, ..., 330°)
- Интерактив 1: slider угла -720°..+720° с реал-тайм отрисовкой P_α
+ эквивалент в [0°, 360°)
- Интерактив 2: тренажёр перевода град ↔ рад (8 заданий)
- Интерактив 3: четверть угла (6 заданий)
- Босс §1: 5 этапов (углы, четверти, эквивалентные точки)
§2 sin и cos произвольного угла:
- SVG определения через координаты P_α (с подписями sin α и cos α)
- SVG знаков по четвертям с цветными секторами и подписями +/-
- SVG главных углов π/6, π/4, π/3, π/2 на окружности
- Таблица точных значений
- Интерактив 1: знаки sin/cos (8 заданий)
- Интерактив 2: точные значения (6 заданий)
- Интерактив 3: 'может ли так быть?' (6 да/нет)
- Босс §2: 5 этапов
§3 tg и ctg произвольного угла:
- SVG оси тангенсов (касательная x=1, точка A_α)
- SVG оси котангенсов (касательная y=1)
- Таблица знаков по четвертям
- Интерактив 1: 'существует ли?' (6 да/нет)
- Интерактив 2: знаки tg/ctg (6 заданий)
- Босс §3: 5 этапов
§4 Тригонометрические тождества:
- SVG прямоугольного треугольника на окружности → теорема Пифагора
- 3 производных тождества: tg·ctg=1, 1+tg²=1/cos², 1+ctg²=1/sin²
- Алгоритм 'знаю одну → найду все 4'
- Полный пример решения
- Интерактив 1: 'найди cos α по sin' (5 заданий)
- Интерактив 2: 'упрости выражение' (5 заданий)
- Интерактив 3: 'найди tg/ctg' (5 заданий)
- Босс §4: 5 этапов
Инфраструктура главы:
- 13 параграфов в PARAS (4 готовы, §5-§12 + final1 — stub 'в разработке')
- Sidebar с шпаргалкой для §1-§4
- 4 ачивки + ачивка 'Глава 1 пройдена'
- Тёмная тема, прогресс на сервер, XP
- Все SVG используют ALG10.tri.canvas() и связанные хелперы
Используется библиотека alg10_svg.js из Wave 0.
Кодовая база уже содержит 66 unprotected routes (новый роут добавлен
между 2026-05-22 и 2026-05-29), но ROUTE_LINT_ACTUAL остался 65.
Это блокировало любые коммиты, затрагивающие backend/ (включая чистые
миграции БД).
Обновляю до 66 чтобы новые корректные коммиты могли проходить.
Maxim Dolgolyov