이 문서가 필요한 경우
- QA, PM, 개발자가 직접 화면을 보며 이슈를 남기는 경우
- 프로젝트 코드에 손대지 않고 바로 검수를 시작해야 하는 경우
시작하기 전에
관리자 콘솔에서 워크스페이스, 프로젝트, 허용 도메인을 먼저 설정해야 합니다.
아직 완료하지 않은 부분이 있다면 시작 준비를 끝내고 오세요.
끝나면 확인할 것
- Extension에 로그인했고 작업할 프로젝트를 선택했습니다.
- 지금 보고 있는 도메인이 프로젝트에 연결됐습니다.
- 캡처 이슈 1건과 녹화 이슈 1건이 관리자 콘솔에 저장됐습니다.
1. Extension 설치하기
Chrome Web Store에서 Issue Sticker Extension을 설치한 뒤 사이드패널을 엽니다. 로그인되어 있지 않다면 사이드패널의 로그인 버튼을 누릅니다. 브라우저가 관리자 콘솔의 로그인 페이지를 열고, 로그인이 끝나면 세션이 Extension으로 넘어옵니다.
Chrome 외 브라우저에서는 Extension 로그인 브리지가 동작하지 않을 수 있습니다.
만약 동작이 불안정한 경우 contact@maana.dev로 문의를 남겨주세요.
2. 프로젝트 선택하기
사이드패널 상단에서 작업할 워크스페이스와 프로젝트를 선택합니다. 프로젝트를 잘못 고르면 이슈가 다른 목록에 쌓이니, 첫 캡처 전에 확인하세요.
3. 현재 도메인 연결하기
Extension은 프로젝트에 연결된 도메인에서만 동작합니다.
관리자 콘솔에서 미리 등록해둔 도메인이라면 이 단계는 건너뛰세요.
등록되지 않은 도메인에서는 사이드패널에 안내가 뜹니다. 로그인한 계정의 워크스페이스 역할에 따라 다음과 같이 동작합니다.
- 소유자와 관리자는
연결하기를 눌러 현재 도메인을 프로젝트에 바로 등록합니다. - 멤버는
연결 요청하기를 눌러 관리자에게 등록을 요청합니다.
운영, 스테이징, 로컬을 함께 쓰는 팀이라면 필요한 도메인을 시작 준비에서 한 번에 등록해두는 편이 빠릅니다.
4. 첫 이슈 남기기
스크린샷 캡처를 누른 뒤 문제가 있는 위치를 클릭합니다. 제목과 설명을 적으면 스크린샷, URL, 브라우저 정보, 콘솔/네트워크 로그가 함께 저장됩니다.
작은 UI 깨짐은 캡처만으로 충분합니다. 재현 과정이 긴 버그라면 영상 녹화를 먼저 누르고 재현한 뒤, 녹화를 멈추고 이슈를 남기세요.
처음에는 콘솔 에러나 네트워크 실패가 있는 화면에서 한 번 남겨보세요. 개발자가 어떤 단서를 받는지 바로 확인할 수 있습니다.