템플릿 재사용 체크리스트는 파생 서비스에게 dev.caskeleton 패키지를
자기 이름으로 바꾸라고 한다. 라이브러리 패키지가 dev.caskeleton.messaging
그대로면, 체크리스트를 따르는 서비스가 import까지 바꿔 라이브러리
클래스를 찾지 못한다. Maven group(dev.cakit.messaging)과 패키지가 다른
말을 하는 것도 첫 배포 뒤에는 고칠 수 없다.
첫 배포(1.0.0) 전에 한 번 바꾼다(설계 NS3, 이름은 소유자 2026-11-08
결정 dev.cakit). 기계적으로 만들었다: 소스 폴더 dev/caskeleton/messaging
44곳을 git mv로 dev/cakit/messaging으로, 파일 411개의
dev.caskeleton.messaging·dev/caskeleton/messaging 문자열을
dev.cakit.messaging·dev/cakit/messaging으로 바꿨다. Kafka 클라이언트
설정 키 caskeleton.messaging.credential.{registry,id}(이 라이브러리
안에서만 쓰는 상수)도 cakit.messaging.credential.*로 바꿨다.
SpotBugs 제외 목록에서 템플릿 타입(@RequiresPermission) 줄을 뺐다.
위험: 지금 쓰는 소비자는 템플릿 하나이고, 템플릿은 1.0.0을 받는
변경에서 import를 함께 바꾼다. 배포한 버전이 없으니 깨질 다른 소비자는
없다.
검증: 남은 caskeleton 문자열은 build-logic 패키지(배포하지 않는 빌드
도구)뿐이다(git grep -i caskeleton).
BREAKING CHANGE: dev.caskeleton.messaging.* 타입이 dev.cakit.messaging.*로
옮겨졌다. import 접두사를 바꾸면 된다. Kafka 설정 키
caskeleton.messaging.credential.*은 cakit.messaging.credential.*이다.
Refs: design-docs repo-structure/05-library-repos.md 6.3절, 15절 변경(2026-11-08)
2.2 KiB
2.2 KiB
기존 runtime → 신규 messaging platform cutover (MSG-015)
왜 기계적 매핑이 안 되는가
두 outbox 모델의 enum 이름이 겹치는데 의미가 반대다.
| 모델 | retryable | terminal |
|---|---|---|
기존 OutboxEventStatus |
FAILED (next_attempt_at 보유) |
DEAD |
신규 OutboxStatus |
AMBIGUOUS |
FAILED, EXHAUSTED |
이름으로 매핑하면 확정 거절이 무한 재시도가 되고 불확정이 park된다. 그래서 application은
자기 어휘(OutboxPublishOutcome)만 쓰고, 변환은 bridge adapter가 한다.
지금 반영된 것
OutboxPublishOutcome—CONFIRMED/AMBIGUOUS/REJECTED_BEFORE_SEND/REJECTED_AFTER_BROKER. application이 소유하는 canonical 결과 타입이며, "리턴 or throw"만 가능한 기존 어댑터를 위해OutboxMessagePublishPort.publishForOutcome의 default가CONFIRMED를 돌려준다.APPLICATION_DOES_NOT_DEPEND_ON_THE_MESSAGING_PLATFORMArchUnit 규칙 — application-core가dev.cakit.messaging..를 import하면 빌드가 깨진다.- 반대 방향(신규
PublishResult→ application outcome) 매핑 규칙을 테스트로 고정.
남은 것
messaging-platform-bridgeoutbound leaf: validated application event → platform envelope,PublishResult→OutboxPublishOutcome. registry에 leaf를 추가하는 변경이라 별도 커밋.- golden contract 테스트: event/message ID, type, schema revision, partition/order/correlation/ causation/tenant/trace, payload digest, wire version이 bytes 단위로 보존되는지.
- 단일 publication authority: writer/relay가 동시에 ACTIVE가 되지 않도록 하는 fence. 이 용도로 쓰려던
outbox V2의
OutboxPublicationAuthority는 한 번도 조립되지 않은 채 2026-09-25에 삭제됐으므로 (docs/capability-status.md"제거된 코드") cutover가 자기 fence를 새로 가져야 한다. dual write/publish는 금지 — 한 business fact가 두 durable store와 두 relay로 나가는 상태가 cutover에서 가장 위험하다. - 첫 cutover 범위는 transport만 교체(저장소는 기존 유지). storage migration은 shadow read → authority switch → old backlog drain 순서로 별도 release.