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.
42 lines
3.6 KiB
Markdown
42 lines
3.6 KiB
Markdown
# 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 — один шарнир: своя векторная
|
||
математика, seeded RNG, минимальная физика с мотором и датчиками.
|