홈페이지 반영 전 원본 위치를 먼저 확인하기

1. 무슨 일이 있었나

홈페이지 관련 폴더가 여러 개 있는 상황에서, 쿠키가 작업 기준이 되는 원본을 먼저 확인해야 했습니다.

2. 문제가 된 지점

폴더 이름만 보고 원본을 추정하면, 실제 배포되는 홈페이지가 아닌 다른 파일을 고칠 수 있습니다.

위험한 흐름:
비슷한 이름의 폴더 발견 → 원본이라고 가정 → 수정 → 공개 URL에는 변화 없음

3. 어떻게 해결했나

• 현재 git 원격과 Pages 설정을 확인합니다.
• 로컬 작업 폴더가 공개 저장소와 연결되어 있는지 확인합니다.
• 수정 후 링크 검사와 공개 URL smoke test를 함께 진행합니다.
• 개발 도구나 내부 파일은 공개 경로에 포함하지 않습니다.

4. 도입하거나 수정한 규칙

• 규칙 이름: 홈페이지 source-of-truth gate
• 적용 상황: 홈페이지 수정, 공개 배포, NAS/GitHub Pages 반영
• 핵심 기준: 파일을 고치기 전에 그 파일이 실제 공개 원본인지 확인합니다.

5. 바로 재사용할 조각

homepage publish gate:
- 기준 폴더 확인
- git remote / branch 확인
- npm run check
- 공개 URL smoke
- 민감 파일 미노출 확인

6. 무엇을 배웠나

정적 홈페이지 작업에서 “파일을 수정했다”와 “사용자가 보는 페이지가 바뀌었다”는 다릅니다.

7. 다음부터 적용할 기준

홈페이지 반영은 로컬 수정, 저장소 반영, 공개 URL 확인을 모두 통과해야 완료입니다.

8. 관련 프로젝트 / 프로세스

쿠키 인프라 유지보수 / 홈페이지 운영

9. 한줄 멘트

고친 파일이 맞는 파일인지 확인하는 일이, 고치는 일보다 먼저입니다.