fix!: 재리뷰가 찾은 결함과 색인에서 빠졌던 발견 5건을 고친다

문제: 성숙도 리뷰 수정을 다시 읽은 재리뷰(Critical 0, 회귀 0)가
Important 27건·Minor 41건을 찾았다. 수정이 새로 만든 결함이 많았다.
@SystemInvoked가 권한 규칙의 탈출구가 됐고, 데모 계정 거부가 정확히
prod일 때만 걸렸고, outbox 순서 번호가 업그레이드 때 뒤로 갔고,
GraphQL union 아래 복잡도가 0이었고, 서블릿 오류 응답이 success:true로
나갔고, 호출자 deadline이 breaker를 열었다. 원래 리뷰 색인이 06 영역
발견 5건(06-10~14)을 빠뜨려 그동안 처리되지 않았다.

방법: 영역별 7묶음이 test-driven-development 절차로 실패 테스트를
먼저 쓰고 고쳤다. 결정은 재리뷰 README 4절에 적었다: 순서 번호는 V21이
기록한 전역 floor부터, 데모 계정은 local·test·demo 허용 목록,
@SystemInvoked bean은 기동 실패, complete 단계 실패는
IDEMPOTENCY_COMPLETION_UNKNOWN(결과 불명), 캐시 조건부 쓰기는 별도
SCRIPT lane, strict lane 정책은 build cache 입력, 끝나지 않는 재시도
행은 원인 코드·지표·PARKED 절차. 레지스트리가 선언만 하고 아무 코드도
내보내지 않던 redis.capability.* 지표 6개는 빼고 runbook을 실제
지표(redis.lane.*) 기준으로 고쳤다.

위험·한계: V21을 V22 없이 직접 고쳤다(어느 배포에도 아직 없음). 이
브랜치의 V21을 적용한 개발 DB는 다시 만들어야 한다. 서블릿 오류
디스패치를 보안 체인이 허용한다. 발행·저장소 포트 시그니처가 바뀌어
파생 서비스 코드가 깨진다. prod에서 fixture-로 시작하는 설정값은
기동을 막는다. httpclient failure-injection lane의 main 단계 중복
실행은 이전 결정대로 남겼다. 실제 CI runner 실행은 확인하지 못했다.

검증: ci, mainCheck, :integrationCheck, -p optional-platforms ci
integrationCheck performanceCheck, :performanceCheck, :releaseCheck
(-PgitRevision), verify-compose-profile-contracts(18 lane) 통과.
첫 실행의 실패 2건(FindSecBugs 1, sample 동시 생성 테스트의 v4 event
id)은 고친 뒤 ci·integrationCheck·mainCheck를 다시 돌려 통과했다.

Refs: docs/reviews/2026-11-03-rereview/README.md 3·4·6·7절
BREAKING CHANGE: outbox 발행 포트와 저장소 포트 시그니처, 순서 번호
첫 값(V21 floor 다음), 샘플 데모 계정 프로필 허용 목록, 새 오류 코드
IDEMPOTENCY_COMPLETION_UNKNOWN, prod의 fixture- 값 거부, 기동 rule은
static·의존 없음이어야 한다.
This commit is contained in:
DongHyeonka
2026-11-03 23:29:35 +09:00
parent 7ef8d0b4cb
commit bbe944bd3c
406 changed files with 13493 additions and 1656 deletions
@@ -2,6 +2,7 @@ package dev.caskeleton.composition.idempotency;
import dev.caskeleton.adapter.outbound.support.StrictSettingsBinder;
import dev.caskeleton.adapter.outbound.support.startup.StartupFailures;
import dev.caskeleton.application.idempotency.IdempotencyExecutor;
import java.time.Duration;
import java.util.Set;
import org.springframework.core.env.Environment;
@@ -17,7 +18,9 @@ import org.springframework.core.env.Environment;
* instead of leaving its default silently in force.
*
* @param provider which store is composed: {@code disabled}, {@code redis} or {@code postgresql}
* @param processingLease how long one attempt holds a claim before another may take it over
* @param processingLease how long one attempt holds a claim before another may take it over; longer
* than the in-flight 409's {@code Retry-After} ({@link
* IdempotencyExecutor#IN_FLIGHT_RETRY_AFTER})
* @param replayTtl how long a completed response is replayable (at most 72h, D6)
* @param failureRetention how long a failed attempt's evidence is kept
* @param responseCodecId identifier of the codec the stored payload is written with
@@ -49,6 +52,16 @@ public record IdempotencySettings(
"processing-lease",
orDefault(processingLease, Duration.ofSeconds(30)),
MAX_PROCESSING_LEASE);
// A duplicate is told to come back after IN_FLIGHT_RETRY_AFTER. With a lease no longer than
// that, the resend always arrives after the attempt it was waiting for has lost its claim.
if (processingLease.compareTo(IdempotencyExecutor.IN_FLIGHT_RETRY_AFTER) <= 0) {
throw StartupFailures.envValidation(
PREFIX
+ ".processing-lease must be longer than "
+ IdempotencyExecutor.IN_FLIGHT_RETRY_AFTER
+ " (the in-flight Retry-After), was "
+ processingLease);
}
replayTtl = bounded("replay-ttl", orDefault(replayTtl, Duration.ofHours(24)), MAX_REPLAY_TTL);
failureRetention =
bounded(
@@ -151,6 +151,31 @@ class IdempotencySettingsTest {
.hasMessageContaining("app.capabilities.idempotency." + message);
}
/**
* The in-flight 409 tells the client to come back after {@code Retry-After} (2 seconds). A lease
* no longer than that sends every resend past the attempt it was meant to wait for, so the rule
* fails startup rather than living in prose (re-review 2026-11-03, RR-02-05).
*/
@ParameterizedTest
@CsvSource({"PT1S", "PT2S"})
@DisplayName("processing-lease 가 처리 중 409 의 Retry-After 이하면 기동을 거부한다")
void aProcessingLeaseNoLongerThanTheInFlightRetryAfterIsRefused(Duration lease) {
// when
Throwable thrown =
catchThrowable(
() ->
new IdempotencySettings(
IdempotencySettings.Provider.REDIS, lease, null, null, null, null, null));
// then
assertThat(thrown)
.isInstanceOfSatisfying(
StartupFailureException.class,
e -> assertThat(e.errorCode()).isEqualTo(StartupErrorCode.STARTUP_VALIDATION_FAILED))
.hasMessageContaining(
"app.capabilities.idempotency.processing-lease must be longer than PT2S");
}
@ParameterizedTest
@CsvSource({"'', response-codec-id must contain 1-64 characters", "' ', response-codec-id"})
void blankCodecIdIsRefused(String codecId, String message) {