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:
commit
878d144b77
221 changed files with 5316 additions and 0 deletions
20
docs/STORAGE.md
Normal file
20
docs/STORAGE.md
Normal file
|
|
@ -0,0 +1,20 @@
|
|||
# Сохранения
|
||||
|
||||
Программа и данные разделены. Данные лежат в **папке проекта**, которую можно
|
||||
целиком положить в git. Личные настройки лежат отдельно.
|
||||
|
||||
| Что | Формат | Заметка |
|
||||
|---|---|---|
|
||||
| Библиотека (меши, материалы, детали) | файлы + RON | переиспользуется между проектами |
|
||||
| Конструкция (детали, шарниры, проводка, схемы, ссылка на прошивку) | читаемый RON | версия схемы + миграции |
|
||||
| Прошивки, образы Linux | бинарники, ссылка по хешу | blob-хранилище |
|
||||
| Мир | seed + параметры + дельта правок | остальное генерируется |
|
||||
| Снимок симуляции | бинарный, сжатый | привязан к версии движка и хешу конструкции |
|
||||
| Сценарий опыта | RON + бинарник результатов | режим, конструкция, мир, скрипт, графики |
|
||||
| Настройки, профиль устройства | XDG (`~/.config`, `~/.local/share`) | у каждого свои |
|
||||
|
||||
## Правила
|
||||
- Каждый файл несёт `format_version`; `storage::migrate` умеет переводить вперёд.
|
||||
- Снимки не гарантируют совместимость между версиями; для долгого хранения
|
||||
используем сценарий (seed + входы), он воспроизводится детерминированно.
|
||||
- Крупные бинарные файлы хранятся один раз по хешу содержимого.
|
||||
Loading…
Add table
Add a link
Reference in a new issue