Tornado3_2026Election/CURRENT_IMPLEMENTATION_STATUS_2026-04-17.md

# 2026-04-17 현재 구현 상태 정리

이 문서는 2026-04-17 기준으로 Tornado3 2026 Election 프로젝트에서 실제 반영된 구현 사항과 검증 결과를 한 번에 확인하기 위한 현행화 문서다.

## 1. 데이터 화면

- 데이터 화면에서 원본 JSON 형태로 보여주던 `데이터 시트`는 제거했다.
- 현재 데이터 화면에는 아래 두 시트만 남겨두었다.
  - `개표율 시트`
  - `후보 시트`
- `데이터 - 선거구명` 콤보박스 첫 항목에 `전체보기`를 추가했다.
- `전체보기` 선택 시, 현재 수신 가능한 지역 데이터를 작은 카드 형태로 한 번에 볼 수 있도록 바꿨다.
  - 표시 형식: `지역명 - 개표율`
  - 목적: 전체 데이터 수신 상태를 빠르게 확인하기 위한 개요 화면

## 2. 후보/개표 데이터 처리 규칙

- 후보가 나오는 데이터는 개표 데이터 기준으로 처리한다.
- 개표 데이터에는 반드시 `개표율`도 함께 표시되도록 맞췄다.
- 개표율 텍스트는 단순 숫자가 아니라 아래 형식으로 송출되도록 수정했다.
  - 예: `개표 98.7%`
- 광역단체장 컷에서는 지역명 대신 실제 직함이 나오도록 보정했다.
  - 예: `부산광역시` -> `부산시장`
  - 예: `경기도` -> `경기도지사`

## 3. 당선/유력/확정 코드 반영

SBS API 판정 코드는 아래 기준으로 반영되어 있다.

- `40`: 유력
- `50`: 확정
- `60`: 개표중 당선
- `80`: 무투표 당선
- `90`: 개표마감 당선

추가 반영 사항:

- `80` 무투표 당선 케이스도 실제 발생 가능한 값으로 보고 정상 처리하도록 반영했다.
- 수동 판정값이 있으면 수동 판정을 우선 적용하고, 없으면 API 판정값을 사용한다.

## 4. 유확당 변수 처리 규칙

`유확당` 계열 변수는 전 컷 공통으로 아래 순서로 처리하도록 정리했다.

1. 해당 컷에 존재하는 `유확당*` 변수들을 먼저 모두 `visible=false`로 숨긴다.
2. 실제 판정 이미지가 필요한 후보에게만 `SetValue(...)`를 넣는다.
3. 값이 들어간 변수만 다시 `visible=true`로 켠다.

적용 범위:

- 1위/2위/3위 후보 슬롯 공통
- `1-2위`, `1-3위`, `당선`, `모든후보`, `접전`, `실시간` 계열 포함

검증 결과:

- 최신 전체 스캔 기준 `유확당` 변수를 사용하는 컷은 총 69개
- 전체 변수 스캔 리포트: `TSCN_VARIABLE_DISCOVERY_ELECT2026_NORMAL.md`
- 라이브 검증 리포트: `LIVE_VALIDATE_1-2위_ani_광역단체장_judgement_visibility.md`

## 5. RGB / 정당 색상 매핑

정당 색상은 아래 경로의 RGB 텍스트 기준으로 매핑한다.

- `E:\김의연\지역민방\T3_Cut\Elect2026_Normal_민방\RGB\`

현재 적용 규칙:

- RGB txt에 `style > ... > color` 지시가 있으면 이미지 교체보다 `SetStyleColor(...)`를 우선 사용한다.
- style color 지시가 없는 항목만 기존 asset 기반 `SetValue(...)` 경로를 사용한다.

특히 `1-2위_ani_광역단체장.txt` 기준으로 아래 항목을 실제 style color 변경 방식으로 맞췄다.

- 정당판: `style > face > color`
- 득표율: `style > edge > color`
- 정당바: `style > face > color`

관련 구현 사항:

- RGB txt에서 style color 대상을 파싱하도록 `PartyColorCatalog`를 보완했다.
- Karisma 적용 단계에서 `IKAStyle.SetStyleColor`를 호출하도록 처리 경로를 추가했다.
- style color 대상에는 잘못된 이미지 값이 들어가지 않도록 분기 처리했다.

검증 문서:

- 컷별 RGB 매핑 문서: `RGB_SPEC_CUT_MAPPING.md`
- style color 검증 리포트: `LIVE_VALIDATE_1-2위_ani_광역단체장_style.md`

## 6. 후보 슬롯 수 처리

- 실제 컷에 존재하는 후보 슬롯 수만큼만 값을 넣도록 보정했다.
- 예를 들어 후보가 2명까지 있는 컷에서는 `후보명03`, `유확당03` 같은 존재하지 않는 변수를 억지로 쓰지 않도록 수정했다.
- 최신 변수 카탈로그를 우선 참조해서 컷별 실제 변수 개수를 판단한다.

우선순위:

1. `TSCN_VARIABLE_DISCOVERY_ELECT2026_NORMAL.md`
2. `TSCN_VARIABLE_DISCOVERY_E_DRIVE.md`
3. 기타 `TSCN_VARIABLE_DISCOVERY*.md`

추가 사항:

- 변수 카탈로그 파일들은 실행 출력 폴더와 `AppX` 배포 폴더에도 함께 복사되도록 정리했다.

## 7. 설정 저장 및 API 주기

- API 자동 갱신 기본값을 `60초`로 변경했다.
- 설정 변경 시 별도 저장 버튼 없이 자동 저장되도록 반영했다.

자동 저장 대상에는 아래 항목들이 포함된다.

- API 자동 갱신 ON/OFF
- API 갱신 주기
- 데이터 관련 주요 선택 상태
- 앱 재시작 후 복원이 필요한 주요 설정

관련 구현 파일:

- 상태 저장 모델: `Tornado3_2026Election/Persistence/AppState.cs`
- 자동 저장 루프: `Tornado3_2026Election/ViewModels/MainViewModel.cs`

## 8. 데이터/라벨 관련 라이브 검증 결과

- `LIVE_VALIDATE_1-2위_ani_광역단체장.md`
  - 기본 변수 송출 검증
- `LIVE_VALIDATE_1-2위_ani_광역단체장_labels.md`
  - `개표 99.9%` 형식, 광역장 직함 표기 검증
- `LIVE_VALIDATE_1-2위_ani_광역단체장_style.md`
  - style color 적용 검증
- `LIVE_VALIDATE_1-2위_ani_광역단체장_judgement_visibility.md`
  - `유확당` visible 처리 검증
- `TSCN_VARIABLE_DISCOVERY_ELECT2026_NORMAL.md`
  - Elect2026_Normal_민방 전체 컷 변수 스캔 결과

## 9. 스케줄 지역 선택 송출

- 스케줄 추가 시 컷만 고르는 방식에서 `컷 + 지역 범위`를 함께 고르는 방식으로 확장했다.
- 스케줄 제어 패널에 지역 선택 콤보박스를 추가했다.
- 지역 콤보박스 구성은 아래와 같다.
  - 첫 번째: `전체`
  - 두 번째: `선택권역`
  - 이후: 개별 지역 목록
- 개별 지역 선택 시 해당 지역 데이터만 송출한다.
- `전체` 선택 시 현재 포맷에 대응되는 지역 데이터 전체를 순서대로 송출한다.
- `선택권역` 선택 시 방송사 설정에 잡혀 있는 권역만 순서대로 송출한다.
- `전체`와 `선택권역`은 데이터 순서에 따라 송출 가능한 지역만 순차적으로 처리한다.
- 스케줄 큐 항목에는 지역 범위 정보가 함께 저장되며, 앱 상태 저장/복원에도 포함된다.
- 송출 중에는 큐 카드와 현재/다음 표시에서 실제 송출 중인 지역명이 함께 보이도록 반영했다.

구현 범위:

- 스케줄 UI 콤보박스 추가
- 스케줄 아이템에 지역 범위 저장
- 스케줄 상태 저장/복원 반영
- 송출 시 지역별 API 재조회 후 순차 송출

## 10. 현재 기준 운영 요약

- 데이터 화면은 `개표율 시트 + 후보 시트 + 전체보기 카드` 기준으로 동작한다.
- 후보 데이터는 개표 데이터 기준으로 처리되고, 개표율이 함께 표시된다.
- 개표율은 항상 `개표 x.x%` 형식으로 송출한다.
- 광역단체장 컷의 지역 표기는 지역명이 아니라 실제 직함 기준으로 보정한다.
- 정당 색상은 RGB txt 기준으로 매핑하며, style color 지시가 있으면 이미지보다 style color를 우선 적용한다.
- `유확당` 변수는 전 컷 공통으로 먼저 숨긴 뒤 필요한 경우에만 값을 넣고 다시 보이게 한다.
- 설정은 변경 즉시 자동 저장되며, API 기본 갱신 주기는 60초다.
- 스케줄은 `전체 / 선택권역 / 개별 지역` 기준으로 지역별 순차 송출이 가능하다.

## 11. 참고

이 문서는 완료된 구현 사항 위주로 정리했다. 이후 추가 변경이 생기면 같은 문서를 기준으로 계속 현행화한다.