이슈 상태 모델
고정 6상태 — 수정 제출과 검수 완료는 다릅니다
고정 6상태
QA Note의 이슈는 아래 여섯 가지 상태만 가집니다. 프로젝트별 커스텀 상태는 없습니다 — 상태가 같은 의미를 가져야 리포트와 검수가 신뢰할 수 있는 기록이 되기 때문입니다.
| 상태 | 의미 | 누가 전환하나 |
|---|---|---|
| 접수 (open) | 이슈가 등록됨 | 캡처·제보·수동 등록 |
| 작업 중 (in_progress) | 작업이 시작됨 | 사람 또는 에이전트(MCP) |
| 수정 제출 (fix_submitted) | 수정이 제출됨 (커밋/PR) | 에이전트, 커밋 키 자동 기록 |
| 검수 완료 (verified) | 사람이 고쳐졌음을 확인함 | 사람만 (로그인 세션) |
| 보고 완료 (closed) | 리포트에 실려 보고됨 | 리포트 발행 시 자동 |
| 차단됨 (blocked) | 진행 불가 (사유 기록) | 사람 또는 에이전트 |
왜 수정 제출과 검수 완료를 나누나요?
에이전트의 자가 보고를 믿지 않기 때문입니다. 코딩 에이전트가 "고쳤다"고 보고하는 것(수정 제출)과, 사람이 실제 화면에서 고쳐졌음을 확인하는 것(검수 완료)은 다른 사건입니다. MCP와 API 키로는 검수 완료로 전환할 수 없습니다.
검수 가능 표시
수정 제출된 이슈라도 배포 전에는 검수할 수 없습니다. QA Note는 커밋과 배포 이벤트를 상관시켜, 수정 커밋이 실제로 배포된 이슈에만 '검수 가능' 표시를 붙입니다. 검수자는 이 목록만 확인하면 됩니다.
재발과 정정
- 검수 완료·보고 완료 이후 같은 문제가 재발하면 이슈를 다시 여는 reopen 이벤트가 기록됩니다. 상태 이력은 지워지지 않습니다.
- GitHub 동기화 시 각 상태는 고정된 라벨로 매핑됩니다. GitHub 쪽에서 라벨을 바꿔도 검수·보고 게이트는 우회되지 않습니다.