Files
Learn_System/backend/scripts
Maxim Dolgolyov 25489a733a feat: YAML content importer + phys/ct-2024 collection (proof)
content/phys/ct-2024.yaml — 15 questions from ЦЭ,ЦТ 2024 across
6 topics (kinem, mol, emf, electro, magnet, optics) as proof of format.

backend/scripts/import-content.js — unified importer:
- Validates schema (subject, year, options, exactly-1-correct)
- Aliases (kinem, mol, ...) resolve to Russian topic names via get-or-create
- Deduplicates by first 80 chars of text (matches legacy seed_*.js behavior)
- Runs in a single transaction, idempotent re-runs

On fresh DB: 13 added (2 dedup collisions — same 80-char prefix, expected).
On prod DB: 0 added (all already exist from legacy seeds).
Second run on either: 0 added (dedup works).

Legacy seed_phys_ct2024.js kept as backup — see content/README.md
for migration guide.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-05-06 17:42:07 +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