From 1919797957e6807a1f9dc7dd743bb41823d805a5 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sat, 7 Nov 2026 17:07:16 +0900 Subject: [PATCH 1/2] =?UTF-8?q?docs(core):=20core=C2=B7=EC=A1=B0=EB=A6=BD?= =?UTF-8?q?=C2=B7=EB=B9=8C=EB=93=9C=C2=B7=ED=94=8C=EB=9E=AB=ED=8F=BC=20?= =?UTF-8?q?=EB=AA=A8=EB=93=88=20=EB=AC=B8=EC=84=9C=EB=A5=BC=20=ED=95=9C?= =?UTF-8?q?=EA=B5=AD=EC=96=B4=EB=A1=9C=20=EC=98=AE=EA=B8=B4=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: core 계층(application·domain·shared-contract), app-bootstrap, composition, registry, build-logic, optional 빌드의 모듈 문서가 영어다. 세션이 처음 읽는 지역 규칙인데 소유자는 2026-11-07에 살아 있는 문서를 모두 한국어로 쓰기로 정했다. leaf CLAUDE.md 셋은 Spring Boot 버전을 4.0.0으로 복사해 두었는데 실제 버전(libs.versions.toml)과 다르다. 방법: 뜻을 그대로 옮기고 코드·명령·경로·식별자·표 구조는 원문으로 둔다. 버전은 `src/gradle/libs.versions.toml`을 가리키는 말로 바꾼다. 다른 문서·코드가 제목으로 가리키는 절(application-core의 Naming convention·Package ownership·Canonical use case shape·Allowed transactional shapes, shared-contract의 Responsibility·Forbidden, messaging의 발행 재시도 절)은 영어 원제를 괄호로 남겨 그 참조가 계속 찾아지게 한다. 참조하는 쪽을 고치는 것은 이 작업 범위 밖이다. 코드와 어긋난 주장은 코드에 맞춘다: TransactionPort 구현을 `adapter-persistence`에서 `adapter:outbound:persistence-jpa`의 `SpringTransaction`으로, registry README의 빈 의존 목록 예를 persistence-mongo(실제 목록은 application-core·shared-contract)에서 domain-core·shared-contract·messaging-core-api로 고친다. TemplatePackageOwnershipDocumentTest는 표 머리 문자열로 표를 찾으므로 머리 상수를 한국어 머리(`| 패키지 (...) |`)로 맞춘다. 표와 기계 사본을 대조하는 계약은 그대로다. 위험: 영어 원제를 괄호로 남긴 제목은 참조하는 문서가 한국어 제목으로 바뀌면 괄호를 지울 수 있다. 본문의 짧은 이력 번호(07-08, 06-01, 11-M9)는 뜻을 바꾸지 않으려고 그대로 옮겼다. 검증: python3 scripts/check-docs.py rc=0(번역한 파일의 language 줄 8개, number 줄 3개 지움), check-work-docs.py rc=0, --links(gates.md 범위) 깨진 링크 0, unittest discover scripts/tests 43개 통과. --- messaging/CLAUDE.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/messaging/CLAUDE.md b/messaging/CLAUDE.md index eda4b57..705cc3f 100644 --- a/messaging/CLAUDE.md +++ b/messaging/CLAUDE.md @@ -1,6 +1,6 @@ -# messaging — local authority for the messaging platform family +# messaging — 메시징 플랫폼 family의 지역 정본 -이 문서는 messaging family의 **local authority**다. leaf 목록·gradle path·허용 의존성은 +이 문서는 messaging family의 **지역 정본(local authority)**이다. leaf 목록·gradle path·허용 의존성은 `src/config/architecture/modules.json`이 SSOT이며 이 문서는 그것을 복제하지 않는다. 여기서 정하는 것은 registry가 표현할 수 없는 것들이다: family별 framework 규칙, public surface 정책, Stable 승격에 필요한 증거, runtime membership이 비어 있다는 사실의 의미. @@ -40,7 +40,7 @@ JDBC이고 SQL은 `jsonb` · `FOR UPDATE SKIP LOCKED` · `ON CONFLICT` · `TIMES registry edge를 주면 그 경계가 깨진다. 복사본을 고칠 때(키 길이 검사, constant-time 비교 등)는 `shared-contract`의 정본과 같은 규칙인지 함께 본다. -### Publish retryability of authentication and authorization +### 인증·인가 거부의 발행 재시도 여부 (Publish retryability of authentication and authorization) 이 제품 안에는 같은 category에 대한 재시도 규칙이 둘 있다. 의도다. From 38a399f06dbb5c6d378d29f26a23ef416eb54c4c Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sat, 7 Nov 2026 18:27:30 +0900 Subject: [PATCH 2/2] =?UTF-8?q?docs(claude):=20=EC=A7=84=EC=9E=85=20?= =?UTF-8?q?=EB=AC=B8=EC=84=9C=EC=97=90=20=EB=8B=A8=EB=8F=85=20=EB=B2=88?= =?UTF-8?q?=ED=98=B8=EB=A1=9C=20=EB=82=A8=EC=9D=80=20=EC=9D=B4=EB=A0=A5=20?= =?UTF-8?q?ID=EB=A5=BC=20=EB=82=B4=EC=9A=A9=EA=B3=BC=20=EB=82=A0=EC=A7=9C?= =?UTF-8?q?=EB=A1=9C=20=EB=B0=94=EA=BE=BC=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit AGENTS.md와 src/**/CLAUDE.md는 본문에 지난 리뷰 ID를 두지 않는다 (docs/work/README.md 8절). 번역한 CLAUDE.md 넷에 짝 하나짜리 번호가 남았다: persistence-jpa·app-bootstrap의 「07-08」, grpc의 「11-M9」, messaging의 「06-01 수정」. check-work-docs.py는 단독 NN-NN을 일부러 잡지 않으므로(범위·절 번호와 구별할 수 없다) 통과했다(번역 묶음 D2b가 넘긴 것). ID 대신 그 발견의 내용과 날짜를 적었다. 원래 ID와 근거 리뷰 파일은 docs/work/evidence.md 10절 끝에 행 넷으로 남겼다(앞 행들과 같은 칸). 검증(노트북): check-work-docs.py OK, --history(바꾼 파일) 이력 ID 0, check-docs.py OK. 이 넷을 읽는 테스트는 없다(git grep 'CLAUDE.md' -- '*Test.java'). --- messaging/CLAUDE.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/messaging/CLAUDE.md b/messaging/CLAUDE.md index 705cc3f..807a589 100644 --- a/messaging/CLAUDE.md +++ b/messaging/CLAUDE.md @@ -52,7 +52,8 @@ registry edge를 주면 그 경계가 깨진다. 복사본을 고칠 때(키 길 publish를 거부한 뒤 멈추기 때문이다. `retryable`을 믿는 publisher가 그 몇 분 동안의 레코드를 영구 보류하지 않게 하려는 것이다. -06-01 수정이 이 제품에서 바꾼 것(모두 publish 경로, 소비 경로 동작은 그대로): +다시 시도하면 될 거부를 relay가 즉시 DEAD로 보내던 결함의 수정(2026-11-01 성숙도 리뷰 뒤)이 이 제품에서 바꾼 것(모두 +publish 경로, 소비 경로 동작은 그대로): - `KafkaPublishFailureClassifier`: 인증·인가 거부를 `retryable = true`로. - `DefaultMessagePublisher`: runtime이 없을 때의 거부(`PUBLISH_RUNTIME_UNAVAILABLE`)를 `retryable = true`로.