---
kind: CONCEPT
slug: adapter-outbound-persistence-jpa-c45
title: V3와 V4는 registry revision을 올리지 않는다
topic: schema-and-wire-models
project: clean-architecture-backend-template
status: 게시 전
sourceRevision: 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916
rootTreeNode: concept:adapter-outbound-persistence-jpa-c45
evidenceCapturedOn: 2026-09-01
assets:
  - key: adapter-outbound-persistence-jpa-c45
    file: ../../../final/evidence/rendered/adapter-outbound-persistence-jpa-c45.svg
evidence:
  - ../../../final/evidence/raw/adapter-outbound-persistence-jpa-c45.txt
source:
  - 원본 분석 절은 analysis/05-adapter-outbound-persistence-jpa.md#L3166 이다.
module: adapter-outbound-persistence-jpa
---

# V3와 V4는 registry revision을 올리지 않는다

Fileserver persistence는 opt-in production capability이고, migration V3·V4가 registry revision을 갱신하지 않는 차이가 뒤따르는 startup fail-open finding의 직접 원인이다.

## 본문

<!-- body:start -->

Fileserver persistence는 latent helper가 아니라 실제 opt-in production capability다. `PersistenceJpaRootAutoConfiguration`이 `FileserverJpaPersistenceConfig`를 import한다.

## PersistenceJpaRootAutoConfiguration 참조 위치

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

## 켜진 배포에서 무엇이 도달 가능해지나

`app.fileserver-platform.enabled=true`이면 Fileserver entity/repository/component scan이 열린다. `FileserverStorageConfiguration.fileserverSchemaActivation()`은 `JdbcOperations`가 있으면 startup에서 `requireActive()`를 호출한다. 따라서 schema activation, quota, cleanup, recovery adapter는 Fileserver capability가 켜진 배포에서 production-reachable하다.

## revision이 2에서 멈춘다

V1은 registry에 `jpa-fileserver-metadata-v1`, `feature_revision=1`, `INSTALLED_INACTIVE`를 기록하고, V2는 recovery schema를 추가한 뒤 revision을 2로 올린다. 이후 V3는 fenced cleanup lease column을, V4는 upload terminal lifecycle column을 추가하지만 registry revision은 더 이상 갱신하지 않는다. 이 차이는 아래 startup fail-open finding의 직접 원인이다.

<!-- body:end -->