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 본문).
43 lines
3.2 KiB
Markdown
43 lines
3.2 KiB
Markdown
# 문제 정의 — grpc-library
|
|
|
|
> 아이디어가 아니라 고객의 문제에서 출발한다. 좋은 스펙은 헷갈리지 않게 하는 스펙이다.
|
|
> 바뀌면 고친다(살아 있는 문서). 왜 바꿨는지는 커밋 본문이나 결정 기록에 남긴다.
|
|
|
|
## 고객의 말 그대로
|
|
|
|
- 소유자(2026-11-07): 「템플릿 repo 안에 프로젝트 계층이 아닌 라이브러리 폴더가 있으면 안 된다. 커스텀 라이브러리는 별도 repo로 관리하고, 매뉴얼에 관리 대상으로 둔다.」
|
|
- 고객은 이 라이브러리를 받아 쓰는 백엔드 서비스(백엔드 템플릿과 그 파생 서비스)와 그 서비스를 만드는 사람·에이전트다.
|
|
|
|
## 지금은 어떻게 버티나
|
|
|
|
- 2026-11-08까지 이 코드는 템플릿 안의 두 번째 Gradle 빌드(`src/platforms/optional-build`)였다. 템플릿 빌드 규칙·카탈로그·testFixtures를 경로로 읽었고, 템플릿 CI가 job 넷과 단계 하나로 따로 돌렸다.
|
|
- 템플릿을 받은 파생 서비스는 쓰지도 않는 플랫폼 코드 수백 파일을 함께 받았다. 템플릿 재사용 체크리스트(「`dev.caskeleton`을 새 패키지로 바꾼다」)가 플랫폼 패키지까지 바꾸게 만들었다.
|
|
|
|
## 하지 않는 것
|
|
|
|
- 템플릿 `adapter:inbound:grpc`를 이 라이브러리에 배선하는 일. 별도 결정이다(`grpc/AGENTS.md` 「application이 이 family에 도달하는 경로」).
|
|
- Maven Central 배포. 템플릿 밖 공개 소비자가 생기면 본다.
|
|
- BOM. 소비자가 템플릿 하나라 카탈로그 버전 한 칸으로 충분하다. 템플릿 밖 소비자가 한 라이브러리에서 모듈 3개 이상을 쓰면 다시 본다.
|
|
- SNAPSHOT 배포. 같이 고칠 때는 composite build를 쓴다.
|
|
|
|
## 성공 기준
|
|
|
|
| 기준 | 구체적으로 | 어떻게 재나 | 목표 값 | 기한 |
|
|
|---|---|---|---|---|
|
|
| 혼자 빌드된다 | 템플릿 없이 PR·main 단계가 초록 | Gitea Actions `pr`·`main` 실행 결과 | 초록 | 2026-11-08 |
|
|
| 배포된다 | 태그 하나로 서명된 모든 모듈이 Gitea Packages에 올라가고 익명으로 읽힌다 | release.yml, `maven-metadata.xml` | `v1.0.0` 게시 | 소유자가 비밀 값을 넣은 뒤 |
|
|
| 템플릿이 가벼워진다 | 템플릿에 gRPC 플랫폼 폴더·optional build·그 CI job이 없다 | `git ls-files src/platforms/grpc*` | 0 | 2026-11-08 PR |
|
|
|
|
## 세 관점 점검
|
|
|
|
| 관점 | 묻는 것 | 답 |
|
|
|---|---|---|
|
|
| 비즈니스 | 돈이 되나, 누가 대가를 치르나 | 템플릿 유지비를 줄인다. 대가는 CI·build-logic 사본·release secret이 한 벌 더 생기는 것 |
|
|
| 기술 | 만들 수 있나, 가장 위험한 가정은 | Gitea Packages가 Gradle이 올리는 체크섬 넷과 `.asc`·`.module`을 모두 받는다는 가정(설계 16절 H8). 첫 태그에서 드러난다 |
|
|
| 고객 | 쓸모 있나, 지금 방법보다 나은가 | 쓰는 서비스는 버전으로 받고, 쓰지 않는 서비스는 아무것도 받지 않는다 |
|
|
|
|
## 되돌릴 수 없는 결정
|
|
|
|
- 배포한 버전은 지우지 않는다(`docs/work/release.md` 2절). 같은 버전은 다시 올릴 수 없다.
|
|
- Maven group `dev.cakit.grpc`와 proto 패키지 `cakit.grpc.*`. 바꾸면 모든 소비자의 MAJOR다. 근거는 design-docs `repo-structure/05-library-repos.md` 6.3절.
|