# 이슈 분류 표준 체계 (Issue Taxonomy)
> 버전: 1.0 | 작성일: 2026-03-15 | 참조: gstack A8 (issue-taxonomy)
> 도입 근거: QA 이슈 보고의 비표준화 → 팀별 다른 형식 → 우선순위/비교 불가

---

## 1. 심각도 (Severity) — 4단계

### CRITICAL (S1)
- 정의: 핵심 기능이 완전히 작동하지 않음. 데이터 손실 위험. 보안 취약점.
- 예시: 서버 크래시, 데이터 유실, 인증 우회, 결제 오류
- 대응: 즉시 수정. 다른 작업 중단하고 핫픽스.
- SLA: 4시간 이내

### HIGH (S2)
- 정의: 주요 기능이 의도대로 작동하지 않으나 우회 가능. 사용자 경험 심각 저하.
- 예시: 검색 결과 누락, 페이지 로딩 10초+, 잘못된 데이터 표시
- 대응: 현재 스프린트 내 수정.
- SLA: 24시간 이내

### MEDIUM (S3)
- 정의: 부가 기능 오류 또는 UX 불편. 핵심 흐름에 영향 없음.
- 예시: 정렬 오류, 디자인 깨짐(비핵심 페이지), 느린 애니메이션
- 대응: 다음 릴리즈에 포함.
- SLA: 1주 이내

### LOW (S4)
- 정의: 미세한 개선점. 기능에 영향 없음. 코스메틱 이슈.
- 예시: 오타, 미세한 정렬 불일치, 콘솔 경고(무해)
- 대응: 백로그 등록. 여유 시 수정.
- SLA: 없음 (백로그)

---

## 2. 카테고리 (Category) — 7개

### Visual (시각)
- 레이아웃 깨짐, 반응형 오류, 색상/폰트 불일치, 이미지 깨짐
- 확인 방법: 스크린샷 비교, 디자인 시안 대조

### Functional (기능)
- 버튼/링크 미작동, 폼 제출 실패, API 호출 오류, 상태 관리 버그
- 확인 방법: 시나리오별 테스트, API 응답 확인

### UX (사용자 경험)
- 혼란스러운 네비게이션, 불명확한 에러 메시지, 느린 피드백, 접근성 저하
- 확인 방법: 사용자 시나리오 워크스루, 접근성 도구

### Content (콘텐츠)
- 오타, 잘못된 정보, 누락된 텍스트, 번역 오류
- 확인 방법: 콘텐츠 검수 체크리스트

### Performance (성능)
- 느린 로딩(3초+), 높은 메모리 사용, 불필요한 리렌더링, 번들 사이즈
- 확인 방법: Lighthouse, Chrome DevTools, bundle analyzer

### Console (콘솔)
- JavaScript 에러, 경고, 네트워크 실패, 미처리 Promise rejection
- 확인 방법: 브라우저 DevTools Console 탭

### Accessibility (접근성)
- 스크린 리더 미지원, 키보드 네비게이션 불가, 색 대비 부족, ARIA 누락
- 확인 방법: axe DevTools, 키보드만으로 전체 흐름 탐색

---

## 3. 이슈 보고 형식

모든 QA 이슈는 아래 형식으로 보고한다:

```
[S{심각도}] [{카테고리}] {이슈 제목}
- 재현 경로: {페이지} > {동작} > {결과}
- 기대 결과: {정상 동작}
- 실제 결과: {비정상 동작}
- 스크린샷/로그: {첨부}
- 환경: {브라우저/OS/해상도}
```

예시:
```
[S2] [Functional] 검색 결과 페이지에서 필터 적용 시 결과 0건 표시
- 재현 경로: /search > "보험" 검색 > "생명보험" 필터 클릭
- 기대 결과: 생명보험 관련 결과만 필터링
- 실제 결과: 결과 0건 표시 (전체 결과가 사라짐)
- 스크린샷: [첨부]
- 환경: Chrome 120, macOS 14.2
```

---

## 4. 페이지별 탐색 체크리스트 (QA 기본 루틴)

각 페이지 테스트 시 아래 항목을 순서대로 확인:

1. [ ] 페이지 로딩 완료 (3초 이내)
2. [ ] Console 에러 없음
3. [ ] 모든 링크/버튼 작동
4. [ ] 폼 입력 + 제출 정상
5. [ ] 반응형 (모바일/태블릿/데스크톱)
6. [ ] 이미지/미디어 로딩
7. [ ] 에러 상태 표시 (네트워크 끊김 등)
8. [ ] 접근성 기본 (키보드 탐색, 스크린 리더)

---

## 변경 이력

- v1.0 (2026-03-15): 초기 작성 (gstack A8 기반, task-566.1)

> 참조: gstack issue-taxonomy.md (4단계 심각도 × 7카테고리)