From eed2d152a570f21f7c900d9f228764cde3e2a5e9 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sun, 8 Nov 2026 14:08:45 +0900 Subject: [PATCH] =?UTF-8?q?build:=20Maven=20group=EC=9D=84=20dev.cakit.grp?= =?UTF-8?q?c=EB=A1=9C=20=EB=B0=94=EA=BE=B8=EA=B3=A0=20=EB=82=A8=EC=9D=80?= =?UTF-8?q?=20hyeonworks=20=EC=9D=B4=EB=A6=84=EC=9D=84=20=EC=A7=80?= =?UTF-8?q?=EC=9A=B4=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 앞 커밋에서 패키지를 dev.cakit.grpc로 바꿨다. 배포 좌표(group)와 문서는 아직 com.hyeonworks.grpc였다. - gradle.properties libraryGroup = dev.cakit.grpc(모든 모듈과 SBOM artifact의 group) - README 받는 법(exclusiveContent 필터 dev.cakit), AGENTS.md, CHANGELOG 옮기는 법, problem-statement, release.md, family AGENTS.md 둘 - SpotBugs 제외에서 템플릿 클래스(@RequiresPermission)를 가리키던 줄을 지웠다. 이 repo에는 그런 bean이 없다 남긴 것: Gitea 주소 git.learn.hyeonworks.com(서버 주소), 기록 ADR-GRPC-002 본문의 「예전에는 hyeonworks」(기록 본문은 고치지 않는다). 검증: git grep -i hyeonworks에서 위 둘만 남는다. 빌드 게이트는 desktop (이 PR 본문). --- AGENTS.md | 2 +- CHANGELOG.md | 6 +++--- README.md | 8 ++++---- config/spotbugs/exclude.xml | 11 +++-------- docs/problem-statement.md | 2 +- docs/work/release.md | 2 +- gradle.properties | 2 +- grpc-advanced/AGENTS.md | 2 +- grpc/AGENTS.md | 10 +++++----- 9 files changed, 20 insertions(+), 25 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 82e482d..a9ea636 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,6 +1,6 @@ # AGENTS.md — grpc-library의 정본 -Spring Boot 앱에 gRPC 서버·클라이언트를 붙이는 플랫폼 라이브러리다(Maven group `com.hyeonworks.grpc`). 백엔드 템플릿에서 2026-11-08에 이력째 옮겨 왔다. 왜 따로 두는지와 받는 법은 `README.md`, 풀 문제는 `docs/problem-statement.md`다. +Spring Boot 앱에 gRPC 서버·클라이언트를 붙이는 플랫폼 라이브러리다(Maven group `dev.cakit.grpc`). 백엔드 템플릿에서 2026-11-08에 이력째 옮겨 왔다. 왜 따로 두는지와 받는 법은 `README.md`, 풀 문제는 `docs/problem-statement.md`다. ## 꼭 지킬 것 — 하나라도 어기면 동작해도 완료가 아니다 diff --git a/CHANGELOG.md b/CHANGELOG.md index b71909c..66f25da 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -10,7 +10,7 @@ 템플릿 안 코드를 직접 썼다면(템플릿 기준 커밋 `22df3525` 이전): -- Java 패키지: `dev.caskeleton.grpc.*` → `com.hyeonworks.grpc.*`. import를 바꾼다. -- proto 패키지: `caskeleton.grpc.common.v1` → `hyeonworks.grpc.common.v1`, 생성 Java 패키지 `caskeleton.grpc.common.v1.generated` → `hyeonworks.grpc.common.v1.generated`. proto는 wire 이름이므로 상대편도 함께 바꾼다. -- Gradle: `project(':grpc:<모듈>')` → `com.hyeonworks.grpc:<모듈>:1.0.0`(저장소 선언은 README 「받는 법」). +- Java 패키지: `dev.caskeleton.grpc.*` → `dev.cakit.grpc.*`. import를 바꾼다. 템플릿 재사용 체크리스트의 `dev.caskeleton` 일괄 바꾸기와 겹치지 않게 다른 이름을 쓴다. +- proto 패키지: `caskeleton.grpc.common.v1` → `cakit.grpc.common.v1`, 생성 Java 패키지 `caskeleton.grpc.common.v1.generated` → `cakit.grpc.common.v1.generated`. proto는 wire 이름이므로 상대편도 함께 바꾼다. +- Gradle: `project(':grpc:<모듈>')` → `dev.cakit.grpc:<모듈>:1.0.0`(저장소 선언은 README 「받는 법」). - 설정 키 `app.grpc.platform.*`와 Flyway 위치 `db/migration/grpc`는 그대로다. diff --git a/README.md b/README.md index 52b54ac..f821f1d 100644 --- a/README.md +++ b/README.md @@ -12,7 +12,7 @@ Spring Boot 앱에 gRPC 서버·클라이언트를 붙이는 플랫폼 라이브 ## 받는 법 -Maven group은 `com.hyeonworks.grpc`, artifact는 모듈 이름 그대로다(`grpc-core-api`, `grpc-runtime`, `grpc-spring-boot-starter`, …). 저장소는 소유자 Gitea Packages이고, 공개라 읽을 때 토큰이 필요 없다. +Maven group은 `dev.cakit.grpc`, artifact는 모듈 이름 그대로다(`grpc-core-api`, `grpc-runtime`, `grpc-spring-boot-starter`, …). 저장소는 소유자 Gitea Packages이고, 공개라 읽을 때 토큰이 필요 없다. ```groovy // settings.gradle @@ -22,7 +22,7 @@ dependencyResolutionManagement { forRepository { maven { url = 'https://git.learn.hyeonworks.com/api/packages/donghyeon.kang/maven' } } - filter { includeGroupByRegex 'com\\.hyeonworks(\\..*)?' } + filter { includeGroupByRegex 'dev\\.cakit(\\..*)?' } } mavenCentral() } @@ -32,11 +32,11 @@ dependencyResolutionManagement { ```groovy // build.gradle dependencies { - implementation 'com.hyeonworks.grpc:grpc-spring-boot-starter:1.0.0' + implementation 'dev.cakit.grpc:grpc-spring-boot-starter:1.0.0' } ``` -`exclusiveContent`는 `com.hyeonworks` group을 이 저장소에서만, 나머지는 Maven Central에서만 찾게 한다. 같은 이름을 공개 저장소에 올리는 공격이 통하지 않고, Gitea가 느려도 다른 의존성 해석에는 영향이 없다. +`exclusiveContent`는 `dev.cakit` group을 이 저장소에서만, 나머지는 Maven Central에서만 찾게 한다. 같은 이름을 공개 저장소에 올리는 공격이 통하지 않고, Gitea가 느려도 다른 의존성 해석에는 영향이 없다. ## 지원 표 diff --git a/config/spotbugs/exclude.xml b/config/spotbugs/exclude.xml index 76cc482..999589d 100644 --- a/config/spotbugs/exclude.xml +++ b/config/spotbugs/exclude.xml @@ -78,17 +78,12 @@ - + - diff --git a/docs/problem-statement.md b/docs/problem-statement.md index e33cf6c..919881f 100644 --- a/docs/problem-statement.md +++ b/docs/problem-statement.md @@ -39,4 +39,4 @@ ## 되돌릴 수 없는 결정 - 배포한 버전은 지우지 않는다(`docs/work/release.md` 2절). 같은 버전은 다시 올릴 수 없다. -- Maven group `com.hyeonworks.grpc`와 proto 패키지 `hyeonworks.grpc.*`. 바꾸면 모든 소비자의 MAJOR다. 근거는 design-docs `repo-structure/05-library-repos.md` 6.3절. +- Maven group `dev.cakit.grpc`와 proto 패키지 `cakit.grpc.*`. 바꾸면 모든 소비자의 MAJOR다. 근거는 design-docs `repo-structure/05-library-repos.md` 6.3절. diff --git a/docs/work/release.md b/docs/work/release.md index fc5a9b3..1f25dd0 100644 --- a/docs/work/release.md +++ b/docs/work/release.md @@ -50,7 +50,7 @@ main 병합 ──> 소유자가 태그 vX.Y.Z push ──> .gitea/workflows/rel git push origin v1.0.0 ``` -5. release.yml 실행이 초록인지 Gitea Actions 화면에서 본다. 마지막 줄들에 모듈마다 `published: com.hyeonworks.grpc:<모듈>:<버전>`이 찍힌다. +5. release.yml 실행이 초록인지 Gitea Actions 화면에서 본다. 마지막 줄들에 모듈마다 `published: dev.cakit.grpc:<모듈>:<버전>`이 찍힌다. 6. 템플릿이 이 라이브러리를 쓰게 되면(지금은 쓰지 않는다) 템플릿 PR로 카탈로그 버전을 올린다. 절차는 템플릿 `docs/work/reference/related-repos.md`다. ## 4. 올리기 직전까지 미리 돌리기 diff --git a/gradle.properties b/gradle.properties index 7a0f866..c391713 100644 --- a/gradle.properties +++ b/gradle.properties @@ -1,6 +1,6 @@ # The Maven group every module publishes under, and where. ca.java-conventions refuses a build # without libraryGroup; ca.library-publishing reads the other two. -libraryGroup=com.hyeonworks.grpc +libraryGroup=dev.cakit.grpc packagesUrl=https://git.learn.hyeonworks.com/api/packages/donghyeon.kang/maven repositoryUrl=https://git.learn.hyeonworks.com/donghyeon.kang/grpc-library diff --git a/grpc-advanced/AGENTS.md b/grpc-advanced/AGENTS.md index cd7cdf1..d929a55 100644 --- a/grpc-advanced/AGENTS.md +++ b/grpc-advanced/AGENTS.md @@ -43,7 +43,7 @@ property key는 `app.grpc.advanced..enabled`이고 전부 기본 off ## Leaf별 담당 capability -| leaf | 패키지(`com.hyeonworks.grpc.advanced.*`) | capability | +| leaf | 패키지(`dev.cakit.grpc.advanced.*`) | capability | | --- | --- | --- | | `grpc-advanced` | `bootstrap` | capability grade, feature flag, module guard, capability별 promotion gate | | `grpc-advanced` | `edition` | Protobuf Edition 2024 opt-in lane, Edition 2026 watch lane | diff --git a/grpc/AGENTS.md b/grpc/AGENTS.md index 807feda..f699795 100644 --- a/grpc/AGENTS.md +++ b/grpc/AGENTS.md @@ -1,7 +1,7 @@ # grpc — gRPC 플랫폼 family의 지역 정본 이 문서는 `grpc:*` family의 **지역 정본(local authority)**이다. gRPC platform은 이 repo(`grpc-library`)가 소유하고 -Maven group `com.hyeonworks.grpc`로 배포한다. 여기서 정하는 것은 family별 framework 규칙, 증거 등급, +Maven group `dev.cakit.grpc`로 배포한다. 여기서 정하는 것은 family별 framework 규칙, 증거 등급, Stable 범위의 경계와 application에 채택될 때 필요한 계약이다. 루트 `AGENTS.md`와 충돌하면 루트가 이긴다. @@ -37,9 +37,9 @@ server profile·named channel profile·method size profile·method policy 기본 그 상수를 쓴다. `GrpcPlatformStartupValidator`는 method의 inbound 한도가 server profile 한도보다 크면 기동을 거부한다. -`.proto`의 proto 조직 이름은 `hyeonworks`다(`package hyeonworks.grpc.common.v1`, 생성 Java 패키지 -`hyeonworks.grpc.common.v1.generated` — 손으로 쓴 `com.hyeonworks`와 겹치지 않는다). proto 패키지는 wire -이름이라 바꾸면 MAJOR다(`docs/work/release.md` 2절). 2026-11-08 전의 이름은 `caskeleton`이었다. +`.proto`의 proto 조직 이름은 `cakit`이다(`package cakit.grpc.common.v1`, 생성 Java 패키지 +`cakit.grpc.common.v1.generated` — 손으로 쓴 `dev.cakit`과 겹치지 않는다). proto 패키지는 wire +이름이라 바꾸면 MAJOR다(`docs/work/release.md` 2절). 2026-11-08 전의 이름은 `caskeleton`이었다(템플릿 자리표시 이름과 겹치지 않게 바꿨다). ### 공용 다이제스트 헬퍼를 복사해 두는 이유 @@ -84,7 +84,7 @@ capability flag 뒤에 있다. `GrpcPlatformStartupValidator`가 Stable catalog ## 라이브러리로 배포된다는 것의 의미 -앱은 이 repo를 빌드에 넣지 않고 Gitea Packages에 배포한 버전(`com.hyeonworks.grpc:<모듈>:<버전>`)을 받는다. 플랫폼 +앱은 이 repo를 빌드에 넣지 않고 Gitea Packages에 배포한 버전(`dev.cakit.grpc:<모듈>:<버전>`)을 받는다. 플랫폼 자체는 이 repo의 `./gradlew ci`로 검증하고, 앱 runtime에 실제 채택하려면 그 앱의 조립 루트가 명시적으로 dependency를 가져오는 별도 변경이 필요하다. 백엔드 템플릿은 지금 이 라이브러리를 받지 않는다.