diff --git a/docs/work/reference/decisions.md b/docs/work/reference/decisions.md index 739e98c6..efef2dab 100644 --- a/docs/work/reference/decisions.md +++ b/docs/work/reference/decisions.md @@ -185,7 +185,7 @@ | PR `ci` 범위 | 변경 모듈만 돌리지 않음. 전체 실행 + Gradle 캐시(보류) | 소유자 | 결정 30 | | 의존성 checksum | 추가 안 함(보류) | 소유자 | 결정 19 | | 취약점이 있는 의존성 버전 | 고친 버전으로 올리는 것이 먼저다. 고친 버전 중 가장 작은 것을 고르고, 짝으로 움직이는 라이브러리(httpclient5와 httpcore5, gRPC와 protobuf)는 upstream이 선언한 짝을 따른다. Boot BOM이 관리하면 Boot 패치를 먼저 보고, 없으면 BOM 속성 override(build-logic `JavaConventionsPlugin`, 이유와 지울 조건 옆). 어떤 leaf도 선언하지 않는데 upstream이 낡은 버전을 가져오면 카탈로그 `pinned-*`로 모든 구성에 고정한다. 무시 목록(`.trivyignore.yaml`)은 고친 버전이 없을 때만, 묻고 쓴다 | 기본값(2026-11-07) | `src/gradle/libs.versions.toml` 「Pinned」, 업그레이드 안내 `docs/upgrade/2026-11-maturity-review.md` B-54 | -| Querydsl 취약 좌표 | `com.querydsl:querydsl-jpa`(CVE-2024-49203, 고친 버전 없음)를 템플릿이 싣지 않는다. persistence-jpa는 쓰는 타입(`Predicate`)이 있는 querydsl-core로만 컴파일하고, querydsl-jpa는 capability를 켜는 서비스가 더한다 | 기본값(2026-11-07, 총괄 확인 전) | 커밋 「persistence-jpa가 querydsl-jpa 대신 querydsl-core로 컴파일한다」 | +| Querydsl 취약 좌표 | `com.querydsl:querydsl-jpa`(CVE-2024-49203, 고친 버전 없음)를 템플릿이 싣지 않는다. persistence-jpa는 쓰는 타입(`Predicate`)이 있는 querydsl-core로만 컴파일하고, querydsl-jpa는 capability를 켜는 서비스가 더한다. leaf README는 그 좌표에 고친 버전이 없다고 적고 OpenFeign 포크(`io.github.openfeign.querydsl`)를 검토하라고 한다 | 위임(2026-11-07, 총괄이 권한 안 A를 확인) | 커밋 「persistence-jpa가 querydsl-jpa 대신 querydsl-core로 컴파일한다」, `src/adapter/outbound/persistence-jpa/README.md` 「라이브러리 API」 | | build-logic 의존성 잠금 | 잠그지 않음 + 문서화(보류) | 소유자 | 결정 27 | | 릴리스 이미지 서명 | cosign keyless, tag 릴리스에서 서명·검증 | 소유자 | 결정 31 | | gRPC `.proto` | protobuf Gradle 플러그인 + Buf(CI) | 소유자 | 결정 18 | diff --git a/src/adapter/outbound/persistence-jpa/README.md b/src/adapter/outbound/persistence-jpa/README.md index 5f07bbd6..58bbab84 100644 --- a/src/adapter/outbound/persistence-jpa/README.md +++ b/src/adapter/outbound/persistence-jpa/README.md @@ -67,9 +67,12 @@ append 포트(`APP_OUTBOX_ENABLED=true`)가 모두 있을 때만 켜진다. subm 아래 타입은 어떤 설정도 bean으로 만들지 않는다. 쓰려면 서비스의 어댑터 leaf가 `implementation project(':adapter:outbound:persistence-jpa')`를 선언하고(registry `allowed_dependencies`에 그 edge가 있어야 한다) 자기 코드에서 생성·호출한다. `runtimeOnly`로는 -컴파일되지 않는다(AGENTS.md capability 규칙의 라이브러리형 예외). Querydsl·Envers는 이 leaf에서 -`compileOnly`이므로 쓰는 서비스가 `com.querydsl:querydsl-jpa:5.1.0:jakarta`·`org.hibernate.orm:hibernate-envers`를 -직접 추가한다. "PG"는 `postgresqlIntegrationTest`(실제 PostgreSQL) 테스트다. +컴파일되지 않는다(AGENTS.md capability 규칙의 라이브러리형 예외). Envers는 이 leaf에서 +`compileOnly`이므로 쓰는 서비스가 `org.hibernate.orm:hibernate-envers`를 직접 추가한다. Querydsl은 +`querydsl-core`의 `Predicate`만 쓴다(`compileOnly`, 버전은 Boot BOM). JPA 질의(`JPAQuery`)가 필요한 +서비스는 querydsl-jpa를 직접 더한다. 단 `com.querydsl:querydsl-jpa` 5.1.0에는 CVE-2024-49203(orderBy를 +통한 HQL injection)이 있고 고친 버전이 없다. 쓰려면 OpenFeign 포크(`io.github.openfeign.querydsl`)를 +검토한다. "PG"는 `postgresqlIntegrationTest`(실제 PostgreSQL) 테스트다. | 패키지 | 진입점 | 동작을 증명하는 테스트 | |---|---|---|