26.04.17 작업 진행 사항

CURRENT_IMPLEMENTATION_STATUS_2026-04-17.md

@@ -0,0 +1,155 @@
+# 2026-04-17 구현 현황 정리
+
+이 문서는 2026-04-17 현재 기준으로 Tornado3 2026 Election 프로젝트의 주요 구현 사항을 정리한 현행화 문서이다.
+기존 메모와 검증 산출물이 여러 파일에 흩어져 있으므로, 실제 운영에 필요한 상태만 이 문서에서 한 번에 확인할 수 있게 정리했다.
+
+## 1. 데이터 화면 현행 상태
+
+- 데이터 화면에서 원본 JSON 전체를 보여주는 "데이터 시트"는 제거했다.
+- 현재 데이터 화면은 아래 두 시트만 유지한다.
+  - 개표율 시트
+  - 후보 시트
+- 선거구명 콤보박스 첫 항목에 `전체보기`를 추가했다.
+- `전체보기` 선택 시, 개표 단계에서 지역별 개표율을 작은 카드 목록으로 표시한다.
+  - 카드 형식: `지역명 - 개표율`
+  - 지원 위치: 개표 단계에서 지원되는 선거 종류
+- 광역단체장 데이터는 지역명 대신 실제 직책명이 보이도록 보정했다.
+  - 예: `부산광역시` -> `부산시장`
+  - 예: `경기도` -> `경기도지사`
+
+## 2. 개표 데이터 표시 규칙
+
+- 후보 데이터는 개표 데이터 기준으로 처리한다.
+- 개표율 표시는 숫자만 넣지 않고 라벨을 포함한 형식으로 통일했다.
+  - 형식: `개표 99.9%`
+- 광역단체장 컷의 `시도명` 계열 변수는 광역 지명 대신 직책명으로 송출한다.
+  - 예: `시도명01 = 부산시장`
+- 후보 슬롯 수는 씬 변수 카탈로그 기준으로 제한한다.
+  - 2인 컷에는 `후보명03`, `유확당03` 같은 없는 변수를 보내지 않는다.
+  - 3인 컷은 3번 슬롯까지 반영한다.
+
+## 3. 후보 판정 코드 반영 상태
+
+SBS API 판정 코드는 아래와 같이 반영한다.
+
+- `40`: 유력
+- `50`: 확정
+- `60`: 개표중 당선
+- `80`: 무투표 당선
+- `90`: 개표마감 당선
+
+추가 메모:
+
+- `80` 무투표 당선은 실제 발생 가능한 값으로 간주하고 별도 예외 없이 반영한다.
+- 수동 판정이 있으면 수동 판정을 우선하고, 없으면 API 판정값을 사용한다.
+
+## 4. 유확당 변수 처리 규칙
+
+`유확당` 계열 변수는 현재 아래 규칙으로 공통 처리한다.
+
+1. 해당 씬에 존재하는 `유확당*` 변수를 먼저 전부 `visible=false`로 숨긴다.
+2. 실제 판정 이미지 경로가 있는 슬롯만 `SetValue(...)`로 값을 적용한다.
+3. 값이 들어간 슬롯만 다시 `visible=true`로 켠다.
+
+적용 범위:
+
+- 1인 / 2인 / 3인 후보 컷 공통
+- `당선`, `이시각1위`, `접전`, `초접전`, `모든후보`, `1-2위`, `1-3위` 계열 포함
+
+검증 결과:
+
+- 최신 씬 스캔 기준 `유확당` 변수를 사용하는 컷은 총 69개다.
+- 전체 스캔 리포트: `TSCN_VARIABLE_DISCOVERY_ELECT2026_NORMAL.md`
+- 실동작 검증 리포트: `LIVE_VALIDATE_1-2위_ani_광역단체장_judgement_visibility.md`
+
+## 5. 정당 색상 / RGB 매핑 상태
+
+정당 색상은 `E:\김의연\지역민방\T3_Cut\Elect2026_Normal_민방\RGB\` 폴더 기준으로 매핑한다.
+
+현재 규칙:
+
+- RGB txt에 `style > ... > color`가 지정된 항목은 이미지 교체보다 `SetStyleColor(...)`를 우선 적용한다.
+- 대표 적용 섹션:
+  - 정당판
+  - 정당바
+  - 득표율
+  - 정당명
+  - 기타 style color 지정 섹션
+- RGB txt에 style color 지정이 없는 항목만 기존 asset `SetValue(...)` 경로를 사용한다.
+
+특히 `1-2위_ani_광역단체장.txt` 기준으로 아래가 반영되도록 디버깅했다.
+
+- `정당판`: `style > face > color`
+- `득표율`: `style > edge > color`
+- `정당바`: `style > face > color`
+
+관련 문서:
+
+- 매핑 문서: `RGB_SPEC_CUT_MAPPING.md`
+- 스타일 검증 리포트: `LIVE_VALIDATE_1-2위_ani_광역단체장_style.md`
+
+## 6. 설정 저장 / 자동 갱신 현행 상태
+
+- API 자동 갱신 기본값은 `60초`다.
+- 설정 변경 시 별도 저장 버튼 없이 자동 저장되도록 구성했다.
+- 자동 저장 대상에는 아래 값이 포함된다.
+  - API 자동 갱신 ON/OFF
+  - 갱신 주기
+  - 데이터 관련 주요 선택 상태
+  - 앱 상태 복원에 필요한 주요 설정
+
+관련 구현 포인트:
+
+- 기본값: `Tornado3_2026Election/Persistence/AppState.cs`
+- 자동 저장 루프: `Tornado3_2026Election/ViewModels/MainViewModel.cs`
+
+## 7. 씬 변수 카탈로그 현행화
+
+씬 변수 카탈로그는 현재 최신 스캔 결과를 우선 사용한다.
+
+우선순위:
+
+1. `TSCN_VARIABLE_DISCOVERY_ELECT2026_NORMAL.md`
+2. `TSCN_VARIABLE_DISCOVERY_E_DRIVE.md`
+3. `TSCN_VARIABLE_DISCOVERY.md`
+4. 동일 패턴의 최신 `TSCN_VARIABLE_DISCOVERY*.md`
+
+추가 조치:
+
+- 위 카탈로그 파일들은 앱 출력 폴더와 `AppX` 폴더에도 함께 복사되도록 했다.
+- 실행본도 최신 씬 변수 정보를 그대로 사용한다.
+
+최신 전체 스캔 결과:
+
+- 전체 씬 수: 114
+- `유확당` 사용 컷 수: 69
+- 출력 리포트: `TSCN_VARIABLE_DISCOVERY_ELECT2026_NORMAL.md`
+
+## 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. 현재 운영 기준 요약
+
+- 데이터 화면은 `개표율 시트 + 후보 시트 + 전체보기 카드` 기준으로 본다.
+- 광역단체장 표기는 지역명이 아니라 직책명 기준으로 본다.
+- 개표율 문구는 항상 `개표 x.x%` 형식으로 보낸다.
+- 정당 색상은 RGB txt 기준이며, style color 지정이 있으면 이미지보다 style color를 우선한다.
+- `유확당`은 전 컷 공통으로 먼저 숨기고, 판정이 있는 슬롯만 다시 보이게 한다.
+- 설정은 변경 즉시 자동 저장되며, API 기본 갱신 주기는 60초다.
+
+## 10. 후속 확인 권장 사항
+
+- 실제 송출 중인 주요 컷에서 `유확당` 표식이 없는 슬롯이 숨겨지는지 최종 육안 확인
+- 2인 / 3인 컷 각각에서 존재하지 않는 슬롯 변수 송출이 없는지 로그 확인
+- 광역단체장 컷에서 `시도명`이 지역명이 아니라 직책명으로 나가는지 최종 확인
+- 무투표 당선(`80`) 케이스 수신 시 `유확당` asset과 visible 처리 확인