89 lines
14 KiB
Markdown
89 lines
14 KiB
Markdown
# 전체 후보 완결성 감사
|
|
|
|
2026-11-04. 조사 후보 R01~R40 전체를 검토했다. 후보는 제품 요구 확정이 아니며 공식 문서의 기능 존재만으로 사용자 수요를 추정하지 않는다. 아래 `범위기각`은 이번 변환기 개선에 채택하지 않기로 결정을 완료했다는 뜻이다. `검증대기`는 구현완료로 계산하지 않는다. 실행 상태는 TASKS.md와 최종 테스트 증거가 우선이다.
|
|
|
|
## 채택 및 범위 결정
|
|
|
|
| ID | 결정 | 근거와 완료 판정 |
|
|
|---|---|---|
|
|
| R01 | 채택 | 개인정보 정책은 기존 옵션의 안전 계약. 메타데이터 회귀와 프리셋 개인정보 문구는 설정 담당 결과에 연결 |
|
|
| R02 | 채택 | WebP lossless 프리셋 실제 encoder 전달 결함 재현·수정. assertion RED→38개 관련 GREEN. 다른 포맷의 완전 보존은 약속에서 제외 |
|
|
| R03 | 채택 | Q/E 원본 보존·번호소진·동명 경합 작업으로 통합. final suite 결과로 판정 |
|
|
| R04 | 채택 | Q01~Q05,Q07,Q09에 통합. 검색 범위 선택·삭제는 공개 command 시나리오 기준 |
|
|
| R05 | 채택 | Q06,Q10,Q11,U07에 통합. 취소·결합은 결과 무결성 계약 |
|
|
| R06 | 채택 | E05와 CORE process runner 회귀에 통합. 문서 엔진 격리와 timeout 우선 |
|
|
| R07 | 제한채택 | 기존 파일별 실패 반환 및 잠금/권한 오류 격리 검증. 실제 UNC 서버·네트워크 단절 검증은 별도 환경 증거 없으면 미검증으로 남김 |
|
|
| R08 | 채택 | U08. 재사용 옵션 저장·복구는 변환기 핵심. 원격 공유/클라우드 동기화는 범위기각 |
|
|
| R09 | 제한채택 | U10,E06. 실제 경로/충돌/파일명 안내 채택. 임의 naming template 언어는 사용자 수요 없어 범위기각 |
|
|
| R10 | 채택 | U03,U10,D01. Provider capability와 도구 가용성을 기준으로 설명. 모든 포맷 정보 보존 약속 금지 |
|
|
| R11 | 범위기각 | 샘플 재변환 비교는 현재 결함 수정과 달리 별도 렌더 취소·캐시·비교 화면 설계 필요. 기존 입력 미리보기와 완료 결과 열기로 사용 흐름 충족. 독립 기능 요청·대표 비교 fixture 없이 확장하지 않음 |
|
|
| R12 | 제한채택 | 기존 진단·로그+U04/U07. 오류 복사/도움말을 채택. 모든 내부 encoder 파라미터를 제품 화면에 노출하는 전문 디버거는 범위기각 |
|
|
| R13 | 채택 | U01~03. 상시 추가/폴더 최상위 정책/지원형식 필터 |
|
|
| R14 | 채택 | U05. 등록 상태와 UI 해제, Portable/MSIX 차이 설명 |
|
|
| R15 | 채택 | Q08,U06,U09,U11. 실제 고대비/배율/스크린리더 증거는 자동 XAML 통과와 구분 |
|
|
| R16 | 제한채택 | 완료 결과 열기/폴더 열기·기존 포커스 유지 채택. 자동 메일/종료/알림센터 통합은 수요 없어 범위기각 |
|
|
| R17 | 채택 | 설정·이력 저장 내구성과 제한. 파일 백업·업데이트 데이터 이관은 별도 실환경 검증 필요 |
|
|
| R18 | 채택 | U04,D01 및 릴리즈 안전성. 도움말/현재 문서/버전/의존성 경계 |
|
|
| R19 | 제한채택 | CLI wildcard 및 오류·도움말 계약 채택. JSON 자동화 API는 현재 소비자 없어 범위기각 |
|
|
| R20 | 제한채택 | 기존 timeout·임시정리·parallelism 경계 채택. 모든 압축폭탄을 미리 판별한다는 보장은 불가능하므로 무제한 지원 주장 제외. OS 격리 worker 구조는 별도 아키텍처 작업으로 기각 |
|
|
| R21 | 제한채택 | 외부 process timeout과 완료 상태 채택. 모든 in-process native crash 격리는 별도 worker 프로토콜/배포 필요해 이번 범위기각. 실제 GPU 가속 표시도 측정 없이 추가하지 않음 |
|
|
| R22 | 제한채택 | 기존 긴변/방향/종횡비 계약 유지. crop·반전·캔버스 편집은 편집기 범위라 기각 |
|
|
| R23 | 제한채택 | ICC/CMYK/HDR 완전 보존 주장은 문서에서 제외. 전문 color-managed pipeline은 타깃 모니터/프로필 실측·사용자 요구 없어 범위기각 |
|
|
| R24 | 제한채택 | 기존 지원 프레임/알파 계약과 손실 고지 유지. 신규 APNG/애니 WebP/AVIF 확장과 GIF 디더링 편집 UI는 fixture·수요 없어 범위기각 |
|
|
| R25 | 제한채택 | Q11 결합 순서·N→1 관계 채택. 페이지 편집·북마크 생성·재배열 편집기는 범위기각 |
|
|
| R26 | 제한채택 | PDF 재저장 서명/XFA/PDF/A 손실 고지 채택. PDF 규격 인증·서명 보존/검증기 구현은 전문 제품 범위라 기각 |
|
|
| R27 | 채택 | E05·HTML 8개 출력 회귀 유지. 외부 폰트/Office 설치별 픽셀 동일성은 환경 증거 없으면 보장하지 않음 |
|
|
| R28 | 제한채택 | WebP 품질/무손실 실제 값 전달과 현재 encoder 옵션 유지. 파일 크기 예측은 데이터별 편차 커서 기각. 전문 CRF/ABR 설명서 전체 복제는 도움말 링크로 대체 |
|
|
| R29 | 채택 | T01,D01. assertion 없는 HTML→Markdown 보강, silent readiness pass 제거, 전체 무필터 측정 |
|
|
| R30 | 범위기각 | 감시 폴더는 쓰기완료 감지·복구·중복 처리 서비스까지 필요. 현재 사용자 요청은 대화형 변환 안정화이며 반복 자동화 수요 증거 없음. CLI 배치 제공 |
|
|
| R31 | 범위기각 | 레이어/콜라주/워터마크/주석은 작업순서·undo·미리보기 편집기가 필요. 변환기 목적 벗어남 |
|
|
| R32 | 범위기각 | FFT·렌즈 보정·CLAHE·형태학은 전문 영상처리 기능. 라이브러리 보유는 제품 수요가 아님 |
|
|
| R33 | 제한채택 | 기존 RAW/HEIC 읽기 지원을 문서화하되 RAW 현상기 아님을 명시. JXL/C2PA 등 신규 coder는 라이선스·fixture·수요 없으므로 이번 추가 기각 |
|
|
| R34 | 범위기각 | 자막/트랙/챕터 편집·trim timeline은 미디어 편집기 영역. 기존 FFmpeg 변환·오디오 추출 유지 |
|
|
| R35 | 제한채택 | 기존 Windows OCR와 언어팩 조건 문서화. 카메라/스캐너/클립보드 관리·언어팩 다운로드 시스템은 하드웨어·권한 경계가 커서 기각 |
|
|
| R36 | 범위기각 | PDF 서명·암호·원문 편집은 인증서/권한/보안 검증을 요구하는 별도 제품. 기존 렌더·압축 한계 명시 |
|
|
| R37 | 범위기각 | 사용자 스크립트 실행은 새 보안 경계. 캐시는 실측 병목/무효화 요구 없이 도입하지 않음. T01은 실제 고정 대기·fixture I/O부터 제거 |
|
|
| R38 | 범위기각 | 메일 전송/조직 서버는 로컬 변환기 데이터 경계와 어긋남. Portable/MSIX 및 선택 AI의 외부 전송 경계 문서화로 판단 완료 |
|
|
| R39 | 채택 | 기존 입력 오류 파일별 격리·정상 파일 지속 계약. 확장자만으로 형식 유효성을 보장하지 않음 |
|
|
| R40 | 채택 | Q06,Q08,U07·상태 전이·취소/완료/실패/skip 의미·검색 빈 상태로 통합 |
|
|
|
|
## 증거와 남은 게이트
|
|
|
|
- 연구: research-a/b 각각100개, validation.json에서 URL/hash 중복0·200개 모두 후보 연결. 독립 사용자 리뷰200개가 아니라 공식 개별 가이드/지원 문서200개다.
|
|
- D01: README의 오래된6개 Provider 한정 설명, 영어 출력 메뉴, Esc·F1 누락, 수동 Provider 등록 설명을 현재 코드에 맞춤. docs/current-features.md에 범위·손실·외부AI 경계를 기록.
|
|
- T01: 정적 HTML fixture의2초 고정 대기를0으로 지정(8개 출력 유지), 작은 viewport, 직접 Provider의 준비실패를 silent pass에서 assertion으로 강화. 제품 기본값은 변경하지 않음. 전체 실행 시간은 최종 TRX로 갱신해야 함.
|
|
- 릴리즈: ReleasePipelineTests는 기존 태그/dirty checkout 거부, force push 금지, native git 실패 확인, 정확한 commit SHA, HTTP 실패와 업로드 크기·URL 검증을 요구한다. 실제 배포는 root 담당.
|
|
|
|
범위기각을 구현완료로 세지 않는다. 제한채택에서 환경 검증이 없는 부분은 기능 보장으로 승격하지 않는다. 최종 TASKS 상태와 배포 결과는 root의 증거로 확정한다.
|
|
|
|
## 이번 세션 TDD 실행 증거
|
|
|
|
- `test-completeness/safety-red.trx`: ReleasePipelineTests2개와 번호소진 seam1개 모두 assertion RED. 스크립트의 checked git/dirty 검사 부재, seam 없음이 원인. 컴파일 실패가 아니다.
|
|
- `test-completeness/settings-safety-red.trx`: 릴리즈2개 및 설정 담당의 새 테스트2개 assertion RED를 함께 보존. 설정 담당에 결과 전달.
|
|
- `test-completeness/safety-html-green.trx`: 관련18개 통과, 실패0, skip0, 테스트기간7초. HTML8출력·Markdown 내용·직접 PDF/PNG·번호소진/실제파일 보존·릴리즈계약을 포함한다. 전체 스위트 통과 증거로 사용하지 않는다.
|
|
- 번호소진은 동일 존재판정 계약을 합성 predicate로 검증(원본+1..9999 존재,10000 미존재·검사10001회). 별도 실제2파일 fixture에서 기존 바이트 보존과 다음 번호를 검증한다. 9999파일 생성/삭제 비용을 제거했다.
|
|
- PowerShell parser로 수정 릴리즈 스크립트 문법오류0 확인. Git wrapper의 `-c user.name="Yun Chan"` 인자 전달을 독립 함수로 확인했다. 실제 push/API 호출은 수행하지 않았다.
|
|
- 릴리즈 스크립트는 dirty checkout·분리HEAD·기존 local/remote tag를 빌드 전 거부한다. 강제 태그 교체를 제거하고 모든 native git 종료코드를 검사한다. commit SHA를 대상에 사용하고 asset 이름·크기·다운로드URL 검증 후 draft를 공개한다. API 실패는 throw하며 성공으로 표시하지 않는다. DryRun은 버전 파일을 수정하지 않는다.
|
|
- 프로파일 목적의 오래된 빌드 전체 실행은 root 요청으로 중단했다. 동시 구현 중인 미연결 RED가 포함됐으므로 최종 성공/성능 판정에 쓰지 않는다. 최종 무필터 새 빌드 측정은 root의 통합 게이트에서 진행한다.
|
|
|
|
## 가지치기 및 속도 개선의 계약
|
|
|
|
- HTML 실제8출력·Markdown 내용 검증은 유지했다. 직접PDF/PNG 두 Fact는 같은 fixture/동일 결과 assertion의 중복이므로 엔진 theory로 통폐합하고 availability assertion도 옮겼다. 정적 fixture에만 렌더 대기0을 지정했다.
|
|
- 9999파일 생성은 동일 존재판정 predicate로 바꾸고 실제2파일 보존 사례를 별도로 유지했다.
|
|
- `ActiveQueueList_Columns_MustProvideAdequateWidthForMetadata`의6컬럼 고정 명세는 삭제했다. 실제1280/1080DIP 렌더의 파일명140DIP 확보·툴바 경계·메타데이터 ellipsis와 시각 검토가 그 목적을 검증한다.6컬럼 자체는 사용자 요구가 아니다.
|
|
- TitleBar의260px 상한은 등록해제 버튼 추가로 낡았다. Header/TrailingContent 실제 사각형이 겹치지 않고 titlebar 밖으로 나가지 않는 검사로 대체했다. 큐 요약은 표시/전체 범위가 명확한 새문구를 검증한다.
|
|
- Queue의 `FilePickerFilter_IncludesEveryRegisteredInput`, `HistoryActionsAndRegistrationManagement_AreDiscoverable`, `ContextMenuManagement_ExplainsCurrentUserAndPackagedScope`는 모든 assertion을 `PopulatedQueue_ExposesEntryHelpHistoryAndRegistrationActions`의 동일 창 사용자 흐름으로 합쳤다. 창3회 생성을 줄였다.
|
|
- `IncompatibleQueue_DisablesKeyboardConversionToo`의 두 assertion은 `RemovingIncompatibleFile_RestoresFormatsAndConversionCommand`에서 제거 전 비활성→제거 후 재활성의 전체 시나리오로 합쳤다. 창1회 생성을 줄였다.
|
|
- UI 레이아웃/상태 테스트는 `persistHistory:false` 생성자 seam으로 실제 사용자 이력읽기·저장과 격리했다. 저장소 내구성/이력 정책 테스트는 별도로 유지한다.
|
|
- 컬렉션 병렬도를4로 제한하고 직렬 비용이 큰Queue/HTML/Core 컬렉션부터 시작한다. 어떤 테스트도 skip/filter로 전체 실행에서 제외하지 않는다. 기본 무제한 병렬은 WPF STA·네이티브 엔진·CSV/XLSX 초기화가 서로CPU를 경쟁해 개별 실행이 수초 늘어났다.
|
|
|
|
## 최종 자동 검증과 남은 게이트
|
|
|
|
- `test-completeness/full-release-final.trx`: clean Release 새 빌드, 전체501/501 통과, 실패/경고/건너뜀0. 실제 개별 결과 earliest start/latest end10.735059초, TRX start/finish12.220101초, 빌드+실행 wall19.3925942초다. T01의10초 목표는 아직 미달이다. 3worker 실험은12초로 악화하여4worker를 유지했다. 기록은 `final-timing.json`에 실패·중간실험을 포함한다.
|
|
- 빈 MainWindow 동일상태의 TitleBar4검사를1창으로, VisualTree 기본badge/기본format/format전환3검사를1창으로 묶고 모든 assertion을 helper에 유지했다. Queue 중복drop→선택/해제→검색0결과/복구도 같은1파일 시나리오로 묶었다. 테스트 수 감소는 중복 fixture 제거이며8출력/오류경계/실파일보존/접근성 검사를 삭제하지 않았다.
|
|
- 테스트가 만드는 모든 WPF Application은 OnExplicitShutdown으로 통일했다. 병렬 창 Close가 Application 자동종료를 일으켜 UIA source가 사라지는 하니스 수명 경합을 막았다. 실제 프로그램의 종료 정책은 바꾸지 않았다.
|
|
- 큐/이력 렌더 결함은 assertion RED 후 root가 XAML을 수정했고, 최종 캡처의1080DIP에서 파일명140DIP·메타데이터·툴바/통계 경계 및 실패 상태를 검증했다. 실제 Narrator/OS 고대비/Per-Monitor 전환은 별도 환경 검증으로 남는다.
|
|
- 이 검증 이후 root가 추가 발견한 기본 프리셋 충돌정책 수정은 별도 RED/GREEN 및 최종 전체 재검증이 필요하다. 이 문서의501 GREEN을 그 후 변경까지 통과한 것으로 해석하면 안 된다.
|
|
|
|
|
|
root 후속 프리셋 통합 RED/GREEN 뒤 최종501/501 통과, 테스트 실행9.5422초. 최종근거는 test-final/release-final-green.trx와 TASKS.md이며 위 child 시점 타이밍을 대체한다.
|