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

7.1 KiB
Raw Blame History

UI/UX 감사와 구현 근거

후속 최종 구현: 프리셋 관리·시작 기본값, 등록 상태/해제, 실패 복구 메뉴, 키보드 미리보기와 이력 필터를 추가했다. 아래 기존 메뉴 목록은 감사 당시 기록이다. 최신 범위는 TASKS.md, 설정/프리셋 검증은 agent-settings-completion.md, 렌더·접근성 검증은 accessibility-qa.md를 따른다.

최소 창 렌더에서 발견한 선택 도구 모음 잘림, 큐/이력 파일명 폭 부족, 이력 통계와 버튼 겹침, 실패도 ‘완료’로 보이는 상태 표시는 추가 assertion RED 후 수정했다. 파일정보를 여러 줄에 나누고 제목 영역을 확보했다. 실제 Windows 시스템 설정 변경·스크린리더 전체 흐름은 미검증으로 유지한다.

범위 및 디자인 경로

designpaca 0단계는 기존 사용자 결정이 기록된 루트 design.md로 채웠다. 사용자도 자율 개선을 명시했다. Windows 11 네이티브, 한국어, 3분할, 두 광고 자리 유지가 이번 국소 보완의 전제다. 1~3단계는 기존 Microsoft Fluent 참조·토큰을 재사용하고 신규 시각 방향은 만들지 않았다. 4단계에서 동작과 접근 경로를 보완하고, 5단계는 공개 command/실제 WPF 바인딩 및 RenderTargetBitmap 캡처로 검증한다. 6단계는 design.md에 추기한다.

현재 메뉴·동작 목록

표면 기존 행동 기존 조건 및 문제
제목 표시줄 대기열/변환 기록, 엔진 상태, 설정, 컨텍스트 메뉴 등록, 진단, 로그 내보내기, 목록 비우기 아이콘은 접근성 이름 대부분 있음. 등록 해제·도움말·정보 진입 없음
변환 설정 출력 교집합, 내장 프리셋, 품질/형식별 옵션, 상세 인코딩, 단일파일 결합 형식 없음에서 결합 검사 빈 확장자 예외. 프리셋의 실제 인코더 전달 별도 감사
저장 위치 사용자 폴더, 건너뛰기/이름 변경/덮어쓰기 기본은 이름 변경. 실제 출력 이름 미리보기 없음
AI 작업 작업 종류·언어·백엔드 설정 원격 전송/모델 가용성 실효 검증은 별도 조사 항목. 자동 선택 조건을 추정해 완료로 보지 않음
목록 도구 검색, 종류 필터, 미리보기 접기 대기열에만 검색 연결. 검색 결과 없음 UI 없음
대기열 전체 선택, 선택 삭제, 완료 정리, 행 제거, 클릭 미리보기 Ctrl+A 해제 오류, 일괄 삭제 후 출력 미갱신, 행이 Border+마우스 이벤트
비어 있는 대기열 드롭 안내, 파일 찾기 파일이 생기면 파일 찾기 버튼 사라짐. Ctrl+O만 남음
기록 날짜별 결과, 로그 내보내기, 결과 위치 열기 실패만 재시도·원인 복사 부족. N→1 결과/입력 관계 감사 필요
처리 중 진행률, 취소 삭제/목록비우기 가능, Esc는 창 닫기. 취소 후 완료 결과 보존 별도 문제
설정 AI/외부도구/광고 고대비·확대·스크린리더 실제 사용자 환경 미검증

확정한 결함과 수정

Before After Why / 검증
Ctrl+A command null→false null은 전체선택, false는 체크박스 해제 KeyboardSelectAll... assertion RED→GREEN
같은 드롭 입력의 중복 미차단 기존집합에 추가하며 중복 검사 AddingSameFileTwice... 2→1 RED→GREEN
공통 형식 없는 혼합 입력에서 창 생성 예외 빈 확장자 결합 검사 차단·시작 command 비활성 혼합 PNG/CSV 생성과 CanExecute 시나리오
선택 삭제·완료 정리에서 출력 목록 잔류 단일 제거 경로로 구독 해제·출력/결합 상태 갱신 CSV 제거 후 PNG용 출력 복구
목록이 채워지면 파일 추가 행동 숨음 목록 위에 파일 추가·폴더 추가·도움말 제공 기존 FsSecondaryButton, 높이32/패딩12/간격8. 실제 native HWND 생성 후 Dispatcher 바인딩 검사
파일 선택에 오래된 이미지/문서만 나열 ProviderRegistry.AllInputExtensions에서 필터 생성 모든 등록 입력확장자가 필터에 있는지 검증
폴더 추가 명령 없음 폴더선택→기존 최상위 파일 확장 경로 하위폴더 제외를 선택창·툴팁·도움말에 명시, 접근거부/IO 오류 안내
도움말 및 버전 경로 없음 도움말 버튼·F1, 실제 assembly version/단축키/저장·덮어쓰기 설명 도움말 command 연결 검사. 모달 파일선택/도움말 클릭 시나리오는 별도 수동 검증 필요
처리 중 파괴 명령 활성·Esc 창 종료 삭제/정리/비우기 command 차단, Esc 취소 요청 ProcessingQueue_ProtectsItems... RED→GREEN. 제목 X 닫기 정책은 후속

시각 관찰

visual-before/main-queue-light.png를 직접 확인했다(1280×860, WPF RenderTargetBitmap, Mica 근사 배경). 3분할과 본문 계층은 유지할 가치가 있다. 파일 추가가 채워진 목록에 없는 점은 실제 캡처와 코드에서 모두 확인된다. 미리보기는 비동기 완료 전 미리보기 만드는 중… 상태이므로 캡처만으로 미리보기 성공 여부를 판정하지 않았다. 광고는 그대로 유지했다.

작업 중 새 버튼 테스트에서 바인딩이 null인 결과가 반복됐다. 원인은 오프스크린 트리에서 Window 조상 연결/비동기 DataBind를 처리하지 않은 fixture였다. Microsoft의 Dispatcher 우선순위와 WPF threading model을 확인하고, 실제 숨김 HWND 생성과 ContextIdle까지 DispatcherFrame을 처리하는 테스트로 변경했다. assertion을 제거해 통과시키지 않았다.

남은 작업과 증거 경계

TASKS.md Q06Q11/U05U11 및 research-backlog.md R01~R40에 연결했다. 코드 미존재/확정 결함/실행 미검증을 구분한다. 스크린리더·OS 고대비·125/150% 배율·실제 폴더선택·도움말 모달·Windows Explorer 등록/해제는 자동 assertion 통과로 대체하지 않는다. 전후 렌더 비교는 동일 크기로 남기며 사용자 작업 시간/이해도 개선은 측정하지 않았다.

변경 후 확인

검색 0건에는 전용 안내와 조건 초기화 버튼을 추가했다. 검색·종류 필터를 초기화하면 원래 목록이 다시 나타나는 command 시나리오를 검증했다.

visual-after/main-queue-light.png와 visual-after/main-empty-dark.png를 직접 열어 확인했다. 1280×860에서 추가 행동 3개가 상시 노출되고 기존 3분할·광고 자리·변환 시작 위계가 유지되며 해당 화면에 겹침은 보이지 않았다. 12개 캡처 생성 테스트도 통과했다. 이 확인을 다른 배율·스크린리더·실제 모달 검증으로 확대 해석하지 않는다.

최종 전체 테스트는 450 통과/실패 0/건너뜀 0, 26초다. test-final/final.trx를 보존했다. 테스트 10초 규약은 미달이며 별도 T01로 추적한다.