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:
Loki 2026-11-16 19:09:10 +01:00
commit 79928b645b
Signed by: boba
GPG key ID: 6CDE87BC9A778D97
222 changed files with 5335 additions and 0 deletions

22
docs/PLUGINS.md Normal file
View 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.