muno-claude-plugin 1.0.0

package/templates/skills/tc-generator/reference/tc-template.md

@@ -0,0 +1,451 @@
+# Test Case 템플릿
+
+## 파일명 규칙
+
+`TC-[Story번호]-[순번]-[영문-케밥-케이스].md`
+
+예: `TC-001-01-valid-login.md`, `TC-001-02-invalid-password.md`
+
+---
+
+## 템플릿
+
+```markdown
+---
+id: TC-XXX-NN
+title: [Test Case 제목]
+story_id: STORY-XXX
+ac_ids: [AC-1, AC-2]  # 연결된 AC 목록
+test_type: e2e  # e2e | integration | api | unit
+priority: P0    # P0 | P1 | P2 | P3
+automation: yes # yes | no | partial
+status: ready   # draft | ready | passed | failed | blocked
+created_at: YYYY-MM-DD
+updated_at: YYYY-MM-DD
+executed_at: YYYY-MM-DD  # 마지막 실행일
+executed_by: [실행자]
+---
+
+# TC-XXX-NN: [Test Case 제목]
+
+## 1. Story Reference
+
+### 연결 정보
+
+| 항목 | 내용 |
+|------|------|
+| Story ID | STORY-XXX |
+| Story 제목 | [Story 제목] |
+| Epic | EPIC-XXX |
+| 연결 AC | AC-1, AC-2 |
+
+### 검증 대상 User Story
+
+**AS A** [사용자 역할]
+**I WANT** [원하는 기능]
+**SO THAT** [비즈니스 가치]
+
+### 검증 대상 Acceptance Criteria
+
+```gherkin
+# AC-1: [AC 제목]
+Scenario: [시나리오 제목]
+  Given [전제 조건]
+  When [사용자 행동]
+  Then [기대 결과]
+
+# AC-2: [AC 제목] (해당시)
+Scenario: [시나리오 제목]
+  Given [전제 조건]
+  When [사용자 행동]
+  Then [기대 결과]
+```
+
+---
+
+## 2. Test Classification
+
+### 분류 정보
+
+| 항목 | 내용 | 비고 |
+|------|------|------|
+| 테스트 유형 | E2E / Integration / API / Unit | |
+| 우선순위 | P0 (Critical) | 핵심 기능 |
+| 자동화 가능 | Yes / No / Partial | |
+| 실행 환경 | Local / Dev / Staging / Prod | |
+| 예상 소요 | 수동: Xm / 자동: Xs | |
+| 실행 주기 | 매 빌드 / Daily / Weekly | |
+
+### 테스트 범위
+
+**포함**:
+- [테스트 범위에 포함되는 항목]
+- [테스트 범위에 포함되는 항목]
+
+**제외**:
+- [테스트 범위에서 제외되는 항목]
+- [테스트 범위에서 제외되는 항목]
+
+---
+
+## 3. Preconditions
+
+### 환경 조건
+
+- [ ] 애플리케이션 서버 실행 상태
+- [ ] 데이터베이스 연결 확인
+- [ ] Redis/캐시 서버 연결 확인 (해당시)
+- [ ] 외부 서비스 Mock 설정 완료 (해당시)
+
+### 데이터 조건
+
+| 데이터 | 조건 | 준비 방법 |
+|--------|------|----------|
+| 테스트 사용자 | `test@example.com` 계정 존재 | SQL 또는 API |
+| 테스트 상품 | 상품 ID 1001 존재 | SQL 또는 API |
+| [기타 데이터] | [조건] | [준비 방법] |
+
+### 상태 조건
+
+- [ ] 이전 테스트 데이터 정리 완료
+- [ ] 로그아웃 상태에서 시작
+- [ ] [기타 상태 조건]
+
+### 데이터 초기화 스크립트
+
+```sql
+-- 테스트 전 실행
+DELETE FROM [table] WHERE [condition];
+INSERT INTO [table] ([columns]) VALUES ([values]);
+```
+
+---
+
+## 4. Test Scenarios
+
+### TC-XXX-NN-01: [정상 케이스 제목]
+
+**케이스 유형**: Happy Path
+**AC 연결**: AC-1
+
+```gherkin
+Scenario: [시나리오 상세 제목]
+  Given [전제 조건 1]
+    | 필드 | 값 |
+    | email | test@example.com |
+    | password | SecurePass1! |
+  And [전제 조건 2]
+  When [사용자 행동 1]
+  And [사용자 행동 2]
+  Then [기대 결과 1]
+    | 검증 항목 | 기대값 |
+    | URL | /home |
+    | 상태코드 | 200 |
+  And [기대 결과 2]
+```
+
+**단계별 상세**:
+
+| Step | 행동 | 입력값 | 기대 결과 |
+|------|------|--------|----------|
+| 1 | 로그인 페이지 접속 | `/login` | 로그인 폼 표시 |
+| 2 | 이메일 입력 | `test@example.com` | 입력값 표시 |
+| 3 | 비밀번호 입력 | `SecurePass1!` | 마스킹 표시 |
+| 4 | 로그인 버튼 클릭 | - | 로딩 표시 |
+| 5 | 결과 확인 | - | 홈 화면 이동 |
+
+---
+
+### TC-XXX-NN-02: [예외 케이스 제목]
+
+**케이스 유형**: Exception / Error Handling
+**AC 연결**: AC-2
+
+```gherkin
+Scenario: [시나리오 상세 제목]
+  Given [전제 조건]
+  When [예외 상황 발생 행동]
+  Then [예외 처리 결과]
+```
+
+**단계별 상세**:
+
+| Step | 행동 | 입력값 | 기대 결과 |
+|------|------|--------|----------|
+| 1 | [행동] | [입력] | [결과] |
+
+---
+
+### TC-XXX-NN-03: [엣지 케이스 제목]
+
+**케이스 유형**: Edge Case / Boundary
+**AC 연결**: AC-3
+
+```gherkin
+Scenario: [시나리오 상세 제목]
+  Given [경계 조건]
+  When [경계값 입력]
+  Then [기대 결과]
+```
+
+---
+
+## 5. Expected Results
+
+### 검증 체크리스트
+
+| ID | 검증 항목 | 기대값 | 검증 방법 | 중요도 |
+|----|----------|--------|----------|--------|
+| V-01 | [검증항목1] | [기대값] | [방법] | Must |
+| V-02 | [검증항목2] | [기대값] | [방법] | Should |
+| V-03 | [검증항목3] | [기대값] | [방법] | Could |
+
+### UI 검증 (해당시)
+
+| 요소 | 검증 항목 | 기대값 |
+|------|----------|--------|
+| 버튼 | 텍스트 | "로그인" |
+| 버튼 | 상태 | 활성화 |
+| 에러 메시지 | 텍스트 | "이메일 또는 비밀번호가 올바르지 않습니다" |
+| 에러 메시지 | 색상 | #FF0000 (빨강) |
+
+### API 응답 검증 (해당시)
+
+**엔드포인트**: `[METHOD] /api/v1/[path]`
+
+**성공 응답** (HTTP 200):
+```json
+{
+  "status": "success",
+  "data": {
+    "field1": "expected_value",
+    "field2": 123
+  }
+}
+```
+
+**실패 응답** (HTTP 4XX):
+```json
+{
+  "status": "error",
+  "error": {
+    "code": "ERROR_CODE",
+    "message": "에러 메시지"
+  }
+}
+```
+
+### DB 상태 검증 (해당시)
+
+```sql
+-- 테스트 후 검증 쿼리
+SELECT [columns] FROM [table] WHERE [condition];
+-- 기대 결과: [설명]
+```
+
+---
+
+## 6. Test Data
+
+### 입력 데이터
+
+| 용도 | 필드 | 값 | 비고 |
+|------|------|-----|------|
+| 정상 케이스 | email | test@example.com | 등록된 계정 |
+| 정상 케이스 | password | SecurePass1! | 유효한 비밀번호 |
+| 예외 케이스 | email | test@example.com | |
+| 예외 케이스 | password | WrongPass! | 잘못된 비밀번호 |
+| 엣지 케이스 | email | a@b.c | 최소 길이 이메일 |
+
+### 사전 준비 데이터
+
+```sql
+-- 테스트 사용자 데이터
+INSERT INTO users (id, email, password_hash, status, created_at)
+VALUES
+  (1, 'test@example.com', '$2a$10$hashedpassword', 'ACTIVE', NOW()),
+  (2, 'inactive@example.com', '$2a$10$hashedpassword', 'INACTIVE', NOW());
+
+-- 테스트 후 정리
+DELETE FROM users WHERE email LIKE '%@example.com';
+```
+
+### Mock 데이터 (외부 연동시)
+
+**Mock 서비스**: [외부 서비스명]
+**Mock 설정 파일**: `test-data/mock-[service].json`
+
+```json
+{
+  "request": {
+    "method": "POST",
+    "url": "/external/api"
+  },
+  "response": {
+    "status": 200,
+    "body": {
+      "result": "success"
+    }
+  }
+}
+```
+
+---
+
+## 7. Execution History (선택)
+
+### 최근 실행 결과
+
+| 날짜 | 환경 | 결과 | 실행자 | 비고 |
+|------|------|------|--------|------|
+| YYYY-MM-DD | Staging | Pass | [이름] | |
+| YYYY-MM-DD | Dev | Fail | [이름] | 버그 #123 |
+
+### 관련 버그/이슈
+
+| 이슈 ID | 제목 | 상태 |
+|---------|------|------|
+| BUG-123 | [버그 제목] | Fixed |
+
+---
+
+## 8. Notes
+
+### 특이 사항
+- [테스트 시 주의할 점]
+- [알려진 제한 사항]
+
+### 관련 문서
+- Story: `backlogs/[feature]/STORY-XXX.md`
+- LLD: `documents/lld/[feature]-lld.md`
+- API 문서: `[링크]`
+
+### 변경 이력
+
+| 날짜 | 버전 | 변경 내용 | 작성자 |
+|------|------|----------|--------|
+| YYYY-MM-DD | 1.0 | 최초 작성 | [이름] |
+| YYYY-MM-DD | 1.1 | 엣지 케이스 추가 | [이름] |
+```
+
+---
+
+## 작성 가이드
+
+### Given-When-Then 작성법
+
+```markdown
+# 좋은 예
+Given 사용자가 로그인 페이지에 있다
+  And 등록된 이메일 "test@example.com"이 존재한다
+When 이메일 필드에 "test@example.com"을 입력한다
+  And 비밀번호 필드에 "SecurePass1!"을 입력한다
+  And 로그인 버튼을 클릭한다
+Then URL이 "/home"으로 변경된다
+  And 상단에 "test@example.com"이 표시된다
+
+# 나쁜 예
+Given 사용자가 있다
+When 로그인한다
+Then 성공한다
+→ 구체적인 값 없음, 검증 불가
+```
+
+### 테스트 데이터 작성법
+
+```markdown
+# 좋은 예 - 명시적이고 재현 가능
+| 필드 | 값 | 용도 |
+|------|-----|------|
+| email | test@example.com | 정상 로그인 |
+| password | SecurePass1! | 유효한 비밀번호 (8자 이상, 대소문자, 숫자, 특수문자) |
+
+# 나쁜 예 - 모호함
+| 필드 | 값 |
+|------|-----|
+| email | 유효한 이메일 |
+| password | 유효한 비밀번호 |
+→ "유효한"의 기준이 불명확
+```
+
+### 기대 결과 작성법
+
+```markdown
+# 좋은 예 - 검증 가능
+| 검증 항목 | 기대값 | 검증 방법 |
+|----------|--------|----------|
+| HTTP 상태 | 200 | Response status |
+| 응답 body.status | "success" | JSON path |
+| 쿠키 | session_id 존재 | Cookie 확인 |
+
+# 나쁜 예 - 검증 불가
+| 검증 항목 | 기대값 |
+|----------|--------|
+| 결과 | 성공 |
+| 화면 | 정상 표시 |
+→ "성공", "정상"의 기준 불명확
+```
+
+---
+
+## 케이스 유형별 가이드
+
+### Happy Path (정상 케이스)
+
+- 가장 일반적인 사용 시나리오
+- 모든 입력이 유효할 때의 동작
+- P0 또는 P1 우선순위
+- 반드시 자동화 대상
+
+### Exception Handling (예외 처리)
+
+- 유효하지 않은 입력
+- 권한 없음
+- 리소스 없음 (404)
+- 서버 오류 처리
+- 에러 메시지 검증
+
+### Edge Cases (경계 케이스)
+
+- 최소/최대 길이
+- 빈 값, null
+- 특수 문자
+- 동시성 (여러 사용자)
+- 타임아웃
+
+### Security Cases (보안 케이스)
+
+- 인증 없이 접근
+- 권한 없는 리소스 접근
+- SQL Injection 시도
+- XSS 시도
+- CSRF 토큰 검증
+
+---
+
+## 상태 정의
+
+| 상태 | 설명 | 다음 액션 |
+|------|------|----------|
+| `draft` | 작성 중 | 검토 요청 |
+| `ready` | 실행 준비 완료 | 테스트 실행 |
+| `passed` | 테스트 통과 | 완료 |
+| `failed` | 테스트 실패 | 버그 등록 |
+| `blocked` | 실행 불가 | 차단 요소 해결 |
+| `skipped` | 이번 사이클 스킵 | 사유 기록 |
+
+---
+
+## 체크리스트
+
+### 작성 전 확인
+- [ ] Story와 AC를 충분히 이해했는가?
+- [ ] 테스트 범위가 명확한가?
+
+### 작성 완료 확인
+- [ ] Story Reference가 정확한가?
+- [ ] 모든 AC가 TC로 커버되는가?
+- [ ] Given-When-Then이 구체적인가?
+- [ ] 테스트 데이터가 재현 가능한가?
+- [ ] 기대 결과가 검증 가능한가?
+- [ ] Test Agent가 바로 테스트 코드를 작성할 수 있는가?