머니큐브 개발일지 2편: 애드센스 승인 준비와 /admin 자동 발행기 구축
요약
- 심사 대비: 소개·문의·개인정보처리방침·이용약관 4개 페이지와 쿠키 안내 배너, 미완성 기능 숨김
- 발행기: 글을 쓰면 글 본문·글 목록·사이트맵이 GitHub 커밋 하나로 함께 반영
- 안전장치: 관리자 페이지는 검색에서 제외하고 메뉴에 링크하지 않음, 발행 전 입력 검증
- 남은 것: 애드센스 게시자 ID를 넣고 실제 신청하는 단계
심사에서 먼저 걸리는 것들
계산기 사이트는 화면은 그럴듯해도 심사에서 두 가지를 지적받기 쉽습니다. 하나는 "콘텐츠가 부족하다"이고, 다른 하나는 "완성되지 않은 기능이 노출된다"입니다. 첫 번째는 해설 30편으로 대응했습니다. 모든 글이 4,900자 이상이고, 계산기 화면에서 관련 해설로 이어지게 했습니다.
두 번째는 코드를 손봐야 했습니다. 로그인 버튼을 눌렀을 때 준비 중이라는 안내만 나오거나, 주소가 비어 있는 카카오톡 채널 버튼이 보이면 심사자 입장에서는 미완성 신호입니다. 그래서 app.js의 설정값이 비어 있는 기능은 버튼 자체를 만들지 않도록 바꿨습니다. 가짜 로그인 화면을 흉내 내는 대신 아예 감추는 쪽을 택했습니다.
개인정보처리방침과 쿠키 고지
개인정보처리방침은 11개 항목으로 다시 썼습니다. 계산기에 입력한 값이 서버로 전송되지 않는다는 점, 자동 수집 항목(접속 IP, 브라우저 정보, 방문 페이지), 광고 사업자의 쿠키, 보유와 파기, 제3자 제공과 처리 위탁, 이용자 권리, 만 14세 미만 아동, 보호책임자와 문의처를 표로 정리했습니다.
쿠키는 실제로 쓰는 것만 적었습니다. 최근 계산 기록(moneynote.recent.v1), 안내 배너를 다시 보지 않기 위한 값, 로그인 세션 쿠키, 로그인 진행용 1회 쿠키, 구글 광고 사업자의 광고 식별 쿠키입니다. 목록에 없는 쿠키를 적으면 오히려 신뢰를 잃기 때문에, 코드에서 쓰는 키와 문서의 키를 같게 유지했습니다.
첫 방문에 한 번 뜨는 안내 배너도 넣었습니다. 확인을 누르면 로컬스토리지에 기록하고 다시 뜨지 않습니다. 배너 높이를 CSS 변수로 넘겨 본문을 가리지 않게 한 것이 작은 신경 쓴 부분입니다.
관리자 페이지를 검색에서 숨긴 이유
발행 도구는 사이트에 두지만 검색에는 나오면 안 됩니다. 그래서 관리자 페이지에 noindex, nofollow를 걸고, 서버 응답 헤더에도 같은 값을 붙이고, robots.txt에서도 막고, 사이트 어느 메뉴에도 링크하지 않았습니다. 네 겹으로 막은 것은 하나가 빠져도 나머지가 버티게 하려는 것입니다.
커밋 하나로 세 파일을 바꾸는 발행기
글을 발행하면 articles 폴더의 본문 HTML, 글 목록 articles.json, sitemap.xml 세 파일이 함께 바뀝니다. GitHub API의 커밋 하나에 세 파일을 담아 보내므로, 중간에 실패해도 글만 있고 목록에 없는 상태가 생기지 않습니다.
발행 전에는 publish-core.js가 입력을 검사합니다. 제목과 슬러그 형식, 요약 길이(220자 이하), 태그 정리를 확인하고, article-template.js가 마크다운을 HTML로 바꾸면서 소제목 목차와 읽기 시간, 관련 글 4개를 붙입니다. 미리보기는 같은 함수를 브라우저에서 먼저 돌려, 실제 발행될 글과 같은 목차·읽기 시간·관련 글까지 보여 줍니다.
발행 경로는 두 가지입니다. 서버 발행은 비밀번호만 입력하면 Cloudflare 함수가 GitHub 토큰을 대신 써서 커밋하므로 토큰이 브라우저에 노출되지 않습니다. 브라우저 직접 발행은 저장소 하나에 Contents 읽기·쓰기 권한만 준 fine-grained 토큰을 쓰고, 만료일을 짧게 잡습니다.
발행한 글은 홈의 아카이브가 articles.json을 읽어 최신순으로 앞에 붙입니다. 정적 카드에 없는 새 글도 필터와 개수 표시가 자동으로 늘어나므로, 발행 후 HTML을 다시 손댈 일이 없습니다.
삭제와 되돌리기
삭제는 슬러그를 한 번 더 입력하게 했습니다. 실수로 누르는 일을 줄이려는 장치이고, 삭제도 커밋이므로 Git 기록에 남아 되돌릴 수 있습니다. 수정은 같은 슬러그로 덮어쓰기를 체크해 다시 발행하면 됩니다. 지운 글도 같은 슬러그로 다시 발행하면 이전 주소를 그대로 쓸 수 있습니다.
시행착오 메모
브라우저에서 GitHub API를 부르는 과정에서 불필요한 헤더 때문에 사전 요청이 꼬여 커밋이 실패한 적이 있습니다. 헤더를 줄여 단순 요청으로 바꾸니 해결됐습니다. 발행일을 UTC로 계산해 밤에 쓴 글이 전날로 표시된 문제도 있어 현지 날짜 기준으로 고쳤습니다. 배포 서비스가 .html을 떼는 설정에서는 아카이브 카드가 중복으로 붙는 문제가 있어 링크 확장자를 통일했습니다.
발행기는 기능이 늘수록 검증도 같이 늘었습니다. 모의 GitHub 저장소를 붙여 발행·덮어쓰기·삭제를 실제 커밋 결과까지 확인하는 테스트가 지금도 매번 돌아갑니다.
남은 것과 다음 편
게시자 ID와 ads.txt의 실제 값은 애드센스 계정이 준비된 뒤 넣을 예정입니다. 그 전에 도메인 연결과 검색 색인이 먼저입니다. 3편에서는 Netlify 무료 크레딧이 거의 바닥나 Cloudflare Pages로 옮긴 과정과, 도메인 네임서버·DNSSEC에서 막힌 이야기를 정리합니다.
