DongHyeonkaandClaude Fable 5.1
b25357c48a
- analysis/·source-index·state.json 을 final/document.md 제2부·제3부로 접었다. SSOT 는 하나다 - 파일럿 — commit-ambiguity-as-a-result 를 새 기준으로 재선별. 후보 14 → 글감 5 (PROMOTE 5 · MERGE_INTO 3 · KEEP_IN_SSOT 4 · 보류 2). 기록 5건을 다시 썼고 그림 1개를 techviz 로 만들었다 - 재선별이 잡은 것: 제1부 §6.2·§11.1 이 자기 §13.2 와 어긋나 있었다(레인을 안 돌렸다 vs 돌렸다) — 정정. 이미 답이 나와 있던 Question 을 HEAD 재실행 질문으로 다시 세웠다. Concept 이 인용한 코드가 SSOT 에 없어 뺐다 - candidateScope·sourceRepository 기록. 나머지 43개 주제는 재선별 대기(PENDING 905) Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
58 lines
2.5 KiB
Markdown
58 lines
2.5 KiB
Markdown
---
|
|
kind: PROJECT_DECISION
|
|
slug: in-root-write-fails-fast
|
|
title: inRootWrite는 suspend하지 않고 fail-fast한다
|
|
topic: transaction-deadline-and-pool
|
|
project: clean-architecture-backend-template
|
|
status: 게시 전
|
|
sourceRevision: 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916
|
|
rootTreeNode: decision:in-root-write-fails-fast
|
|
decisionStatus: ADOPTED
|
|
decidedOn: 2026-08-30
|
|
source:
|
|
- src/adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/transaction/SpringTransactionPort.java
|
|
- final/document.md#a05
|
|
---
|
|
|
|
# inRootWrite는 suspend하지 않고 fail-fast한다
|
|
|
|
## 결정문
|
|
|
|
루트 쓰기 연산은 이미 트랜잭션이 열려 있으면 바깥을 일시 중단하지 않고 예외를 던진다.
|
|
|
|
## 판단 이유
|
|
|
|
이 연산의 이름이 약속하는 것은 루트 트랜잭션이다. 호출자가 그렇게 부르는 이유는 자기 작업이 다른 트랜잭션에 참여하지 않기를 바라기 때문이다.
|
|
|
|
이미 트랜잭션이 열려 있는데 일시 중단하고 새로 시작하면 두 가지가 일어난다. 바깥 커넥션이 핀되고, 호출자는 자기가 루트라고 믿는데 실제로는 중첩 안에 있다.
|
|
|
|
첫 번째는 풀 비용이다. 두 번째는 더 나쁘다. 커밋 순서와 롤백 범위에 대한 호출자의 가정이 틀린 채로 진행된다.
|
|
|
|
그래서 일시 중단하지 않고 던진다. 중첩된 루트 트랜잭션이 거절되었다는 전용 예외 타입이다.
|
|
|
|
이 선택은 호출자에게 부담을 넘긴다. 루트를 요구하는 코드가 어디서 불리는지 알아야 하기 때문이다. 그것이 의도다. 그 사실을 아는 것이 이 연산을 쓰는 조건이다.
|
|
|
|
## 영향
|
|
|
|
감수하는 것
|
|
|
|
이 연산을 호출하는 경로가 트랜잭션 안에 들어가면 런타임에 실패한다. 정적으로는 막히지 않는다.
|
|
|
|
기존 코드에서 이 연산을 쓰려면 호출 경로를 먼저 정리해야 한다.
|
|
|
|
얻는 것
|
|
|
|
루트라고 부른 것이 실제로 루트다.
|
|
|
|
중첩 깊이가 예상 밖으로 늘어나 풀 하한을 깨는 경로 하나가 사라진다.
|
|
|
|
## 근거
|
|
|
|
- **REQUIRES_NEW의 커넥션 비용과 풀 사이징 제약**
|
|
일시 중단이 커넥션을 놓지 않는다는 사실이 이 결정의 근거 중 하나다.
|
|
- **트랜잭션 템플릿은 모드별로 미리 만들어 둔다**
|
|
같은 포트의 다른 모드 결정이다.
|
|
- **트랜잭션 결과 대수 — 다섯 변형이 각각 답하는 질문**
|
|
참여와 루트를 구별하는 결과 타입이다.
|
|
|