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를 가져오는 별도 변경이 필요하다. 백엔드 템플릿은 지금 이 라이브러리를 받지 않는다.