fabrilis/docs
loki5512344 93075ab1fd
Some checks failed
ci / check (macos-latest) (push) Has been cancelled
ci / check (ubuntu-latest) (push) Has been cancelled
ci / check (windows-latest) (push) Has been cancelled
Add design persistence, world rendering, metrics overlay and logs
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.
2026-11-16 23:34:05 +01:00
..
ARCHITECTURE.md Initial commit: Fabrilis docs, rules and deterministic core 2026-11-16 23:06:29 +01:00
CLI.md Add design persistence, world rendering, metrics overlay and logs 2026-11-16 23:34:05 +01:00
CODE_RULES.md Add design persistence, world rendering, metrics overlay and logs 2026-11-16 23:34:05 +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:34:05 +01:00
DEPENDENCIES.md Initial commit: Fabrilis docs, rules and deterministic core 2026-11-16 23:06:29 +01:00
DETERMINISM.md Initial commit: Fabrilis docs, rules and deterministic core 2026-11-16 23:06:29 +01:00
ELECTRONICS.md Initial commit: Fabrilis docs, rules and deterministic core 2026-11-16 23:06:29 +01:00
LOGGING.md Add design persistence, world rendering, metrics overlay and logs 2026-11-16 23:34:05 +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:34:05 +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 Add design persistence, world rendering, metrics overlay and logs 2026-11-16 23:34:05 +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 Initial commit: Fabrilis docs, rules and deterministic core 2026-11-16 23:06:29 +01:00
UI.md Initial commit: Fabrilis docs, rules and deterministic core 2026-11-16 23:06:29 +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 (скелет, правила, CI) и M1 (ядро: единицы, время, математика, планировщик, Fidelity, снимки). Дальше M2 — один шарнир: своя векторная математика, seeded RNG, минимальная физика с мотором и датчиками.