Files
Learn_System/backend/scripts
Maxim Dolgolyov 65c2e7dac1 feat(phys7 ch1): Phase 1 Wave 1 — §1, §2 + интеграция widgets
GEN: gen_phys7_ch.js теперь подключает <script src=phys7_chN_widgets.js> и
вызывает PHYS7_CHN_WIDGETS[id] в ensureBuilt, удаляя placeholder. Все 5 chN
регенерированы под этот hook.

WIDGETS (frontend/js/phys7_ch1_widgets.js, 402 строки, экспорт p1+p2):
- §1 «Физика — наука о природе»:
  * 3 теор. карточки (что изучает / связь с науками / 6 примеров явлений)
  * IV-1 СИМ: галерея 8 областей физики с hover-эффектом
  * IV-2 КВИЗ: 3 вопроса о предмете физики и слове «фюзис»
  * IV-3 DnD: 8 карточек → 4 науки (астро/химия/био/физика)
  * IV-4 ТРН: 5 вопросов тренажёр
- §2 «Физическое тело, явление, величина»:
  * 3 теор. карточки (4-понятийная таблица / как отличать / стакан-пример)
  * IV-1 СИМ (главный): DnD 12 карточек → 4 корзины (тело/вещество/явление/величина),
    в т.ч. KaTeX-величины (=5$ кг, =-10$ °C, =30$ км/ч)
  * IV-2 КВИЗ: «найди величину/явление/вещество» (3 вопроса)
  * IV-3 ТЕСТ: 5 быстрых вопросов на классификацию
  * IV-4 ТРН: 4 расчётных + концептуальных вопроса
- Кнопка «Я прочитал §» (+10 XP), localStorage-фиксация, серая «Прочитано»
  после первого нажатия.

ИНФРАСТРУКТУРА:
- Общие хелперы внутри файла: makeCard (theory/rule/example), wgWrap, dndPool,
  wireDnd, quizQuestion, wireQuiz, readButton, wireReadBtn, renderMath с правильными
  delimiters $..$ и $$..$$.
- XP: DnD +15, квиз +10, тренажёр +15, прочитал +10. Прогресс параграфа +30 при
  «прочитал», +10 базово при открытии. Цвета §1+§2 единые с темой главы 1 (indigo).
- Parse-check, KaTeX-аудит ($$ только двойной backslash), smoke-test пройдены.
2026-05-30 10:41:27 +03:00
..

backend/scripts

Operational scripts for LearnSpace backend.

Cron setup (production)

# Daily backup at 4am
0 4 * * *  /path/to/repo/backend/scripts/backup.sh

# Weekly verification at 6am Sunday (cron mails on non-zero exit)
0 6 * * 0  /path/to/repo/backend/scripts/verify-backup.sh

Scripts

backup.sh

Creates a safe SQLite snapshot via VACUUM INTO. Keeps last 7 backups (configurable via KEEP=14).

./backup.sh                        # default: ../data/learnspace.db → ../../backups/
./backup.sh /path/to/db /path/to/backups
KEEP=14 ./backup.sh

verify-backup.sh

Restores the latest backup to /tmp, runs PRAGMA integrity_check, compares row counts vs production.

Exit codes:

  • 0 — all checks passed
  • 2 — no backup files found
  • 3 — latest backup older than 48h (backup job may have stopped)
  • 4integrity_check failed (backup is corrupt)
  • 5 — user count diverged >5% from production
./verify-backup.sh
BACKUP_DIR=/custom/backups PROD_DB=/custom/db.sqlite ./verify-backup.sh

check-route-auth.js

Scans src/routes/*.js for :id-bearing routes without an auth-guard middleware. Fails if new unprotected routes exceed the current baseline.

npm run lint:routes

import-content.js (coming in Task 8)

Imports question collections from YAML manifests into the database.

npm run import:content -- ../content/phys/ct-2024.yaml

Deploy order (first time / fresh server)

npm install
npm run migrate
npm run seed:permissions
npm start