testing.md

테스트 전략

목표

Trace의 MVP 테스트는 캡처 앱의 핵심 흐름이 반복 사용 중 깨지지 않는 것을 목표로 한다.

단위 테스트 대상

저장 경로

• 날짜별 폴더 경로 생성
• 파일명 생성
• 파일명 충돌 처리
• 상대 경로와 절대 경로 변환
• 원자적 메타데이터 쓰기
• 손상된 메타데이터 파일 복구
• 저장 위치 전환 시 선택한 위치의 메타데이터만 로드

설정

• 기본 설정 생성
• 설정 저장
• 설정 불러오기
• 마지막으로 선택한 저장 위치 복원
• 잘못된 설정 파일 처리

메타데이터

• 캡처 항목 추가
• 최신순 정렬
• 날짜별 그룹화
• 누락 파일 상태 표시

캡처 방식 분기

• 기본 캡처 모드에서는 전달 대상 선택 창을 띄우지 않는다.
• 앱으로 자동 전달 모드에서 전달 대상 방식이 매번 앱 선택이면 캡처 후 전달 대상 선택 창을 띄운다.
• 앱으로 자동 전달 모드에서 전달 대상 방식이 가장 최근 사용 앱이면 캡처 후 선택 창 없이 캡처 시작 직전 활성 앱으로 전달한다.
• 앱으로 자동 전달 모드에서 전달 대상 방식이 지정한 앱이면 지정 앱으로 바로 전달한다.
• 지정 앱이 실행 중이지 않으면 실패 알림을 보낸다.
• 지정 앱의 윈도우 처리 방식이 윈도우 선택이면 지정 앱의 윈도우 선택 창을 띄운다.
• 건너뛰기 시 전달용 클립보드는 유지되고, 저장 옵션이면 저장도 유지된다.
• Accessibility 권한이 없으면 자동 전달을 시도하지 않는다.
• 저장된 자동 전달 캡처에서 대상 앱 전달 실패 시 실패 상태가 기록된다.

권한 상태

• Screen Recording 권한이 없으면 캡처 시작이 macOS 권한 요청으로 이어지고 캡처 UI는 열리지 않는다.
• Accessibility 권한이 없으면 앱 자동 전달이 macOS 권한 요청으로 이어지고 전달은 시도하지 않는다.
• Notifications 권한이 없으면 저장은 성공하고 알림만 생략된다.

통합 테스트 대상

기본 캡처

1. 캡처 시작
2. 영역 선택
3. 자동 복사 설정이 켜져 있으면 클립보드 복사
4. 저장 설정이면 이미지 저장
5. 저장된 경우 히스토리 반영

앱으로 자동 전달 캡처

1. 자동 전달 캡처 시작
2. 영역 선택
3. 전달용 클립보드 복사
4. 저장 및 전달 설정이면 이미지 저장
5. 매번 앱 선택 설정이면 전달 대상 선택 창 표시
6. 앱 선택 또는 가장 최근 사용 앱 설정이면 캡처 시작 직전 활성 앱 사용
7. 지정한 앱 설정이면 지정 앱 실행 여부 확인 후 윈도우 처리 설정 적용
8. 앱 활성화와 붙여넣기 이벤트 전송 완료
9. 저장된 경우 히스토리 반영

히스토리 재사용

1. 히스토리 창 열기
2. 최근 캡처 확인
3. 날짜별 이력 확인
4. 이미지 미리보기
5. 클립보드에 다시 복사
6. Finder에서 보기

수동 점검 체크리스트

• 메뉴바 앱이 실행되는가
• 단축키로 캡처가 시작되는가
• 캡처 오버레이가 열린 상태에서 영역/전체 화면과 복사/전달을 바꿀 수 있는가
• 캡처 취소가 가능한가
• 멀티 디스플레이에서 선택 영역이 정확한가
• Retina 디스플레이에서 저장 이미지 크기가 의도와 맞는가
• 저장 위치에 날짜별 폴더가 생성되는가
• 저장 위치를 바꾸면 해당 위치의 히스토리만 표시되고, 이전 위치를 다시 선택하면 기존 히스토리가 다시 표시되는가
• 자동 복사 설정이 켜져 있으면 클립보드에 이미지가 들어가는가
• 기본 캡처 모드에서 전달 대상 창이 뜨지 않는가
• 자동 전달 모드의 매번 앱 선택 설정에서 범위 선택 후 전달 대상 창이 뜨는가
• 자동 전달 모드의 가장 최근 사용 앱 설정에서 범위 선택 후 이전 활성 앱으로 바로 돌아가 붙여넣기를 보내는가
• 자동 전달 모드의 지정한 앱 설정에서 지정 앱으로 바로 붙여넣기를 보내는가
• 지정 앱이 꺼져 있으면 실패 알림이 표시되는가
• 지정 앱의 윈도우 선택 설정에서 지정 앱의 윈도우 선택 창만 표시되는가
• 자동 전달 실패 시 사용자가 실패를 알 수 있는가
• 히스토리에서 최근 캡처가 최신순으로 보이는가
• 파일을 Finder에서 열 수 있는가