REV-BE-0038 (test(notification), a9780caf): 발송 판정의 분기 다섯을 지워도 :application-notification:test가 통과한다.
category 억제(SuppressionEntry.appliesToCategory)를 return true;나 return notificationCategory.isEmpty();로 바꿔도 통과한다. 시험 fixture의 SuppressionEntry가 모두 category 없이 만들어지기 때문이다.
DefaultNotificationRetryPolicy의 INVALID_PAYLOAD·TEMPLATE_FAILURE → Stop, contact point 비활성 → Fallback, provider 정지 → Stop 분기를 지워도 통과한다. 그 reason code를 단언하는 시험이 없다.
새 시험 둘:
NotificationEligibilityTest.aCategorySuppressionBlocksItsOwnCategoryOnly: 같은 category를 억제하면 SUPPRESSED_USER_OPT_OUT으로 막히고, "marketing"을 억제하면 허용된다.
NotificationRetryPolicyTest.evidenceThatRulesOutAnotherAttemptStopsOrFallsBackWithItsReason: 7행 표. 재시도로 끝나는 transient 실패에서 규칙 하나가 읽는 증거만 바꾼다. 그래서 지운 분기는 그 행의 decision 대신 RetryAfter로 드러난다.
PolicyFixtures에 CATEGORY 상수와 categorySuppression(...)을 둔다.
REV-BE-0039 (fix(notification), 1a1340c4): RedriveDeliveryUseCase가 없는 attemptId를 받으면 IllegalStateException을 던진다.
오류 매뉴얼(docs/manual/06-errors.md 「어떤 예외 타입으로 던지나」)은 그 예외를 있을 수 없는 서버 상태(500, 로그)에만 쓴다. attemptId는 운영자 command가 싣는 값이라(오타, 다른 환경의 id) 서버 결함이 아니다.
고친 것: 없는 id를 남의 tenant attempt와 같은 AdminAccessDeniedException(REDRIVE)로 거절한다(RedriveDeliveryUseCase.java:118). 다르게 답하면 tenant 범위 운영자가 다른 tenant에 그 id가 있는지 알게 된다. dry run과 실제 redrive가 같은 검사를 지나므로 둘 다 고쳐진다.
새 시험 NotificationAdminUseCasesTest.aRedriveOfAnUnknownAttemptIsRefusedLikeAnotherTenantsAttemptAndClaimsNothing: (tenant-b 운영자·전역 운영자) × (dry run·실제) 4행. 예외 타입, required()가 REDRIVE, claim 0, audit 0을 본다.
같이 바꾼 것: AdminAccessDeniedException Javadoc(「권한 없음, tenant 밖, 없는 대상」), 새 docs/upgrade/2026-11-notification-admin-redrive.md(바뀐 동작 행 하나), docs/notification/operations.md 운영자 연산 절 한 줄.
고른 방법과 버린 대안
0038 표의 꼴: 행마다 기준 context(재시도로 끝나는 transient 실패)에서 필드 하나만 바꾼다. accepted 행만 confirmation과 submission outcome 둘을 바꾼다. 분기 하나를 지우면 그 행만 RetryAfter로 바뀐다. 그래서 실패한 행 이름이 지운 분기를 가리킨다.
0038 카드 밖 행: 카드가 적은 넷에 PROVIDER_ALREADY_ACCEPTED 행과 provider 정지 상태 셋(AUTHENTICATION_FAILED·DISABLED·DRAINING)을 더했다. accepted 분기도 지워도 통과하던 분기라 변이 m6로 RED에 넣었다.
0039 거절 방법: 남의 tenant와 같은 예외를 고른 이유는 매뉴얼이 「남의 것」과 「없음」을 같은 응답으로 묶어 존재를 숨기기 때문이다.
버린 안:
reconcile처럼 건너뛰기. redrive는 대상이 하나라 건너뛰면 성공으로 보인다.
새 not-found 예외와 코드. NotificationFailureCode는 닫힌 목록이고 not-found 코드가 없다. 새 코드는 공개 계약을 바꾸므로 이 카드 범위 밖이다.
위험과 영향
0038: policy main 코드는 바꾸지 않았다. 운영 영향이 없다. shipped 코드는 아직 category 억제를 만들지 않는다. 이 시험은 그것을 만드는 코드가 생길 때를 지킨다.
0039 응답이 바뀐다: 없는 attemptId redrive가 IllegalStateException(전송이 500으로 냈다면 500)에서 AdminAccessDeniedException(code VALIDATION_FAILED, category AUTHORIZATION)으로 바뀐다. 그 ISE를 잡던 코드는 이 예외를 놓친다.
제목에 !를 붙이지 않았다. upgrade 안내의 행이 「바뀐 동작 (따라 할 일 없음)」이고, 템플릿은 이 연산을 부르는 전송을 싣지 않는다. 선례 REV-BE-0024(5f6d7628)도 !가 없다.
전역 운영자(tenant 범위 없음)도 없는 id에 같은 거절을 받는다. 시험 4행 중 2행이 이것이다.
admin 유스케이스를 부르는 transport가 아직 없어 HTTP 상태로는 보지 않았다.
카드 범위 밖으로 둔 것(리뷰 반영):AdminAccessDeniedException Javadoc, upgrade 안내, operations.md 한 줄. 응답이 바뀌는 변경은 약속한 응답과 안내를 같이 맞춘다는 기준(docs/work/improve.md 4절 6번, docs/work/reference/decisions.md 「약속한 응답으로 맞추기」)을 따랐다.
바꾸지 않은 것: ReconcileDeliveriesUseCase는 묶음 안의 없는 id를 그대로 건너뛴다.
열기 전 origin/main은 c79ddf52로 나아갔다(#85, .gitignore만). git merge-tree --write-tree origin/main HEAD는 충돌 없이 트리 9fc45251을 냈다. 위 gate는 6292c528 위의 이 브랜치 트리(23b189be31)에서 돌렸다.
main 전용 lane은 돌리지 않았다. 근거:
바꾼 main 줄(RedriveDeliveryUseCase.java:118)과 policy 클래스(SuppressionEntry·DefaultNotificationRetryPolicy)를 동작으로 부르는 시험은 :application-notification 단위 시험뿐이다. 모듈 밖에서 이 클래스를 쓰는 시험은 NotificationPlatformCoreConfigurationTest.java:125 하나다. bean 목록에 RedriveDeliveryUseCase.class가 있는지만 보고 redrive를 부르지 않는다(git grep -n -E 'RedriveDeliveryUseCase|delivery attempt is not available|AdminAccessDeniedException', 시험 경로, notification 모듈 밖).
바꾼 문서 둘을 읽는 시험은 없다. git grep -n 'docs/notification/operations.md' -- 'src/*.java'는 main Javadoc 참조 하나(NotificationAdminPermissions.java:10, 절 이름 「운영자 연산」은 그대로)뿐이다. upgrade 안내 파일 이름은 src/·scripts/·build-logic/ 어디에도 없다.
리뷰어가 볼 곳
NotificationRetryPolicyTest의 otherwiseRetrying(...): 행이 바꾸는 필드 다섯만 인자다. 나머지는 transientFailureWithBudgetAndDeadlineRetries와 같은 재시도 context다.
NotificationAdminUseCasesTest의 새 시험: 상태 단언은 이 repo 규칙(.claude/rules/java-tests.md 5, then은 한 번에 비교)에 맞춰 List.of(required, claims, audit) 하나로 묶고 .as(...)로 자리 이름을 붙였다.
docs/upgrade/2026-11-notification-admin-redrive.md 2절 표 한 행: 전·후 동작과 해당 서비스.
리뷰 반영
종류 B, 리뷰 1회(병렬 둘, 세션 기본 모델): reviewer(렌즈 be-domain·be-testing·be-api-contract) Medium 1·Low 1·Minor 3, arch-reviewer(be-domain) 발견 0.
Medium(응답이 바뀌는데 upgrade 안내·운영 문서가 없고 제목에 !가 없다): upgrade 행과 operations.md 줄을 더했다. !는 위 「위험과 영향」의 이유로 붙이지 않았다.
Low(AdminAccessDeniedException Javadoc이 「권한 없음」만 말한다): Javadoc과 required() 설명을 넓혔다.
Minor 셋: retry 시험 Javadoc의 「필드 하나」를 accepted 행 예외까지 정정, 커밋 본문 문구 정리, 전역 운영자 행 추가.
ReconcileDeliveriesUseCase.java:119의 reconciled++가 없는 id도 affected로 센다(be-domain 후속).
PolicyFixtures.java:93FixedSuppressionStore는 계약 밖 시험 전용 fake다. testkit에 InMemorySuppressionStore가 있다(be-testing).
docs/manual/06-errors.md:36·07-authorization.md:58은 남의 것을 404로 숨기는데 운영자 연산은 AUTHORIZATION 거절로 숨긴다. admin 전송이 생길 때 not-found 코드를 정할 일이다(소유자 결정, 공개 계약).
## 무엇을, 왜
커밋 둘이다. 하나는 시험만 더하고, 하나는 main 한 줄을 고친다.
- **REV-BE-0038** (`test(notification)`, a9780caf): 발송 판정의 분기 다섯을 지워도 `:application-notification:test`가 통과한다.
- category 억제(`SuppressionEntry.appliesToCategory`)를 `return true;`나 `return notificationCategory.isEmpty();`로 바꿔도 통과한다. 시험 fixture의 `SuppressionEntry`가 모두 category 없이 만들어지기 때문이다.
- `DefaultNotificationRetryPolicy`의 `INVALID_PAYLOAD`·`TEMPLATE_FAILURE` → Stop, contact point 비활성 → Fallback, provider 정지 → Stop 분기를 지워도 통과한다. 그 reason code를 단언하는 시험이 없다.
- 새 시험 둘:
- `NotificationEligibilityTest.aCategorySuppressionBlocksItsOwnCategoryOnly`: 같은 category를 억제하면 `SUPPRESSED_USER_OPT_OUT`으로 막히고, `"marketing"`을 억제하면 허용된다.
- `NotificationRetryPolicyTest.evidenceThatRulesOutAnotherAttemptStopsOrFallsBackWithItsReason`: 7행 표. 재시도로 끝나는 transient 실패에서 규칙 하나가 읽는 증거만 바꾼다. 그래서 지운 분기는 그 행의 decision 대신 `RetryAfter`로 드러난다.
- `PolicyFixtures`에 `CATEGORY` 상수와 `categorySuppression(...)`을 둔다.
- **REV-BE-0039** (`fix(notification)`, 1a1340c4): `RedriveDeliveryUseCase`가 없는 attemptId를 받으면 `IllegalStateException`을 던진다.
- 오류 매뉴얼(`docs/manual/06-errors.md` 「어떤 예외 타입으로 던지나」)은 그 예외를 있을 수 없는 서버 상태(500, 로그)에만 쓴다. attemptId는 운영자 command가 싣는 값이라(오타, 다른 환경의 id) 서버 결함이 아니다.
- 고친 것: 없는 id를 남의 tenant attempt와 같은 `AdminAccessDeniedException(REDRIVE)`로 거절한다(`RedriveDeliveryUseCase.java:118`). 다르게 답하면 tenant 범위 운영자가 다른 tenant에 그 id가 있는지 알게 된다. dry run과 실제 redrive가 같은 검사를 지나므로 둘 다 고쳐진다.
- 새 시험 `NotificationAdminUseCasesTest.aRedriveOfAnUnknownAttemptIsRefusedLikeAnotherTenantsAttemptAndClaimsNothing`: (tenant-b 운영자·전역 운영자) × (dry run·실제) 4행. 예외 타입, `required()`가 `REDRIVE`, claim 0, audit 0을 본다.
- 같이 바꾼 것: `AdminAccessDeniedException` Javadoc(「권한 없음, tenant 밖, 없는 대상」), 새 `docs/upgrade/2026-11-notification-admin-redrive.md`(바뀐 동작 행 하나), `docs/notification/operations.md` 운영자 연산 절 한 줄.
## 고른 방법과 버린 대안
- **0038 표의 꼴:** 행마다 기준 context(재시도로 끝나는 transient 실패)에서 필드 하나만 바꾼다. accepted 행만 confirmation과 submission outcome 둘을 바꾼다. 분기 하나를 지우면 그 행만 `RetryAfter`로 바뀐다. 그래서 실패한 행 이름이 지운 분기를 가리킨다.
- **0038 카드 밖 행:** 카드가 적은 넷에 `PROVIDER_ALREADY_ACCEPTED` 행과 provider 정지 상태 셋(`AUTHENTICATION_FAILED`·`DISABLED`·`DRAINING`)을 더했다. accepted 분기도 지워도 통과하던 분기라 변이 m6로 RED에 넣었다.
- **0039 거절 방법:** 남의 tenant와 같은 예외를 고른 이유는 매뉴얼이 「남의 것」과 「없음」을 같은 응답으로 묶어 존재를 숨기기 때문이다.
- 버린 안:
- reconcile처럼 건너뛰기. redrive는 대상이 하나라 건너뛰면 성공으로 보인다.
- 새 not-found 예외와 코드. `NotificationFailureCode`는 닫힌 목록이고 not-found 코드가 없다. 새 코드는 공개 계약을 바꾸므로 이 카드 범위 밖이다.
## 위험과 영향
- **0038:** policy main 코드는 바꾸지 않았다. 운영 영향이 없다. shipped 코드는 아직 category 억제를 만들지 않는다. 이 시험은 그것을 만드는 코드가 생길 때를 지킨다.
- **0039 응답이 바뀐다:** 없는 attemptId redrive가 `IllegalStateException`(전송이 500으로 냈다면 500)에서 `AdminAccessDeniedException`(code `VALIDATION_FAILED`, category `AUTHORIZATION`)으로 바뀐다. 그 ISE를 잡던 코드는 이 예외를 놓친다.
- 제목에 `!`를 붙이지 않았다. upgrade 안내의 행이 「바뀐 동작 (따라 할 일 없음)」이고, 템플릿은 이 연산을 부르는 전송을 싣지 않는다. 선례 REV-BE-0024(`5f6d7628`)도 `!`가 없다.
- 전역 운영자(tenant 범위 없음)도 없는 id에 같은 거절을 받는다. 시험 4행 중 2행이 이것이다.
- admin 유스케이스를 부르는 transport가 아직 없어 HTTP 상태로는 보지 않았다.
- **카드 범위 밖으로 둔 것(리뷰 반영):** `AdminAccessDeniedException` Javadoc, upgrade 안내, `operations.md` 한 줄. 응답이 바뀌는 변경은 약속한 응답과 안내를 같이 맞춘다는 기준(`docs/work/improve.md` 4절 6번, `docs/work/reference/decisions.md` 「약속한 응답으로 맞추기」)을 따랐다.
- 바꾸지 않은 것: `ReconcileDeliveriesUseCase`는 묶음 안의 없는 id를 그대로 건너뛴다.
## 검증
RED·GREEN은 desktop 드라이버(`red.sh`)로 돌렸다. 로그는 desktop `~/be-lane-n7-p2red/`다.
- 먼저 origin/main 6292c528 위에서 변이를 넣고 모듈 전체를 돌렸다.
- 다음에 두 커밋을 `git am`해 트리 `23b189be31583dbdb868cac3ab9fd8c6084d0d3e`(노트북 HEAD 트리와 같음)에서 GREEN과 변이 일곱을 하나씩 돌렸다.
- 명령: `flock /tmp/claude-gates/heavy.lock ./gradlew :application-notification:test [--tests …NotificationEligibilityTest --tests …NotificationRetryPolicyTest --tests …NotificationAdminUseCasesTest] --no-daemon --console=plain --no-build-cache`
| 실행 | 변이(main) | 범위 | rc | 실패한 시험 |
|---|---|---|---|---|
| pre-a | m1 + mR(m3~m6 함께), 고치기 전 트리 | 모듈 전체 | 0 | 없음(380 통과) |
| pre-b | m2 + mR, 고치기 전 트리 | 모듈 전체 | 0 | 없음(380 통과) |
| green | 없음 | 세 클래스 | 0 | 없음(42) |
| m1 | `SuppressionEntry.java:54` → `return true;` | 세 클래스 | 1 | `aCategorySuppressionBlocksItsOwnCategoryOnly` `[2] "marketing"`(허용 기대, 막힘) |
| m2 | 같은 줄 → `return notificationCategory.isEmpty();` | 세 클래스 | 1 | `aCategorySuppressionBlocksItsOwnCategoryOnly` `[1] "payment.receipt"`(`SUPPRESSED_USER_OPT_OUT` 기대, 허용) |
| m3 | `DefaultNotificationRetryPolicy.java:41-43` `INVALID_PAYLOAD, TEMPLATE_FAILURE` → Stop 삭제 | 세 클래스 | 1 | `evidenceThatRulesOutAnotherAttempt…` 행 `INVALID_PAYLOAD`·`TEMPLATE_FAILURE`(`RetryAfter[PT1S]`) |
| m4 | 같은 파일 `:67-69` contact point 비활성 → Fallback 삭제 | 세 클래스 | 1 | 같은 시험 행 `contact point inactive` |
| m5 | 같은 파일 `:70-72` provider 정지 → Stop 삭제 | 세 클래스 | 1 | 같은 시험 행 `provider AUTHENTICATION_FAILED`·`DISABLED`·`DRAINING` |
| m6 | 같은 파일 `:64-66` `CONFIRMED_ACCEPTED` → Stop 삭제(카드 밖) | 세 클래스 | 1 | 같은 시험 행 `provider already accepted` |
| m7 | `RedriveDeliveryUseCase.java:118`을 `IllegalStateException`으로 되돌림 | 세 클래스 | 1 | `aRedriveOfAnUnknownAttemptIsRefused…` 4행 모두(`IllegalStateException: delivery attempt is not available`) |
- m7 트리는 고친 줄만 고치기 전으로 되돌리고 새 시험은 둔 트리다. 그래서 이 한 줄이 REV-BE-0039 C1의 「고치기 전에는 ISE로 실패」와 「ISE로 되돌리면 실패」를 함께 보인다.
- pre-a·pre-b를 둘로 나눈 것은 m1과 m2가 같은 줄을 바꾸기 때문이다. mR은 m3~m6을 한 패치로 묶은 것이다(같은 파일 인접 줄).
- 「삭제」 변이는 분기를 통째로 지웠다. 필드를 안 읽게 되는 변이가 없어 Error Prone `UnusedVariable`에 걸리지 않는다. 변이 로그에 컴파일 오류는 없다(`error:` 0줄).
gate(노트북 detached worktree, 트리 23b189be3158, HEAD 트리와 같음):
- desktop `scripts/verify.sh leaf :application-notification --no-cache --log be-lane-n7-p2-leaf`: rc=0, tests=393 failures=0 errors=0 skipped=0, FROM-CACHE 0 (REV-BE-0039 C2)
- desktop `scripts/verify.sh pr --no-cache --log be-lane-n7-p2-pr`: rc=0, tests=7363 failures=0 errors=0 skipped=35, FROM-CACHE 0
- 노트북 `scripts/verify.sh docs`: rc=0
- PR run `pr / done`: run 534(head 1a1340c4) success
- 열기 전 origin/main은 c79ddf52로 나아갔다(#85, `.gitignore`만). `git merge-tree --write-tree origin/main HEAD`는 충돌 없이 트리 `9fc45251`을 냈다. 위 gate는 6292c528 위의 이 브랜치 트리(23b189be3158)에서 돌렸다.
- main 전용 lane은 돌리지 않았다. 근거:
- 바꾼 main 줄(`RedriveDeliveryUseCase.java:118`)과 policy 클래스(`SuppressionEntry`·`DefaultNotificationRetryPolicy`)를 동작으로 부르는 시험은 `:application-notification` 단위 시험뿐이다. 모듈 밖에서 이 클래스를 쓰는 시험은 `NotificationPlatformCoreConfigurationTest.java:125` 하나다. bean 목록에 `RedriveDeliveryUseCase.class`가 있는지만 보고 redrive를 부르지 않는다(`git grep -n -E 'RedriveDeliveryUseCase|delivery attempt is not available|AdminAccessDeniedException'`, 시험 경로, notification 모듈 밖).
- 바꾼 문서 둘을 읽는 시험은 없다. `git grep -n 'docs/notification/operations.md' -- 'src/*.java'`는 main Javadoc 참조 하나(`NotificationAdminPermissions.java:10`, 절 이름 「운영자 연산」은 그대로)뿐이다. upgrade 안내 파일 이름은 `src/`·`scripts/`·`build-logic/` 어디에도 없다.
## 리뷰어가 볼 곳
- `NotificationRetryPolicyTest`의 `otherwiseRetrying(...)`: 행이 바꾸는 필드 다섯만 인자다. 나머지는 `transientFailureWithBudgetAndDeadlineRetries`와 같은 재시도 context다.
- `NotificationAdminUseCasesTest`의 새 시험: 상태 단언은 이 repo 규칙(`.claude/rules/java-tests.md` 5, then은 한 번에 비교)에 맞춰 `List.of(required, claims, audit)` 하나로 묶고 `.as(...)`로 자리 이름을 붙였다.
- `docs/upgrade/2026-11-notification-admin-redrive.md` 2절 표 한 행: 전·후 동작과 해당 서비스.
## 리뷰 반영
- 종류 B, 리뷰 1회(병렬 둘, 세션 기본 모델): `reviewer`(렌즈 be-domain·be-testing·be-api-contract) Medium 1·Low 1·Minor 3, `arch-reviewer`(be-domain) 발견 0.
- Medium(응답이 바뀌는데 upgrade 안내·운영 문서가 없고 제목에 `!`가 없다): upgrade 행과 `operations.md` 줄을 더했다. `!`는 위 「위험과 영향」의 이유로 붙이지 않았다.
- Low(`AdminAccessDeniedException` Javadoc이 「권한 없음」만 말한다): Javadoc과 `required()` 설명을 넓혔다.
- Minor 셋: retry 시험 Javadoc의 「필드 하나」를 accepted 행 예외까지 정정, 커밋 본문 문구 정리, 전역 운영자 행 추가.
- 확인 리뷰 0회(총괄 결정: upgrade 문서와 `!` 판단을 총괄이 읽고 받아들였다).
## 관련
- 리뷰 항목 REV-BE-0038, REV-BE-0039(묶음 REV-BE-0047 be4-core의 PR 2)
- 넘긴 것(이 diff 밖):
- `ReconcileDeliveriesUseCase.java:119`의 `reconciled++`가 없는 id도 affected로 센다(be-domain 후속).
- `PolicyFixtures.java:93` `FixedSuppressionStore`는 계약 밖 시험 전용 fake다. testkit에 `InMemorySuppressionStore`가 있다(be-testing).
- `docs/manual/06-errors.md:36`·`07-authorization.md:58`은 남의 것을 404로 숨기는데 운영자 연산은 AUTHORIZATION 거절로 숨긴다. admin 전송이 생길 때 not-found 코드를 정할 일이다(소유자 결정, 공개 계약).
발송 판정의 category 억제(SuppressionEntry.appliesToCategory)를
`return true;`나 `return notificationCategory.isEmpty();`로 바꿔도,
DefaultNotificationRetryPolicy의 INVALID_PAYLOAD·TEMPLATE_FAILURE →
Stop, contact point 비활성 → Fallback, provider 정지 → Stop 분기를
지워도 :application-notification:test가 통과한다. 시험 fixture의
SuppressionEntry는 모두 category가 비어 있고, 그 reason code를
단언하는 시험이 없다.
- NotificationEligibilityTest에 category 억제 두 행을 더한다. 같은
category면 SUPPRESSED_USER_OPT_OUT으로 막히고, 다른 category면
허용된다. PolicyFixtures에 categorySuppression과 context의 category
상수를 둔다.
- NotificationRetryPolicyTest에 (증거 → 기대 decision) 표를 더한다.
각 행은 재시도로 끝나는 transient 실패에서 규칙 하나가 읽는 증거만
바꾼다(accepted 행만 confirmation과 submission outcome 둘). 그래서
지운 분기는 그 행의 decision 대신 RetryAfter로 드러난다.
카드가 적은 넷에 PROVIDER_ALREADY_ACCEPTED와 provider 정지 상태
셋(AUTHENTICATION_FAILED·DISABLED·DRAINING)을 행으로 더했다.
위험·한계: policy main 코드는 바꾸지 않았다. shipped 코드는 아직
category 억제를 만들지 않으므로 이 시험은 그것을 만드는 코드가 생길
때를 지킨다.
검증: desktop RED·GREEN은 PR 본문에 둔다.
Refs: REV-BE-0038
RedriveDeliveryUseCase는 운영자가 보낸 attemptId로 시도를 찾지 못하면
IllegalStateException을 던진다. 오류 매뉴얼(06-errors)은 그 예외를
있을 수 없는 서버 상태(500, 로그)에 쓰고, 찾는 것이 없음은 클라이언트
탓으로 정한다. attemptId는 운영자 command가 싣는 값이라(오타, 다른
환경의 id) 서버 결함 경보를 울릴 일이 아니다.
없는 id를 남의 tenant 시도와 같은 AdminAccessDeniedException(REDRIVE)로
거절한다. 매뉴얼도 「남의 것」과 「없음」을 같은 응답으로 묶어 존재를
숨긴다. 다르게 답하면 tenant 범위 운영자가 다른 tenant에 그 id가
있는지 알게 된다. dry run과 실제 redrive가 같은 검사를 지나므로 둘 다
같이 고쳐진다. NotificationAdminUseCasesTest에 (tenant 범위 운영자·전역
운영자) × (dry run·실제)를 행으로 하는 시험을 더한다: 그 예외, claim 0,
audit 0.
AdminAccessDeniedException의 Javadoc을 「권한 없음, tenant 밖, 없는
대상」으로 넓히고 required()를 「거절된 연산이 쓰는 authority」로 쓴다.
응답이 바뀌므로 docs/upgrade/2026-11-notification-admin-redrive.md에
바뀐 동작 행을 두고, docs/notification/operations.md 운영자 연산 절에
한 줄 적는다. 따라 고칠 코드는 대개 없어(템플릿은 전송을 싣지 않는다)
제목에 !를 붙이지 않았다.
버린 안:
- reconcile처럼 건너뛰기. redrive는 대상이 하나라 건너뛰면 성공으로
보인다.
- 새 not-found 예외와 코드. notification 오류 어휘(NotificationFailureCode)는
닫힌 목록이고 not-found 코드가 없어 새 코드가 공개 계약을 바꾼다. 이
변경의 범위 밖이다.
위험·한계: 전역 운영자(tenant 범위 없음)도 없는 id에 거절을 받는다.
admin 유스케이스를 부르는 transport가 아직 없어 HTTP 상태로는 보지
않았다. ReconcileDeliveriesUseCase의 건너뛰기는 그대로다.
검증: desktop RED·GREEN은 PR 본문에 둔다.
Refs: REV-BE-0039
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
무엇을, 왜
커밋 둘이다. 하나는 시험만 더하고, 하나는 main 한 줄을 고친다.
test(notification),a9780caf): 발송 판정의 분기 다섯을 지워도:application-notification:test가 통과한다.SuppressionEntry.appliesToCategory)를return true;나return notificationCategory.isEmpty();로 바꿔도 통과한다. 시험 fixture의SuppressionEntry가 모두 category 없이 만들어지기 때문이다.DefaultNotificationRetryPolicy의INVALID_PAYLOAD·TEMPLATE_FAILURE→ Stop, contact point 비활성 → Fallback, provider 정지 → Stop 분기를 지워도 통과한다. 그 reason code를 단언하는 시험이 없다.NotificationEligibilityTest.aCategorySuppressionBlocksItsOwnCategoryOnly: 같은 category를 억제하면SUPPRESSED_USER_OPT_OUT으로 막히고,"marketing"을 억제하면 허용된다.NotificationRetryPolicyTest.evidenceThatRulesOutAnotherAttemptStopsOrFallsBackWithItsReason: 7행 표. 재시도로 끝나는 transient 실패에서 규칙 하나가 읽는 증거만 바꾼다. 그래서 지운 분기는 그 행의 decision 대신RetryAfter로 드러난다.PolicyFixtures에CATEGORY상수와categorySuppression(...)을 둔다.fix(notification),1a1340c4):RedriveDeliveryUseCase가 없는 attemptId를 받으면IllegalStateException을 던진다.docs/manual/06-errors.md「어떤 예외 타입으로 던지나」)은 그 예외를 있을 수 없는 서버 상태(500, 로그)에만 쓴다. attemptId는 운영자 command가 싣는 값이라(오타, 다른 환경의 id) 서버 결함이 아니다.AdminAccessDeniedException(REDRIVE)로 거절한다(RedriveDeliveryUseCase.java:118). 다르게 답하면 tenant 범위 운영자가 다른 tenant에 그 id가 있는지 알게 된다. dry run과 실제 redrive가 같은 검사를 지나므로 둘 다 고쳐진다.NotificationAdminUseCasesTest.aRedriveOfAnUnknownAttemptIsRefusedLikeAnotherTenantsAttemptAndClaimsNothing: (tenant-b 운영자·전역 운영자) × (dry run·실제) 4행. 예외 타입,required()가REDRIVE, claim 0, audit 0을 본다.AdminAccessDeniedExceptionJavadoc(「권한 없음, tenant 밖, 없는 대상」), 새docs/upgrade/2026-11-notification-admin-redrive.md(바뀐 동작 행 하나),docs/notification/operations.md운영자 연산 절 한 줄.고른 방법과 버린 대안
RetryAfter로 바뀐다. 그래서 실패한 행 이름이 지운 분기를 가리킨다.PROVIDER_ALREADY_ACCEPTED행과 provider 정지 상태 셋(AUTHENTICATION_FAILED·DISABLED·DRAINING)을 더했다. accepted 분기도 지워도 통과하던 분기라 변이 m6로 RED에 넣었다.NotificationFailureCode는 닫힌 목록이고 not-found 코드가 없다. 새 코드는 공개 계약을 바꾸므로 이 카드 범위 밖이다.위험과 영향
IllegalStateException(전송이 500으로 냈다면 500)에서AdminAccessDeniedException(codeVALIDATION_FAILED, categoryAUTHORIZATION)으로 바뀐다. 그 ISE를 잡던 코드는 이 예외를 놓친다.!를 붙이지 않았다. upgrade 안내의 행이 「바뀐 동작 (따라 할 일 없음)」이고, 템플릿은 이 연산을 부르는 전송을 싣지 않는다. 선례 REV-BE-0024(5f6d7628)도!가 없다.AdminAccessDeniedExceptionJavadoc, upgrade 안내,operations.md한 줄. 응답이 바뀌는 변경은 약속한 응답과 안내를 같이 맞춘다는 기준(docs/work/improve.md4절 6번,docs/work/reference/decisions.md「약속한 응답으로 맞추기」)을 따랐다.ReconcileDeliveriesUseCase는 묶음 안의 없는 id를 그대로 건너뛴다.검증
RED·GREEN은 desktop 드라이버(
red.sh)로 돌렸다. 로그는 desktop~/be-lane-n7-p2red/다.6292c528위에서 변이를 넣고 모듈 전체를 돌렸다.git am해 트리23b189be31583dbdb868cac3ab9fd8c6084d0d3e(노트북 HEAD 트리와 같음)에서 GREEN과 변이 일곱을 하나씩 돌렸다.flock /tmp/claude-gates/heavy.lock ./gradlew :application-notification:test [--tests …NotificationEligibilityTest --tests …NotificationRetryPolicyTest --tests …NotificationAdminUseCasesTest] --no-daemon --console=plain --no-build-cacheSuppressionEntry.java:54→return true;aCategorySuppressionBlocksItsOwnCategoryOnly[2] "marketing"(허용 기대, 막힘)return notificationCategory.isEmpty();aCategorySuppressionBlocksItsOwnCategoryOnly[1] "payment.receipt"(SUPPRESSED_USER_OPT_OUT기대, 허용)DefaultNotificationRetryPolicy.java:41-43INVALID_PAYLOAD, TEMPLATE_FAILURE→ Stop 삭제evidenceThatRulesOutAnotherAttempt…행INVALID_PAYLOAD·TEMPLATE_FAILURE(RetryAfter[PT1S]):67-69contact point 비활성 → Fallback 삭제contact point inactive:70-72provider 정지 → Stop 삭제provider AUTHENTICATION_FAILED·DISABLED·DRAINING:64-66CONFIRMED_ACCEPTED→ Stop 삭제(카드 밖)provider already acceptedRedriveDeliveryUseCase.java:118을IllegalStateException으로 되돌림aRedriveOfAnUnknownAttemptIsRefused…4행 모두(IllegalStateException: delivery attempt is not available)UnusedVariable에 걸리지 않는다. 변이 로그에 컴파일 오류는 없다(error:0줄).gate(노트북 detached worktree, 트리
23b189be31, HEAD 트리와 같음):desktop
scripts/verify.sh leaf :application-notification --no-cache --log be-lane-n7-p2-leaf: rc=0, tests=393 failures=0 errors=0 skipped=0, FROM-CACHE 0 (REV-BE-0039 C2)desktop
scripts/verify.sh pr --no-cache --log be-lane-n7-p2-pr: rc=0, tests=7363 failures=0 errors=0 skipped=35, FROM-CACHE 0노트북
scripts/verify.sh docs: rc=0PR run
pr / done: run 534(head1a1340c4) success열기 전 origin/main은 c79ddf52로 나아갔다(#85,
.gitignore만).git merge-tree --write-tree origin/main HEAD는 충돌 없이 트리9fc45251을 냈다. 위 gate는6292c528위의 이 브랜치 트리(23b189be31)에서 돌렸다.main 전용 lane은 돌리지 않았다. 근거:
RedriveDeliveryUseCase.java:118)과 policy 클래스(SuppressionEntry·DefaultNotificationRetryPolicy)를 동작으로 부르는 시험은:application-notification단위 시험뿐이다. 모듈 밖에서 이 클래스를 쓰는 시험은NotificationPlatformCoreConfigurationTest.java:125하나다. bean 목록에RedriveDeliveryUseCase.class가 있는지만 보고 redrive를 부르지 않는다(git grep -n -E 'RedriveDeliveryUseCase|delivery attempt is not available|AdminAccessDeniedException', 시험 경로, notification 모듈 밖).git grep -n 'docs/notification/operations.md' -- 'src/*.java'는 main Javadoc 참조 하나(NotificationAdminPermissions.java:10, 절 이름 「운영자 연산」은 그대로)뿐이다. upgrade 안내 파일 이름은src/·scripts/·build-logic/어디에도 없다.리뷰어가 볼 곳
NotificationRetryPolicyTest의otherwiseRetrying(...): 행이 바꾸는 필드 다섯만 인자다. 나머지는transientFailureWithBudgetAndDeadlineRetries와 같은 재시도 context다.NotificationAdminUseCasesTest의 새 시험: 상태 단언은 이 repo 규칙(.claude/rules/java-tests.md5, then은 한 번에 비교)에 맞춰List.of(required, claims, audit)하나로 묶고.as(...)로 자리 이름을 붙였다.docs/upgrade/2026-11-notification-admin-redrive.md2절 표 한 행: 전·후 동작과 해당 서비스.리뷰 반영
reviewer(렌즈 be-domain·be-testing·be-api-contract) Medium 1·Low 1·Minor 3,arch-reviewer(be-domain) 발견 0.!가 없다): upgrade 행과operations.md줄을 더했다.!는 위 「위험과 영향」의 이유로 붙이지 않았다.AdminAccessDeniedExceptionJavadoc이 「권한 없음」만 말한다): Javadoc과required()설명을 넓혔다.!판단을 총괄이 읽고 받아들였다).관련
ReconcileDeliveriesUseCase.java:119의reconciled++가 없는 id도 affected로 센다(be-domain 후속).PolicyFixtures.java:93FixedSuppressionStore는 계약 밖 시험 전용 fake다. testkit에InMemorySuppressionStore가 있다(be-testing).docs/manual/06-errors.md:36·07-authorization.md:58은 남의 것을 404로 숨기는데 운영자 연산은 AUTHORIZATION 거절로 숨긴다. admin 전송이 생길 때 not-found 코드를 정할 일이다(소유자 결정, 공개 계약).