IssueTruck

매뉴얼

사용 매뉴얼

초대 링크로 참여해 이슈를 등록하고, 테스트 환경을 갖춘 뒤 처리 과정을 확인해 검수까지 마치는 과정입니다.

01

시작하기

초대받은 서비스에 참여한 뒤 이슈를 등록하고, 담당자가 남긴 처리 기록을 확인합니다. 검수 요청이 오면 같은 조건에서 다시 테스트한 뒤 종료하거나 재오픈합니다.

이슈 처리 흐름

단계 하는 일
1 로그인 초대 링크를 열고, 계정이 없으면 회원가입한 뒤 로그인합니다.
2 서비스 참여 서비스명과 참여 안내를 확인하고 참여합니다.
3 이슈 등록 구분과 제목, 재현 내용, 첨부와 테스트 환경을 입력합니다.
4 처리 확인 활동 영역에서 댓글과 상태 변경 메모를 확인합니다.
5 검수 수정된 버전에서 다시 테스트하고 종료하거나 재오픈합니다.
이슈 상태 흐름 접수 처리 중 검수 요청 종료 재오픈

현재 서비스에 등록된 모든 이슈를 조회하고 검색할 수 있습니다. 댓글 등록과 상태 변경은 그 이슈의 참여자만 할 수 있습니다.

초대 링크와 로그인

관리자가 전달한 초대 링크를 엽니다. 로그인하지 않은 상태라면 로그인 화면을 거쳐 초대 화면으로 돌아옵니다.

초대 링크를 연 로그인 화면
  1. 1 계정이 있으면 이메일과 비밀번호를 입력한 뒤 [로그인]을 선택합니다.
  2. 2 계정이 없으면 [회원가입]으로 계정을 만든 뒤 로그인합니다.

초대 링크가 아닌 일반 로그인 화면에서 가입했다면, 로그인을 마친 뒤 전달받은 초대 링크를 다시 엽니다.

서비스 참여

로그인하면 초대받은 서비스의 이름과 참여 안내가 표시됩니다. 참여하려는 서비스가 맞는지 확인합니다.

서비스 참여 확인 화면
  1. 1 서비스명과 참여 안내를 확인합니다.
  2. 2 [서비스 참여]를 선택하면 테스터 권한으로 참여합니다.

참여한 서비스가 현재 서비스로 자동 선택됩니다. 같은 초대 링크를 다시 열어도 참여자가 중복으로 등록되지는 않습니다.

02

이슈 등록

등록 화면을 열고 구분과 제목, 재현 내용, 첨부와 테스트 환경을 차례로 입력합니다.

등록 화면 열기

상단의 서비스명을 먼저 확인합니다. 좌측 메뉴에서 이슈 목록을 연 뒤 등록 화면으로 들어갑니다.

이슈 목록에서 등록 화면을 여는 위치
  1. 1 좌측 메뉴에서 [이슈]를 선택해 목록을 엽니다.
  2. 2 목록 오른쪽 위의 [+ 이슈 등록]을 선택합니다.
등록 전 확인
  • [참여한 이슈만 보기]를 해제하고 제목이나 증상으로 검색해 같은 문제가 이미 등록되어 있는지 봅니다.
  • 여러 문제가 함께 발생했다면 원인과 재현 절차가 다른 것은 따로 등록합니다.
  • 선택된 서비스가 테스트 대상 서비스인지 확인합니다.

기본 정보와 재현 내용

구분과 우선순위를 고른 뒤 제목과 내용을 입력합니다.

구분, 제목, 재현 내용 입력 화면
  1. 1 구분, 우선순위, 카테고리를 선택합니다. 우선순위를 판단하기 어려우면 [보통]을 씁니다.
  2. 2 제목에는 발생 위치와 증상을 함께 적습니다.
  3. 3 내용에서 재현 절차, 실제 결과, 기대 결과, 재현 빈도를 나누어 적습니다.
내용 템플릿
  • [+ 템플릿]을 선택하면 일반 이슈와 오류 보고 두 가지 서식을 불러올 수 있습니다.
  • 불러온 서식에 들어 있는 작성 예시는 실제 이슈 내용으로 바꿔 적습니다.

제목과 재현 절차를 쓰는 방법은 04 잘 쓰는 법에서 다룹니다.

첨부와 테스트 환경

재현에 도움이 되는 파일과 이번 테스트에 쓴 환경을 함께 등록합니다.

증거 파일과 테스트 환경 선택 화면
  1. 1 스크린샷, 영상, 로그처럼 재현에 도움이 되는 파일을 올립니다.
  2. 2 [발생 상황]에는 문제가 생기기 직전에 한 작업을 적습니다.
  3. 3 [테스트 환경]에서 이번 테스트에 쓴 환경을 고릅니다.
  4. 4 입력한 내용을 확인한 뒤 [이슈 등록]을 선택합니다.

고를 수 있는 테스트 환경은 개인 설정에 등록해 둔 것입니다. 목록이 비어 있다면 03 개인 설정에서 먼저 만듭니다.

첨부 제한
  • 내용에 넣은 이미지를 첨부까지 합쳐 최대 5개
  • 파일 하나당 최대 10MB
  • 파일명 최대 255자

첨부 전에 비밀번호, 개인정보, API 키, 토큰 같은 민감정보가 담겨 있지 않은지 확인합니다.

03

개인 설정

이슈 등록 화면에서 골랐던 테스트 환경은 개인 설정에서 미리 만들어 둡니다. 한 번 등록해 두면 이슈를 올릴 때마다 목록에서 고르기만 하면 됩니다.

테스트 환경 등록

좌측 메뉴의 개인 설정에서 등록해 둔 테스트 환경을 확인하고 새 환경을 추가합니다.

개인 설정의 테스트 환경 목록
  1. 1 좌측 메뉴에서 [개인 설정]을 선택합니다.
  2. 2 테스트 환경 영역의 [테스트 환경 추가]를 선택하면 입력 창이 열립니다.
목록에서 하는 일
  • 등록한 환경은 이름과 기기 종류로 목록에 표시됩니다.
  • [수정]으로 항목을 고치고, 더 쓰지 않는 환경은 [삭제]로 지웁니다.
  • 기기나 버전이 다르면 환경을 따로 만들어 두고 이슈마다 골라 씁니다.

테스트 환경 항목 입력

이름과 기기 종류를 먼저 정하고, 기기 종류에 맞는 상세 항목을 채웁니다.

테스트 환경 추가 창
  1. 1 목록에서 알아볼 수 있는 이름을 적고 기기 종류를 고릅니다.
  2. 2 운영체제와 OS 버전, 브라우저와 브라우저 버전, 화면 해상도를 입력하고 덧붙일 설명은 비고에 적습니다.
  3. 3 [변경사항 저장]을 선택하면 목록에 추가됩니다.

여기 입력한 항목이 이슈 상세의 정보 영역에 그대로 표시됩니다. 담당자가 재현할 때 쓰는 정보이므로 버전까지 정확히 적습니다.

알림 설정

같은 화면에서 어떤 알림을 어떤 수단으로 받을지 정합니다. 알림마다 이메일과 푸시를 따로 켜고 끈 뒤 [알림 설정 저장]을 선택합니다.

알림 받는 시점
이슈 생성 참여한 서비스에 새 이슈가 등록되었을 때
새 댓글 참여한 이슈에 댓글이 달렸을 때
상태 변경 참여한 이슈의 상태가 바뀌었을 때
참여자 추가 이슈의 참여자로 지정되었을 때

댓글과 상태 변경 알림은 등록자와 활성 참여자에게 전송되며, 행동한 사용자는 제외됩니다.

04

잘 쓰는 법

다른 사람이 같은 결과를 그대로 확인할 수 있도록 쓰는 방법입니다.

제목 쓰기

제목만 보고도 발생 위치와 증상을 알 수 있게 적습니다.

좋은 제목

회원가입 화면에서 인증번호 확인 버튼이 동작하지 않음

피해야 할 제목

오류가 납니다 / 확인해 주세요

재현 절차 쓰기

내용에는 다음 네 가지를 나누어 적습니다.

재현 순서
  1. 앱을 실행하고 테스트 계정으로 로그인합니다.
  2. 상단 알림 아이콘을 선택합니다.
  3. 모든 알림을 확인한 뒤 목록 화면으로 돌아갑니다.
실제 결과

새 알림이 없는데도 알림 배지 숫자 1이 계속 표시됩니다.

기대 결과

모든 알림을 확인하면 알림 배지가 사라져야 합니다.

재현 빈도

5회 중 5회 발생

구분 선택 기준

등록 화면의 구분은 다음 기준으로 고릅니다.

구분 사용 기준
오류 정상적으로 동작하지 않거나 오류가 발생한 경우
개선 기존 기능이나 사용성을 개선할 필요가 있는 경우
제안 새로운 기능이나 방식을 제안하는 경우
문의 동작이나 정책에 대한 확인이 필요한 경우

등록 전 확인

등록을 누르기 전에 다섯 가지를 봅니다.

  • 제목만 보고도 발생 위치와 증상을 알 수 있는가
  • 재현 순서를 다른 사람이 그대로 따라 할 수 있는가
  • 실제 결과와 기대 결과를 구분했는가
  • 이번 테스트에 쓴 테스트 환경을 골랐는가
  • 증빙 파일에 민감정보가 없는가
05

처리 확인

등록한 이슈의 상세 화면에서 처리 내역과 참여자, 현재 상태를 확인합니다.

등록한 이슈 확인

등록을 마치면 상세 화면으로 이동하고 처음 상태는 접수로 표시됩니다.

접수된 이슈 상세 화면
  1. 1 상단에서 이슈의 구분, 우선순위, 현재 상태를 확인합니다.
  2. 2 활동 영역에서 등록한 내용과 첨부, 댓글, 상태 변경 이력을 확인합니다. 등록자는 연필 버튼으로 내용을 고칠 수 있습니다.
  3. 3 정보 영역에서 등록자와 등록일, 최근 활동, 이슈에 붙은 테스트 환경을 확인합니다.
  4. 4 참여자 영역에서 이 이슈의 참여자와 담당자를 확인합니다.

이슈 목록에서는 제목, 구분, 우선순위, 상태, 댓글 수와 최근 활동 시각을 볼 수 있습니다.

참여자와 담당자

이슈마다 참여자가 따로 있고, 댓글과 상태 변경 알림은 참여자에게 전달됩니다.

참여자가 정해지는 방식
  • 이슈를 등록하면 등록자로 참여자 목록에 들어갑니다.
  • [담당자 관리]에서 이 이슈를 처리할 담당자를 지정합니다.
  • 댓글 등록과 상태 변경은 그 이슈의 참여자만 할 수 있습니다.
  • 참여자가 아니어도 같은 서비스에 등록된 이슈를 조회하고 검색할 수 있습니다.

댓글과 상태 변경 알림은 등록자와 활성 참여자에게 전송되며, 행동한 사용자는 제외됩니다.

상태 이해

담당자가 이슈를 확인한 뒤 상태와 메모를 남깁니다. 상태가 바뀐 이유는 활동 영역에서 확인합니다.

상태 의미 확인할 것
접수 등록 완료 담당자 확인을 기다립니다.
처리 중 담당자가 처리 중 추가 질문이 오면 댓글로 답변합니다.
정보 요청 담당자가 확인할 내용을 물음 물어본 내용을 댓글로 보충합니다.
처리 완료 담당자 작업이 끝남 반영된 내용을 확인합니다.
검수 요청 수정 후 확인 필요 같은 조건에서 다시 테스트합니다.
보류 처리 일시 중단 요청받은 정보가 있으면 보충합니다.
종료 처리가 끝나고 닫힘 문제가 해결되었는지 마지막으로 확인합니다.
재오픈 문제가 계속됨 재현 결과와 증거를 추가합니다.

서비스 설정에 따라 검수 요청 단계 없이 담당자가 바로 이슈를 종료할 수 있습니다.

댓글 등록 규칙
  • 담당자의 질문에는 재현 환경과 결과를 함께 답변합니다.
  • 댓글에도 파일을 최대 5개, 하나당 10MB까지 첨부할 수 있습니다.
  • 종료된 이슈에는 댓글을 새로 달거나 기존 댓글을 고칠 수 없습니다.
  • 추가 설명이 필요하면 이슈를 먼저 재오픈합니다.
06

검수와 종료

검수 요청이 오면 같은 조건에서 다시 테스트하고, 결과에 따라 종료하거나 재오픈합니다.

검수 요청 확인

상태가 검수 요청으로 바뀌면 담당자가 남긴 수정 내용과 메모를 확인합니다. 결과는 상세 화면 위쪽의 두 버튼으로 반영합니다.

이슈 상세 상단의 댓글 작성과 상태 변경 버튼
  1. 1 [댓글 작성]은 내용을 남기면서 상태까지 함께 바꾸고, [상태 변경]은 상태만 바꿉니다.
재테스트 순서
  1. 수정된 앱 또는 서비스 버전이 배포되었는지 확인합니다.
  2. 처음 등록한 테스트 환경과 재현 절차를 그대로 반복합니다.
  3. 실제 결과가 기대 결과와 맞는지 확인합니다.
  4. 해결되었으면 종료, 계속 발생하면 재오픈을 선택합니다.

댓글과 상태 변경

재테스트 결과를 댓글로 남기고 상태를 바꿉니다.

댓글 작성 창과 상태 변경 창
  1. 1 [댓글 작성]에서 내용과 첨부를 넣고, 아래 상태 변경에서 바꿀 상태를 고른 뒤 [댓글 등록]을 선택합니다.
  2. 2 [상태 변경]에서는 상태를 고르고 메모만 남깁니다. 메모는 선택 항목입니다.
재오픈 메모 예시

Android 15, 앱 2.4.1에서 다시 확인했지만 동일하게 발생합니다. 새로 확인한 화면을 댓글에 첨부했습니다.

종료와 재오픈 판단

재테스트 결과에 따라 둘 중 하나를 고릅니다. 바뀐 상태는 제목 아래 배지와 활동 이력에 남습니다.

상태 배지와 상태 변경 이력
  1. 1 현재 상태는 제목 아래 배지에 표시됩니다.
  2. 2 활동 영역에 상태가 바뀐 순서와 시각이 이력으로 남습니다.
종료하는 경우
  • 수정 버전에서 처음 재현 절차로 문제가 발생하지 않습니다.
  • 실제 결과가 기대 결과와 일치합니다.
  • 연관된 주요 기능에서도 같은 문제가 발생하지 않습니다.
재오픈하는 경우
  • 동일한 문제가 계속 발생합니다.
  • 일부 조건에서만 해결되었거나 다른 환경에서는 재현됩니다.
  • 수정으로 인해 같은 기능에서 새로운 문제가 생겼습니다.

기존 이슈와 증상, 재현 절차 또는 원인이 분명히 다르면 재오픈하지 않고 새 이슈로 등록합니다.

최종 체크리스트
  • 중복 이슈를 검색했다
  • 발생 위치와 증상이 드러나는 제목을 작성했다
  • 재현 절차, 실제 결과, 기대 결과를 구분했다
  • 이번 테스트에 쓴 테스트 환경을 골랐다
  • 필요한 스크린샷 또는 로그를 첨부했다
  • 첨부파일의 민감정보를 확인했다
  • 검수 요청 시 같은 조건에서 다시 테스트했다
  • 검수 결과에 따라 종료 또는 재오픈했다