fabrilis/docs/PLUGINS.md
loki5512344 878d144b77 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

22 lines
1.6 KiB
Markdown
Raw Permalink 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.

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