Files
clean-architecture-backend-…/docs/work/reference/related-repos.md
T
DongHyeonka a2dbf33b75 docs: grpc-library의 Maven group·패키지 이름을 dev.cakit.grpc로 맞춘다
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.
2026-11-08 14:09:47 +09:00

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가 생긴 뒤의 절차다(지금은 없다).

  1. src/gradle/libs.versions.toml의 라이브러리 버전 칸을 바꾼다.
  2. desktop에서 ./gradlew resolveAndLockAll --write-locks 뒤 verifyDependencyLocks.
  3. 쓰는 leaf의 check와 architectureCheck, 그 leaf의 lane.
  4. 라이브러리 CHANGELOG.md에서 그 사이 버전의 깨지는 변경을 읽는다. MAJOR면 docs/upgrade/에 행을 더하고 커밋 제목에 !.
  5. 커밋 제목 예: build(deps): gRPC 라이브러리를 1.1.0으로 올린다.

4. 받는 법(처음 채택할 때)

src/settings.gradle의 저장소 선언에 Gitea Maven 저장소를 exclusiveContent로 더한다. dev.cakit group은 그 저장소에서만, 나머지는 Maven Central에서만 찾는다. 선언 예는 라이브러리 repo README 「받는 법」이다. 공개 owner라 읽기 토큰은 필요 없다.