fabrilis/docs
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
..
ARCHITECTURE.md Finish M4: cart, log facade, idle diagnostics and terrain LOD 2026-11-17 14:32:52 +01:00
CLI.md Add design persistence, world rendering, metrics overlay and logs 2026-11-16 23:40:39 +01:00
CODE_RULES.md Add design persistence, world rendering, metrics overlay and logs 2026-11-16 23:40:39 +01:00
COORDINATES.md Initial commit: Fabrilis docs, rules and deterministic core 2026-11-16 23:06:29 +01:00
COUPLING.md Initial commit: Fabrilis docs, rules and deterministic core 2026-11-16 23:06:29 +01:00
DECISIONS.md Add design persistence, world rendering, metrics overlay and logs 2026-11-16 23:40:39 +01:00
DEPENDENCIES.md Initial commit: Fabrilis docs, rules and deterministic core 2026-11-16 23:06:29 +01:00
DETERMINISM.md Add design persistence, world rendering, metrics overlay and logs 2026-11-16 23:40:39 +01:00
ELECTRONICS.md Initial commit: Fabrilis docs, rules and deterministic core 2026-11-16 23:06:29 +01:00
LOGGING.md Finish M4: cart, log facade, idle diagnostics and terrain LOD 2026-11-17 14:32:52 +01:00
MODES.md Initial commit: Fabrilis docs, rules and deterministic core 2026-11-16 23:06:29 +01:00
NETWORK.md Add design persistence, world rendering, metrics overlay and logs 2026-11-16 23:40:39 +01:00
PHYSICS_SCOPE.md Initial commit: Fabrilis docs, rules and deterministic core 2026-11-16 23:06:29 +01:00
PLUGINS.md Initial commit: Fabrilis docs, rules and deterministic core 2026-11-16 23:06:29 +01:00
README.md Finish M4: cart, log facade, idle diagnostics and terrain LOD 2026-11-17 14:32:52 +01:00
REFERENCES.md Initial commit: Fabrilis docs, rules and deterministic core 2026-11-16 23:06:29 +01:00
SCENARIOS.md Initial commit: Fabrilis docs, rules and deterministic core 2026-11-16 23:06:29 +01:00
STORAGE.md Initial commit: Fabrilis docs, rules and deterministic core 2026-11-16 23:06:29 +01:00
TESTING.md Add design persistence, world rendering, metrics overlay and logs 2026-11-16 23:40:39 +01:00
UI.md Finish M4: cart, log facade, idle diagnostics and terrain LOD 2026-11-17 14:32:52 +01:00
VALIDATION.md Initial commit: Fabrilis docs, rules and deterministic core 2026-11-16 23:06:29 +01:00

Fabrilis — документация

Платформа полного проектирования механизмов: подробная физика + электроника + код + управление. Цель — спроектировать любую конструкцию целиком (механика, материалы, проводка, плата, прошивка), проверить её на сценариях работы, стабилизацию, отказы, нагрузки, тепло и окружение, а затем собрать в реальности.

Мех-паук — первый эталонный проект (examples/), а не часть движка: в движке нет кода под конкретную конструкцию.

Документ О чём
ARCHITECTURE.md crate'ы, слои, поток данных, бюджет производительности
DECISIONS.md принятые решения и открытые вопросы
MODES.md режимы Bench / Lab / World, Fidelity, время, события
UI.md свой UI: модель, текст, event-driven redraw, что берём из ShapeUI
LOGGING.md оверлей метрик, CSV-лог, dev-режим, настройки
NETWORK.md сетевой режим: сервер физики, клиенты-наблюдатели
CLI.md headless CLI: прогоны, развёртки, сервер, среда для обучения
PHYSICS_SCOPE.md механика, FEM, трение, тепло, вентиляция, проводка, виды
SCENARIOS.md сценарии, стабилизация, отказы, развёртки, метрики
ELECTRONICS.md эмуляция CPU/SoC, аналоговая схема, мост
COUPLING.md связь подсистем: классы связей, события, откат шага
DETERMINISM.md уровни D1/D2/D3 и правила одинакового результата
COORDINATES.md системы координат, единицы, оси
STORAGE.md проекты, конструкции, снимки, миры
TESTING.md стратегия тестов
VALIDATION.md verification, validation, qualification
DEPENDENCIES.md библиотеки: что берём, что пишем сами, сколько весят
PLUGINS.md деталь как данные и плагин, правила совместимости
REFERENCES.md что читать и у кого подсматривать
CODE_RULES.md проверяемые правила кода (лимиты, тесты отдельно, слои)

Лицензия: MIT.

План работ: ../TODO.md.

Название: Fabrilis (лат. fabrilis, «относящийся к мастеру, ремесленнику»). Автор: loki.

Статус: готовы M0 (скелет, правила), M1 (ядро: единицы, время, математика, планировщик, Fidelity, снимки), M2 (векторы, RNG, шарнир с мотором, датчики, PD-контур), M3 (импорт STL/OBJ, массы и инерция, материалы, RON-сцены, blob-store) и M4 (рельеф и chunked LOD, wgpu-рендер, тележка на шарнирах, оверлей и логи). Дальше M5 — эталонный паук: конструкция, приводы, контакт стоп с землёй и устойчивость.