Files
KEPS/keps_db_free_migration_notes.md
2026-03-20 08:52:16 +09:00

105 lines
3.0 KiB
Markdown

# keps 마이그레이션 메모 (DB 스키마 없이 진행 기준)
## 결론
- `FarPoint Spread`는 `DataGridView`로 대체해도 됨
- 현재 업로드된 `00.투표구추출용.22대총선_전체(0310)_수정.xlsx` 기준으로
- 엑셀 파서
- 후보 컬럼 추출
- 메모리 기반 집계
- DataGridView 표시
- 최종 추출 결과 내보내기
는 **DB 스키마 없이도 진행 가능**
- 다만 아래 기능은 DB 또는 과거 데이터가 있어야 완전 재현 가능
- 프로그램 버전 체크 / FTP 업데이트
- `elections` 목록 조회
- 과거 선거 기반 시뮬레이션(Source/Target 비교)
- 기존 SQL 기반 결과와 100% 동일성 검증
## 업로드된 엑셀에서 확인한 점
- 사용 가능한 시트: `85개` (`Sheet1`은 빈 시트)
- 대부분의 시트 헤더는 동일
- 후보 컬럼은 `투표수` 다음부터 `계` 직전까지 존재
- 확인된 대표 헤더:
- 선거구명
- 시군구
- 층코드
- 층명
- 읍면동
- 투표소
- 전체 선거인수
- 투표수
- 이재명 ~ 김민찬
- 계
- 건물명
- 투표소주소
- 비고
- 중복여부
- 투표구 관할구역
- 일부 시트는 뒤쪽에 빈 컬럼이 더 붙어 있음 -> 파서에서 무시 가능
## DB 없이 먼저 만들 수 있는 범위
1. 메인 MDI + WinForms UI
2. 엑셀 파일 선택 / 시트 선택 / 전체 일괄 파싱
3. 후보명 자동 인식 (헤더 기반)
4. 내부 모델 생성
5. 군집 계산 로직 C# 이식
6. 자동 추출 / 수동 보정 UI
7. 결과 Excel/CSV 저장
## DB 없이 진행 시 권장 구조
- `ExcelParser`
- `PollRow`
- `CandidateVote`
- `ClusterCalculator`
- `SamplingEngine`
- `ResultExporter`
- `AppSettings.json` (DB/FTP 대신 로컬 설정)
## 나중에 찾으면 좋은 DB 테이블 우선순위
### 1순위 (있으면 좋음)
#### poll_data
원본 VB6에서 확인된 핵심 컬럼:
- ele_ym
- 선거명
- 시도명
- 선거구명
- 시군구
- 읍면동
- 투표구명
- t_유권자수
- 선거인수
- 투표인수
- cand
- cand_ratio
- 후보별득표수계
- 투표소_중복여부
- 관할구역
- 건물명
- 주소1
- 비고_기타
- 군집1개 ~ 군집7개
- 비고
### 2순위 (시뮬레이션 재현 시 필요)
- poll_data_simul_2017 또는 poll_data_simul_{year}
- cand_name / cand_name_{year}
- 군집별비율 / 군집별비율_simul
- 시군구별유권자수와군집 / 시군구별유권자수와군집_simul
### 3순위 (없어도 진행 가능)
- elections
- information
## 기대 결과를 모를 때 검증 포인트
- 프로젝트 zip 내부 `prt` 폴더의 기존 출력 xls 파일들을 회귀 검증 기준으로 활용 가능
- 즉, 결과 규칙을 모르더라도
- 같은 입력
- 같은 조건
- 기존 출력과 비교
방식으로 맞춰갈 수 있음
## 실무 권장 방향
- 1차 목표: **DB 없는 독립형 WinForms 버전** 완성
- 2차 목표: 나중에 DB 구조를 찾으면 저장/조회 기능만 추가
- 이렇게 가야 현재처럼 내부 지식이 끊긴 레거시 프로젝트를 가장 안전하게 살릴 수 있음