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

39 lines
3.3 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 |
| [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 (скелет, правила, CI) и M1 (ядро: единицы, время, математика,
планировщик, Fidelity, снимки). Дальше M2 — один шарнир: своя векторная
математика, seeded RNG, минимальная физика с мотором и датчиками.