Files
clean-architecture-backend-…/docs/roadmap/messaging-r2.md
T
DongHyeonka bae2965f06 docs: 단계표·capability 상태·설정 설명을 지금 빌드와 workflow에 맞춘다
문제: 살아 있는 문서가 지운 workflow·태스크·job과 옛 동작을 가리켰다.
- 단계 구성이 네 곳에 따로 적혔고 둘이 틀렸다. TESTING_STRATEGY의 repository
  목록은 releaseCheck를 「ci + ...」라 했고, docs/build.md의 mainCheck·
  qualificationCheck 행은 testQualityCheck·verifyFeatureScaffold·graphqlStableTest를
  빠뜨렸다.
- capability-status가 지운 redis-sdk-topology.yml·notification-platform.yml·
  verifyNotificationEvidence, app-bootstrap의 OutboxConfig(지금
  :composition:outbox-relay), 없는 lane 이름을 증거로 들었다. 제거된 코드 표의
  재배치 전 경로는 설명 없이 지금 트리에 없었다.
- docs/build.md·bootstrap-local.sh가 기본 조립이 Flyway를 돈다고 했다(기본은
  web뿐). 알림 키 개수를 복사해 틀렸다.
- roadmap messaging-r2가 지운 VerifyMessagingEvidenceTask·
  MessagingQualificationPlugin을 예시로 들었다.
- cache-redis README·build.gradle, httpclient build.gradle이 #13이 합친
  integration job을 가리켰다.
- renovate.json·취약점 정책이 「두 봇」과 GitHub vulnerability alert를 전제했다.
  이 Gitea repo에 Renovate 실행기는 없다.
- graphql AGENTS·README가 「모듈별 yml 금지·없음」이라 했지만 leaf는
  config/graphql.yml을 직접 읽는다. 지운 execution profile을 적었다.

고친 것: 단계 구성은 gates.md 1절과 루트 build.gradle을 정본으로 가리키고, 남긴
표 행은 지금 태스크대로 고쳤다. capability-status 행 넷을 지금 job·태스크·모듈로
고치고, 제거된 코드 표의 경로가 지운 때의 배치라는 머리말과 지운
ComposeMergeCharacterizationTest 행을 더했다. 기본 조립·Flyway 설명, 알림 키(개수
대신 registry), roadmap(`> 이력`), 세 integration 설명(`main` job이
:integrationCheck :mainCheck를 함께 돈다), renovate·정책(실행기 없음, enforced는
trivy), graphql 설정 파일 설명을 고쳤다.

검증: check-docs.py·check-work-docs.py rc=0, 이 문서들을 읽는 시험은
CapabilityStatusDocumentTest(app-bootstrap document-contract)다.

Refs: RR9-04-09, RR9-04-10, RR9-04-20, RR9-04-21, RR9-04-22, RR9-04-25, RR9-04-28, RR9-03-30
2026-11-13 05:03:52 +09:00

2.5 KiB

Messaging R2 자격(qualification) — 미구현

추적: MSG-015

상태

구현되지 않았다. R2 자격을 주장할 수 있는 근거가 없다.

  • qualification producer 없음
  • 대응하는 Test 태스크 없음
  • 공통 스키마 validator 없음

따라서 src/adapter/outbound/messaging/release/readiness-cards.yaml의 카드는 모두 maturity: not-implemented다. 유일하게 implemented-candidate였던 json-schema-envelope.v1은 그 구현(adapter messaging의 JsonSchemaIntegrationEventEncoder와 verifyMessagingJsonSchemaV1)을 2026-09-25에 삭제하면서 not-implemented로 내렸다. 남은 evidence producer는 verifyMessagingContracts 하나다.

왜 Gradle 태스크를 미리 만들어 두지 않는가

2026-09 이전에는 루트 빌드가 아래 아홉 개 태스크 이름을 미리 등록해 두고, 그 본문이 입력과 무관하게 무조건 예외를 던졌다.

verifyMessagingPollingOutboxR2        verifyMessagingTargetBinding
verifyMessagingKafkaProducerR2        verifyMessagingDeploymentCutover
verifyMessagingSecurityR2             verifyMessagingCleanupTargetBinding
verifyMessagingReleaseProfile         verifyMessagingFinalR2Profile
verifyMessagingTargetBindingPreflight

의도는 "fail-closed"였지만 결과는 다음과 같았다.

  • ./gradlew tasks에 게이트처럼 보이는 이름 아홉 개가 나타난다.
  • dependsOn으로 걸 수 있다. 거는 순간 그 레인은 영원히 빨간불이다.
  • 정상적인 입력으로도 성공할 수 없으므로 "검증"이 아니다.

즉 TODO를 Gradle 태스크 API로 표현한 것이었다. 미구현 사실을 기록하는 자리는 이 문서이고, 태스크는 실제로 통과할 수 있게 된 시점에 그 producer와 함께 추가한다.

구현 시 추가할 것

  1. 각 시나리오를 실제로 실행하는 Test 태스크.
  2. 그 실행 결과(JUnit XML)에서 payload-free manifest를 만드는 producer.
  3. src/adapter/outbound/messaging/release/evidence/build-evidence-manifest-v1.schema.json으로 그 manifest 바이트를 검증하는 단계. manifest를 쓰는 태스크가 쓰자마자 검증한다.
  4. 위 셋이 모두 생긴 다음에 verifyMessaging<Scenario>R2 태스크 등록.

이력: 네 단계를 모두 갖춘 예시였던 build-tools MessagingQualificationPlugin(verifyMessagingContracts)과 VerifyMessagingEvidenceTask는 메시징 플랫폼을 messaging-library repo로 옮기며(2026-11-08) 이 repo에서 지웠다.