build: Maven group을 dev.cakit.grpc로 바꾸고 남은 hyeonworks 이름을 지운다
pr / ci (pull_request) Successful in 4m0s
pr / ci (pull_request) Successful in 4m0s
앞 커밋에서 패키지를 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 본문).
This commit is contained in:
@@ -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`다.
|
||||
|
||||
## 꼭 지킬 것 — 하나라도 어기면 동작해도 완료가 아니다
|
||||
|
||||
|
||||
+3
-3
@@ -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`는 그대로다.
|
||||
|
||||
@@ -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가 느려도 다른 의존성 해석에는 영향이 없다.
|
||||
|
||||
## 지원 표
|
||||
|
||||
|
||||
@@ -78,17 +78,12 @@
|
||||
<!-- CT_CONSTRUCTOR_THROW (finalizer attack: a subclass's finalize() keeps a half-built object).
|
||||
A final class cannot be attacked this way, and every class that could be made final was.
|
||||
These three groups must stay subclassable. -->
|
||||
<!-- CT group 1 — CGLIB proxies. @RequiresPermission is enforced by a method-security advisor,
|
||||
and Spring Boot proxies with CGLIB, which subclasses the bean
|
||||
(RequiresPermissionProxyabilityTest fails the build if such a class is final). The
|
||||
Annotation matcher covers every class annotated at class level, including ones added
|
||||
later. A class that annotates only some methods is proxied all the same but is not matched
|
||||
here; name it when one appears. A @Configuration class is CGLIB-subclassed for its @Bean
|
||||
methods for the same reason. -->
|
||||
<!-- CT group 1 — CGLIB proxies. A @Configuration class is CGLIB-subclassed for its @Bean
|
||||
methods, so it must stay subclassable. (The template's copy also names its
|
||||
@RequiresPermission beans here; this library has none.) -->
|
||||
<Match>
|
||||
<Bug pattern="CT_CONSTRUCTOR_THROW" />
|
||||
<Or>
|
||||
<Annotation name="dev.cakit.application.security.RequiresPermission" />
|
||||
<Annotation name="org.springframework.context.annotation.Configuration" />
|
||||
</Or>
|
||||
</Match>
|
||||
|
||||
@@ -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절.
|
||||
|
||||
@@ -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. 올리기 직전까지 미리 돌리기
|
||||
|
||||
+1
-1
@@ -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
|
||||
|
||||
|
||||
@@ -43,7 +43,7 @@ property key는 `app.grpc.advanced.<capability>.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 |
|
||||
|
||||
+5
-5
@@ -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를 가져오는 별도 변경이 필요하다. 백엔드 템플릿은 지금 이 라이브러리를 받지 않는다.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user