Скрипты и код

В этом разделе описаны все C# скрипты проекта, их назначение и взаимосвязи.

Полный список скриптов

Common/Extensions

Common/Utilities

Gameplay/Common

Gameplay/Features

Gameplay/StaticData

Infrastructure

Infrastructure/Events

Infrastructure/Factories

Infrastructure/AssetManagement

Infrastructure/Input

Infrastructure/UI

Классификация по категориям

Менеджеры (управляющие системы)

• Bootstrap — инициализация.
• World — управление игровым миром.
• ResourceSpawner — спавн ресурсов.
• TaskManagement — диспетчеризация задач.
• BuilderManagement — управление строительством.

Модели данных

• Area, Rectangle — геометрические примитивы.
• ResourceSpendRequest — DTO для траты ресурсов.
• ResourceWeight — вес ресурса.
• Structure — абстракция строения.

UI (Пользовательский интерфейс)

• Все презентеры в Infrastructure/UI/.
• StorageView, ResourceManagementView — Unity UI компоненты.

Утилиты

• Все классы в Common/Utilities и Common/Extensions.
• ThrowIf, PriorityQueue, Utils.

Сервисы

• IntelligentEventAggregator — система событий.
• AssetProvider — загрузка ресурсов.
• StaticDataProvider — доступ к конфигурациям.
• InputReader — обработка ввода.

Жизненный цикл ключевых объектов

sequenceDiagram
    participant B as Bootstrap
    participant E as EventAggregator
    participant W as World
    participant BS as BaseStructure
    participant R as ResourceSpawner
    participant Wo as Worker
    participant T as TaskManagement

    B->>E: Создание и регистрация
    B->>W: Создание мира
    B->>R: Запуск спавна ресурсов
    B->>BS: Инициализация базы
    BS->>Wo: Создание начальных рабочих
    loop Каждый кадр
        R->>R: Проверка интервала спавна
        R->>W: Создание ресурса
        BS->>BS: Сканирование области
        BS->>T: Назначение задач
        T->>Wo: Выдача задачи рабочему
        Wo->>Wo: Движение к ресурсу
        Wo->>Wo: Сбор ресурса
        Wo->>BS: Доставка ресурса
        BS->>E: Публикация ResourceCollectedEvent
    end

Система обработки ввода

Ввод обрабатывается через Unity Input System. Класс InputReader реализует интерфейс IInputReader и предоставляет события:

• OnClick — при клике левой кнопкой мыши.
• OnRightClick — при клике правой кнопкой.
• OnDrag — при перемещении мыши с зажатой кнопкой.
• OnZoom — при прокрутке колёсика.

Пример использования:

public class SomeController : MonoBehaviour
{
    [SerializeField] private IInputReader _inputReader;

    private void OnEnable()
    {
        _inputReader.OnClick += HandleClick;
    }

    private void OnDisable()
    {
        _inputReader.OnClick -= HandleClick;
    }

    private void HandleClick(Vector2 screenPosition)
    {
        // Конвертируем screenPosition в мировые координаты
        // и выполняем действие
    }
}

Система событий

События реализованы через IntelligentEventAggregator, который поддерживает:

• Типизированные события (наследники IEvent).
• Фильтры (IEventFilter) для выборочной доставки.
• Условия подписки (ISubscribeCondition) для динамического управления подписками.
• Weak‑ссылки на подписчиков, чтобы избежать утечек памяти.

Пример события:

public class ResourceCollectedEvent : IEvent
{
    public ResourceType Type { get; }
    public int Amount { get; }

    public ResourceCollectedEvent(ResourceType type, int amount)
    {
        Type = type;
        Amount = amount;
    }
}

Подписка и публикация:

// Подписка
_eventAggregator.Subscribe<ResourceCollectedEvent>(OnResourceCollected);

// Публикация
_eventAggregator.Publish(new ResourceCollectedEvent(ResourceType.Stone, 1));

// Обработчик
private void OnResourceCollected(ResourceCollectedEvent evt)
{
    Debug.Log($"Собран ресурс {evt.Type} в количестве {evt.Amount}");
}

Корутины и асинхронные операции

Для работы с корутинами используется интерфейс ICoroutineRunner, который позволяет запускать корутины вне MonoBehaviour.

Пример:

public class SomeService
{
    private readonly ICoroutineRunner _coroutineRunner;

    public SomeService(ICoroutineRunner coroutineRunner)
    {
        _coroutineRunner = coroutineRunner;
    }

    public void StartCounting()
    {
        _coroutineRunner.StartCoroutine(CountCoroutine());
    }

    private IEnumerator CountCoroutine()
    {
        for (int i = 0; i < 10; i++)
        {
            Debug.Log(i);
            yield return new WaitForSeconds(1);
        }
    }
}

Расширение CoroutineExtensions добавляет метод StartCoroutineSafe, который автоматически останавливает корутину при уничтожении объекта.

Рекомендации по добавлению нового кода

1. Соблюдайте слоистую архитектуру: инфраструктурный код — в Infrastructure/, игровая логика — в Gameplay/, общие утилиты — в Common/.
2. Используйте события для связи между системами, а не прямые вызовы.
3. Проверяйте предусловия с помощью ThrowIf.
4. Документируйте публичные методы XML‑комментариями.
5. Следите за длиной файлов — не более 200 строк (правило проекта).