fabrilis/docs/README.md
loki5512344 190ef9cc4b 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:40:39 +01:00

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