13 KiB
13 KiB
개선 작업장 — 2026-11-04
요청: 유명 프로그램의 아티클 본문 200개 이상 조사, 병렬 정적 분석, UI/UX 및 빠진 기능 감사, 발견 사항을 작업으로 등록하고 구현 시작.
상태: TODO 미구현 / DOING 진행 / DONE 검증 완료 / VERIFY 구현 후 검증 대기 / PARTIAL 명시된 일부 범위만 완료. 외부 릴리즈는 별도다.
기존 장기 아키텍처 SSOT는 docs/ssot/_data/*.json. 이 작업장은 이번 조사로 발견한 구체적 결함과 UX 작업을 관리하며 기존 로드맵의 완료 상태를 추정해서 바꾸지 않는다.
실행 및 근거 게이트
- 기존 상태: 깨끗한 worktree. 전체 baseline 432 통과, 실패 0, 건너뜀 0, 33초. 10초 예산 미달.
- 조사: research-a/b의 실제 읽은 개별 본문을 합치고 URL·제목·본문 hash·개별 관찰을 검증한다. 검색결과, 수집 실패, 중복, 인덱스만 있는 문서는 200개에 포함하지 않는다.
- 코드 변경: 명확한 assertion RED → 최소 구현 → 타깃 GREEN → 전체 스위트.
- 시각 판단: 기존 RenderTargetBitmap 캡처를 사용. Mica는 근사 배경이고 실제 OS 고대비/배율/스크린리더 검증과 구분한다.
구현 대기열
| ID | 우선순위 | 상태 | 발견 및 할 일 | 완료 기준 / 검증 |
|---|---|---|---|---|
| Q01 | P1 | DONE | Ctrl+A가 null 인자를 false로 해석해 선택 해제함. 전체 선택 수정 | 공개 command로 선택·체크박스로 해제 시나리오 |
| Q02 | P1 | DONE | 한 번에 같은 파일을 넣으면 중복 등록. 입력 내 중복 제거 | 동일 초기 경로 2개 → 항목 1개 |
| Q03 | P1 | DONE | 이미지+CSV처럼 공통 출력이 없으면 CanCombine 빈 확장자 예외 | 혼합 입력 창 생성 성공, 출력 없음 표시 |
| Q04 | P1 | DONE | 공통 출력이 없어도 키보드 변환 command 활성 | CanExecute=false |
| Q05 | P1 | DONE | 선택 삭제 후 출력 목록 미갱신, 이벤트 구독 해제 누락 | CSV 제거 후 이미지 출력/변환 복구 |
| Q06 | P1 | DONE | 처리 중 삭제/목록 비우기/중복 실행/창 닫기 경계 명확화 | 처리 중 command 보호, Esc 취소, 닫기 정책 시나리오 |
| Q07 | P2 | DONE | 완료 항목 정리도 출력 재계산 및 이벤트 구독 해제 | 정리 후 교집합/합치기 상태 갱신 |
| Q08 | P2 | DONE | 검색 필터 결과가 0건일 때 빈 상태 없음 | 검색 결과 없음 + 필터 초기화 행동 |
| Q09 | P2 | DONE | 선택/전체선택이 숨겨진 항목에도 적용. 범위 표시/정책 결정 | 검색→선택→삭제 시 보이는 범위 계약 |
| Q10 | P1 | DONE | 취소 시 완료 결과 이력 손실 및 상태 잔류 가능 | 완료/진행/대기 각각 결과 보존과 재시도 |
| Q11 | P1 | DONE | 결합 N→1 결과를 snapshot.Zip으로 기록해 잔여 입력이 남음 | 3개 입력 결합→결과 1개, 큐 0개, 이력 관계 보존 |
| U01 | P2 | DONE | 비어 있지 않은 대기열에서 파일 추가 버튼 미노출 | 항상 접근 가능한 파일 추가 행동 |
| U02 | P2 | DONE | 폴더 추가 메뉴 없음, 드롭은 최상위만 확장 | 폴더 선택 메뉴·재귀 정책·권한 오류 안내 |
| U03 | P2 | DONE | 파일 추가 필터가 오래된 이미지/문서 목록 | Provider 입력 SSOT 기반 미디어/데이터 포함 |
| U04 | P2 | DONE | 도움말/단축키/프로그램 정보 메뉴 없음 | F1 및 접근 가능한 도움말, 버전/의존성 정보 |
| U05 | P2 | DONE | 컨텍스트 메뉴 등록은 있으나 등록 해제는 CLI만 존재 | UI에서 해제·현재 등록 상태 확인 |
| U06 | P2 | DONE | 목록 행이 MouseDown Border 기반, 키보드 미리보기 부족 | 탭·방향키·Enter로 항목 접근 및 미리보기 |
| U07 | P2 | DONE | 변환 실패 복구/재시도 메뉴 없음 | 실패 이유 복사·원본 재추가·실패만 재시도 |
| U08 | P2 | DONE | 사용자 프리셋 저장/불러오기 없음 | 옵션 저장→재시작→복구, 잘못된 프리셋 오류 |
| U09 | P2 | DONE | 이력 검색/필터가 대기열에만 연결됨 | 이력 탭에서도 검색과 종류 필터 일치 |
| U10 | P2 | DONE | 출력 경로 미리보기·손실/EXIF/투명도 안내 보완 | 실제 예정 경로와 손실 조건 설명 |
| U11 | P2 | PARTIAL | 고대비·125/150%·스크린리더는 기존 문서에서도 미검증 | 실제 Windows 환경별 검증 및 결함 수정 |
| E01 | P1 | DONE | 빈 배치에서 Math.Clamp(1,0) 예외 | 빈 입력 반환 시나리오 |
| E02 | P1 | DONE | CLI wildcard 미확장으로 문서 예제 실패 | *.png 및 literal path 혼합 테스트 |
| E03 | P1 | DONE | AppendNumber 9999 소진 시 기존 원래 경로 반환 | 이름 소진 시 기존 파일 보존 |
| E04 | P1 | DONE | 병렬 동명 출력 경합 | 동명 원본 2개 동시 변환→독립 결과/내용 |
| E05 | P1 | DONE | DOCX LibreOffice 공용 temp/출력 미배수/timeout 누락 | 공용 runner 연결, 동명 문서·취소·timeout 검증 |
| E06 | P2 | DONE | HEIC/DOCX 중간 GUID가 최종 파일명에 노출 | 원본 이름 기반 출력·페이지 번호 |
| T01 | P2 | DONE | 전체 스위트 33초로 10초 규약 위반 | 느린 테스트 분류 후 의미 유지하며 10초 이내 |
| D01 | P2 | DONE | README 기능/필터/단축키가 현재 프로그램과 불일치 | 현재 구현 기반 문서 갱신 |
세부 근거는 static-audit.md, ui-audit.md, research-a.md, research-b.md에 연결한다. 연구에서 새 문제가 확인되면 기존 항목에 병합하거나 ID를 추가한다.
1차 구현 기록 (후속 완료 전 기준)
- 2026-11-04 최종 전체 스위트: 450 통과, 실패 0, 건너뜀 0, 26초.
test-final/final.trx. 빌드 경고 출력 없음. T01의 10초 기준은 미달이다. - Q06: 실행 중 삭제/정리/비우기·중복 실행 보호와 Esc 취소 완료. 제목 표시줄 X 정책 및 취소 후 결과 보존은 남았다.
- E04: 동일 배치의 같은 출력 디렉터리를 직렬화해 동명 경합을 방지했다. 배치 간·프로세스 간 경합과 원자적 파일 공개는 미완료다. 단일 출력 폴더의 병렬 처리량 감소가 트레이드오프다.
- R01 일부 완료: MagickProvider의 EXIF/XMP 제거·보존 및 ICC 유지, 회전 후 픽셀을 실제 JPEG/TIFF fixture로 검증했다. HEIC 전처리·다른 provider 전체에 대한 개인정보 제거 보장은 아직 없다.
metadata-fix.md참고. - R02 일부 완료: WebP 무손실 프리셋은 실제 ImageLossless=true, 다른 WebP 프리셋 전환은 false를 전달하도록 수정했다. PDF 압축 약속은 후속이다.
- UI 캡처:
visual-after/12장. 대기열 라이트·빈 상태 다크를 직접 확인했다. 실제 OS 고대비·확대·스크린리더 및 모달 상호작용은 미검증이다. - 통합 연구 작업 40개는 research-backlog.md, 정적 분석 17개는 static-audit.md에 등록했다. 두 문서의 중복 ID는 같은 작업을 가리킨다.
- 다음 구현 순서: Q10/Q11 결과 무결성 → E04 원자적 출력 보존 → E05 문서 프로세스 격리 → U05/U06/U07 기본 메뉴·키보드·복구 → T01 시간 예산.
2차 완결 구현 및 배포 게이트
- Q06/Q09/Q10/Q11: 표시 범위 선택·삭제, 처리 중 창 닫기 취소, 완료/부분 산출물 보존, 결합 입력 관계와 큐 제거를 구현했다.
- U05~U10: 현재 사용자 레지스트리 등록 상태/등록 해제, 키보드 미리보기, 실패 복구 메뉴, 사용자 프리셋 관리/시작 기본값, 이력 필터, 실제 첫 파일 예정 저장 폴더와 손실 안내를 연결했다.
- CORE-04~15: 같은 볼륨 staging 후 원자 공개, 교차 호출/프로세스 충돌 보호, 외부 프로세스 시간 제한·로그 상한·Word 작업자 격리, 설정 원자 저장과 이력 보존/오류 피드백을 구현했다. 상세 RED/GREEN은 agent-core-completion.md와 agent-settings-completion.md를 따른다.
- 추가 통합 결함: 프리셋이 큐 변경 때 덮이는 문제, ImageOptim 메타데이터 제거/크기 제한 fallback, 완료 진행률 중복 계산, 이력 결과 미리보기 경로를 assertion RED 후 수정했다.
- 화면 결함: 1080×640에서 선택 도구 모음 잘림 및 파일명 폭38px를 렌더 기반 assertion RED로 확인했다. 동작줄 분리와 파일정보 재배치 후 최종 재검증한다.
- U11: SystemColors 고대비 역할·변경 감지, 실제 WPF AutomationPeer 및125/150% DPI 렌더는 자동 검증한다. 실제 OS 배율 전환·Narrator 낭독·Office Word-only 환경은 이 PC에서 검증하지 않았으므로 완료로 표시하지 않는다.
- 연구 후보40개의 채택/제한채택/제품범위 제외 판단은 agent-completeness.md에 개별 기록했다. 범위 제외를 구현 완료로 계산하지 않는다.
- 최종 Release 전체 테스트·성능 예산·배포 자산 검증 결과는 아래에 확정한다.
최종 Release 코드 검증
test-final/release-final-green.trx: 501 통과 / 실패0 / 건너뜀0, 빌드 경고 출력0. 무필터 Release 전체다.- 실제 첫 테스트 시작
마지막 종료 9.5422초. VSTest 준비/발견을 포함한 TRX startfinish는 10.4308445초다. T01은 테스트 실행 구간 기준 실측 목표를 충족했다. 이전 cold 실행은10.735초였으므로 기동/발견/빌드까지 항상10초 이내라는 보장은 하지 않는다.test-timing.md의 이전 실패·실험도 보존했다. - 중복된 HTML PDF/PNG 검증은 엔진8출력에 assertion을 통합했고, 동일 상태의 UI 창 검사를 합쳤다. 전체 변환 출력과 사용자 행동 assertion을 유지했다. 무제한 병렬 대신4컬렉션과 긴 컬렉션 우선 순서를 적용했다.
- 프리셋 마지막 통합 RED: 기대
Skip|Overwrite|translate|한국어/ 실제AppendNumber|AppendNumber|summarize|영어. 시작 기본값·충돌 토글과 옵션 동기화, AI 양방향 바인딩을 수정했다. - 마지막 P1 RED3개: 배치/결합/별도 엔진 동시 배치의 다른 입력 원본 덮어쓰기. 활성 입력 전체를 프로세스 공유 보호집합에 등록하고 최종 공개와 같은 잠금으로 차단했다. 별도 프로세스 입력과 경로 별칭은 이 보호집합 범위 밖이다.
- U11의 OS 설정 전환·Narrator·Word-only Office 실환경 검증은 남은 환경 게이트다. 전문 편집기 기능의 범위 제외와 구분한다.
- 1.1.0 코드·버전 커밋과 원격 태그를 반영했다. 공개 URL과 다운로드 자산 검증은
release-verification.json으로 확정한다.
배포 중 발견한 검증 부작용
- 기존
ApplyProductionAdMobKeysToLocalSettings테스트가 실제 사용자 저장소에 setup/광고 설정5개를 쓰고 있었다. 배포 전후 암호문 해시 차이로 확인했다. 임시 경로 저장소로 격리했고 테스트 이름도 수정했다. 제품 바이너리 변경은 없다. - 격리 후 전체501개를 다시 통과했고 실행 전후 사용자 설정 파일 해시가 동일했다.
test-final/profile-isolation.json과release-test-isolation-green.trx를 보존했다. 최초 배포 전에는 평문 스냅샷을 만들지 않았으므로 최초 설정 값 동일성까지 소급하여 보장하지 않는다. 이력 파일은 계속 부재 상태로 보존됐다. - Inno Setup의 기존 UninstallRun 항목에 RunOnceId가 없는 경고1건이 남았다. .NET 테스트·빌드 경고0과 별도로 기록하며 설치 파일 생성은 성공했다.
- Forgejo11.0.16 최초 릴리즈 생성은
UQE_release_n중복 키로 실패했다. 태그 삭제 없이 서버 소스의 기존 tag 레코드 승격 경로를 확인한 뒤 동일 요청을 다시 보내 draft 생성에 성공했다. 태그 처리와의 경합은 추정이며 서버 DB를 변경하지 않았다. 출처: https://codeberg.org/forgejo/forgejo/src/tag/v11.0.16/routers/api/v1/repo/release.go
배포 완료
- v1.1.0 공개 릴리즈, 코드/버전 커밋
414f5e9, 원격 태그 일치. - 첨부5종을 공개 URL에서 다시 수신했고 로컬 빌드와 파일 전체 SHA-256·크기가 모두 일치했다. 일반 대용량 응답이 지연돼1MiB HTTP Range 수신 후 결합했다. 최종 검증은 범위별 해시가 아니라 결합된 파일 전체 해시다.
- 다운로드한 MSIX 서명
Valid, manifest1.1.0.0, Portable 파일 버전과 시작 경로 smoke 검증 통과. ZIP/MSIX에 개인 설정·이력·.env·PFX 없음. 결과는release-verification.json이다. - 배포 완료와 U11 실환경 미검증, Inno 경고1건은 구분한다. 설정의 최초 평문 동일성은 소급 보장하지 않으며 이후 전체 테스트의 설정 무변경은 해시로 확인했다.