fabrilis/README.md
loki5512344 190ef9cc4b Add design persistence, world rendering, metrics overlay and logs
M3: STL/OBJ import with mesh validation, mass/COM/inertia, material database, RON scene with content-addressed blobs and v0->v1 migration. M4: deterministic heightmap terrain, trimesh colliders, wgpu renderer with instancing and depth, winit app with 1 kHz physics, fly camera, on-screen metrics overlay and per-frame CSV/dev logs. Docs: UI, logging, network and headless CLI plans.
2026-11-16 23:40:39 +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 |
| 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.