좋은 지원 링크는 한 가지 버그를 가장 적은 코드와 개인정보 없는 데이터로 재현합니다. 검토자가 무엇을 해야 하는지, 무엇이 일어나야 하는지, 실제로 무엇이 일어나는지, 어떤 환경에서 시험했는지 바로 알 수 있어야 합니다. 운영 페이지를 그대로 복사하면 원인은 가려지고 노출 위험만 커집니다.
재현되는 카운터 버그를 내려받습니다
카운터 fixture 내려받기, UTF-8 기준 1474 byte입니다. 증가 버튼, 초기화 버튼, 보이는 카운트가 있고 외부 자원, 계정 상태, 운영 API를 쓰지 않습니다.
- 순서: 증가를 두 번 누릅니다.
- 기대: 표시된 카운트가 2가 됩니다.
- 의도적으로 깨뜨린 이 fixture의 실제 결과: 카운트가 0에 머무릅니다.
- 원인:
count = count++가 이전 값을 다시count에 넣습니다. - 시도할 수정: 그 문장을
count += 1로 바꾸고 같은 순서를 반복합니다.
제공된 로컬 DOM 점검은 원래 스크립트와 고친 스크립트를 모두 실행합니다. Chrome, Safari나 배포된 뷰어를 시험했다는 주장은 아닙니다. 직접 만든 재현본을 게시한 뒤에는, 그곳에서 실패를 다시 확인했을 때만 실제 브라우저, viewport, 날짜를 적습니다.
공유 전에 줄입니다
- 새 로컬 HTML 파일에 실패를 복사합니다.
- 실패와 무관한 프레임워크, 컴포넌트, 스타일, 데이터를 제거합니다.
- 이름, 이메일, ID, URL, 토큰, 고객 내용을 fixture로 바꿉니다.
- 운영 API 호출은 결정적인 로컬 응답으로 대체합니다.
- 버그가 여전히 발생하는지 확인합니다.
- 의존성 하나를 더 지우고 다시 시험합니다.
- 기대 결과, 실제 결과, 순서, 브라우저, viewport, 날짜를 데모 위에 적습니다.
최소 재현 예제의 핵심은 문제를 보여주기에 충분한 코드만 남기고, 원인에 기여하지 않는 것은 모두 덜어내는 것입니다.
페이지 안에 재현 계약을 둡니다
파일 안에 간결한 설명 블록을 넣습니다.
기대: 증가를 두 번 누르면 2가 표시된다.
실제: 제공된 fixture에서는 카운트가 0에 머문다.
순서: 초기화 → 증가 → 증가.
브라우저 / viewport / 날짜: 공유한 URL에서 직접 시험한 뒤 적는다.
console 출력은 작고 관련된 것만 남깁니다. 분석 ID, session storage 전체, 요청 헤더, 운영 로그는 넣지 않습니다.
미리보기 경계를 압니다
HTML2WEB은 격리된 뷰어에서 인라인 HTML, CSS, 스크립트를 허용하지만 임의의 외부 연결은 막습니다. 그래서 브라우저에서 보이는 한 파일 문제에 맞습니다. 인증 API, cookie, service worker, 교차 출처 요청, 서버 렌더링, 이메일 배달, 운영 데이터베이스 상태를 재현하기에는 적합하지 않습니다.
백엔드를 제거하면 버그도 사라지는 경우에는, 지원팀의 안전한 경로로 저장소 fixture나 승인된 스테이징 환경을 제공합니다.
게시하고 검증합니다
- 비밀값과 개인정보를 검색합니다.
- 짧은 만료를 고릅니다.
- HTML 파일 하나를 게시합니다.
- 공개 링크를 시크릿 창에서 엽니다.
- 적어 둔 순서를 그대로 반복합니다.
- 관리 URL은 비공개로 둡니다.
- 공개 URL과 간결한 절차만 티켓에 붙입니다.
- 분석이 끝나면 공유를 삭제합니다.
만료와 삭제는 이후 접근을 줄이지만, 이미 내려받은 사본을 회수하지는 못합니다. 자격증명은 절대 게시하지 말고, 노출된 비밀값은 교체합니다.
재현본은 HTML-to-URL 도구로 만듭니다. 원래 페이지에 로컬 CSS나 이미지가 있다면 file:// 자산이 공유 후 깨지는 이유를 먼저 읽어 보세요.
