문제: 성숙도 리뷰 수정을 다시 읽은 재리뷰(Critical 0, 회귀 0)가 Important 27건·Minor 41건을 찾았다. 수정이 새로 만든 결함이 많았다. @SystemInvoked가 권한 규칙의 탈출구가 됐고, 데모 계정 거부가 정확히 prod일 때만 걸렸고, outbox 순서 번호가 업그레이드 때 뒤로 갔고, GraphQL union 아래 복잡도가 0이었고, 서블릿 오류 응답이 success:true로 나갔고, 호출자 deadline이 breaker를 열었다. 원래 리뷰 색인이 06 영역 발견 5건(06-10~14)을 빠뜨려 그동안 처리되지 않았다. 방법: 영역별 7묶음이 test-driven-development 절차로 실패 테스트를 먼저 쓰고 고쳤다. 결정은 재리뷰 README 4절에 적었다: 순서 번호는 V21이 기록한 전역 floor부터, 데모 계정은 local·test·demo 허용 목록, @SystemInvoked bean은 기동 실패, complete 단계 실패는 IDEMPOTENCY_COMPLETION_UNKNOWN(결과 불명), 캐시 조건부 쓰기는 별도 SCRIPT lane, strict lane 정책은 build cache 입력, 끝나지 않는 재시도 행은 원인 코드·지표·PARKED 절차. 레지스트리가 선언만 하고 아무 코드도 내보내지 않던 redis.capability.* 지표 6개는 빼고 runbook을 실제 지표(redis.lane.*) 기준으로 고쳤다. 위험·한계: V21을 V22 없이 직접 고쳤다(어느 배포에도 아직 없음). 이 브랜치의 V21을 적용한 개발 DB는 다시 만들어야 한다. 서블릿 오류 디스패치를 보안 체인이 허용한다. 발행·저장소 포트 시그니처가 바뀌어 파생 서비스 코드가 깨진다. prod에서 fixture-로 시작하는 설정값은 기동을 막는다. httpclient failure-injection lane의 main 단계 중복 실행은 이전 결정대로 남겼다. 실제 CI runner 실행은 확인하지 못했다. 검증: ci, mainCheck, :integrationCheck, -p optional-platforms ci integrationCheck performanceCheck, :performanceCheck, :releaseCheck (-PgitRevision), verify-compose-profile-contracts(18 lane) 통과. 첫 실행의 실패 2건(FindSecBugs 1, sample 동시 생성 테스트의 v4 event id)은 고친 뒤 ci·integrationCheck·mainCheck를 다시 돌려 통과했다. Refs: docs/reviews/2026-11-03-rereview/README.md 3·4·6·7절 BREAKING CHANGE: outbox 발행 포트와 저장소 포트 시그니처, 순서 번호 첫 값(V21 floor 다음), 샘플 데모 계정 프로필 허용 목록, 새 오류 코드 IDEMPOTENCY_COMPLETION_UNKNOWN, prod의 fixture- 값 거부, 기동 rule은 static·의존 없음이어야 한다.
3.6 KiB
adapter:outbound:identifier — 사용자 principal 가명화, durable operation id
이 leaf의 main 코드는 HmacUserPrincipalPseudonymizer와 UuidV7DurableOperationIdFactory 두 클래스다. 패키지 루트:
dev.caskeleton.adapter.outbound.identifier.
허용·금지 의존과 테스트 명령 같은 모듈 규칙은 CLAUDE.md가 기준이다. 이 문서는 설계 결정의 근거를 모은다.
이름과 내용이 다른 이유 (review 05-21)
leaf 이름은 identifier지만 범용 식별자 생성기·clock·random 소스는 여기 없다. 식별자 생성은
durable operation id(UUIDv7) 하나뿐이고(아래), 기능이 서버에서 id를 정하면 그 기능의 domain
*IdFactory 구현도 여기 둔다(:domain-core 의존이 그 때문이다). 예전 문서가 범용 생성기 계획을 현재 내용처럼 적었다. 이름은 바꾸지 않았다: Gradle 경로·registry id·소비자
(composition:service-runtime, app-bootstrap, sample-portfolio)의 의존 선언이 모두 이 이름을
쓰고, 바꿔서 얻는 것은 이름 하나뿐이다. 외부 연동이 없는 crypto 능력을 새로 둘 곳이 필요하면 이
leaf에 둔다. 그때 이 절을 고친다.
HmacUserPrincipalPseudonymizer
UserPrincipalPseudonymizerPort(application-core)의 HMAC-SHA-256 구현이다. 로그의
user_principal 값을 원래 값 대신 이 토큰으로 남긴다.
- 출력: 비어 있지 않은
rawPrincipal을 UTF-8 바이트로 서명한 256-bit HMAC을 64자 소문자 hex로 돌려준다.null이나 blank면null. - 정답 값: 테스트가 RFC 4231 test case 2와 non-ASCII(UTF-8) 벡터를 고정한다. 알고리즘·charset·hex 대소문자를 바꾸면 테스트가 실패한다.
- Salt:
APP_PRIVACY_PSEUDONYMIZATION_SALT(secret, 90일 회전)에서 온다. 이 클래스는 salt를 스스로 읽지 않고 생성자로 받는다. 받은 배열은 복사해 둔다. - 서명: 이 클래스는
Mac을 직접 다루지 않는다. shared-contract의HmacSha256.sign에 맡긴다(리뷰 2026-11-01 01-11).HmacSha256이 호출마다 새Mac을 만들고(Mac은 thread-safe하지 않다), JDK 필수 알고리즘이라 사실상 나지 않는 checked exception을IllegalStateException으로 감싼다. 그래서 이 클래스는 싱글톤 bean으로 공유해도 된다.
UuidV7DurableOperationIdFactory
DurableOperationIdFactory(application-core) 구현. UuidCreator.getTimeOrderedEpochPlus1()로 UUIDv7을
만든다(샘플 id adapter와 같은 방식). operation id는 제출 이벤트의 event id가 되고, messaging platform
MessageId는 UUIDv7만 받는다. 예전에는 web controller가 UUID.randomUUID()(v4)로 만들어 모든 제출
이벤트가 발행 시점에 거부되어 DEAD가 됐다(리뷰 2026-11-01 06-06, Kafka relay lane이 발견).
composition:durable-operation이 bean으로 조립한다.
조립
Spring 어노테이션이 없다. bean은
composition/service-runtime/.../logging/PseudonymizationConfig.java가 만든다
(@ConditionalOnMissingBean이라 파생 서비스가 자기 구현으로 바꿀 수 있다).
빌드 결정
의존은 넷이다: :application-core(두 클래스가 구현하는 port), :shared-contract(HmacSha256),
:domain-core(기능의 *IdFactory 구현 자리), uuid-creator(UUIDv7). 목록과 이유는
CLAUDE.md Allowed 절이 기준이다.
:application-core를 implementation으로 받는다. 이 leaf의 public 타입 시그니처에
application-core 타입이 드러나지만, 조립하는 쪽이 application-core를 이미 classpath에 갖고 있다.
허용 edge는 src/config/architecture/modules.json이 기준이다.