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.
This commit is contained in:
Loki 2026-11-16 19:09:10 +01:00
commit 878d144b77
221 changed files with 5316 additions and 0 deletions

30
docs/TESTING.md Normal file
View file

@ -0,0 +1,30 @@
# Тесты
Тесты лежат отдельно от кода: `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.