8.8 KiB
설정·프리셋·개인정보 개선 완료 기록
2026-11-04, research_a. 배포·커밋은 수행하지 않았다. MainWindow·변환 엔진·개별 provider의 후속 변경은 담당 세션에 전달했다.
구현과 검증
SettingsPersistenceRegressionTests: 서로 다른 DPAPI 저장소 인스턴스의 키 유지, 잠긴 대상의 저장 실패에서 기존 바이트·메모리 값 보존 및 임시파일 정리, 손상 설정 파일 무단 덮어쓰기 방지. 기존 구현 assertion RED 3개 → GREEN 3개.DpapiSettingsStore: 경로별 OS mutex로 read/merge/write 직렬화, 사용자 DPAPI 암호화 유지, 같은 디렉터리의 고유 임시파일을 flush한 뒤 교체. 디스크 공개 성공 이후에만 메모리 상태 갱신한다. 손상 파일은 시작 시 빈 표시로 허용하되 수정할 때 InvalidDataException으로 원본을 보존한다.UserPresetWorkflowTests: 저장→새 인스턴스→기본값 복원, 잘못된 JSON/버전 거절 및 기존 데이터 보존, 공유 내보내기에 API 키 제외, 가져오기·삭제. assertion RED 4개 → GREEN 4개. codec/pdf 인덱스 범위 거절 RED 2개 → GREEN 2개, null 정수 값 거절은 최초 검사부터 PASS.- 프리셋 문서는 버전 1, 최대 64개, 가져오기 최대 1MB다. 변환 옵션만 명시적으로 허용한다. 전체 설정 저장소·API 키·광고 식별자를 직렬화하지 않는다. 공유 파일에 사용자 지정 출력 폴더 경로가 들어갈 수 있음을 UI에 표시한다.
UserPresetsWindow: 이름 입력·현재 옵션 저장, 목록, 적용, 기본값 지정·해제, 삭제, 가져오기·내보내기, 빈 상태, 스크롤, 상태 접근성 알림을 제공한다. 기존 Windows Fluent 테마와 강조 버튼 1개를 사용했다.design.md를 상위 기준으로 designpaca의 기존 시스템 확장 경로를 적용했다.HistoryRepository: 경로를 주입해 실제 사용자 이력을 건드리지 않고 검증한다. 스트리밍 읽기와 최근 N개 제한, 잘못된 JSON 행 건너뛰기, 원자적 이력 재작성, 기록 중지 시 기존 파일 보존, 삭제 성공 여부와 LastError를 제공한다. 기존 HistoryStorage API는 호환 래퍼로 유지했다.SettingsWindow: 이력 기록 여부와 최근 100/1,000/5,000/10,000개 보존을 설정하고 저장 즉시 적용한다. 기록 중지와 기존 이력 삭제를 명확히 구분한다.SettingsCompletionTests: 이력 보존/중지/삭제 시나리오, 프리셋 대화상자 행동·빈 상태·접근성, 설정 이력 UI 계약. assertion RED 3개 → GREEN 3개.- 1차 대상 검증: 13개 통과, 실패 0, 경고 0, 테스트 기간 163ms. 전체 suite·실제 창 렌더·배포 게이트는 root가 통합 검증한다. 정적 XAML 계약을 실제 스크린리더 사용 검증으로 간주하지 않는다.
API와 통합
new UserPresetsWindow(ISettingsStore settings, OptionsViewModel options, string outputExtension); ShowDialog()==true 때 SelectedOutputExtension을 사용한다. OptionsViewModel에 SavePreset, ApplyPreset, ApplyDefaultPreset, SetDefaultPreset, DeletePreset, ExportPresets, ImportPresets, GetPresets를 제공한다.
HistoryStorage.Configure(settings)는 이력 로드 전에 호출한다. history.enabled=false는 새 기록만 중지한다. history.maxEntries 기본값은 1000이며 100~10000 범위를 허용한다. TryAppend/TryClear 결과와 LastError를 UI에 연결하도록 root에 전달했다.
연구 대기열 연결 및 범위 판단
| 항목 | 이번 결과 | 추가 확인/보류 근거 |
|---|---|---|
| R01 개인정보 제거 | 앞선 Magick 단일·다중프레임·결합 경로에 EXIF/XMP 제거·ICC 유지·회전 픽셀 검증 완료 | ImageOptim의 옵션 미소비와 원본 fallback도 후속 RED→GREEN 완료. HEIC 중간 PNG의 보존 가능 범위는 provider 담당 검증으로 구분 |
| R08 사용자 프리셋/U08 | 저장·재시작 복원·기본값·공유·잘못된 schema 보호와 관리 창 구현 | root의 메인 진입 연결과 함께 기본 프리셋 오류 격리까지 완료 |
| R12 진단 개인정보 | 공유 내보내기 API 키 제외, 경로 포함 안내 구현 | 진단 로그 익명화는 로그 생성 담당 범위로 별도 |
| R17 설정·이력/static CORE-12/13 | DPAPI 원자성·인스턴스 합병·실패 보존, 이력 한도·기록 중지·삭제 실패 API 구현 | 설치/업데이트의 실제 데이터 보존은 배포 시나리오 담당 검증 필요 |
| R18 언어·도움말 | 새 UI는 한국어, API 키 제외/기록 범위/가져오기 교체 의미를 표시 | 전체 제품 현지화는 설정 저장소 기능과 독립된 범위 |
| R23 색관리 | 기존 Magick ICC 바이트 유지와 실제 픽셀 fixture 검증을 보존 | CMYK/HDR/인쇄 색교정은 ICC 보존과 다른 작업이며 프로파일/디스플레이 fixture 필요 |
| R37 프리셋 스크립트 | 실행되지 않는 선언적 JSON 프리셋으로 현재 반복 설정 문제 해결 | 임의 스크립트 실행은 별도 실행 권한·취소·격리 계약 없이 추가하지 않음 |
| R38 외부 전송 | 프리셋 공유는 사용자가 로컬 파일을 직접 내보내는 방식 | 자동 업로드·메일 전송은 변환 도구 핵심 목적에 필요하지 않아 보류. 기존 선택 AI 기능의 네트워크 필요 안내는 유지 |
나머지 R01~R40 항목은 통합 대기열의 엔진/UI/배포 담당 소유이며 이 문서에서 중복 완료 처리하지 않는다. 연구 자료가 기능을 제공한다는 이유만으로 제품에 모든 전문 편집/자동화를 추가하지 않았다.
후속 통합 보완과 최종 증거
- root 통합 RED(
integration-red.trx)에서 잠긴 DPAPI 설정 생성자의 IOException, SettingsWindow 저장 오류 노출, ImageOptim 출력의 남은 EXIF를 assertion으로 확인했다. 생성자는 빈 캐시와LastLoadError로 복구하고 이후 쓰기는 엄격하게 보호한다. 설정 창은 저장 실패를 창 안의 접근성 상태문구로 표시하며 닫지 않는다. ImageOptimizationOptionTests: 실제 noise JPEG를 낮은 품질로 생성해 품질100 재압축이 커지는 경로를 사용했다. EXIF 제거 선택이 실제 프로필에 반영되고 ICC는 유지된다. resize16은 처음부터 PASS였고 RED라고 주장하지 않는다. resize47로 강화해 원본48px fallback을 assertion RED로 확인한 뒤, 메타데이터 제거 또는 크기 제한 요청이 있으면 원본 fallback을 금지해 GREEN을 확보했다.UnreadableHistoryIsNeverReplacedByNewEntry는 최초부터 PASS였다. 잠긴 이력 보존에 대한 추가 회귀 검증이며 새로운 결함/RED로 계산하지 않는다.- 손상된 저장 프리셋으로 시작할 때
ApplyDefaultPreset이 예외를 외부로 내보내는 assertion RED를 확보했다. 시작 기본값 적용만 오류를 격리해PresetLoadError를 남기고 원문을 보존한다. 명시적인 가져오기/저장/적용에서는 오류를 숨기지 않고 관리 창에서 보여준다. - root가 좁은 MainWindow 이력 연결 소유권을 위임했다. ctor의
persistHistory=falseseam, 시작/설정창 종료 후 Configure, TryAppend 실패 안내, TryClear 성공 후에만 UI 이력 삭제를 연결했다. 이력/프리셋 오류는 비동기 외부도구 상태 갱신에 덮이지 않도록 유지한다.MainWindowHistoryIntegrationHonorsSettingsAndChecksPersistenceBeforeClearingRows의 assertion RED→GREEN을 확보했다. 실제 이력 파일 실패/보존 동작은 독립 경로 repository 테스트가 검증한다. - 최종 내 대상: 20개 통과, 실패 0, 481ms,
test-completion/settings-completed-green.trx.settings-final-red.trx는 프리셋·resize47·MainWindow 통합 RED와 기존 손상설정 catch 범위 회귀를 기록한다. 같은 실행에서 root 예정 출력 경로의 RED도 전달했다. settings-final-green.trx는 이름과 달리 root가 직전에 추가한 컨텍스트 메뉴 등록 상태 검사 1개가 RED이고 내 대상과 예정 출력 경로는 GREEN인 중간 통합 기록이다. 최종 통과 수는 전용settings-completed-green.trx를 기준으로 한다.- 후속 전체 테스트·새 프리셋 창 실제 렌더·MSIX/Portable·업데이트 보존·릴리즈 게이트는 root가 통합 검증한다. 내 담당 완료를 전체 R01~R40 또는 배포 완료로 확대하지 않는다.
DpapiSettingsStore.LastLoadError는 설정 창을 열면 SettingsSaveStatus에 표시된다. 최초 메인 창 기동 시 자동 안내하는 연결은 현재 없다. 기본 프리셋 문서 오류와 이력 저장 오류의 메인 안내는 별도로 연결되어 있다. 대형 일괄 작업에서 이력 N개 원자 재작성 비용과 실제 삭제 권한 실패의 GUI 사용 검증은 별도 한계다.