9장 시간표와 이벤트를 함께 설계한다

자동화는 webhook 같은 사건 기반과 cron 같은 시간 기반을 함께 쓴다. 사건은 빠르지만 누락될 수 있고, 시간표는 단순하지만 중복과 지연이 생긴다. 둘을 화해시키는 방법은 상태 기반 조회다.

주간 요약은 매주 월요일 09시에 “지난주 생성된 것”을 무조건 보내지 않는다. digest_pending=true이고 해당 기간의 멱등성 키가 없는 항목을 조회한다. 실행 시각은 UTC로 저장하고 사용자 시간대를 명시한다. 서머타임이 있는 지역은 “24시간 후”와 “다음 날 오전 9시”가 다르다.

웹훅은 서명, 타임스탬프, 재전송 방지 nonce를 검증한다. 빠르게 2xx를 반환하고 무거운 처리는 큐에 둔다. 공급자가 재전송하므로 이벤트 ID를 중복 제거한다. 순서가 뒤바뀔 수 있어 현재 상태와 이벤트 버전을 확인한다.