파일 취합 도구 0.1 / Windows 체험·납품 공통 실행판

이 도구는 PC 안에서 실행합니다. Excel 설치나 유료 API는 필요 없습니다.
실행 파일은 서명되지 않았습니다. 회사 보안 정책을 우회하지 마세요.
보안 정책상 실행할 수 없다면 소스·합성 자료·결과 파일로 검토하세요.

실행 순서
1. ZIP 전체를 새 폴더에 풉니다.
2. 파일취합도구.exe를 실행합니다.
3. CSV·TSV·XLSX 파일을 선택합니다.
4. 반복 업무용 설정 파일이 있으면 불러옵니다.
5. 식별키 열을 입력하고 중복 제외 여부를 확인합니다.
6. 취합 및 검수를 누릅니다.
7. 결과를 새 폴더에 저장합니다.
8. 취합결과.xlsx의 검수대상과 제외기록을 확인합니다.

합성 예시
samples의 UTF8_합성자료.csv, XLSX_합성자료.xlsx, CP949_합성자료.csv를 선택합니다.
고객설정_예시.json을 불러옵니다.
입력 12행 = 결과 9행 + 제외기록 3행입니다.
주문번호 001003의 두 행은 수량·금액이 다릅니다. 두 행을 보존하고 검수합니다.
이 자료는 실제 고객·주문 정보가 아닙니다.

보존 원칙
- 원본 파일과 기존 결과 폴더를 덮어쓰지 않습니다.
- CSV의 식별자는 문자열로 읽어 선행 0을 보존합니다.
- 이미 숫자로 저장된 XLSX 식별자는 원래 선행 0을 복구할 수 없습니다. 확인 대상으로 표시합니다.
- XLSX 수식은 계산하지 않습니다. 원문을 실행되지 않는 문자열로 저장합니다.
- 공백·날짜·값을 임의로 통일하지 않습니다.
- 숫자 변환은 설정의 numeric_columns에 지정한 열에만 적용합니다.
- 키가 같지만 값이 다른 행은 삭제하지 않습니다.
- 데이터 시트가 여러 개면 설정의 sheet에 시트 이름을 지정합니다.

시트
취합결과: 유지한 모든 행과 원본 위치.
검수대상: 누락, 숫자 형식, 중복, 식별키 값 차이 등.
제외기록: 사용자가 선택한 완전 일치 중복만 별도 보존.
처리기록: 입력·출력·제외 행 수와 원본 해시.

명령행
파일취합도구.exe --config samples\고객설정_예시.json --out 새_결과폴더 samples\UTF8_합성자료.csv samples\XLSX_합성자료.xlsx samples\CP949_합성자료.csv

한도
도구: 30개 파일, 전체 100,000행, 100열, 파일당 25MB.
기계 처리 한도는 납품 계약 범위와 다릅니다.
표준 맞춤 설정 서비스: 10개 파일, 전체 5,000행, 20열.

검증 범위
개발 PC에서 핵심 동작, 실행 파일 명령행, Tk 화면 생성/처리 검증을 수행합니다.
실제 고객 파일, 다른 PC의 보안 정책, macOS, 사용자의 최종 화면·업무 수용성은 별도 확인 대상입니다.
