1
0
Fork 0
Everything2Everything/docs/research/2026-11-04/TASKS.md

13 KiB
Raw Permalink Blame History

개선 작업장 — 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, manifest 1.1.0.0, Portable 파일 버전과 시작 경로 smoke 검증 통과. ZIP/MSIX에 개인 설정·이력·.env·PFX 없음. 결과는 release-verification.json이다.
  • 배포 완료와 U11 실환경 미검증, Inno 경고1건은 구분한다. 설정의 최초 평문 동일성은 소급 보장하지 않으며 이후 전체 테스트의 설정 무변경은 해시로 확인했다.