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.
22 lines
1.6 KiB
Markdown
22 lines
1.6 KiB
Markdown
# Плагины деталей
|
||
|
||
Деталь это данные (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.
|