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 878d144b77
221 changed files with 5316 additions and 0 deletions

20
docs/STORAGE.md Normal file
View file

@ -0,0 +1,20 @@
# Сохранения
Программа и данные разделены. Данные лежат в **папке проекта**, которую можно
целиком положить в git. Личные настройки лежат отдельно.
| Что | Формат | Заметка |
|---|---|---|
| Библиотека (меши, материалы, детали) | файлы + RON | переиспользуется между проектами |
| Конструкция (детали, шарниры, проводка, схемы, ссылка на прошивку) | читаемый RON | версия схемы + миграции |
| Прошивки, образы Linux | бинарники, ссылка по хешу | blob-хранилище |
| Мир | seed + параметры + дельта правок | остальное генерируется |
| Снимок симуляции | бинарный, сжатый | привязан к версии движка и хешу конструкции |
| Сценарий опыта | RON + бинарник результатов | режим, конструкция, мир, скрипт, графики |
| Настройки, профиль устройства | XDG (`~/.config`, `~/.local/share`) | у каждого свои |
## Правила
- Каждый файл несёт `format_version`; `storage::migrate` умеет переводить вперёд.
- Снимки не гарантируют совместимость между версиями; для долгого хранения
используем сценарий (seed + входы), он воспроизводится детерминированно.
- Крупные бинарные файлы хранятся один раз по хешу содержимого.