fabrilis/docs/TESTING.md
loki5512344 79928b645b
Initial commit: Fabrilis docs, rules and deterministic core
Docs (architecture, decisions, coupling, determinism, UI, references), code rules enforced by tools/limits, deterministic core with units, time, math, sched, snapshot, vec and rng, plus smoke tests. ref/ stays out of git.
2026-11-16 23:06:29 +01:00

2.5 KiB
Raw Blame History

Тесты

Тесты лежат отдельно от кода: tests.rs рядом с модулем или папка tests/ (CODE_RULES.md).

  1. Юнит-тесты в каждом crate.
  2. Валидация по аналитике (физика должна совпадать с формулами):
    • консольная балка: прогиб δ = PL³ / 3EI;
    • маятник, снаряд с сопротивлением;
    • RC-цепь: экспонента заряда;
    • одномерная теплопроводность;
    • масса и инерция меша: шар, куб, цилиндр.
  3. Property-тесты на seeded core::rng — основа (инварианты массы, инерции, симметрия тензора). proptest разрешён как dev-зависимость (D26) там, где нужен shrinking, но не заменяет свои тесты.
  4. Детерминизм: golden-хеши состояния на уровнях D1/D2/D3 (DETERMINISM.md): своя машина, 1/2/8/24 потока, три ОС. Хеш хранится в репозитории.
  5. RISC-V: официальные riscv-tests (rv32ui/rv64ui и др.) и дифференциальное тестирование против QEMU или Spike на случайных программах; загрузка Linux как медленный интеграционный тест.
  6. Форматы: snapshot-тесты сцены и миграции версий; проверка меша до расчёта массы (замкнутость, ориентация нормалей, единицы).
  7. Производительность: бенчмарки горячих путей в benches/ (criterion как dev-зависимость, D26) плюс бюджет эталонной сцены в CI; регрессия видна как падение RTF.
  8. Правила репозитория: fabrilis-limits (в build.rs каждого crate'а, pre-commit и CI); тесты лежат в отдельных файлах (CODE_RULES.md).
  9. Сценарии Rhai служат функциональными тестами («подними паука, замерь нагрузку»).

Verification (правильность реализации) и validation (совпадение с реальной сборкой) — разные вещи, см. VALIDATION.md.