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 79928b645b
Signed by: boba
GPG key ID: 6CDE87BC9A778D97
222 changed files with 5335 additions and 0 deletions

36
docs/PHYSICS_SCOPE.md Normal file
View file

@ -0,0 +1,36 @@
# Физика: объём и цели
Цель — спроектировать любую конструкцию на 100% так, чтобы её можно было собрать
в реальности. Движок универсален; мех-паук — только первый пример.
## Импорт и материалы
Меш (glTF/STL/OBJ) + материал → объём, масса, центр масс, тензор инерции (по
дивергенции), коллайдер. Параметры материала: плотность, модуль Юнга, предел
текучести и прочности, трение, теплопроводность, теплоёмкость, удельное
сопротивление. Заполнение (infill/полость) задаёт эффективную плотность.
## Механика (`physics`, `structure`)
- Жёсткие тела, шарниры, ограничения, контакты (Rapier на старте).
- Трение: статическое и кинетическое, переключаемая модель (Кулон, с вязкой частью).
- Балочные и FEM-элементы для Lab: поле напряжений, деформации, усталость.
- Разрушение: при превышении прочности деталь ломается (разделение по сечению).
## Тепло и вентиляция (`thermal`)
Теплопроводность, конвекция, излучение; источники: мышцы, моторы, провода,
микросхемы. Вентиляция: потоки воздуха через корпус, обдув радиаторов. Метод
(сеть каналов или CFD-lite) решаем перед этим этапом.
## Проводка (`wiring`)
Жгуты: сечение AWG, длина, сопротивление, падение напряжения, нагрев током и его
обратная связь в `thermal`, разъёмы, предохранители.
## Аэродинамика (`aero`)
Панельный метод для Lab, таблицы коэффициентов для World; ветер.
## Режимы вида (`render::views`)
Переключаемые цветовые карты по деталям: напряжение (запас до разрушения),
деформация, температура, ток, давление/поток воздуха, трение/контакт.
## Выход в реальность (`parts::bom`)
Из конструкции экспортируется BOM: детали, материалы, массы, крепёж, провода,
компоненты платы. Допуски и реальные размеры учитываются в сцене.