fabrilis/README.md
loki5512344 878d144b77 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.
2026-11-16 23:06:29 +01:00

42 lines
2.2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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.