fabrilis/docs/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

45 lines
3.9 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 — документация
Платформа полного проектирования механизмов: подробная физика + электроника +
код + управление. Цель — спроектировать любую конструкцию целиком (механика,
материалы, проводка, плата, прошивка), проверить её на сценариях работы,
стабилизацию, отказы, нагрузки, тепло и окружение, а затем собрать в реальности.
Мех-паук — первый эталонный проект (`examples/`), а не часть движка: в движке
нет кода под конкретную конструкцию.
| Документ | О чём |
|---|---|
| [ARCHITECTURE.md](ARCHITECTURE.md) | crate'ы, слои, поток данных, бюджет производительности |
| [DECISIONS.md](DECISIONS.md) | принятые решения и открытые вопросы |
| [MODES.md](MODES.md) | режимы Bench / Lab / World, Fidelity, время, события |
| [UI.md](UI.md) | свой UI: модель, текст, event-driven redraw, что берём из ShapeUI |
| [LOGGING.md](LOGGING.md) | оверлей метрик, CSV-лог, dev-режим, настройки |
| [NETWORK.md](NETWORK.md) | сетевой режим: сервер физики, клиенты-наблюдатели |
| [CLI.md](CLI.md) | headless CLI: прогоны, развёртки, сервер, среда для обучения |
| [PHYSICS_SCOPE.md](PHYSICS_SCOPE.md) | механика, FEM, трение, тепло, вентиляция, проводка, виды |
| [SCENARIOS.md](SCENARIOS.md) | сценарии, стабилизация, отказы, развёртки, метрики |
| [ELECTRONICS.md](ELECTRONICS.md) | эмуляция CPU/SoC, аналоговая схема, мост |
| [COUPLING.md](COUPLING.md) | связь подсистем: классы связей, события, откат шага |
| [DETERMINISM.md](DETERMINISM.md) | уровни D1/D2/D3 и правила одинакового результата |
| [COORDINATES.md](COORDINATES.md) | системы координат, единицы, оси |
| [STORAGE.md](STORAGE.md) | проекты, конструкции, снимки, миры |
| [TESTING.md](TESTING.md) | стратегия тестов |
| [VALIDATION.md](VALIDATION.md) | verification, validation, qualification |
| [DEPENDENCIES.md](DEPENDENCIES.md) | библиотеки: что берём, что пишем сами, сколько весят |
| [PLUGINS.md](PLUGINS.md) | деталь как данные и плагин, правила совместимости |
| [REFERENCES.md](REFERENCES.md) | что читать и у кого подсматривать |
| [CODE_RULES.md](CODE_RULES.md) | проверяемые правила кода (лимиты, тесты отдельно, слои) |
Лицензия: [MIT](../LICENSE).
План работ: [../TODO.md](../TODO.md).
Название: Fabrilis (лат. fabrilis, «относящийся к мастеру, ремесленнику»). Автор: loki.
Статус: готовы M0 (скелет, правила), M1 (ядро: единицы, время, математика,
планировщик, Fidelity, снимки), M2 (векторы, RNG, шарнир с мотором, датчики,
PD-контур), M3 (импорт STL/OBJ, массы и инерция, материалы, RON-сцены,
blob-store) и M4 (рельеф и chunked LOD, wgpu-рендер, тележка на шарнирах,
оверлей и логи). Дальше M5 — эталонный паук: конструкция, приводы, контакт стоп
с землёй и устойчивость.