MappedParametersSystem (Core)

Namespace: Vortex.Core.MappedParametersSystem.Bus, Vortex.Core.MappedParametersSystem.Base Сборка: ru.vortex.core.mappedparameters Платформа: .NET Standard 2.1+

---

Назначение

Система параметрических карт. Описывает граф зависимостей между именованными параметрами с направленными связями и стоимостями. Карта определяет структуру (какие параметры существуют и как связаны), модель — хранит конкретные значения.

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

• Граф параметров: базовые (корневые) и производные (с родителями)
• Связи (IParameterLink) с числовой стоимостью (Cost)
• Логика объединения стоимостей при нескольких родителях (And, Or, Sum)
• Получение массива GenericParameter[] для runtime-использования
• Создание и инициализация IMappedModel через шину ParameterMaps
• GUID карты — FullName типа модели

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

• Хранение карт (ScriptableObject-пресеты) — Unity-слой
• Inspector-редактирование, валидация, атрибуты — Unity-слой
• Интерпретация стоимости — контроллер прикладного уровня

---

Зависимости

---

Архитектура

ParameterMaps : SystemController<ParameterMaps, IDriverMappedParameters>
  ├── _parametersMaps: Dictionary<string, ParametersMap>
  ├── GetParameters<T>() → GenericParameter[]
  ├── GetParameters(Type) → GenericParameter[]
  ├── GetParameters(string fullName) → GenericParameter[]
  ├── GetModel<T>() → IMappedModel          ← Activator.CreateInstance + Init
  ├── GetModel(Type) → IMappedModel
  └── InitMap(IMappedModel) → void           ← инициализация существующего экземпляра

ParametersMap
  ├── Guid: string                           ← FullName типа модели
  ├── Parameters: IParameterMap[]
  ├── GetParameterMap(name) → IParameterMap
  └── GetParameters() → GenericParameter[]   ← новый массив при каждом вызове

GenericParameter [Serializable, POCO]
  ├── GenericParameter()         ← безпараметрический ctor (Name = "")
  ├── GenericParameter(string)   ← ctor с именем
  ├── Name: string
  ├── Value: int
  ├── SetValue(int) → OnUpdate event
  └── OnUpdate: Action

IParameterMap
  ├── Name: string
  ├── Parents: IParameterLink[]
  ├── Cost: int
  └── CostLogic: ParameterLinkCostLogic

IParameterLink
  ├── Parent: string                         ← имя родительского параметра
  └── Cost: int

IMappedModel
  ├── OnUpdate: Action
  ├── GetParameters() → string[]
  ├── GetValue(string) → int
  ├── GetParents(string) → IParameterLink[]
  ├── GetParameterAsContainer(string) → GenericParameter
  └── Init(ParametersMap)

IDriverMappedParameters : ISystemDriver
  └── SetIndex(Dictionary<string, ParametersMap>)

Карта vs Модель

ParametersMap — immutable описание графа. IMappedModel — mutable состояние, созданное по карте. Разделение позволяет создавать множество независимых экземпляров по одной схеме.

ParameterLinkCostLogic

Интерпретация Cost определяется прикладным контроллером: порог, множитель, очки прокачки и т.д.

GenericParameter — реактивность

SetValue(int) проверяет изменение значения. При Value != value обновляет и вызывает OnUpdate через ActionExt.Fire(). Повторная установка того же значения — no-op.

---

Контракт

Вход

• Драйвер (IDriverMappedParameters) получает ссылку на _parametersMaps через SetIndex()
• Драйвер заполняет словарь: ключ — FullName типа IMappedModel, значение — ParametersMap

Выход

• GetParameters<T>() — массив GenericParameter[] из карты (новые экземпляры при каждом вызове)
• GetModel<T>() — создаёт экземпляр T через Activator.CreateInstance, инициализирует картой
• InitMap(model) — инициализирует существующий экземпляр IMappedModel

API

Ограничения

---

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

Реализация модели данных

public class CharacterStats : IMappedModel
{
    public event Action OnUpdate;

    private Dictionary<string, GenericParameter> _parameters = new();
    private ParametersMap _map;

    public void Init(ParametersMap map)
    {
        _map = map;
        _parameters.Clear();
        foreach (var param in map.GetParameters())
        {
            param.OnUpdate += () => OnUpdate?.Invoke();
            _parameters[param.Name] = param;
        }
    }

    public string[] GetParameters() => _parameters.Keys.ToArray();
    public int GetValue(string name) => _parameters.TryGetValue(name, out var p) ? p.Value : 0;
    public GenericParameter GetParameterAsContainer(string name) => _parameters.GetValueOrDefault(name);
    public IParameterLink[] GetParents(string name) => _map?.GetParameterMap(name)?.Parents ?? Array.Empty<IParameterLink>();
}

Получение модели в runtime

// Новый экземпляр
var stats = ParameterMaps.GetModel<CharacterStats>() as CharacterStats;

// Инициализация существующего
var stats = new CharacterStats();
ParameterMaps.InitMap(stats);

// Работа с параметрами
var strength = stats.GetParameterAsContainer("Strength");
strength.OnUpdate += () => Console.WriteLine($"Strength: {strength.Value}");
strength.SetValue(10);

---

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