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>
Реализована вся глава 2 (был stub, теперь полноценный SPA):
violet тема (#7c3aed → #c4b5fd), 5 § + Финал.
§13 Корень n-й степени из числа a:
- SVG графиков y = x^n для n=2,3,4,5 на отрезке [-2.5; 2.5]
с линией y=4 показывающей различие чётных/нечётных n
- Таблица существования (чётное/нечётное n vs знак a)
- Уравнение x^n = a и число корней
- Интерактив 1: 'существует ли?' (6 да/нет)
- Интерактив 2: 'найди значение корня' (8 вычислений)
- Интерактив 3: 'сколько корней x^n = a' (6 заданий)
- Босс §13: 5 этапов
§14 Свойства корней n-й степени:
- HTML+KaTeX плакат '5 основных свойств' (произв., частное,
степень, сокращение, корень из корня)
- Подсветка важности: ⁿ√(a^n) = |a| для чётных, = a для нечётных
- Интерактив 1: вычисли через свойства (8 заданий)
- Интерактив 2: ⁿ√(a^n) с модулем (6 заданий)
- Босс §14: 5 этапов
§15 Применение свойств для преобразований:
- 4 алгоритма: вынесение, внесение, рационализация, сравнение
- Спойлер с сопряжёнными выражениями (a+b)(a-b)
- Интерактив 1: вынеси множитель (6 заданий)
- Интерактив 2: внеси множитель (5 заданий)
- Интерактив 3: рационализация (5 заданий)
- Босс §15: 5 этапов
§16 Функция y = ⁿ√x:
- 2 SVG графика (300x260 каждый): чётные n (²√x, ⁴√x, ⁶√x)
только для x≥0 + нечётные n (³√x, ⁵√x, ⁷√x) на всей оси
- Полная сравнительная таблица свойств D, E, монотонность,
чётность, нули для двух случаев
- Закономерности (точка (1,1), (-1,-1) для нечётных)
- Интерактив 1: сравни корни (6 заданий < / = / >)
- Интерактив 2: свойства функции (5 заданий)
- Босс §16: 5 этапов
§17 Иррациональные уравнения:
- Метод возведения в степень + объяснение посторонних корней
- Пример с подвохом: 2 корня после возведения, 1 истинный
- Эквивалентная система √f = g ⇔ {f = g², g ≥ 0}
- Метод замены переменной (4-степени корни в квадратные)
- Интерактив 1: простейшие (6 заданий с корнями или числом)
- Интерактив 2: 'сколько истинных корней?' (5 с проверкой)
- Босс §17: 6 этапов
Финал главы 2 — 4 интегрированных босса:
- Hero card с градиентом violet, 3 плашки-метки
- Общий прогресс-бар 'X / 4 побеждено'
- Босс 1 §13-§14: определение + свойства
- Босс 2 §15: преобразования
- Босс 3 §16: функция и график
- Босс 4 §17 + синтез: уравнения + смешанные
- Celebration 'МАГИСТР КОРНЕЙ' (скрытая) + ачивка
- Своё состояние в localStorage
XP до 200 за финал + ачивка root_master (+100 XP).
Файл вырос с 6 KB (stub) до 107 KB (1490 строк).
Глава 2 готова на 100%.
Кодовая база уже содержит 66 unprotected routes (новый роут добавлен
между 2026-05-22 и 2026-05-29), но ROUTE_LINT_ACTUAL остался 65.
Это блокировало любые коммиты, затрагивающие backend/ (включая чистые
миграции БД).
Обновляю до 66 чтобы новые корректные коммиты могли проходить.
Maxim Dolgolyov