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

39
docs/README.md Normal file
View file

@ -0,0 +1,39 @@
# Fabrilis — документация
Платформа полного проектирования механизмов: подробная физика + электроника +
код + управление. Цель — спроектировать любую конструкцию целиком (механика,
материалы, проводка, плата, прошивка), проверить её на сценариях работы,
стабилизацию, отказы, нагрузки, тепло и окружение, а затем собрать в реальности.
Мех-паук — первый эталонный проект (`examples/`), а не часть движка: в движке
нет кода под конкретную конструкцию.
| Документ | О чём |
|---|---|
| [ARCHITECTURE.md](ARCHITECTURE.md) | crate'ы, слои, поток данных, бюджет производительности |
| [DECISIONS.md](DECISIONS.md) | принятые решения и открытые вопросы |
| [MODES.md](MODES.md) | режимы Bench / Lab / World, Fidelity, время, события |
| [UI.md](UI.md) | свой UI: модель, текст, event-driven redraw, что берём из ShapeUI |
| [PHYSICS_SCOPE.md](PHYSICS_SCOPE.md) | механика, FEM, трение, тепло, вентиляция, проводка, виды |
| [SCENARIOS.md](SCENARIOS.md) | сценарии, стабилизация, отказы, развёртки, метрики |
| [ELECTRONICS.md](ELECTRONICS.md) | эмуляция CPU/SoC, аналоговая схема, мост |
| [COUPLING.md](COUPLING.md) | связь подсистем: классы связей, события, откат шага |
| [DETERMINISM.md](DETERMINISM.md) | уровни D1/D2/D3 и правила одинакового результата |
| [COORDINATES.md](COORDINATES.md) | системы координат, единицы, оси |
| [STORAGE.md](STORAGE.md) | проекты, конструкции, снимки, миры |
| [TESTING.md](TESTING.md) | стратегия тестов |
| [VALIDATION.md](VALIDATION.md) | verification, validation, qualification |
| [DEPENDENCIES.md](DEPENDENCIES.md) | библиотеки: что берём, что пишем сами, сколько весят |
| [PLUGINS.md](PLUGINS.md) | деталь как данные и плагин, правила совместимости |
| [REFERENCES.md](REFERENCES.md) | что читать и у кого подсматривать |
| [CODE_RULES.md](CODE_RULES.md) | проверяемые правила кода (лимиты, тесты отдельно, слои) |
Лицензия: [MIT](../LICENSE).
План работ: [../TODO.md](../TODO.md).
Название: Fabrilis (лат. fabrilis, «относящийся к мастеру, ремесленнику»). Автор: loki.
Статус: готовы M0 (скелет, правила, CI) и M1 (ядро: единицы, время, математика,
планировщик, Fidelity, снимки). Дальше M2 — один шарнир: своя векторная
математика, seeded RNG, минимальная физика с мотором и датчиками.