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.
42 lines
2.2 KiB
Markdown
42 lines
2.2 KiB
Markdown
# Fabrilis
|
||
|
||
Платформа проектирования и виртуальных испытаний механизмов: механика, материалы,
|
||
электроника, прошивка и управление в одной детерминированной симуляции.
|
||
|
||
Название — от лат. *fabrilis*, «относящийся к мастеру, ремесленнику».
|
||
|
||
Цель: спроектировать конструкцию целиком, проверить её на сценариях (нагрузки,
|
||
отказы, тепло, устойчивость), получить отчёт и BOM, а затем собрать в реальности.
|
||
Эталонный проект — мех-паук в `examples/`; в движке нет кода под конкретную
|
||
конструкцию.
|
||
|
||
## Состояние
|
||
|
||
| Этап | Что готово |
|
||
|---|---|
|
||
| M0 | workspace, правила кода (`tools/limits`), pre-commit, CI |
|
||
| M1 | ядро: СИ-единицы, целое время, детерминированная математика, планировщик, снимки |
|
||
| M2 | в работе: своя векторная математика, RNG, один шарнир с мотором и датчиками |
|
||
|
||
План и критерии готовности: [TODO.md](TODO.md).
|
||
|
||
## Сборка
|
||
|
||
```sh
|
||
cargo test --workspace # тесты
|
||
cargo run -p fabrilis-limits # проверка правил репозитория
|
||
cargo clippy --workspace --all-targets -- -D warnings
|
||
```
|
||
|
||
Версия компилятора зафиксирована в `rust-toolchain.toml`. Правила кода
|
||
проверяются в `build.rs` каждого crate'а, поэтому их нарушение ломает сборку.
|
||
|
||
## Документация
|
||
|
||
Начать с [docs/README.md](docs/README.md): архитектура, решения, режимы, детерминизм,
|
||
связь подсистем, тесты и зависимости.
|
||
|
||
## Лицензия
|
||
|
||
MIT, см. [LICENSE](LICENSE). Код можно брать и менять, но нужно сохранять
|
||
упоминание автора: Copyright (c) 2026 loki.
|