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/SCENARIOS.md Normal file
View file

@ -0,0 +1,30 @@
# Сценарии и анализ
Проектирование не заканчивается сборкой модели: нужно доказать, что она работает
в заданных условиях. Сценарий — воспроизводимый опыт (seed + входы + скрипт).
## Что проверяем
- **Рабочие сценарии**: ходьба, подъём, перенос груза, взлёт, любые задачи конструкции.
- **Стабилизация и управление**: устойчивость контроллера (PID, свой код на МК),
реакция на возмущения (толчок, порыв ветра, неровность), задержки и шум датчиков.
- **Отказы (fault injection)**: обрыв провода, просадка батареи, заклинивание
привода, перегрев, отказ датчика, сбой прошивки, поломка детали.
- **Нагрузки и ресурс**: пики напряжений, запас прочности, усталость, температура.
- **Окружение**: ветер, поверхность, температура воздуха, наклон.
## Инструменты (`analysis`, `sensors`, `scripting`)
- **Сценарии Rhai**: подготовка сцены, подача входов и возмущений, проверки (assert),
запись метрик.
- **Развёртки параметров**: перебор длины, массы, коэффициентов регулятора;
параллельный прогон на ядрах, результат не зависит от числа потоков.
- **Monte Carlo с допусками**: разброс размеров, материалов, номиналов, шума.
- **Метрики устойчивости**: перерегулирование, время установления, запас по углу
опрокидывания, энергопотребление, время до отказа.
- **Датчики** (`sensors`): IMU, энкодеры, токовые датчики; шум, смещение, задержка,
дискретизация; управление видит мир только через них.
- **Позже**: линеаризация и частотный отклик контуров управления, запасы по
амплитуде и фазе.
## Результат
Отчёт по сценарию: графики, метрики, пройдено или нет, ссылка на хеш конструкции и
версию движка. Хранится как сценарий опыта (STORAGE.md).