SaveSystem (Core)

Namespace: Vortex.Core.SaveSystem.Bus, Vortex.Core.SaveSystem.Abstraction, Vortex.Core.SaveSystem.Model Сборка: ru.vortex.save Платформа: .NET Standard 2.1+

---

Назначение

Система сохранения и загрузки данных. Предоставляет шину SaveController для управления процессами save/load, реестр ISaveable-модулей и асинхронный сбор/раздачу данных. Данные хранятся как Dictionary<string, Dictionary<string, string>> — иерархия модуль → ключ → значение (строки).

Возможности:

• SaveController — шина: Save(), Load(), Remove(), GetIndex()
• ISaveable — интерфейс для модулей, данные которых подлежат сохранению
• Асинхронный сбор данных при Save, асинхронная раздача при Load (UniTask)
• SaveProcessData — двухуровневый прогресс (глобальный + модульный)
• События: OnSaveStart, OnSaveComplete, OnLoadStart, OnLoadComplete, OnRemove
• SaveSummary — метаданные сохранения (имя, дата, XML-сериализуемый)
• Автогенерация GUID для новых сохранений

Вне ответственности:

• Физическое хранение (PlayerPrefs, файлы) — Unity-слой
• Сжатие/шифрование данных — Unity-слой (драйвер)
• UI-отображение прогресса — Unity-слой

---

Зависимости

---

Архитектура

SaveController : SystemController<SaveController, IDriver>
  ├── SaveDataIndex: Dictionary<string, Dictionary<string, string>>
  │    └── модуль (SaveId) → { ключ → значение }
  ├── Saveables: HashSet<ISaveable>
  ├── State: SaveControllerStates
  ├── ProcessData: SaveProcessData
  │
  ├── Save(name, guid?) → UniTask<string>
  │    ├── State = Saving, OnSaveStart
  │    ├── foreach ISaveable → GetSaveData() → SaveDataIndex
  │    ├── guid ??= Crypto.GetNewGuid()
  │    ├── Driver.Save(name, guid)
  │    └── State = Idle, OnSaveComplete
  │
  ├── Load(guid) → UniTask
  │    ├── State = Loading, OnLoadStart
  │    ├── Driver.Load(guid) → заполняет SaveDataIndex
  │    ├── foreach ISaveable → OnLoad()
  │    └── State = Idle, OnLoadComplete
  │
  ├── Remove(guid) → Driver.Remove(guid), OnRemove
  ├── GetData(id) → Dictionary<string, string>
  ├── GetIndex() → Driver.GetIndex()
  ├── Register(ISaveable) / UnRegister(ISaveable)
  └── GetProcessData() → SaveProcessData

ISaveable
  ├── GetSaveId() → string
  ├── GetSaveData(CancellationToken) → UniTask<Dictionary<string, string>>
  ├── GetProcessInfo() → ProcessData
  └── OnLoad(CancellationToken) → UniTask

IDriver : ISystemDriver
  ├── Save(name, guid)
  ├── Load(guid)
  ├── Remove(guid)
  ├── SetIndexLink(Dictionary<string, Dictionary<string, string>>)
  ├── GetIndex() → Dictionary<string, SaveSummary>
  └── GetNumberLastSave() → int

Формат данных

SaveDataIndex: Dictionary<string, Dictionary<string, string>>
  └── "ModuleA" → { "key1" → "json1", "key2" → "json2" }
  └── "ModuleB" → { "key1" → "json1" }

Каждый ISaveable возвращает свой GetSaveId() (идентификатор модуля) и Dictionary<string, string> (ключ → JSON-строка). SaveController агрегирует все модули в SaveDataIndex.

Жизненный цикл Save

1. Проверка замка (State == Saving → возврат null)
2. State = Saving, OnSaveStart
3. SaveDataIndex.Clear()
4. Для каждого ISaveable — await GetSaveData(token) → добавление в SaveDataIndex
5. Генерация GUID если не передан
6. Driver.Save(name, guid) — физическое сохранение
7. State = Idle, OnSaveComplete

Жизненный цикл Load

1. Проверка замка (State == Loading → return)
2. State = Loading, OnLoadStart
3. Driver.Load(guid) — драйвер заполняет SaveDataIndex
4. Для каждого ISaveable — await OnLoad(token) (модуль читает из SaveController.GetData())
5. State = Idle, OnLoadComplete

SaveProcessData — двухуровневый прогресс

Структуры данных

---

Контракт

Вход

• ISaveable-модули регистрируются через Register()
• Save(name, guid?) / Load(guid) / Remove(guid) запускают процессы

Выход

• GetData(id) — данные модуля после загрузки
• GetIndex() — все существующие сохранения (Dictionary<string, SaveSummary>)
• События: OnSaveStart, OnSaveComplete, OnLoadStart, OnLoadComplete, OnRemove

API

Ограничения

---

Использование

Реализация ISaveable

public class InventoryController : ISaveable
{
    private ProcessData _processData = new("Inventory");

    public string GetSaveId() => "Inventory";

    public async UniTask<Dictionary<string, string>> GetSaveData(CancellationToken ct)
    {
        var data = new Dictionary<string, string>();
        data["items"] = JsonUtility.ToJson(items);
        data["gold"] = gold.ToString();
        return data;
    }

    public ProcessData GetProcessInfo() => _processData;

    public async UniTask OnLoad(CancellationToken ct)
    {
        var data = SaveController.GetData("Inventory");
        if (data.TryGetValue("items", out var json))
            items = JsonUtility.FromJson<ItemList>(json);
        if (data.TryGetValue("gold", out var g))
            gold = int.Parse(g);
    }
}

Сохранение / загрузка

// Регистрация
SaveController.Register(inventoryController);

// Сохранение (новый GUID)
SaveController.Save("Quick Save");

// Сохранение (перезапись)
SaveController.Save("Quick Save", existingGuid);

// Загрузка
SaveController.Load(guid);

// Список сохранений
var saves = SaveController.GetIndex();
foreach (var (guid, summary) in saves)
    Debug.Log($"{summary.Name} — {summary.Date}");

// Удаление
SaveController.Remove(guid);

---

Граничные случаи