Проверки справочника

Из корня репозитория. Установите зависимости документации в локальную виртуальную среду по инструкции.

python -m unittest discover -s tests -v
python scripts/check_practicum_sizing.py
python -m mkdocs build --strict

Unit tests проверяют результат commit через fake Kafka client. Sizing проверяет арифметику учебных таблиц. Сборка MkDocs проверяет внутренние ссылки и anchors.

Markdown и Mermaid

Для расширенной проверки нужны Node.js, Chrome или Chromium и локальные инструменты QA. Создайте рабочий каталог за пределами репозитория, скопируйте туда scripts/qa-package.json как package.json и выполните npm install --prefix <каталог>. Значения $qaTools и $browser ниже указывают на каталог пакетов и исполняемый файл браузера. Замените дату на дату прогона.

$run = Join-Path $qaTools ([guid]::NewGuid().ToString())
node scripts/audit_markdown.mjs --practicum --qa-tools "$qaTools" --work "$run" --report "$run/report.json" --checked-on 2026-11-03
node scripts/render_diagrams.mjs --qa-tools "$qaTools" --work "$run" --output "$run/svg" --browser "$browser" --checked-on 2026-11-03

Для других разделов используйте режим по умолчанию (01), --storage, --processing, --reliability, --fintech или --igaming. Каждый режим записывайте в отдельный свежий каталог. Границы проверок