초기 커밋.

2026-03-25 17:26:16 +09:00
commit 7b0d900bdb
86 changed files with 20087 additions and 0 deletions
--- a/SYSTEM_SPEC.md
+++ b/SYSTEM_SPEC.md
@@ -0,0 +1,228 @@
+# 선거방송 송출 프로그램 요구사항 정의 (v0.1)
+
+---
+
+## 1. 시스템 개요
+
+### 1.1 목적
+- Tornado3를 통해 선거 방송 자막 송출
+- 포맷(디자인)에 데이터 매핑 후 송출
+
+---
+
+## 2. 데이터 처리
+
+### 2.1 데이터 수신
+- Polling 기반
+- 수동 수신 가능
+
+### 2.2 수동 수신 정책
+- 수동 수신 시 polling 주기 초기화
+- 3초 이내 재요청 금지
+
+### 2.3 갱신 vs 송출
+- 갱신 중 송출 요청 시 → 갱신 완료 후 송출
+
+### 2.4 데이터 기준
+- 득표율: 소수점 1자리 반올림
+- 득표수: 3자리 콤마
+
+### 2.5 데이터 유효성
+- 필수 필드 누락 시 송출 금지
+- 사진 필수 포맷에서 이미지 없으면 송출 금지
+
+---
+
+## 3. 포맷
+
+### 3.1 정의
+- 디자인 템플릿
+- 데이터 매핑 구조
+
+### 3.2 구조
+- 포맷 → 컷 → (준비 → 송출)
+
+### 3.3 루프
+- 하위 범주 반복 (예: 시도별 17개)
+
+### 3.4 데이터 반영
+- 현재 컷 반영 금지
+- 다음 컷부터 반영
+
+### 3.5 송출 시간
+- 포맷별 설정 가능
+- 변경 시 다음 컷부터 적용
+
+---
+
+## 4. 스케줄
+
+### 4.1 구조
+- 큐 기반
+
+### 4.2 상태
+- 현재 송출: 빨간색
+- 다음 송출: 주황색
+
+### 4.3 제어
+- 다음 포맷 변경 가능
+- 현재 포맷 강제 중지 후 전환 가능
+- 순서 변경 가능
+
+### 4.4 삭제 정책
+- 대기 포맷 삭제 가능
+- 송출 중 포맷 삭제 불가
+
+### 4.5 루프
+- 전체 루프 가능
+- 첫 포맷부터 재시작
+
+### 4.6 빈 스케줄
+- 설정에 따라:
+  - 즉시 Out
+  - 마지막 화면 유지
+
+### 4.7 종료
+- 수동 종료 시:
+  - 스케줄 종료
+  - 해당 Layer Out
+
+---
+
+## 5. 방송 영역
+
+- 노멀
+- 좌상단
+- 하단
+- VideoWall
+
+특징:
+- 독립 스케줄
+- 동시 송출 가능
+
+---
+
+## 6. 방송사 설정
+
+### 대상
+- KNN, TBC, KBC, G1, TJB, JTV
+
+### 특징
+- 동일 구조
+- 지역 필터만 다름
+
+### 지역 필터
+- 기본값 제공
+- 사용자 수정 가능
+
+---
+
+## 7. 유력/확실/당선
+
+### 기준
+- 후보 단위
+
+### 수동 입력
+- 콤보박스 선택
+- 자동 판정보다 우선
+
+### 자동 판정
+- 수동 지정 없는 경우만 적용
+- 당선 조건:
+  - (1위 - 2위) > 남은 개표수
+
+### 초기화
+- 전체 초기화 가능
+
+### 저장
+- 방송사 + 선거종류 + 선거구 + 후보 기준
+
+---
+
+## 8. Tornado3 연동
+
+### 방식
+- TCP + DLL
+
+### 기능
+- 이미지 변경
+- 텍스트 변경
+- 준비
+- 송출
+
+### 응답 처리
+- ACK 대기 없음
+- 5초 내 응답 없으면 실패
+
+### 상태
+- IDLE
+- READY (송출 가능 상태)
+- SENDING
+- ON_AIR
+- ERROR
+
+### 연결
+- 끊김 시 재연결
+- 재연결 후 사용자 확인 후 재개
+
+---
+
+## 9. 상태 흐름
+
+IDLE → READY → SENDING → ON_AIR → NEXT  
+               ↓  
+             ERROR
+
+---
+
+## 10. 복원
+
+### 대상
+- 스케줄
+- 방송사
+- 상태값
+
+### 방식
+- 통합 대화상자
+- 체크박스 선택
+
+---
+
+## 11. UI 구조
+
+### 네비게이션
+- 통합 스케줄
+- 노멀
+- 좌상단
+- 하단
+- VideoWall
+- 데이터
+- 설정
+- 로그
+
+### 표시
+- 빨강: 현재 송출
+- 주황: 다음 송출
+
+---
+
+## 12. 이미지
+
+경로 규칙:
+{선택경로}/{선거종류}/{지역코드}/{후보코드}.png
+
+---
+
+## 13. 예외 처리
+
+- API 실패 → 사용자 알림
+- Tornado 실패 → ERROR 상태
+
+---
+
+## 14. 핵심 개념
+
+- 포맷 기반
+- 컷 단위 송출
+- 스케줄 큐 구조
+- 상태 머신 기반 제어