이 글의 핵심 개념을 보여주는 대표 이미지. 리뷰 파일과 포스트를 어긋나지 않게 연결하는 방법

리뷰 파일과 포스트를 어긋나지 않게 연결하는 방법


리뷰 시스템은 잘못된 피드백이 다른 포스트에 붙기 시작하는 순간부터 조용히 무너진다.

해법은 리뷰를 “코멘트 파일”이 아니라 “식별 레코드”로 다루는 것이다.

1. 식별 필드를 고정한다

모든 리뷰에 동일한 3개 필드를 넣는다. blog id, post 번호, slug. 하나라도 없으면 무효다.

2. 어긋남은 즉시 실패로 본다

slug가 바뀌면 리뷰 파일도 반드시 바뀌어야 한다. 안 바뀌면 빌드 실패나 검수 경고가 떠야 한다.

3. 포스트 이동과 리뷰 이동을 묶는다

포스트가 studio에서 실제 블로그 폴더로 이동하면 리뷰 파일도 같이 이동해야 한다. 남으면 연결이 끊긴다.

blog id, post id, slug, generated markdown, review record가 이어진 식별 체인

What to do first

모든 리뷰에 식별 필드를 적고 발행 전에 반드시 검증한다.

  • blog id + post 번호 + slug가 일치해야 한다
  • 리뷰 파일 이름은 slug와 같아야 한다
  • 리뷰 파일은 포스트 이동과 함께 움직여야 한다