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.
This commit is contained in:
commit
79928b645b
222 changed files with 5335 additions and 0 deletions
22
docs/PLUGINS.md
Normal file
22
docs/PLUGINS.md
Normal file
|
|
@ -0,0 +1,22 @@
|
|||
# Плагины деталей
|
||||
|
||||
Деталь это данные (RON) плюс при необходимости плагин (Rust-код).
|
||||
|
||||
## Правила до версии 1.0
|
||||
- Только статическая регистрация через Rust API при сборке. Динамические библиотеки
|
||||
не поддерживаем.
|
||||
- Идентификатор `автор.имя` и версия semver. Зависимости от других плагинов и от
|
||||
версии ядра объявляются явно; несовместимость это ошибка загрузки.
|
||||
- Плагин получает доступ только к трейтам подсистем (порты: механический,
|
||||
электрический, тепловой), а не к их внутренним данным.
|
||||
- Состояние плагина сериализуется через serde и входит в подснимок; после загрузки
|
||||
снимка плагин восстанавливается из него.
|
||||
- Плагин детерминирован и подчиняется правилам DETERMINISM.md.
|
||||
|
||||
## Жизненный цикл
|
||||
`register` → `validate` (данные и версии) → `instantiate` (на сцену) → `step` (по
|
||||
периоду) → `snapshot` и `restore` → `drop`.
|
||||
|
||||
## Стабильность
|
||||
Проект публичный, но до версии 0.6.0 API плагинов может ломаться без предупреждения
|
||||
(D26). К 0.6.0 API стабилизируется и дальше подчиняется semver.
|
||||
Loading…
Add table
Add a link
Reference in a new issue