> **기록 · 설계서** 본문은 쓴 때의 원문이다. 지금 동작은 「현재 정본」을 읽는다. - 상태: 확인 안 함 - 작성일: 2026-09-18 - 요약: PostgreSQL 멱등성 저장소 조립을 app-bootstrap에서 persistence-jpa로 옮기는 설계다. - 현재 정본: `src/bootstrap/idempotency/README.md` # PostgreSQL Idempotency Composition Ownership ## Goal Remove the concrete PostgreSQL owner-safe idempotency store construction from app-bootstrap while keeping provider selection, lifecycle policy, and assembly validation application-owned. ## Ownership adapter:outbound:persistence-jpa owns: - construction of PostgreSqlOwnerSafeIdempotencyStore; - the provider=postgresql condition for that concrete store; - reachability only through PersistenceJpaAutoConfiguration, so the JPA master switch remains the structural prerequisite. app-bootstrap owns: - IdempotencyProviderSettings and the provider selection; - IdempotencySettings TTL/reaper policy; - IdempotencyExecutorV2 lifecycle policy such as processing lease, response codec id, replay/failure retention and policy revision; - bean-count/exclusivity validation across JDBC, Redis and PostgreSQL providers; - startup dependency validation saying both jdbc and postgresql providers require JPA. ## Boundary The leaf configuration exposes only the application-owned IdempotencyStorePortV2 bean. It does not import app-bootstrap settings or construct the application executor. app-bootstrap consumes the port and no longer imports PostgreSqlOwnerSafeIdempotencyStore. No new public JPA type is required; the store configuration remains package-private under the existing JPA autoconfigure package. ## Compatibility - provider property and values are unchanged; - provider=postgresql still yields exactly one V2 store and one V2 executor when JPA is enabled; - other providers never receive the PostgreSQL store; - the existing executor policy constants are unchanged; - provider=postgresql with JPA disabled now fails during capability dependency validation rather than reaching a later missing-bean failure. ## Verified result - app-bootstrap idempotency production imports from persistence concrete packages: 0; - persistence-jpa production imports from app-bootstrap: 0; - PostgreSQL store configuration is package-private and contributes only IdempotencyStorePortV2; - provider=postgresql with JPA disabled is rejected by capability dependency validation; - persistence-jpa check and verifyJpaApiSurface: PASS, public API unchanged; - app-bootstrap test and architectureTest: PASS; - git diff --check: PASS.