QA 관리
ProjectHub에 내장된 이슈 트래킹 시스템으로, 버그 보고부터 AI 자동 수정까지 QA 전 과정을 관리합니다.
개요
QA 탭에서 프로젝트의 이슈(버그, 개선사항, 기능 요청 등)를 체계적으로 관리할 수 있습니다.
QA 탭 전체 레이아웃 (이슈 목록 + 상세 뷰)public/images/manual/qa-management/qa-01-full-layout.png스크린샷 교체 예정
핵심 기능
- 5가지 이슈 유형 지원
- 7가지 상태 워크플로우
- 4단계 우선순위
- 4단계 심각도
- AI 자동 버그 수정 연동
- 코멘트 및 첨부 파일
이슈 유형
| 유형 | 아이콘 | 색상 | 용도 |
|---|---|---|---|
| Bug | 🐞 | 빨강 | 버그, 오류, 결함 |
| Improvement | ⬆️ | 파랑 | 기존 기능 개선 |
| Feature Request | ⭐ | 보라 | 새로운 기능 요청 |
| Question | ❓ | 주황 | 질문, 논의 사항 |
| Task | ✅ | 초록 | 일반 작업, 할 일 |
이슈 생성 폼 - 유형 선택 드롭다운public/images/manual/qa-management/qa-02-create-type-dropdown.png스크린샷 교체 예정
이슈 상태
이슈는 다음 상태 워크플로우를 따릅니다:
Open → Reviewing → In Progress → Testing → Closed
↕
Reopened
↓
Rejected
| 상태 | 아이콘 | 색상 | 설명 |
|---|---|---|---|
| Open | ○ | 파랑 | 새로 등록된 이슈 |
| Reviewing | 👁️ | 주황 | 검토 중 |
| In Progress | 🔄 | 보라 | 수정/개발 진행 중 |
| Testing | 🧪 | 청록 | 테스트 진행 중 |
| Closed | ✅ | 초록 | 해결 완료 |
| Rejected | ✖️ | 회색 | 거절됨 (수정 불필요) |
| Reopened | ↩️ | 빨강 | 재오픈 (재발 또는 미해결) |
이슈 상세 - 상태 변경 드롭다운public/images/manual/qa-management/qa-03-status-dropdown.png스크린샷 교체 예정
우선순위
| 우선순위 | 아이콘 | 색상 | 설명 |
|---|---|---|---|
| Urgent | ‼️‼️‼️ | 빨강 | 즉시 수정 필요 |
| High | ‼️‼️ | 주황 | 빠른 수정 필요 |
| Medium | ‼️ | 노랑 | 일반적인 우선순위 |
| Low | — | 회색 | 낮은 우선순위 |
심각도
| 심각도 | 설명 |
|---|---|
| Critical | 시스템 전체 장애, 데이터 손실 |
| Major | 주요 기능 장애 |
| Minor | 사소한 기능 문제 |
| Trivial | 시각적 문제, 오타 등 |
이슈 생성
이슈 생성 폼 전체public/images/manual/qa-management/qa-04-create-form-full.png스크린샷 교체 예정
필수 필드
| 필드 | 설명 |
|---|---|
| 제목 | 이슈를 설명하는 짧은 제목 |
| 유형 | Bug, Improvement, Feature 등 |
| 우선순위 | Urgent ~ Low |
선택 필드
| 필드 | 설명 |
|---|---|
| 설명 | 상세한 이슈 설명 |
| 심각도 | Critical ~ Trivial |
| 담당자 | 이슈 담당 개발자 |
| 보고자 | 이슈를 보고한 사람 |
| 마감일 | 수정 마감 날짜 |
| 태그 | 분류 태그 |
| 관련 이슈 | 연결된 다른 이슈 |
| 첨부 파일 | 스크린샷, 로그 파일 등 |
| 해결 방법 | 수정 완료 시 해결 방법 기록 |
이슈 상세 보기
이슈 상세 뷰 전체 (정보 + 코멘트 + 히스토리)public/images/manual/qa-management/qa-05-detail-full.png스크린샷 교체 예정
이슈를 클릭하면 다음 정보를 확인할 수 있습니다:
- 전체 이슈 정보
- 코멘트 목록 (스레드 형식)
- 상태 변경 히스토리
- 첨부 파일
- 관련 이슈 링크
코멘트
이슈에 코멘트를 추가하여 논의할 수 있습니다:
코멘트 입력 폼과 기존 코멘트 목록public/images/manual/qa-management/qa-06-comments.png스크린샷 교체 예정
- 텍스트 코멘트 작성
- 상태 변경 시 자동 코멘트
- 타임스탬프 표시
AI 자동 버그 수정
QA 시스템의 가장 강력한 기능은 AI에게 이슈를 할당하여 자동으로 수정하는 것입니다.
AI에게 이슈 할당 버튼public/images/manual/qa-management/qa-07-ai-assign-btn.png스크린샷 교체 예정
작동 방식
- 이슈 상세에서 AI에게 할당 버튼 클릭
- AI가 3단계로 작업을 진행합니다:
| 단계 | 설명 | 표시 |
|---|---|---|
| Analyzing | 이슈 분석 및 원인 파악 | 🔍 분석 중 |
| Planning | 수정 계획 수립 | 📋 계획 중 |
| Working | 코드 수정 실행 | 💻 작업 중 |
AI 진행 상태 - 3단계 진행 바public/images/manual/qa-management/qa-08-ai-progress.png스크린샷 교체 예정
- 수정 완료 시 이슈 상태가 자동으로 Testing으로 변경됩니다
- 경과 시간이 표시됩니다
AI 오류 시
AI가 오류를 만나면:
- 오류 상태가 표시됩니다
- 재시작 버튼으로 다시 시도할 수 있습니다
AI 오류 상태 - 재시작 버튼public/images/manual/qa-management/qa-09-ai-error.png스크린샷 교체 예정
이슈 필터링 및 정렬
이슈 목록 - 필터 및 정렬 옵션public/images/manual/qa-management/qa-10-filter-sort.png스크린샷 교체 예정
- 유형별 필터 — Bug만, Feature만 등
- 상태별 필터 — Open만, Closed 제외 등
- 우선순위별 필터 — Urgent만 등
- 담당자별 필터 — 특정 담당자의 이슈만
- 정렬 — 최신순, 우선순위순, 마감일순