예약과 게시 상태

앙크 앱(ANKK APP)은 대규모 다채널 발행을 안정적으로 처리하기 위해 모든 게시 작업을 비동기 큐(Queue) 방식으로 실행합니다. 사용자가 발행 버튼을 누른 시점(접수)과 실제 SNS에 게시물이 등록되는 시점(성공)은 분리되어 관리됩니다.

예약

☷ 목록

ANKK launch update@ankk_demo · Instagram예정일: 2026-09-01 · 09:00

수정스케줄 취소

ANKK APP UI preview · 예약 · ko

📑 운영 화면 구조

채널 또는 모든 채널 보기에서 작업 목적에 맞는 화면을 선택합니다.

화면	확인하고 처리하는 항목
예약	미래에 발행할 콘텐츠. 목록·주간·월간 보기에서 수정, 일정 변경 또는 취소
확인 필요	발행 실패, 재인증, 권한 또는 제공자 확인처럼 사용자 판단이 필요한 항목
발행됨	ANKK APP에서 발행했거나 SNS에서 동기화한 콘텐츠, 원본 게시물 주소와 수집 지표
Inbox	채널별 댓글과 답글, 답글 전송 상태
분석	브랜드 전체 또는 개별 채널의 기간별 지표와 인기 게시물

예약 화면의 보기 방식

예약 화면은 같은 콘텐츠를 목록, 주간 달력, 월간 달력으로 보여줍니다. 보기 방식은 콘텐츠 상태가 아니며, 예약 콘텐츠는 어느 보기에서도 수정·일정 변경·취소할 수 있습니다.

🔄 콘텐츠 생명주기 (State Diagram)

콘텐츠의 생성부터 최종 완료까지의 상태 전이 흐름입니다:

stateDiagram-v2
    [*] --> scheduled : 예약 발행 (scheduled_for 설정)
    [*] --> pending : 즉시 발행 (즉시 큐 인입)
    scheduled --> pending : 예약 시각 도달
    scheduled --> deleted : 예약 취소 (삭제 처리)
    pending --> publishing : 워커 작업 시작
    publishing --> published : SNS 게시 성공
    publishing --> failed : SNS 게시 실패 (네트워크/API 오류)
    failed --> pending : 재시도 실행
    published --> unavailable : 원본 SNS 포스트 삭제됨

📊 콘텐츠 6대 핵심 상태

상태값	의미	설명
`scheduled`	예약 대기	지정된 예약 시각까지 대기 중인 상태. 취소/수정이 가능합니다.
`publishing`	게시 진행 중	앙크 워커가 SNS API와 통신하여 미디어 업로드 및 본문 작성을 진행 중인 상태.
`published`	게시 완료	SNS에 성공적으로 등록됨. 발행된 콘텐츠 탭으로 이동합니다.
`failed`	게시 실패	일시적인 오류로 실패함. 실패와 재시도 가이드에 따라 복구할 수 있습니다.
`deleted`	삭제/취소됨	사용자가 예약을 취소하거나 삭제한 상태.
`unavailable`	조회 불가	원본 SNS에서 게시물이 삭제되었거나 연동 계정 권한이 상실된 상태.

⚠️ 접수(Accepted / 202)와 실제 성공의 차이

Web UI에서 발행을 요청하거나 API로 POST /v1/brand/contents를 호출하여 HTTP 202 Accepted 응답을 받는 것은 작업이 대기열에 정상 등록되었음을 의미합니다:

✅ 인증 및 Public API 키 검증 완료
✅ 요금제 예약 슬롯 및 월간 한도 검사 통과
✅ 본문 글자수 및 미디어 유효성 검증 완료
✅ 작업 큐 인입 완료

실제 SNS 게시 결과는 대기열의 상태 변경 또는 Webhook 이벤트(sns.publish.succeeded)로 확인해야 합니다.