---
kind: CONCEPT
slug: adapter-outbound-persistence-jpa-c43
title: H2 idempotency와 V2 owner 필드
topic: state-machines-and-ownership
project: clean-architecture-backend-template
status: 게시 전
sourceRevision: 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916
rootTreeNode: concept:adapter-outbound-persistence-jpa-c43
evidenceCapturedOn: 2026-09-01
assets:
  - key: adapter-outbound-persistence-jpa-c43
    file: ../../../final/evidence/rendered/adapter-outbound-persistence-jpa-c43.svg
evidence:
  - ../../../final/evidence/raw/adapter-outbound-persistence-jpa-c43.txt
source:
  - 원본 분석 절은 analysis/05-adapter-outbound-persistence-jpa.md#L3119 이다.
module: adapter-outbound-persistence-jpa
---

# H2 idempotency와 V2 owner 필드

`H2IdempotencyClaimRepository`의 MERGE/takeover는 V2 owner/transition field를 초기화하지 않는다. baseline `IdempotencyRecordEntity`가 V1 field만 매핑하고 owner-safe V2는 PostgreSQL capability stream으로 분리되어 있으므로, 서로 다른 schema generation의 필드를 H2 V1이 reset하지 않는 것은 현재 계약 위반이 아니다.

## 본문

<!-- body:start -->

## H2 baseline이 소유하는 필드

`H2IdempotencyClaimRepository`의 MERGE/takeover 경로에는 V2 owner/transition field 초기화가 없다. 그러나 baseline `IdempotencyRecordEntity` 자체가 V1 field만 매핑한다.

## H2IdempotencyClaimRepository 참조 위치

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

## PostgreSQL V2와 분리된 activation contract

owner-safe V2는 PostgreSQL capability stream으로 분리되어 별도 activation contract를 가진다. H2 baseline 경로와 PostgreSQL V2 경로가 서로 다른 schema generation을 소유하므로, H2 V1이 V2 field를 reset하지 않는 동작은 현재 계약과 충돌하지 않는다.

<!-- body:end -->