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

2.7 KiB
Raw Permalink Blame History

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.

Сборка

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/README.md: архитектура, решения, режимы, детерминизм, связь подсистем, тесты и зависимости.

Лицензия

MIT, см. LICENSE. Код можно брать и менять, но нужно сохранять упоминание автора: Copyright (c) 2026 loki.