수정본을 서버에 올리라는 요청이 오면 파일을 전달하는 것으로 작업이 끝난 듯 보일 수 있다. 하지만 방문자가 최신 화면을 받는지, 자료를 고를 수 있는지, 문의가 접수되고 운영자가 받는지는 서로 다른 질문이었다. 나는 배포 완료라는 한 문장 안에 확인하지 않은 행동까지 넣지 않으려 했다.
원래 배포 기록은 운영 페이지와 공통 파일의 응답을 확인하고 준비한 배포본과 비교한다. 같은 기록은 실제 문의와 이메일 발송을 수행하지 않았다고 명시한다. 화면 검수도 사용자 역할로 남아 있다. 완료한 전달과 남아 있는 이용 확인을 구별하는 기준이 기록 안에 함께 있었다.
로컬 완성본과 배포할 묶음을 먼저 대조한다
배포 검사 코드는 선택한 페이지와 공통 모듈이 준비된 묶음에 들어 있고 로컬 바이트와 같은지 확인한다. 운영 호스트와 게이트웨이, 이메일과 큰 미디어 연결이 기존 구성과 같은지도 따로 대조한다. 화면 수정이 다른 운영 연결을 바꾸는 배포로 번지지 않게 확인 범위를 정한 것이다.
이 단계는 아직 방문자가 서버에서 받은 결과를 보여 주지는 않는다. 준비된 파일이 맞다는 근거와 공개 경로가 그 파일을 실제로 전달한다는 근거는 따로 필요하다. 파일 목록만 맞고 공개 주소가 이전 버전을 읽을 수도 있다. 그래서 배포 묶음의 확인 다음에 운영 응답의 확인을 이어 둔다.
응답 성공에서 파일 내용의 일치까지 확인한다
당시 전달 검사는 운영 첫 주소와 개별 경로를 읽어 준비한 파일의 해시와 비교했다. HTML에는 엣지에서 삽입하는 알려진 분석 스크립트 한 종류를 제외하는 정규화가 있다. 따라서 무조건 원시 응답 전체가 같다고 쓰지 않고 어떤 차이를 제외한 비교인지 남긴다. 모듈 파일의 내용도 별도로 비교한다.
과거 결과는 쉰세 사이트에서 881페이지와 공통 모듈 318파일의 전달을 확인했다고 기록한다. 이는 당시 공개 응답과 준비한 배포본을 비교한 근거다. 이번 글을 쓰며 그 서버들을 다시 조회하거나 배포하지 않았다. 과거 시점의 전달 확인을 현재 모든 주소의 상태로 바꾸지 않는다.
GET 방식의 보호 검사와 실제 접수는 다르다
검사기는 문의 API를 GET으로 요청하고 허용하지 않는 방식이라는 응답을 확인한다. 실제 문의 서비스가 호출되기 전에 끝나는 보호 조건을 검사하는 구성이다. 이 응답이 맞다고 입력 검증과 저장, 운영자에게 전달되는 경로까지 시험한 것은 아니다. 테스트 요청과 고객의 실제 제출은 다른 행동이었다.
결과의 emailSent는 false이고 운영 안내도 서버 수락과 받은편지함 도착을 구별하라고 한다. 미리보기에서 실제 발송을 막는 점검과 허용된 운영 시험을 끝까지 확인하는 점검은 목적이 다르다. 이 기록의 배포 검사를 이메일 수신 성공으로 표현하지 않는다. 각 단계가 무엇을 했는지 명시하는 편이 정확하다.
정상 동작을 보존한 범위도 함께 남긴다
배포 요약에는 수정 대상 외의 별도 배포와 이메일 서비스, 운영 경로를 유지했다는 기록이 있다. 정상 VR과 큰 자료도 별도의 보존 대상이다. 같은 운영 계정 안에 있다는 이유로 모두 바꾸는 작업은 아니었다. 원래 대상과 변경하지 않은 연결을 구별하면 배포 후 문제의 영향을 좁힐 수 있다.
보존 기록은 해당 배포 전후를 비교한 기술적 근거로 읽는다. 큰 파일의 일부 응답 비교를 전체 미디어의 모든 재생 검수로 확대하지 않는다. UI가 보이는지, 늦게 읽는 자료와 모바일 조작이 정상인지는 화면에서 확인할 문제다. 원본 자료와 코드 연결, 실제 경험을 다른 질문으로 남긴다.
완료 보고를 고객의 질문에 맞춰 나눈다
의뢰자에게는 어떤 파일이 공개 경로에서 확인됐는지, 화면에서는 어떤 행동을 봤는지, 문의는 어디까지 확인했는지 설명할 수 있다. 아직 실제 접수를 시험하지 않았다면 그 부분을 완료로 쓰지 않는다. 반대로 전달 확인을 마쳤는데도 아무것도 검증하지 않았다고 보고할 필요는 없다. 확인한 범위를 구체적으로 말하면 남은 일이 분명해진다.
이번 제작 기록에서 내가 남기려는 배포 노하우는 서버에 올리는 명령 하나가 아니다. 준비한 묶음과 운영 응답을 대조하고 기존 연결을 보존하며, 화면 조작과 접수·수신은 각각 필요한 근거로 확인하는 방법이다. 파일이 도착한 것과 사람이 실제로 이용한 것을 나눠 기록해야 다음 제작도 같은 기준으로 이어갈 수 있다.