예약 발행 기능은 status 하나로 끝나지 않는다
예약 발행은 scheduled 값을 저장하는 일이 아니다. 공개 시간, 조회 조건, 상세 페이지, 검색과 사이트맵까지 같은 기준으로 막아야 한다.

“이 글이 지금 독자에게 보여도 되는가?”라는 질문에 모든 조회 경로가 같은 답을 내는가?
작은 블로그에 예약 발행을 붙일 때는 scheduled 상태와 날짜 입력란만 추가하면 끝날 것 같아 나머지 경로가 부담스럽게 느껴질 수 있다.
하지만 공개 여부는 상태뿐 아니라 공개 시각과 삭제 여부까지 함께 판단해야 한다.
이 블로그의 구현은 그 조건을 공통으로 사용하고, 인증된 관리자의 미리보기만 별도 예외로 둔다.
표지 이미지는 글의 요점을 시각화한 개념 이미지(AI 생성)다.
예약 발행의 기준은 저장된 상태 이름이 아니라, 지금 이 글을 독자에게 공개해도 되는지 판단하는 공통 조건이다.
status만 바꾸면 예약이 아니다
상태 하나로는 부족하다.
scheduled라는 값만으로는 언제 공개할지 알 수 없고, published인 글에 미래 시각이 저장돼 있을 때의 동작도 정할 수 없다.
경로마다 판단을 따로 만들면 목록에서는 숨긴 글이 상세 URL이나 사이트맵에 나타날 위험이 있다.
이는 일반적인 설계 위험이며, 이 블로그에서 그런 누수가 발생했다는 기록은 아니다.
이 블로그는 상태와 published_at을 함께 보는 공개 판정을 이미 사용하고 있었다.
예약 발행 웹 기능을 보완한 변경은 편집 폼의 날짜 입력과 저장, 관리자 미리보기, 주기적인 상태 정리 등을 연결한 작업이다.
기존 status와 published_at을 재사용했으므로 이 작업에 새 마이그레이션은 없었다.
상태만으로 운영하다가 시간 조건을 뒤늦게 붙인 사례로 읽으면 실제 변경을 잘못 이해하게 된다.
상태와 시간, 편집 시각을 구분한다
이 구현에서 status는 운영 상태를, published_at은 독자에게 공개할 시각을 담는다.
삭제 여부는 deleted_at으로 따로 관리하며, 삭제된 글은 공개 조회에서 제외한다.
편집 시각과 공개 시각도 구분해야 글을 고치는 일이 발행 날짜와 정렬 순서를 바꾸지 않는다.
| 항목 | 이 블로그의 처리 | 확인할 경계 |
|---|---|---|
status | API 입력은 draft·scheduled·published | DB 제약에는 failed도 있어 계층별 허용값이 다르다 |
published_at | 공개 판정에 쓰는 시각 | 상태와 함께 해석하며 NULL 처리도 명시한다 |
deleted_at | 소프트 삭제 여부 | 공개 조회는 NULL인 글만 포함한다 |
| 편집 시각 | 수정 시점을 나타내는 별도 값 | 이미 공개된 글의 발행 날짜를 대신하지 않는다 |
실제 수정 기록에는 이미 공개된 글을 편집하거나 재발행할 때 공개 시각이 편집 시각으로 덮이던 문제가 남아 있다. 그 결과 블로그가 발행일 대신 수정 시점을 표시하고 그 기준으로 글을 정렬했다. 수정된 저장 로직은 기존 공개 시각이 비어 있지 않고 현재 시각 이하이면 그 값을 보존한다. 보존하려는 것은 이미 공개된 글의 발행 시각이며, 초안과 미래 예약의 시각은 변경할 수 있어야 한다.
편집 폼의 예약 입력은 datetime-local을 사용한다.
예약 상태로 저장하면 선택한 예약 시각을 쓰고, 공개 상태로 저장하면 과거 공개 시각은 유지하되 미래 시각이나 NULL은 현재 시각으로 처리한다.
초안으로 저장할 때는 공개 시각을 NULL로 되돌린다.
재발행의 갱신 대상에는 deleted_at이 없어, 글을 다시 저장했다고 삭제 상태가 자동으로 풀리지는 않는다.
공개 조건과 관리자 미리보기를 나눈다
공개 목록은 하나의 SQL 조건을 공유하고, 상세 페이지는 같은 규칙을 구현한 판정 함수를 사용한다. 홈·카테고리·태그·검색·인기글이 이 조건을 쓰며, RSS와 사이트맵도 같은 공개 글 조회를 거친다. 공개 여부의 기준은 아래와 같고, 모든 경우에 삭제되지 않았다는 조건이 먼저 필요하다.
| 상태 | 공개 시각 | 삭제되지 않은 글의 공개 여부 |
|---|---|---|
published | NULL 또는 현재 시각 이하 | 공개 |
published | 미래 | 비공개 |
scheduled | 값이 있고 현재 시각 이하 | 공개 |
scheduled | NULL 또는 미래 | 비공개 |
draft·failed | 어떤 값이든 | 비공개 |
일반 독자가 미래 예약·초안·삭제 글의 상세 URL을 요청하면 404를 받는다. 인증된 관리자에게는 공개 조건을 통과하지 않은 글도 미리 볼 수 있는 예외가 있다. 구현은 관리자 세션, Bearer 토큰, 관리자 쿠키를 인정하며, 존재하지 않는 글까지 보여 주는 것은 아니다. 공개 전 글을 관리자 권한으로 미리 볼 때는 조회수를 올리지 않아 독자 조회수에 섞이지 않게 한다.
댓글 작성 경로에는 이 관리자 예외가 없다. 대상 글을 다시 조회한 뒤 일반 공개 조건을 통과하지 못하면 404를 반환한다. 관리자가 예약 글을 읽을 수 있다는 사실과 그 글에 댓글을 작성할 수 있다는 사실은 별개다. 미리보기 예외의 근거는 구현과 변경 설명이며, 예약 발행 테스트가 관리자 인증을 넣은 HTTP 요청까지 검증한다는 뜻은 아니다.
API는 예약 시간을 검증해야 한다
API는 상태를 생략한 경우와 잘못 입력한 경우를 구분한다.
생략하면 published를 사용하지만, schedueld 같은 알 수 없는 값은 400으로 거부한다.
예약 상태인데 시각이 없거나 시간 입력을 해석할 수 없어도 400을 반환한다.
DB에 failed가 허용된다고 해서 게시 API도 그 값을 입력으로 받는 것은 아니다.
예약 시각은 epoch 밀리초 숫자·숫자 문자열 또는 ISO 문자열로 받는다. 직접 만든 블로그에서도 입력 형식과 시간대 해석을 먼저 정하고, 저장 시에는 비교 가능한 단일 기준으로 맞추는 편이 좋다. 화면에 표시한 지역 시각과 저장한 숫자가 같은 순간을 뜻하는지 확인한 뒤, 서버의 현재 시각과 비교해야 한다. 날짜 입력란에 값이 보인다는 사실만으로 공개 시각이 올바르게 저장됐다고 판단하지 않는다.
테스트에 남길 공개·편집 불변식
예약 기능의 테스트는 미래 예약을 숨기는 조건과 시간이 도래한 예약을 포함하는 조건을 구분해야 한다. 편집 테스트도 이미 공개된 글과 아직 공개 전인 글을 나눠야 한다. 이 블로그의 테스트에는 다음과 같은 검사 대상이 실제로 남아 있다. 여기서 소개하는 것은 테스트가 확인하도록 작성된 조건이며, 실행 통과 결과를 제시하는 것은 아니다.
- 과거 공개 시각을 가진 공개 글을 수정해도 기존 공개 시각이 보존되는지 검사한다.
- 초안을 공개 상태로 바꿀 때 공개 시각이 채워지는지 검사한다.
- 삭제된 글을 재발행해도 삭제 상태가 유지되는지 검사한다.
- 시간이 도래한 예약 글을 슬러그로 조회할 수 있는지 검사한다.
- cron이 도래 예약의 공개 시각을 유지하며 상태를 바꾸고, 미래 예약과 삭제 글은 건드리지 않는지 검사한다.
슬러그 조회 검사는 데이터 접근 단계와 HTTP 응답 단계를 구분해 읽어야 한다. 저장된 예약 글을 슬러그로 가져올 수 있다는 것만으로 일반 독자의 상세 요청이나 관리자 미리보기까지 확인한 것은 아니다. 특히 관리자 우회를 HTTP로 검사하는 테스트는 예약 발행 테스트에서 확인되지 않았다. 자체 구현을 검증할 때는 독자 요청과 관리자 요청을 따로 추가해 기대 결과를 명시해야 한다.
조회가 공개를 판단하고 cron은 상태를 정리한다
이 블로그의 cron은 5분 주기로 시간이 도래한 예약 글의 상태를 published로 바꾼다.
코드에 적힌 목적은 공개 처리가 아니라 저장된 상태 라벨의 정확성을 유지하는 것이다.
공개 조회는 이미 예약 시각과 현재 시각을 비교하므로, 시간이 도래한 글을 보여 주기 위해 다음 cron 실행을 기다리지 않는다.
상태 전환은 공개 시각을 바꾸지 않고, 반복 실행해도 같은 결과를 유지하도록 구성돼 있다.
만약 상태 전환만으로 공개를 결정한다면 cron 지연이 공개 지연으로 이어질 수 있다. 이것은 설계상 실패 가능성을 설명하는 것이며, 이 블로그에서 cron 장애를 겪었다는 기록은 아니다. 현재 구현에서는 조회 조건이 공개 여부를 결정하고 cron이 상태 이름을 정리한다는 역할 구분이 핵심이다.
| 확인 항목 | 판단 기준 |
|---|---|
| 상태 입력 | API와 DB의 허용값을 각각 명시하고 알 수 없는 입력을 거부한다 |
| 예약 시각 | 예약에는 해석 가능한 공개 시각이 있어야 한다 |
| 미래 예약 | 일반 독자의 상세 요청과 공개 목록에서 숨긴다 |
| 관리자 미리보기 | 인증된 관리자만 우회하고 공개 전 글의 조회수는 올리지 않는다 |
| 도래 예약 | 상태 정리 전에도 조회 시점의 조건으로 공개한다 |
| 소프트 삭제 | 공개 시각과 상태를 만족해도 독자 경로에서 제외한다 |
독자와 관리자를 나눠 확인하는 순서
다음은 자체 구현을 확인할 때 사용할 수 있는 절차이며, 이 글에서 실행한 결과는 아니다. 식별하기 쉬운 테스트 글 하나에 상태와 시각을 바꿔 넣고, 저장값과 응답을 함께 기록한다. 독자 요청에서는 관리자 세션·토큰·쿠키를 제거해야 의도된 미리보기를 공개 누수로 오해하지 않는다. 관리자 요청은 별도로 보내 같은 글에 대한 두 권한의 차이를 확인한다.
- 초안을 만든다.
draft와published_at = NULL을 저장하고, 독자의 상세 요청은 404이며 공개 목록에 없는지 확인한다. - 미래로 예약한다.
scheduled와 미래 시각을 저장하고, 독자의 상세 요청과 목록·검색·RSS·사이트맵에서 숨는지 확인한다. - 관리자로 미리 본다. 같은 미래 예약을 인증된 관리자 요청으로 열고, 조회수가 늘지 않는지 확인한다.
- 예약 시각을 과거로 옮긴다. 상태는
scheduled로 둔 채 공개 조건을 만족시키고, cron 전에도 독자 경로에서 보이는지 확인한다. - 삭제 조건을 겹친다.
deleted_at을 채운 뒤 독자 경로에서 다시 제외되는지 확인한다.
| 확인 경로 | 미래 예약 | 도래 예약 | 삭제 뒤 |
|---|---|---|---|
| 일반 독자의 상세 요청 | 404 | 200 | 404 |
| 홈·카테고리·태그·검색 | 제외 | 포함 | 제외 |
| RSS·사이트맵 | URL 제외 | URL 포함 | URL 제외 |
| 댓글의 대상 글 공개 판정 | 차단 | 통과 | 차단 |
RSS와 사이트맵도 HTTP 상태 코드를 가지지만, 특정 글의 공개 여부는 응답 본문에 그 URL이 포함됐는지까지 봐야 한다.
댓글 역시 대상 글이 공개 조건을 통과했다는 사실만으로 작성 요청 전체의 성공이 보장되지는 않는다.
각 검사에는 status, published_at, deleted_at, 요청 권한, 기대 결과와 실제 결과를 함께 남긴다.
어긋난 결과를 좁히는 접근은 버그를 좁혀 고치는 습관과도 연결된다.
테스트를 먼저 둘 때는 미래 예약의 독자 차단, 도래 예약의 공개, 이미 공개된 글의 시각 보존을 서로 다른 조건으로 적는다. 초안의 공개 전환과 삭제 글 재발행도 따로 검사해야 날짜 입력란 뒤의 저장 동작까지 확인할 수 있다. 이런 테스트가 없으면 버튼은 예뻐도 예약 기능이 의도대로 작동하는지는 아직 알 수 없다.
아직 댓글이 없습니다.