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:
+14
-1
@@ -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(
|
||||
|
||||
+25
@@ -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) {
|
||||
|
||||
Reference in New Issue
Block a user