--- kind: CASE slug: messaging-reliability-api-f05 title: inbox 보존 규칙이 문서로만 있다 topic: contract-domain-and-bounds project: clean-architecture-backend-template status: 게시 전 sourceRevision: 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916 rootTreeNode: case:messaging-reliability-api-f05 evidenceCapturedOn: 2026-09-01 assets: - key: messaging-reliability-api-f05 file: ../../../final/evidence/rendered/messaging-reliability-api-f05.svg evidence: - ../../../final/evidence/raw/messaging-reliability-api-f05.txt source: - 원본 분석 절은 final/document.md#a19-messaging-reliability-api#L725 이다. module: messaging-reliability-api priority: P3 --- # inbox 보존 규칙이 문서로만 있다 InboxRepository.purgeProcessedBefore javadoc이 "Retention must outlive the broker's maximum redelivery window, otherwise a late redelivery arrives after its inbox row was pruned and is processed a second time"라고 한다. 그 비교를 하는 코드가 이 leaf에도 messaging-policy의 프로파일 검증기에도 없다. ## 관계 - **계약만 담는 leaf도 계약의 거절 조건은 자기 레인에서 검증한다** 같은 분석 리프에서 끌어낸 규칙이다. - **record의 `equals`를 좁히면 이유를 적는다** 같은 분석 리프에서 끌어낸 규칙이다. - **호출 컨텍스트가 계약이면 그 컨텍스트를 검증할 수단을 함께 정한다** 같은 분석 리프에서 끌어낸 규칙이다. ## 문제 InboxRepository.purgeProcessedBefore javadoc이 "Retention must outlive the broker's maximum redelivery window, otherwise a late redelivery arrives after its inbox row was pruned and is processed a second time"라고 한다. 그 비교를 하는 코드가 이 leaf에도 messaging-policy의 프로파일 검증기에도 없다. ## 결론 위반의 결과가 부작용의 이중 실행이다 — Inbox가 존재하는 이유 그 자체가 무효화된다. 그리고 위반이 조용하다: 짧은 보존은 정상 동작처럼 보이고 늦은 재전달이 올 때만 드러난다. ## 검증 환경 OpenJDK : 21.0.12 java -version 으로 확인 Gradle : 9.0.0 src/gradle/wrapper/gradle-wrapper.properties 의 distributionUrl 로 확인 확인 방식 : InboxRepository 참조 20건 검색과 보존·재전달 창을 비교하는 코드의 존재 여부 확인 소스 수정 : x ## 재현 조건 원문은 final/document.md#a19-messaging-reliability-api#L725 에 있다. ## 본문 `InboxRepository.purgeProcessedBefore` javadoc이 "Retention must outlive the broker's maximum redelivery window, otherwise a late redelivery arrives after its inbox row was pruned and is processed a second time"라고 한다. 그 비교를 하는 코드가 이 leaf에도 `messaging-policy`의 프로파일 검증기에도 없다. ## InboxRepository 참조 위치 :::evidence key="messaging-reliability-api-f05" alt="코드베이스에서 InboxRepository 를 검색한 출력 20줄. 이 기록이 세는 참조가 그 출력에 그대로 보인다." caption="InboxRepository 코드베이스 검색 — 20줄 · exit 0" zoom="true" ::: ## 위반의 결과가 부작용의 이중 실행이다 Inbox가 존재하는 이유 그 자체가 무효화된다. 그리고 위반이 조용하다 — 짧은 보존은 정상 동작처럼 보이고 늦은 재전달이 올 때만 드러난다. ## 확인하지 못한 것 inbox 보존 기간이 실제 배포에서 브로커 재전달 창보다 긴지 확인할 수 없었다. 비교하는 코드가 없다.