시스템 오류/결함 리포트

결함 리포트는 문제를 본 사람이 그것을 고쳐야 하는 사람에게 보내는 메시지입니다. 하는 일은 하나, 그 자리에 없었던 사람이 같은 문제를 다시 일으킬 수 있게 하는 것입니다. “청구서 화면이 고장 났어요”라고만 쓰면 개발자는 한 시간 동안 되묻게 되지만, 버전과 재현 절차, 기대한 결과와 실제 결과가 적혀 있으면 그날 안에 고쳐지는 일도 많습니다.

이 서식은 그 점을 중심으로 만들었습니다. 알아보기 쉬운 제목, 발생 환경(환경, 버전, 기기), 번호 순서의 재현 절차, 기대 결과와 실제 결과, 얼마나 심각한지(심각도)와 얼마나 빨리 고쳐야 하는지(우선순위), 문제를 보여 주는 파일과 그 위치, 리포트에 일어난 일의 이력을 적습니다. 항목이 단순해서 어떤 이슈 관리 도구에도 복사해 넣을 수 있고, 웹 페이지, 모바일 앱, 서비스, 게임 어디에나 같은 방식으로 쓸 수 있습니다. 국제 공통 양식 한 가지이며, 리포트는 업무용 문서이지 법률 자문이 아닙니다.

• 제품을 테스트하거나 쓰다가 문제를 발견해 제대로 전달해야 할 때
• 고객이나 동료가 말로 설명한 문제를 개발자가 쓸 수 있는 형태로 정리하고 싶을 때
• 이슈 관리 도구가 없거나 문제가 생겼을 때 쓸 수 없을 때
• 테스트 결과서, 공급사와의 협의, 하자보증 논의에 쓸 인쇄본이나 Word 기록이 필요할 때

1. 무엇이 어디서 잘못되는지 한 줄 제목으로 씁니다.
2. 발생 환경을 적습니다. 환경, 버전·빌드, 운영체제, 브라우저·앱, 기기입니다.
3. 재현 절차를 순서대로, 한 줄에 동작 하나씩, 새로 로그인한 상태처럼 알려진 상태에서 시작해 적습니다.
4. 기대한 결과와 실제 결과를 적고, 아는 우회 방법과 영향받는 사람도 적습니다.
5. 심각도와 우선순위를 정하고 발생 빈도를 고른 뒤, 스크린샷·로그·녹화와 그 위치를 적습니다. 먼저 비밀번호와 개인정보를 지우세요.
6. 리포트가 분류, 수정, 검증되는 대로 처리 이력을 최신으로 유지합니다.

• “안 돼요” 같은 제목. 무엇이, 어디서, 어떤 조건에서 안 되는지 쓰세요.
• 시작 상태를 빼먹은 절차. 어떤 데이터가 열려 있었는지 모르면 “저장 클릭”만으로는 의미가 없습니다.
• 한 리포트에 여러 문제를 담는 것. 결함 하나에 리포트 하나여야 배정, 수정, 검증이 쉽습니다.
• 짜증 난 정도로 심각도를 정하는 것. 영향으로 판단하세요. 데이터 유실이나 우회 불가능이면 심각합니다.
• 비밀번호, 키, 개인정보가 보이는 로그나 스크린샷을 첨부하는 것.

1. 입력
2. 미리보기 확인
3. PDF, Word, Excel로 저장

필요한 나라를 고르세요. 각 서식은 그 나라에서 흔히 쓰는 문구와 형식을 따릅니다. “현지 전문가 확인 권장”이 붙은 서식은 쓰기 전에 현지 규정을 아는 사람이 읽어 보아야 합니다.

• 국제 공통 (XX): 작성 언어: 영어, 한국어, 일본어, 독일어