fabrilis/README.md
loki5512344 1042269d7e
Finish M4: cart, log facade, idle diagnostics and terrain LOD
Add the core::log facade with five levels and a sink; migrate the app dev log and enable trace in --dev. Replace the dropped cubes with a four-wheel cart on revolute joints driven by velocity motors, add WASD controls, a golden trajectory and a slope test. Instrument idle frame spikes and throttle the window title. Add chunked terrain LOD with skirts (2368 vs 8192 triangles) while physics keeps the full mesh. Pin Rust 1.100.0; edition stays 2024.
2026-11-17 14:32:52 +01:00

50 lines
2.7 KiB
Markdown
Raw Permalink 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, шарнир с мотором, датчики, PD-контур |
| M3 | импорт STL/OBJ, массы и инерция, материалы, RON-сцены, blob-store |
| M4 | рельеф и chunked LOD, wgpu-рендер, тележка на шарнирах, оверлей и логи |
План и критерии готовности: [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'а, поэтому их нарушение ломает сборку.
## Управление
`WASD` — тележка (газ и поворот), стрелки — камера, `Q`/`E` — камера вниз/вверх,
`Shift` — ускоренная камера, левая кнопка мыши — обзор, `Escape` — выход.
Подробнее: [docs/UI.md](docs/UI.md).
## Документация
Начать с [docs/README.md](docs/README.md): архитектура, решения, режимы, детерминизм,
связь подсистем, тесты и зависимости.
## Лицензия
MIT, см. [LICENSE](LICENSE). Код можно брать и менять, но нужно сохранять
упоминание автора: Copyright (c) 2026 loki.