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:
commit
79928b645b
222 changed files with 5335 additions and 0 deletions
39
docs/README.md
Normal file
39
docs/README.md
Normal 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, минимальная физика с мотором и датчиками.
|
||||
Loading…
Add table
Add a link
Reference in a new issue