grpc-library가 이름을 com.hyeonworks.grpc에서 dev.cakit.grpc로 바꾼다 (grpc-library PR #2, 소유자 2026-11-08: 개인 도메인 이름을 공용 라이브러리에 쓰지 않는다). 이 브랜치 문서는 옛 이름을 적고 있었다. - README 재사용 체크리스트 6번: 라이브러리 패키지 dev.cakit.*은 바꾸지 않는다. 2번이 바꾸는 dev.caskeleton과 겹치지 않게 정한 이름이라고 적었다 - related-repos.md(group 두 칸과 받는 법), capability-status, 업그레이드 안내 B-55, 카탈로그 주석 남긴 것: Gitea 서버 주소, 기록(ADR-GRPC-002, 리뷰·history 본문)의 옛 proto 조직 이름 hyeonworks. 검증: check-docs.py OK, check-work-docs.py OK, --links broken 0.
2.9 KiB
관련 저장소 — 템플릿 밖에서 관리하는 라이브러리
프로젝트 계층이 아닌 라이브러리는 이 repo에 두지 않는다(소유자 결정 2026-11-07, decisions.md 「라이브러리 repo」). 라이브러리마다 별도 repo에서 고치고 Gitea Packages에 버전으로 배포한다. 이 문서는 그 목록과, 템플릿에서 그 라이브러리를 다루는 법이다. 설계 근거는 design-docs repo-structure/05-library-repos.md다.
1. 목록
| repo | 무엇 | Maven group | 카탈로그 칸 | 쓰는 leaf |
|---|---|---|---|---|
| grpc-library | gRPC 플랫폼(Stable 7, advanced 2) | dev.cakit.grpc |
없음(채택 전) | 없음. adapter:inbound:grpc는 io.grpc를 직접 쓴다. 채택은 별도 결정이다 |
messaging-library |
메시징 제품 | dev.cakit.messaging |
(옮긴 뒤 messagingLibrary) |
아직 src/platforms/messaging에 있다. 다음 분리 작업에서 옮긴다 |
고치는 법·게이트·릴리스는 각 repo의 docs/work/다. 이 repo의 매뉴얼은 위치만 가리킨다.
2. 라이브러리를 고칠 때
-
템플릿 안에서 라이브러리 코드를 고치지 않는다. 라이브러리 repo에서 고치고 릴리스한다.
-
템플릿 변경 때문에 라이브러리를 고쳐야 하면 브랜치를 둘 만들고, 템플릿에서 명령 줄로만 끼워 같이 시험한다.
./gradlew --include-build ../grpc-library <태스크>그 상태로 lockfile을 쓰거나 커밋하지 않는다.
-
병합 순서는 하나다: 라이브러리 PR 병합 → 태그·릴리스 → 템플릿 PR에서 버전을 올리고 lockfile을 다시 쓴다 → 템플릿 병합.
-
라이브러리가 끌고 온 취약 의존성은 템플릿에서 먼저 덮어 막고(Boot 버전이나 카탈로그
pinned-*), 라이브러리 repo에 수정을 남긴다.
3. 템플릿이 라이브러리 버전을 올릴 때
라이브러리를 카탈로그로 받는 leaf가 생긴 뒤의 절차다(지금은 없다).
src/gradle/libs.versions.toml의 라이브러리 버전 칸을 바꾼다.- desktop에서
./gradlew resolveAndLockAll --write-locks뒤verifyDependencyLocks. - 쓰는 leaf의
check와architectureCheck, 그 leaf의 lane. - 라이브러리
CHANGELOG.md에서 그 사이 버전의 깨지는 변경을 읽는다. MAJOR면docs/upgrade/에 행을 더하고 커밋 제목에!. - 커밋 제목 예:
build(deps): gRPC 라이브러리를 1.1.0으로 올린다.
4. 받는 법(처음 채택할 때)
src/settings.gradle의 저장소 선언에 Gitea Maven 저장소를 exclusiveContent로 더한다. dev.cakit group은 그 저장소에서만, 나머지는 Maven Central에서만 찾는다. 선언 예는 라이브러리 repo README 「받는 법」이다. 공개 owner라 읽기 토큰은 필요 없다.