📘TIL - RTS UI Selection 확장과 Command Pipeline 구조 연결

문제

기존 UI 구조에서 Selection과 Command는 각각 안정화되어 있었지만
실제 RTS 흐름 기준에서는 다음 문제가 남아 있었다.

---

구조적 한계

구분	문제
Selection	Multi Selection 표현 가능하지만 실행과 연결되지 않음
Command	UI 표시까지만 가능, 실제 실행 구조 없음
UI 흐름	상태 표현과 행동 실행이 분리되어 있음
구조 연결	UI → Gameplay로 이어지는 경로 부재

---

기존 상태 흐름

Selection
→ ViewModel
→ SelectionPanel 표시

CommandPanel
→ ViewModel 표시만 수행

---

분석

핵심 문제는 단순 기능이 아니라
“상태 → 실행 → 상태 갱신” 흐름이 끊겨 있다는 점이었다.

---

1. Selection은 확장됐지만 실행으로 이어지지 않음

어제 단계에서 Selection은 다음 구조로 확장되었다.

UENUM()
enum class ESelectionViewMode : uint8
{
    None,
    Single,
    Multi
};

USTRUCT()
struct FSelectionViewModel
{
    GENERATED_BODY()

    ESelectionViewMode ViewMode;

    // Single
    FName SelectionId;

    // Multi
    int32 TotalSelectedCount;
    TArray<FSelectionSummaryItemViewModel> SummaryItems;
};

하지만 이 상태에서는:

Command 클릭 → 실행 경로 없음

---

2. 입력 처리 구조 부재

기존 방식:

// ❌ 잘못된 구조 (예시)
void UCommandWidget::OnClick()
{
    // 직접 실행 or 아무 처리 없음
}

문제:

• 입력 경로 통일 안됨
• 서버 연결 불가
• 유지보수 어려움

---

해결

---

1. Command 실행 흐름 연결

---

전체 흐름

Selection 상태
→ Command 생성
→ 입력 발생
→ 실행
→ 상태 변경
→ UI 갱신

---

실제 연결 코드

---

1-1. UI → PlayerController

// CommandSlotWidget.cpp
void URTSCommandSlotWidget::OnClicked()
{
    if (OwningPC)
    {
        OwningPC->ExecuteCommandById(CommandId);
    }
}

---

1-2. 단일 진입점

// PlayerController.cpp
bool ARTSUIPrototypePlayerController::ExecuteCommandById(FName CommandId)
{
    if (!CommandDispatcher || CommandId.IsNone())
    {
        return false;
    }

    return CommandDispatcher->DispatchCommandById(CommandId);
}

---

1-3. Dispatcher 계층

// CommandDispatcher.cpp
bool URTSCommandDispatcher::DispatchCommandById(FName CommandId)
{
    // 1. UI Context 처리
    if (OwnerPC->HandleLocalOnlyCommand(CommandId))
    {
        return true;
    }

    // 2. 서버 실행 요청 생성
    FRTSCommandRequest Request = BuildCommandRequest(CommandId);

    return OwnerPC->IssueCommandRequest(Request);
}

---

1-4. CommandRequest 생성

FRTSCommandRequest URTSCommandDispatcher::BuildCommandRequest(FName CommandId)
{
    FRTSCommandRequest Request;

    Request.CommandId = CommandId;
    Request.SelectedEntityIds = SelectionProvider->GetSelectedIds();
    Request.TargetLocation = OwnerPC->GetCachedMouseHitLocation();

    return Request;
}

---

### 1-5. Server RPC 진입

UFUNCTION(Server, Reliable)
void ARTSUIPrototypePlayerController::ServerIssueCommand(
    const FRTSCommandRequest& Request)
{
    OrderService->ExecuteCommandOnServer(Request);
}

---

1-6. 실제 실행 계층

// OrderService.cpp
bool URTSOrderService::ExecuteCommandOnServer(
    const FRTSCommandRequest& Request)
{
    if (Request.CommandId == "Move")
    {
        ExecuteMove(Request);
    }
    else if (Request.CommandId == "Attack")
    {
        ExecuteAttack(Request);
    }

    return true;
}

---

2. Multi Selection + Command 연결

---

교집합 계산

TArray<FName> URTSUIHUDCoordinator::BuildCommonCommandIds()
{
    TArray<TArray<FName>> AllCommands;

    for (const FName& EntityId : SelectedEntities)
    {
        AllCommands.Add(CommandTable->GetCommands(EntityId));
    }

    return Intersect(AllCommands);
}

---

결과 예시

Marine: Move, Attack, Stop
SCV:    Move, Attack, Stop, Build

→ 결과
Move, Attack, Stop

---

3. Context 시스템

---

Provider 내부

void USelectionProvider::PushContext(FName NewContext)
{
    ContextStack.Push(CurrentContext);
    CurrentContext = NewContext;
}

void USelectionProvider::PopContext()
{
    if (ContextStack.Num() > 0)
    {
        CurrentContext = ContextStack.Pop();
    }
}

---

Command 처리

bool APlayerController::HandleLocalOnlyCommand(FName CommandId)
{
    if (CommandId == "BuildMenu")
    {
        SelectionProvider->PushContext("BuildMenu");
        return true;
    }

    if (CommandId == "Back")
    {
        SelectionProvider->PopContext();
        return true;
    }

    return false;
}

---

4. Provider → UI 갱신 흐름

---

상태 변경 후 흐름

// Provider 내부
void USelectionProvider::NotifySelectionChanged()
{
    OnSelectionChanged.Broadcast();
}

---

Coordinator

void URTSUIHUDCoordinator::Initialize(...)
{
    SelectionProvider->OnSelectionChanged.AddUObject(
        this,
        &URTSUIHUDCoordinator::RefreshAll
    );
}

---

UI 갱신

void URTSUIHUDCoordinator::RefreshAll()
{
    RefreshSelectionPanel();
    RefreshCommandPanel();
}

---

5. 전체 구조 요약

---

계층 구조

UI (Widget)
→ PlayerController
→ CommandDispatcher
→ Server RPC
→ OrderService
→ Provider
→ Coordinator
→ UI

---

코드 기준 흐름

// 1. 클릭
Widget → ExecuteCommandById

// 2. 분기
Dispatcher → Local or Server

// 3. 실행
Server → OrderService

// 4. 상태 변경
Provider

// 5. UI 갱신
Coordinator → Widget

---

결과

---

구조 변화

항목	변경
Selection	Single → Multi 확장
Command	표시 → 실행 가능
입력	단일 진입점
상태 관리	Provider 집중
실행 구조	Dispatcher 분리

---

핵심 성과

• Selection → Command → 실행 흐름 완성
• UI와 Gameplay 완전 분리
• 멀티플레이 대응 가능 구조 확보

---

종합

---

핵심 흐름

Selection 확장
→ Command 생성
→ ExecuteCommandById
→ Dispatcher
→ Server
→ 상태 변경
→ UI 갱신

---

오늘의 정리

• Multi Selection 구조를 실제 Command 실행까지 연결했다
• 입력 → 실행 → 상태 갱신 → UI 반영 흐름이 완성됐다
• UI는 끝까지 데이터 소비만 하고, 실행과 상태는 외부 계층에서 처리하도록 유지했다