---
kind: CONCEPT
slug: adapter-outbound-persistence-jpa-c24
title: 질의 계층은 프레임워크가 아니라 세 단계의 정책층이다
topic: capability-and-disclosure-models
project: clean-architecture-backend-template
status: 게시 전
sourceRevision: 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916
rootTreeNode: concept:adapter-outbound-persistence-jpa-c24
evidenceCapturedOn: 2026-09-01
assets:
  - key: adapter-outbound-persistence-jpa-c24
    file: ../../../final/evidence/rendered/adapter-outbound-persistence-jpa-c24.svg
  - key: adapter-outbound-persistence-jpa-c24-diagram
    file: ../../../final/assets/diagrams/adapter-outbound-persistence-jpa-c24.svg
evidence:
  - ../../../final/evidence/raw/adapter-outbound-persistence-jpa-c24.txt
source:
  - 원본 분석 절은 final/document.md#a05#L1610 이다.
module: adapter-outbound-persistence-jpa
---

# 질의 계층은 프레임워크가 아니라 세 단계의 정책층이다

`springdata`와 `querydsl`은 application-core의 repository contract를 대체하는 generic CRUD layer가 아니다. `JpaRepositoryFragmentSupport`에는 범용 `save/findAll/delete`가 없다.

## 본문

<!-- body:start -->

현재 code shape는 대략 다음처럼 읽는 것이 맞다. `springdata`와 `querydsl`이 application-core의 repository contract를 대체하는 generic CRUD layer가 아니다.

## 질의 계층의 세 단계

:::evidence key="adapter-outbound-persistence-jpa-c24-diagram" alt="응용 계층 질의 계약과 springdata 와 hibernate 가 위에서 아래로 쌓이고 위임 방향 화살표가 아래로 그려진 구조" caption="질의 계층의 세 단계" zoom="false"
:::

`springdata/**`는 allowlisted sort, keyset assembly/predicate, fetch-plan catalog, bounded stream lifetime, Specification safety를 맡는다. `hibernate/**`는 provider/version facts, 실제 Statistics/JDBC batch evidence, statement naming, batch/bulk/stateless provider optimization을 맡는다.

## JpaRepositoryFragmentSupport 참조 위치

:::evidence key="adapter-outbound-persistence-jpa-c24" alt="코드베이스에서 JpaRepositoryFragmentSupport 를 검색한 출력 5줄. 이 기록이 세는 참조가 그 출력에 그대로 보인다." caption="JpaRepositoryFragmentSupport 코드베이스 검색 — 5줄 · exit 0" zoom="true"
:::

## 범용 CRUD가 없는 이유

`JpaRepositoryFragmentSupport`에는 범용 `save/findAll/delete`가 없고, domain-owned adapter가 필요한 query mechanism만 조합하게 설계돼 있다. 이 방향은 support matrix의 "platform-owned generic CRUD repository는 unsupported"와 일치한다.

<!-- body:end -->