Maxim Dolgolyov
2e9a0ebfb1
- [U] Обновление из репозитория: бэкап -> git pull --ff-only -> npm install -> миграции -> рестарт -> health-check; при провале миграций/health предлагает откат (git reset --hard + восстановление БД из свежего бэкапа). Текущая версия (git short-hash + subject) в шапке. - [M] Обслуживание БД: backend/scripts/db-maintain.js (node:sqlite) — integrity_check -> WAL checkpoint(TRUNCATE) -> VACUUM; VACUUM пропускается на битой БД. Авто-бэкап + стоп/старт. - Авто-прунинг бэкапов: Backup-Db хранит последних 10 (Prune-Backups), Copy-DbFrom вынесен общим (реюз в Restore-Db и откате обновления), запоминается путь последнего бэкапа. - Живые логи: отдельный tools/tail-logs.ps1 — раскраска уровней (ERROR/FATAL красным, WARN жёлтым, успех зелёным) вместо сырого tail; вынос из inline-команды (PS 5.1 quoting). - Экран «Сторож»: дашборд в рамке с перерисовкой — статус-маркер, счётчики проверок/ перезапусков, последнее событие; выход по клавише. Все .ps1 — UTF-8 BOM, парсинг OK; db-maintain протестирован на копии БД (10.7->10.5 МБ); рендер-смоук подтвердил выравнивание. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
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 passed2— no backup files found3— latest backup older than 48h (backup job may have stopped)4—integrity_checkfailed (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