review-followup Wave 3 라운드 3(P21): messaging 플랫폼 — Kafka 소비(MessageHandler 하나), API 정리

- 결정 10: consume 계약을 `MessageHandler<T>` 하나로, starter-kafka가 consumer 조립(handler bean이 있으면 켜짐,
  `app.messaging.enabled=false`로 끔). 오프셋은 handler Success(inbox면 트랜잭션 커밋) 뒤 또는 DLQ 쓰기 확인 뒤에만 커밋,
  auto-commit 금지, `read_committed`, 재시도 소진 → DLQ(없으면 멈춤) — Kafka+PG로 왕복·중복 제거·DLQ 검증
- 미사용 API 타입·Blocking/Reactive/Batch facade·reactor api 노출 삭제, `PublishResult` 정적 factory,
  `MessagingCapabilities` → EnumSet, API leaf 병합(core-api+schema-api, admin-api+admin-runtime), starter god config 분해,
  Kafka broker 설정은 starter-kafka로, 등급 용어 정리
- 결함 수정: Retry 응답이 시도 횟수를 세지 않아 partition 정지(P21-new-1), deliveryAttempt 항상 1(P21-new-2)
- 통합: app-bootstrap `MessagingPublicSurfaceContractTest` 기대값을 P21 변경에 맞춤, starter-kafka에 `api kafka-clients`

검증: ./gradlew check architectureCheck verifyDependencyLocks :app-bootstrap:verifyEnvKeys :app-bootstrap:integrationTest
:sample-portfolio:integrationTest :messaging:messaging-spring-boot-starter:integrationTest
:messaging:messaging-reliability-jdbc-postgresql:integrationTest mainCheck --continue 통과(812 task)

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
This commit is contained in:
donghyeon-ka
2026-09-29 13:29:46 +09:00
co-authored by Claude Opus 5.5
parent 36ba0810c8
commit 486d85a603
197 changed files with 3526 additions and 4089 deletions
@@ -223,18 +223,19 @@ W1·W2 잔여 21행(Wave 2.5)은 P14로 1라운드에서 함께 처리한다. W1
| P24 | 2 | fileserver·object storage 구조 | `D-7d` `D-7e` `D-8a` `D-8b` `D-8c` `S1-#6a` `S1-#6b` `S1-#12` `S1-#13` `S1-#17a` `S1-#17b` `S1-#18b` `S1-lead-4` `S4-#11a` `S4-#11b` `S4-#12` `S4-lead-2` `S5-#10` `S6-lead-5` |
| P25 | 2 | core 죽은 표면 · web · GraphQL · sample 구조(NEW-10d) | `A-2c` `A-4b` `A-5b` `A-5c` `A-10c` `I-5b` `I-6b` `I-8d` `J-7` `J-10d` `K-11b` `X1-#6f` `S1-#15b` `S5-#7a` `S6-#8` `S6-#10a` `S6-#10b` `S6-#10c` `S6-#10d` `S6-#11a` `S6-#13` `NEW-9b` `NEW-10d` `NEW-12` |
| P26 | 2 | HTTP client · JPA 구조 | `E-6b` `H-4b` `H-7a` `S2-#3b` `S3-#2b` `S3-#6` `S3-#7` `S3-#8b` `S3-#10` `S3-lead-5` `S6-#3c` `S6-#3d` |
| P19 | 3 | 3-D 공통 유틸·tenant·context·caller 트랜잭션 guard | `D-8d` `E-3b` `I-1c` `J-12` `X1-지도-caller 트랜잭션 guard` `X1-지도-Backoff 계산식` `X1-#1c` `X1-#4` `X1-#9` `X1-#10b` `X2-P1-4b` `X2-P1-5` `X2-P1-7` `X2-P2-4` `X2-P2-5` `X2-P2-6a` `S1-#11` `S1-lead-2` `S2-lead-3` `S5-lead-3` `P9-new-4` `P9-new-5` |
| P19 | 3 | 3-D 공통 유틸·tenant·context·caller 트랜잭션 guard | `D-8d` `E-3b` `I-1c` `J-12` `X1-지도-caller 트랜잭션 guard` `X1-지도-Backoff 계산식` `X1-#1c` `X1-#4` `X1-#9` `X1-#10b` `X2-P1-4b` `X2-P1-5` `X2-P1-7` `X2-P2-4` `X2-P2-5` `X2-P2-6a` `S1-#11` `S1-lead-2` `S2-lead-3` `S5-lead-3` `P9-new-4` `P9-new-5` `E-6b`(P26 잔여) `P16-new-5` `ORCH-new-3` |
| P21 | 3 | messaging 플랫폼: Kafka 소비(결정 10)·API 정리 | `M-9` `S7-#2` `S7-#6a` `S7-#6b` `S7-#9a` `S7-#9b` `S7-#9c` `S7-#10` `S7-#11` `S7-#12` `S7-#14` |
| P22 | 3 | Redis 구조 · startup rule | `G-4i` `G-6b` `G-7a` `G-7c` `G-7d` `G-7e` `G-8` `X1-지도-lock / lease / fencing` `S1-#15c` `S3-#3a` `S3-#3b` `S3-#4b` `S3-#5` `S3-#9` `S6-#2c` `S6-#3a` |
| P23 | 3 | notification: SES → sesv2(결정 17), `persistence-notification` 추출, SRP | `S1-#4` `S1-#9` `S1-#10b` `S2-#1b` `S2-#6c` `S2-#8a` `S2-#13b` `S4-#3c` `S4-#4b` `S4-#9` `S4-#14b` `S4-#15` `S4-lead-3` `S4-lead-5` |
| P27 | 3 | 빌드 잔여(결정 28·29·31): O3-5 나머지(`ca.release-provenance`·auxiliary → `jvm-test-suite`), messaging 카드 검증 leaf 테스트로, cosign 서명, `INTERNAL_ERROR` retryable=false, persistence-fileserver `ca.api-surface` | `BUILD-결론-1` `BUILD-O3-5` `X1-#7a` `X1-지도-readiness…` `BUILD-계획-C` `P15-new-3` `P16-new-6` |
| P28 | 3 | 로컬 보안 파일시스템 primitive 공용화(보안 민감 재작성, P24에서 분리) + fileserver 잔여 | `S4-lead-2` `P24-new-2` `P25-new-2` `P24-new-3` `S6-#10a` `S1-#6b` `S1-#18b`(결정 32) `S2-#8a` `S2-#13b` `P23-new-1` `P23-new-2` |
| P29 | 4 | 빌드 잔여 2: auxiliary 레인 → Gradle `jvm-test-suite`(P27 중단분, WIP 패치 보관), build-logic 줄 수 판정 | `BUILD-O3-5` `BUILD-결론-1` |
| P20 | 4 | 3-B 설정 prefix `app.*`(결정 16), strict 바인딩 | `X2-P1-3c` `S3-lead-2` `S3-lead-4` `S6-#14` `P11-new-1` |
- [x] 라운드 1: P14 · P15 · P16 · P17 → 통합·검증·커밋 (2026-09-28, `9fdb0af4`·`c4a066df`·라운드 1 마무리 커밋)
- [ ] 라운드 2: P18 · P24 · P25 · P26 → 통합·검증·커밋
- [x] 라운드 2: P18 · P24 · P25 · P26 → 통합·검증·커밋 (2026-09-28~29, `4fb7943b`·`64a83918`·`25de288a`·`423a29c4`)
- [ ] 라운드 3: P19 · P21 · P22 · P23 · P27 · P28 → 통합·검증·커밋 (P23은 P18과 겹치지 않아 라운드 2 자리에서 먼저 시작)
- [ ] 라운드 4: P20 → 통합 → Wave 종료 검증 → 현황표·「제거된 코드」 갱신 → 커밋 `review-followup Wave 3`
- [ ] 라운드 4: P20 · P29 → 통합 → Wave 종료 검증 → 현황표·「제거된 코드」 갱신 → 커밋 `review-followup Wave 3`
## Wave 4 — 테스트 규칙 (시작할 때 상세 Task 추가)