Files
CODE_ASSISTANT/specs/002-capture-to-chat/quickstart.md
T
2026-09-16 17:22:14 +09:00

35 lines
2.0 KiB
Markdown

# Quickstart: 화면 캡쳐 → 챗 첨부 검증
end-to-end "돌아간다" 확인 가이드. 구현은 tasks.md/구현 단계.
## 전제
- Windows + WebView2. `3_windowsApp` 빌드(.NET SDK), `2_frontend` `npm install`.
- DEBUG 실행은 WebView2 안에 vite dev 물어 띄움 → 브릿지 살아있음.
## 실행
```pwsh
# 데스크톱 런처(DEBUG) — CodeAssist.App 빌드/실행
```
## 단위 검증 (호스트 없이)
```pwsh
cd 2_frontend; npm run test # Composer 이미지 첨부 상태·capture.image 수신(consume) 로직
dotnet test 3_windowsApp/CodeAssist.Tests # (있으면) 좌표/DPI 변환 순수부
```
## end-to-end 시나리오 (수동 — 오버레이·CopyFromScreen은 헤드리스 불가)
1. **오버레이** (AS-1): 아무 창 포커스 → `Ctrl+Shift+9` → 모든 모니터가 어두워지며 캡쳐 오버레이 뜸(십자 커서).
2. **캡쳐→첨부** (AS-2): 영역 드래그 후 놓음 → 오버레이 닫히고 앱 창이 떠 **새 대화**로 이동, 입력창에 그 영역 **썸네일 첨부** 붙음.
3. **내용 일치** (SC-002): 첨부 썸네일이 드래그로 고른 영역과 내용·경계 일치.
4. **취소** (AS-3): 오버레이서 `Esc` 또는 드래그 없이 클릭 → 아무 캡쳐 없이 닫힘, 챗·클립보드 변화 없음.
5. **멀티모니터** (AS-5/SC-003): 보조 모니터 영역 드래그 → 그 영역 정확히 캡쳐.
6. **제거** (AS-4): 첨부의 X → 그 첨부 사라짐.
7. **누적** (AS-6): 한 번 더 캡쳐 → 첨부 하나 더 추가(기존 유지).
8. **v1 전송 경계** (FR-009): 이미지 첨부 있는 상태로 메시지 전송 → **텍스트만** 나가고 이미지는 백엔드로 안 감(분석 안 일어남). (백엔드 붙기 전까지 정상.)
## 참조
- 메시지·표면 계약: [contracts/bridge-capture.md](./contracts/bridge-capture.md)
- 데이터/상태: [data-model.md](./data-model.md)
- 결정 근거(캡쳐 API·DPI·전달): [research.md](./research.md)