QuizPlease/Agent/TASK.md

Задача: Unity / C# Middle

Кратко

Нужно реализовать загрузочный поток приложения в Unity через собственную state machine.

Проект создается с нуля. Базовые абстракции, сервисы, View/ViewModel и state machine нужно написать самостоятельно, потому что это часть оценки.

Ориентировочное время выполнения: около 1,5 часов. Если ушло больше или меньше времени, это нормально, но нужно честно указать это в документации.

Технические требования

• Unity 2022 LTS+.
• C#.
• Использовать VContainer, UniTask и UniRx.
• Опционально можно использовать Odin Inspector и DOTween.

Архитектурные требования

Reactive

Использовать UniRx для реактивных значений и подписок.

Если дополнительно понадобится собственная обертка ReactiveValue<T>, она должна поддерживать сигнатуру подписки:

IDisposable Subscribe(Action<T> cb, bool invokeImmediately = true)

Требования:

• каждая подписка должна корректно диспозиться;
• нельзя использовать голые event Action без отписки.

Async

Все async-операции должны быть реализованы только через UniTask и CancellationToken.

Запрещено использовать async void, кроме Unity-колбэков.

Dependency Injection

Использовать VContainer.

Все сервисы регистрируются как интерфейсы:

builder.Register<Impl>(Lifetime.Singleton).As<IInterface>();

Запрещено использовать:

• FindObjectOfType;
• Singleton.Instance;
• static-хранилища состояния.

UI

Нужно сделать базовую пару View/ViewModel:

public class UIView : MonoBehaviour
{
    public virtual void Initialize() { }
    public virtual void Release() { }
}

public class UIView<TVm> : UIView where TVm : IUIViewModel
{
}

Требования:

• ViewModel должна быть обычным C#-классом, не MonoBehaviour;
• логика находится во ViewModel;
• View хранит только Unity-ссылки и биндинги.

Services

Сервисы должны иметь асинхронный жизненный цикл:

UniTask InitializeAsync(CancellationToken ct)
UniTask ReleaseAsync(CancellationToken ct)

Требования:

• сервисы оформляются как Service : IService;
• фоновые циклы стартуют в InitializeAsync;
• фоновые циклы останавливаются через CancellationTokenSource.Cancel() в ReleaseAsync.

Config

Конфиги должны быть ScriptableObject с суффиксом *Settings.

Регистрация в LifetimeScope:

[SerializeField] private SomeSettings _settings;

protected override void Configure(IContainerBuilder builder)
{
    builder.RegisterInstance(_settings);
}

Задача: Boot Flow

Реализовать загрузочный поток приложения через собственную state machine из трех состояний.

1. База state machine

Нужно реализовать собственные абстракции:

• IState;
• IStatesController<TEnum>;
• StatesController<TEnum>.

В StatesController<TEnum> должен быть метод:

UniTask EnterStateAsync(TEnum code, CancellationToken ct)

Контракт перехода между состояниями:

await currentState.ExitAsync(ct);
await newState.EnterAsync(ct);

Требования:

• CancellationToken пробрасывается через всю цепочку вызовов;
• CancellationToken должен реально отменять внутренние ожидания;
• повторные входы в состояния не должны ломать UI и подписки.

2. Состояния

Нужно реализовать три состояния.

SplashState

Поведение:

• показывает лого;
• ждет 1 секунду через UniTask.Delay(..., ct);
• переходит в следующее состояние.

LoadState

Поведение:

• имитирует загрузку;
• выполняет 5 шагов по 200 мс;
• хранит ReactiveValue<float> Progress со значением от 0 до 1;
• обновляет Progress после каждого шага.

MenuState

Поведение:

• показывает MenuUIView;
• содержит одну кнопку Restart;
• по клику на Restart возвращает приложение в LoadState.

3. UI

Нужно реализовать LoadingUIView.

Требования:

• LoadingUIView подписывается на LoadState.Progress;
• прогресс-бар обновляется через DOTween или ручной Lerp;
• при ExitAsync все подписки должны корректно очищаться;
• при повторном входе в LoadState не должно быть NullReferenceException и дублирующихся подписок.

Что сдать

• GitHub-репозиторий или zip-архив без Library/, Temp/, obj/.
• README.md с инструкцией запуска.
• В README.md добавить 5-10 строк о том, что было бы доделано при наличии еще 2 часов.
• SELF_NOTES.md с описанием собственных решений.
• AI_LOG.md с описанием использования AI. Если AI не использовался, нужно написать почему.

SELF_NOTES.md

В SELF_NOTES.md нужно своими словами описать:

• какие идеи были рассмотрены и почему выбрана текущая реализация;
• какие места в коде были придуманы и написаны самостоятельно, без AI;
• что в коде понятно до последней строки;
• что осталось непонятным или воспринимается как магия;
• ответы на 2-3 ключевых вопроса вида: почему здесь сделано именно так.

AI_LOG.md

В AI_LOG.md нужно описать:

• какие промпты использовались;
• где AI ошибся;
• что было переписано руками;
• если AI не использовался, почему было принято такое решение.

Что не требуется

Не нужно тратить время на:

• красивый арт;
• сложные анимации;
• звук;
• мобильную сборку.

Главное: архитектурные слои, стиль кода, корректная работа жизненного цикла и понимание собственных решений.