fabrilis/docs/README.md
loki5512344 79928b645b
Initial commit: Fabrilis docs, rules and deterministic core
Docs (architecture, decisions, coupling, determinism, UI, references), code rules enforced by tools/limits, deterministic core with units, time, math, sched, snapshot, vec and rng, plus smoke tests. ref/ stays out of git.
2026-11-16 23:06:29 +01:00

3.3 KiB
Raw Blame History

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

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

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

Документ О чём
ARCHITECTURE.md crate'ы, слои, поток данных, бюджет производительности
DECISIONS.md принятые решения и открытые вопросы
MODES.md режимы Bench / Lab / World, Fidelity, время, события
UI.md свой UI: модель, текст, event-driven redraw, что берём из ShapeUI
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, минимальная физика с мотором и датчиками.