템플릿 재사용 체크리스트는 파생 서비스에게 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)
문제: High·P1을 고친 뒤에도 P2·P3 약 90건이 남았다. 연결·구독·메시지
크기 상한이 없는 전송(WebSocket·gRPC·GraphQL deadline), 낙관적 충돌의
500, upsert 경쟁, Mongo 무제한 timeout, 샘플 목록 N+1, 갈라진 복사본
(TenantId 3벌, 이벤트 ID 문법 5곳, SQLState 표 2벌), 문서를 읽는 PR
테스트와 캐시를 막는 lane 설정 등이다. 새 기능을 어디에 어떤 순서로
만드는지 알려 주는 문서와 도구가 없었다. MinIO 공식 이미지가 사라져
객체 저장소 lane이 돌지 않았다.
방법: 영역별 묶음으로 실패 테스트를 먼저 쓰고 고쳤다. 고치는 중에 찾은
결함도 함께 고쳤다(durable operation id가 UUIDv4라 이벤트가 전부 DEAD,
S3 어댑터 생성·작은 chunk 읽기 실패, Redis 조건부 기록의 EVALSHA 권한).
MinIO는 pgsty/minio를 digest로 고정했다(Chainguard는 태그·실행 사용자·
mc 이미지 문제로 버림). docs/manual/에 작업 순서와 판단 지점을 쓰고,
scripts/new-feature.sh가 5개 leaf에 뼈대를 만든다. 생성→빌드→통과
왕복을 verifyFeatureScaffold가 mainCheck에서 본다. 묶음별 결과와
결정은 리뷰 README 14절에 있다.
위험·한계: 파생 서비스 동작이 바뀐다. JDBC batch 50 기본, 운영 jar에서
H2 제거, 트랜잭션 30초 제한, 격리 수준을 Hikari에서 고정, gRPC·
WebSocket·GraphQL 새 한도, correlation ID 규칙 밖이면 서버가 교체,
샘플 키 오류 코드 IDEMPOTENCY_KEY_INVALID. 새 leaf 두 개
(composition:durable-operation, adapter:inbound:messaging)와 새
마이그레이션(postgresql V20·V21, notification V11·V12, sample V8_1,
grpc-ledger V002)이 생긴다. V21 유일 인덱스는 기존 중복이 있으면
실패한다(runbook에 확인 쿼리).
검증: ci, mainCheck(생성 명령 왕복 포함), integrationCheck(MinIO 포함
전 컨테이너 lane), -p optional-platforms ci integrationCheck 통과.
Refs: docs/reviews/2026-11-01-maturity-review/README.md 14절
BREAKING CHANGE: JDBC batch 기본 켜짐, H2 운영 의존 제거, 트랜잭션
기본 제한 30초, gRPC·WebSocket·GraphQL 서버 한도 기본값 추가,
샘플 Idempotency-Key 오류 코드 변경.
- 결정 32: fileserver transport 연산 21개를 `port.in` use case로, 쓰기·읽기에 `file:*` 권한(소유자·tenant 정책은 유지),
inbound 서비스 이름 `*UseCase`, port 구현 이름 `<Tech><Port>` 규칙(S2-#13b, 24개)
- 디렉터리 descriptor 파일 primitive를 `adapter:outbound:support`로(S4-lead-2 일부 — fileserver는 번역만),
persistence-fileserver를 scan·클래스별 조건 대신 명시적 `@Bean` 설정으로(S2-#8a 일부), `FileVerifier`를 adapter로
- 호출자 0인 `poster.image-attached` 이벤트 삭제, SES SDK client를 레지스트리 종료 때 close, fileserver migration V1–V5 고정
- P29: auxiliary 레인 → Gradle `jvm-test-suite`(BUILD-O3-5, build-logic 16,768 → 5,851줄), redis-sdk가 runtime을 api로(P22-new-3)
- 통합: JPA API surface 기준선 재승인(이름 규칙 변경), migration lane에 V19 반영, messaging 통합 테스트가 jar 안 migration 목록 조회(ORCH-new-5)
- P28·P29 에이전트가 세션 재시작으로 중단 — 커밋된 것만 합치고 결과 파일은 오케스트레이터가 확정, S6-#10a는 P30으로
검증: ./gradlew ci verifyDependencyLocks --warning-mode=fail(714 task) · mainCheck architectureCheck verifyPublicPathSnapshot
:app-bootstrap:verifyEnvKeys configContractCheck · :app-bootstrap:integrationTest :sample-portfolio:integrationTest
:sample-portfolio:systemTest integrationCheck · -p build-logic test · -p optional-platforms ci · releaseCheck qualificationBootJar 통과
Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>