# CHANGELOG.md

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

---

## [1.0.0] - 2026-07-03

### 초기 릴리스

기존 검증된 로고삽입 프로그램을 AI-WORKS 표준으로 리팩터링한 v1.0.0 릴리스입니다.

#### Added (새 기능)

- **다중 로고 관리**: config.json 배열 구조로 여러 개의 로고를 동시 처리
  - v1.0 기본: logo_left.png (왼쪽), logo_right.png (오른쪽)
  - 무한 확장 가능 (config 수정만으로 추가 가능)

- **비율 기반 크기 계산**: 로고 원본 픽셀 크기 무시, 사진 크기 기준으로 자동 계산
  - width_percent로 방향별 크기 조절 (landscape, portrait, square)
  - PNG 교체 후에도 항상 동일한 크기로 적용

- **모듈화 구조**: 기존 750줄 코드를 5개 핵심 모듈로 분리
  - utils/ (유틸리티): color_utils, position_utils, logger_utils, validator
  - image_handler.py (이미지 처리)
  - config_handler.py (설정 관리)
  - logo_processor.py (로고 삽입)
  - batch_processor.py (배치 처리)

- **개발 모드**: source/ → output/ 폴더 처리 (폴더 구조 유지, 원본 보존)

- **테스트 모드**: N개 파일만 처리 후 Y/N 선택으로 전체 처리 계속 가능

- **로그 시스템**: 일자별 로그 파일 (`logs/YYYY-MM-DD.log`)

- **사용자 가이드**: LOGO_MANAGEMENT.md (사용자 기준 작성)

#### Changed (변경 사항)

- 프로젝트 구조를 AI-WORKS 표준으로 변경
- config.json 구조 개선 (logos 배열 구조)
- 폴더 구조 평탄화 제거 (원본 구조 유지)

#### Removed (제거 사항)

- 사진분류기 의존성 제거
- 자동 후처리 제거
- 외부 프로그램 호출 제거
- 다른 프로그램 연동 기능 제거

#### Technical

- **기반 코드**: D:\AI-TOOLS\02-로고삽입\logo_inserter.py (750줄)
- **방식**: 리팩터링 (새로 작성하지 않음, 기존 코드 재사용)
- **라이브러리**: Pillow >= 10.0.0
- **Python**: 3.8+

---

## 향후 계획

### v1.1 (예정)

- QR 코드 로고 추가
- 텍스트 워터마크 고급 기능
- 배포 모드 구현 (폴더 선택 UI)

### v2.0 (장기)

- 웹 UI 추가
- 배치 스케줄링
- 고급 필터 옵션