From 6ad8f4b635e79e2d9ddd0e6ea23d6c9b4bd285b0 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sat, 7 Nov 2026 19:24:43 +0900 Subject: [PATCH] =?UTF-8?q?docs(persistence-jpa):=20README=EA=B0=80=20?= =?UTF-8?q?=EA=B3=A0=EC=B9=9C=20=EB=B2=84=EC=A0=84=20=EC=97=86=EB=8A=94=20?= =?UTF-8?q?Querydsl=20=EC=A2=8C=ED=91=9C=EB=A5=BC=20=EA=B6=8C=ED=95=98?= =?UTF-8?q?=EC=A7=80=20=EC=95=8A=EA=B2=8C=20=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: persistence-jpa README 「라이브러리 API」가 Querydsl을 쓰는 서비스에 `com.querydsl:querydsl-jpa:5.1.0:jakarta`를 직접 추가하라고 한다. 그 좌표에는 HIGH CVE-2024-49203(orderBy를 통한 HQL injection)이 있고 고친 버전이 없다. 8e3bef0f가 이 leaf를 querydsl-core로 옮겼는데, 살아 있는 문서는 아직 그 좌표를 권한다. 고친 방법: 총괄이 권한 안 A를 확인하고 이 문장도 고치라고 했다(2026-11-07). 문장을 넷으로 나눴다: 템플릿은 querydsl-core의 `Predicate`만 쓴다, JPA 질의가 필요한 서비스는 querydsl-jpa를 직접 더한다, 그 좌표 5.1.0에는 CVE-2024-49203이 있고 고친 버전이 없다, 쓰려면 OpenFeign 포크(`io.github.openfeign.querydsl`)를 검토한다. Envers 안내는 그대로다. 결정 색인 「Querydsl 취약 좌표」 행의 「누가」를 「총괄 확인 전」에서 위임(총괄 확인)으로 바꾸고 README를 출처에 더했다. - 원래는 8e3bef0f와 같은 커밋이어야 했다. 그 커밋은 이미 push해서 고쳐 쓰지 않고 바로 뒤에 붙인다. 위험·한계: README 줄은 문서 번역 작업(D2b) 범위 안이다. 총괄이 D2b에 이 줄을 건드리지 말라고 알린다. 검증(desktop, 이 커밋과 다음 커밋을 얹은 트리 fbb325c1): `python3 -m unittest discover -s scripts/tests` OK, `check-docs.py` rc=0, `check-work-docs.py` rc=0, 같은 범위 상대 링크 555개 깨짐 0, `check-repo-layout.py` rc=0. lychee(0.22.0 이미지)는 rc=2이고 실패 4건이 앞 트리와 같다(기록 문서의 404, 이 변경 전부터). 이 README를 읽는 테스트는 없다(`grep -rn --include='*.java'`). --- docs/work/reference/decisions.md | 2 +- src/adapter/outbound/persistence-jpa/README.md | 9 ++++++--- 2 files changed, 7 insertions(+), 4 deletions(-) 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) 테스트다. | 패키지 | 진입점 | 동작을 증명하는 테스트 | |---|---|---|