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

1.8 KiB
Raw Permalink Blame History

Сохранения

Программа и данные разделены. Данные лежат в папке проекта, которую можно целиком положить в git. Личные настройки лежат отдельно.

Что Формат Заметка
Библиотека (меши, материалы, детали) файлы + RON переиспользуется между проектами
Конструкция (детали, шарниры, проводка, схемы, ссылка на прошивку) читаемый RON версия схемы + миграции
Прошивки, образы Linux бинарники, ссылка по хешу blob-хранилище
Мир seed + параметры + дельта правок остальное генерируется
Снимок симуляции бинарный, сжатый привязан к версии движка и хешу конструкции
Сценарий опыта RON + бинарник результатов режим, конструкция, мир, скрипт, графики
Настройки, профиль устройства XDG (~/.config, ~/.local/share) у каждого свои

Правила

  • Каждый файл несёт format_version; storage::migrate умеет переводить вперёд.
  • Снимки не гарантируют совместимость между версиями; для долгого хранения используем сценарий (seed + входы), он воспроизводится детерминированно.
  • Крупные бинарные файлы хранятся один раз по хешу содержимого.