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

20 lines
1.8 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.

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