# grpc-library Spring Boot 앱에 gRPC 서버·클라이언트를 붙이는 플랫폼 라이브러리다. 타입 있는 서비스 adapter, method 정책(deadline·멱등성·크기 한도), 실행 증거와 실패 모델, durable operation 원장, 관측 규칙, 인증 lane(in-process·실제 Netty·fault·performance)을 준다. ```text 앱 소유 port ──> 앱의 inbound adapter ──> grpc-spring-boot-starter (조립) ├─ grpc-runtime (io.grpc 위의 정책·서버·클라이언트) ├─ grpc-core-api (Java 표준 라이브러리만: 식별자·정책·증거·실패 모델) ├─ grpc-observability (metric·trace 규칙) └─ grpc-operation-ledger-jpa (선택: 멱등성 원장) ``` ## 받는 법 Maven group은 `com.hyeonworks.grpc`, artifact는 모듈 이름 그대로다(`grpc-core-api`, `grpc-runtime`, `grpc-spring-boot-starter`, …). 저장소는 소유자 Gitea Packages이고, 공개라 읽을 때 토큰이 필요 없다. ```groovy // settings.gradle dependencyResolutionManagement { repositories { exclusiveContent { forRepository { maven { url = 'https://git.learn.hyeonworks.com/api/packages/donghyeon.kang/maven' } } filter { includeGroupByRegex 'com\\.hyeonworks(\\..*)?' } } mavenCentral() } } ``` ```groovy // build.gradle dependencies { implementation 'com.hyeonworks.grpc:grpc-spring-boot-starter:1.0.0' } ``` `exclusiveContent`는 `com.hyeonworks` group을 이 저장소에서만, 나머지는 Maven Central에서만 찾게 한다. 같은 이름을 공개 저장소에 올리는 공격이 통하지 않고, Gitea가 느려도 다른 의존성 해석에는 영향이 없다. ## 지원 표 | 라이브러리 | Spring Boot(컴파일·시험한 줄) | io.grpc BOM | Java | | --- | --- | --- | --- | | 1.0.x | 4.0.x (`4.0.9`) | 1.75.0 | 21 | 무엇을 인증했고 무엇은 지켜보기만 하는지는 `docs/compatibility/grpc-support-matrix.md`와 `grpc-advanced-support-matrix.md`다. ## 프로젝트 구조 | 폴더 | 무엇 | | --- | --- | | `grpc/` | Stable 모듈 7개(Unary, Server Streaming). 규칙은 `grpc/AGENTS.md` | | `grpc-advanced/` | capability flag 뒤의 고급 능력 2개(client·bidi streaming, xDS, gRPC-Web 등). 규칙은 `grpc-advanced/AGENTS.md` | | `build-logic/` | 백엔드 템플릿에서 복사해 줄인 Gradle convention 플러그인. 출처는 `build-logic/UPSTREAM.md` | | `config/` | 모듈 registry(`architecture/modules.json`), Checkstyle·SpotBugs 설정, 테스트 컨테이너 이미지 | | `scripts/` | 검증 진입점 `verify.sh`, 고정 도구 `tool.sh`, Buf `buf.sh`, 릴리스 보조 `release/` | | `.gitea/workflows/` | 단계 파일 셋: `pr.yml`(`ci`), `main.yml`(`mainCheck`), `release.yml`(`releaseCheck release`) | | `docs/` | 문서. 지도는 `docs/README.md` | ## 문서 지도 - 작업 방법: `docs/work/README.md`(고치기·리뷰), `docs/work/gates.md`(게이트), `docs/work/release.md`(릴리스·버전 규칙·비밀 값) - 결정 기록: `docs/adr/`(ADR-GRPC-001~006, ADR-GRPC-ADV-001) - 운영: `docs/runbooks/grpc-platform-operations.md`, `docs/runbooks/grpc-advanced-capabilities.md` - 설계서: `docs/design/2026-08-30-grpc-platform-adaptation-design.md` - 바뀐 것: `CHANGELOG.md` ## 서명 배포 파일마다 PGP 서명(`.asc`)이 붙는다. 공개 키는 첫 릴리스 때 소유자가 여기에 붙인다(`docs/work/release.md` 1절). ## 이력 - 2026-08-31 ~ 2026-11-07: 백엔드 템플릿 `clean-architecture-backend-template` 안에서 만들었다(`src/grpc`, `src/grpc-advanced`, `src/optional-platforms` → 2026-11-07부터 `src/platforms/…`). - 2026-11-08: `git filter-repo`로 그 경로들의 이력을 이 repo로 옮겼다(템플릿 main `22df3525` 기준). 옮긴 코드 폴더의 트리 해시는 템플릿 기준 커밋과 같다. - filter-repo가 커밋 SHA를 모두 다시 썼다. 코드 주석과 문서가 부르는 커밋 SHA와 리뷰 ID(`RR6-…`, `BUILD-O3-5` 등)는 **템플릿 repo** 기준이다. 그 리뷰 문서는 템플릿 `docs/reviews/`에 남아 있다. - 설계와 결정: design-docs `repo-structure/05-library-repos.md`(소유자 승인 2026-11-07).