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.
39 lines
3.3 KiB
Markdown
39 lines
3.3 KiB
Markdown
# 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, минимальная физика с мотором и датчиками.
|