fabrilis/docs/PLUGINS.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

1.6 KiB
Raw Blame History

Плагины деталей

Деталь это данные (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.