소프트웨어 테스팅의 테스트 문서(예)
토마스 해밀턴
⚡ 스마트 요약
테스트 문서는 소프트웨어 테스트 전이나 테스트 중에 생성되는 구조화된 아티팩트를 정의합니다. 목표, 전략, 테스트 케이스 및 결과를 문서화하여 계획, 실행, 추적성 및 품질 보증을 지원합니다. 효과적인 문서화는 프로젝트 전반의 적용 범위, 투명성 및 반복성을 향상시킵니다.
테스트 문서란 무엇입니까?
테스트 문서는 소프트웨어 테스트 전이나 테스트 중에 생성된 결과물(아티팩트)을 기록한 문서입니다. 테스트 팀은 이를 통해 필요한 노력을 예측하고, 리소스와 진행 상황을 추적하며, 적절한 테스트 커버리지를 확보할 수 있습니다. 테스트 기록과 보고서는 테스트 계획, 테스트 설계, 테스트 실행, 그리고 테스트 활동에서 도출된 테스트 결과를 설명하고 문서화할 수 있는 완전한 문서 모음입니다.
👉 무료 라이브 소프트웨어 테스팅 프로젝트에 등록하세요
왜 시험 형식이 필요한가?
초보자에게는 테스트란 다양한 코드 섹션을 임시적으로 실행하고 결과를 검증하는 것이라고 생각하기 쉽습니다. 하지만 현실 세계에서 테스트는 매우 공식적인 활동이며 세부적으로 문서화됩니다. 테스트 문서는 테스트 계획, 검토 및 실행을 쉽고 검증 가능하게 만들어 줍니다.
시험 형식성의 정도는 다음에 따라 달라집니다.
- 테스트 대상 애플리케이션(AUT)의 유형입니다.
- 귀하의 조직에서 따르는 표준입니다.
- 개발 프로세스의 성숙도.
테스트 활동은 일반적으로 다음 사이에 소모됩니다. 30 %와 50 % 전체 소프트웨어 개발 노력의 결과입니다. 문서는 향후 프로젝트에 적용할 수 있는 테스트 프로세스 개선 사항을 파악하는 데 도움이 됩니다.
테스트 문서에는 어떤 유형이 있나요?
테스트 문서의 주요 유형은 다음과 같습니다.
"실제로 이러한 문서는 초기 계획(테스트 정책, 전략)부터 실행 및 종료(결함 및 요약 보고서)까지 다양한 단계에서 작성됩니다."
| 테스트 문서 유형 | 기술설명 |
|---|---|
| 테스트 정책 | 조직의 원칙, 방법 및 모든 중요한 테스트 목표를 설명하는 고급 문서입니다. |
| 테스트 전략 | 프로젝트에 대해 실행할 테스트 수준(유형)을 식별하는 상위 수준 문서입니다. |
| 테스트 계획 | 테스트 계획은 테스트 활동의 범위, 접근 방식, 리소스, 일정 등을 포함하는 완전한 계획 문서입니다. |
| 요구 사항 추적 성 매트릭스 | 이는 요구 사항을 테스트 사례에 연결하는 문서입니다. |
| 테스트 시나리오 | 테스트 시나리오 하나 이상의 테스트 케이스를 통해 검증할 수 있는 소프트웨어 시스템의 항목이나 이벤트입니다. |
| 테스트 케이스 | 입력 값, 실행 전제 조건, 예상 실행 사후 조건, 그리고 결과의 집합으로, 테스트 시나리오를 위해 개발되었습니다. |
| 테스트 데이터 | 테스트 데이터는 테스트가 실행되기 전에 존재하는 데이터입니다. 테스트 케이스를 실행하는 데 사용됩니다. |
| 결함 보고서 | 결함 보고서는 예상 기능을 수행하지 못하는 소프트웨어 시스템의 결함을 문서화한 보고서입니다. |
| 테스트 요약 보고서 | 테스트 요약 보고서는 수행된 테스트 활동과 테스트 결과를 요약한 상위 수준의 문서입니다. |
테스트 문서화를 달성하기 위한 모범 사례는 무엇입니까?
이 섹션에서는 테스트 문서화를 달성하는 데 도움이 되는 모범 사례에 대해 알아보고 이를 더 잘 이해하는 데 도움이 되는 예를 살펴보겠습니다.
- 프로젝트 초기에 QA를 참여시키세요: 프로젝트 초기부터 QA팀을 포함시켜 제품 설계 및 요구 사항과 함께 테스트 문서도 개발합니다.
예: QA는 스프린트 계획 중에 협업하여 사용자 스토리를 기반으로 초기 테스트 사례를 초안합니다. - 문서를 최신 상태로 유지하세요: 테스트 문서를 만들고 그냥 잊어버리지 마세요. 요구 사항이나 기능이 변경될 때마다 업데이트하세요.
예: 로그인 API가 변경되면 관련 테스트 사례와 결과를 즉시 업데이트합니다. - 버전 제어 사용: 혼란과 데이터 손실을 방지하기 위해 버전 제어 시스템을 통해 테스트 문서의 모든 변경 사항을 관리하고 추적합니다.
예: 명확한 버전 기록과 롤백 옵션을 유지하려면 GitHub에 테스트 계획을 저장하세요. - 명확성과 목적을 위한 문서: 테스트 진행 상황과 성과물을 이해하는 데 도움이 되는 내용만 기록하세요.
예: 관리자 검토를 위해 통과, 실패, 차단된 테스트 사례를 강조하는 테스트 요약 보고서를 포함합니다. - 표준 템플릿 사용: Excel이나 Word 템플릿과 같은 일관된 형식을 따르면 문서를 더 쉽게 만들고 검토할 수 있습니다.
예: ID, 설명, 전제 조건 및 예상 결과에 대한 필드가 있는 표준 "테스트 케이스 템플릿"을 사용합니다. - 문서 저장을 중앙화하세요: 팀원들이 쉽게 참조하거나 업데이트할 수 있도록 모든 프로젝트 관련 문서를 한 곳에 보관하세요.
예: 공유된 테스트 아티팩트 저장 Google Drive QA 및 개발 팀 전체가 접근할 수 있는 폴더입니다. - 충분한 세부 정보를 포함하세요: 모호하거나 불완전한 정보는 피하세요. 자세한 설명은 이해를 높이고 테스트 실행 중 오류를 줄여줍니다.
예: "로그인 확인" 대신 "유효한 자격 증명으로 사용자 로그인을 확인하면 대시보드로 성공적으로 리디렉션됩니다."라고 작성합니다.
소프트웨어 테스트를 위한 테스트 문서는 언제 작성해야 할까요?
소프트웨어 테스트를 위한 테스트 문서를 작성해야 하는 주요 사항은 다음과 같습니다.
- 계획 단계: 테스트 실행을 시작하기 전에 범위, 목표, 테스트 전략을 명확하게 정의합니다.
- 시험 준비: 테스트 계획 시, 타임라인, 리소스, 환경 요구 사항을 효율적으로 설정합니다.
- 요구 사항 분석 : 요구사항 분석 후 기능적 사양과 비기능적 사양을 모두 완벽하게 포괄하도록 보장합니다.
- 설계 표준화: 테스트 사례를 설계하기 전에 형식을 표준화하고 모든 문서에서 추적성을 유지합니다.
- 시나리오 문서: 테스트 설계 중에 시나리오, 입력, 예상 출력 및 테스트 데이터 세부 정보를 문서화합니다.
- 실행 준비성: 테스트를 실행하기 전에 테스트 환경, 도구, 문서의 정확성이 준비되었는지 확인합니다.
- 사후 평가: 테스트 후 프로세스 개선을 위해 결과, 결함, 교훈을 기록합니다.
테스트 문서화에는 어떤 유형의 템플릿이 필요합니까?
소프트웨어 테스트에서 테스트 문서화에 필요한 템플릿은 다음과 같습니다.
| 템플릿 이름 | 도구 |
|---|---|
| 테스트 계획 템플릿 | Microsoft Word, Google Doc협업 편집 및 버전 제어를 위한 s 또는 Confluence |
| 테스트 케이스 템플릿 | 구조화된 테스트 관리를 위한 TestRail, Zephyr(JIRA), Xray 또는 Excel/Google 시트 |
| 테스트 시나리오 템플릿 | 고수준 테스트 조건을 문서화하기 위한 JIRA, TestLink 또는 Google 시트 |
| 요구 사항 추적 매트릭스(RTM) 템플릿 | 요구 사항을 테스트 케이스에 매핑하기 위한 Excel, Google Sheets 또는 TestRail |
| 결함 보고서 템플릿 | JIRA, Bugzilla 또는 Azure 결함 로깅 및 추적을 위한 DevOps |
| 테스트 요약 보고서 템플릿 | 합류, Google Doc테스트 결과 및 분석을 컴파일하기 위한 s 또는 TestRail |
테스트 문서의 장단점
장점
- 테스트 문서를 작성하는 주된 이유는 테스트 활동에 대한 불확실성을 줄이거나 없애기 위해서입니다. 작업 할당과 관련하여 종종 발생하는 모호성을 제거하는 데 도움이 됩니다.
- 문서화는 체계적인 접근 방식을 제공할 뿐만 아니라 소프트웨어 테스팅뿐만 아니라, 소프트웨어 테스팅 과정을 처음 접하는 신입 직원을 위한 교육 자료로도 활용됩니다.
- 성숙한 테스트 프로세스를 보여주기 위해 테스트 문서를 선보이는 것은 좋은 마케팅 및 판매 전략이 됩니다.
- 테스트 문서는 특정 기간 내에 고객에게 고품질의 제품을 제공하는 데 도움이 됩니다.
- In 소프트웨어 공학테스트 문서는 구성 문서와 운영자 매뉴얼을 통해 프로그램을 구성하거나 설정하는 데에도 도움이 됩니다.
- 테스트 문서는 고객과의 투명성을 개선하는 데 도움이 됩니다.
단점
- 문서화하는 데는 많은 시간이 걸리므로 비용이 가치보다 더 많이 들 수도 있습니다.
- 글을 잘 못 쓰는 사람이나 내용을 잘 모르는 사람이 쓴 글이 많은데요.
- 클라이언트가 요청한 변경 사항을 추적하고 해당 문서를 업데이트하는 것은 힘든 일입니다.
- 문서화가 제대로 이루어지지 않으면 제품 품질이 직접적으로 반영되는데, 고객과 조직 사이에 오해가 생길 수 있기 때문입니다.
테스트 문서에서 피해야 할 일반적인 실수
테스트 문서에서 피해야 할 가장 흔한 실수는 다음과 같습니다.
- 불분명하거나 모호한 테스트 사례 설명을 작성하지 마세요.
- 테스트 전제 조건과 종속성을 문서화하는 것을 건너뛰지 마세요.
- 각 테스트에 대한 예상 결과를 포함하는 것을 잊지 마세요.
- 다양한 테스트 문서에서 일관되지 않은 서식을 사용하지 마세요.
- 모호하거나 측정할 수 없는 테스트 목표는 사용하지 마세요.
- 테스트 문서 업데이트를 위한 버전 제어를 생략하지 마세요.
- 여러 테스트 아티팩트에 걸쳐 정보가 중복되는 것을 피하세요.
- 정확성과 완전성을 위해 문서 검토를 소홀히 하지 마세요.
