📘TIL-Selection Multi 구조 확장 및 Command 교집합 처리 구현

문제

DataTable 기반 구조로 UI 아키텍처를 정리한 이후,
기본적인 Single Selection과 CommandPanel 동작은 안정적으로 동작했지만
다음과 같은 한계가 남아 있었다.

---

구조적 문제

구분	문제
SelectionPanel	단일 선택 기준으로만 설계되어 다중 선택 표현 불가
Multi Selection	선택된 유닛 목록을 표현할 구조 없음
CommandPanel	다중 선택 시 어떤 커맨드를 보여줄지 기준 부재
UI 상태	None / Single / Multi 상태 구분 없음
표현 방식	다중 선택 시 단순 텍스트 나열 수준

---

기존 상태

Selection
→ ViewModel (Single 기준)
→ SelectionPanel 출력

이 구조에서는:

• 다중 선택 시 정보 표현 불가
• CommandPanel은 단일 기준으로만 동작
• RTS UI에서 필수적인 그룹 선택 UX 부재

---

분석

문제의 핵심은 다음 두 가지였다.

---

1. Selection 상태가 단일 기준으로 고정되어 있음

기존 구조에서는 Selection이 항상 하나의 엔티티 기준으로 처리되었다.

SelectionId
→ DisplayName
→ TypeLabel
→ HP

하지만 실제 RTS에서는:

단일 선택 → 상세 정보
다중 선택 → 요약 정보 + 그룹 상태

즉, Selection 자체의 상태 모델이 부족한 상황이었다.

---

2. 다중 선택 시 Command 기준이 정의되지 않음

다중 선택에서 가장 중요한 것은:

선택된 모든 유닛이 공통으로 수행 가능한 행동만 표시

하지만 기존 구조에서는:

• 단일 Command 목록만 존재
• 다중 선택 기준 없음
• Provider가 임의로 커맨드 구성

즉, Command 표시 기준이 UI가 아니라 로직에 의존하는 구조였다.

---

3. UI가 상태에 따라 분기되지 않음

SelectionPanel은 항상 동일한 레이아웃을 사용했다.

Portrait + Name + HP

이 구조에서는:

• Multi 상태 표현 불가능
• Summary 구조 확장 불가

---

해결

핵심 방향은 다음 세 가지로 정리했다.

---

1. Selection 상태를 구조적으로 확장

SelectionViewModel에 상태 개념을 추가했다.

ESelectionViewMode
- None
- Single
- Multi

추가된 데이터:

항목	역할
ViewMode	Selection 상태 구분
TotalSelectedCount	총 선택 수
SummaryItems	다중 선택 요약 정보

---

구조 변화

기존
→ SelectionId 기반 단일 구조

변경 후
→ ViewMode 기반 상태 분기 구조

---

2. Multi Selection Summary 구조 도입

다중 선택을 표현하기 위해 Summary 구조를 추가했다.

FSelectionSummaryItemViewModel
- EntityId
- DisplayName
- Count
- Icon

---

UI 표현 방식

[Icon] Marine     x5
[Icon] SCV        x2

---

구현 방식

• SummaryContainer (PanelWidget)
• SummaryItemWidget 동적 생성
• 각 아이템별 ViewModel 전달

---

결과

• 단순 텍스트 → UI 카드 형태로 개선
• 아이콘 + 이름 + 개수 분리
• 확장 가능한 구조 확보

---

3. Command 교집합 기반 처리 도입

다중 선택 시 Command 표시 기준을 변경했다.

---

기존

Provider → Command 목록 직접 전달

문제:

• 유닛마다 다른 커맨드 충돌 발생
• UI 일관성 깨짐

---

변경

SelectionSummary
→ EntityId 목록 추출
→ 각 Entity의 Command 목록 조회
→ 교집합 계산
→ UI 표시

---

핵심 로직

Marine: Move, Attack, Stop, Patrol
SCV:    Move, Attack, Stop, Patrol, BuildMenu

→ 결과
Move, Attack, Stop, Patrol

---

역할 분리

영역	역할
Provider	EntityId 기반 Command 목록 제공
Coordinator	교집합 계산
UI	결과 출력

---

4. SelectionPanel 상태 기반 UI 분리

SelectionPanel을 상태별로 분리했다.

---

구조

StateSwitcher
├─ EmptyState
├─ SingleState
└─ MultiState

---

상태별 역할

상태	UI 구성
None	안내 텍스트
Single	Portrait + 상세 정보
Multi	Summary 리스트

---

결과

• UI 분기 명확해짐
• 상태별 책임 분리
• 유지보수 용이

---

5. UI → 완전한 데이터 소비 구조 유지

이번 단계에서도 기존 원칙 유지:

UI는 데이터를 생성하지 않는다

---

최종 흐름

SelectionSource / ResourceSource
→ Coordinator
→ ViewModel 생성
→ HUDRoot
→ SelectionPanel / CommandPanel

---

Multi 구조 포함 흐름

SelectionSource
→ SummaryItems + EntityId 목록
→ Coordinator
→ Command 교집합 계산
→ ViewModel 구성
→ UI 출력

---

결과

항목	변화
Selection 구조	Single → Multi 확장
UI 상태	None / Single / Multi 분리
Command 처리	교집합 기반
Summary UI	텍스트 → 카드형 UI
구조 안정성	유지
확장성	실제 RTS 시스템 대응 가능

---

오늘의 정리

• 이번 작업은 단순 기능 추가가 아니라
  Selection을 중심으로 UI 상태 모델을 확장하고,
  다중 선택과 Command 처리 기준을 구조적으로 정의한 단계였다.
• UI는 여전히 데이터를 소비하는 역할을 유지하면서,
  Coordinator를 통해 복잡한 상태를 조합하는 방향으로 확장했다.