fix: 하네스 제거 및 keycloak 문서 보강

2026-07-25 12:53:13 +09:00
parent 6c53ded9cb
commit d71669eb59
2329 changed files with 138239 additions and 172816 deletions
@@ -1 +0,0 @@
-../../vault/40-publish/blog-topics/transaction-isolation-vendor-default-pin-2026-07-02.md
@@ -0,0 +1,82 @@
+---
+title: blog-topic / transaction-isolation-vendor-default-pin
+source_type: blog-topic
+status: raw
+related_branches: [feature-transaction-concurrency-contract]
+related_projects: [ca-tmpl]
+tags: [blog-topic, ca-tmpl, persistence, postgresql, transaction-isolation, mvcc, gap-lock]
+created: 2026-07-02
+status_label: ready-for-canonical
+target_audience: backend-engineer
+inspiration_url:
+archive_url:
+---
+
+# blog-topic: transaction-isolation-vendor-default-pin
+
+> Layer: `raw/blog-topics/` — 작업 중 나온 블로그 글감 원석. 최종 블로그는 canonical 정제 후 `wiki/blog/`에서 작성한다.
+
+## Parent / 부모
+
+- [[raw/branch-notes/feature-transaction-concurrency-contract]] — DB vendor default에 맡기지 않고 isolation을 명시 pin하는 결정에서 나온 글감.
+
+## 트리거 / Trigger
+
+- 트리거 유형: `branch-work`
+- 트리거 날짜: 2026-07-02
+- 트리거 연결 노트: [[raw/branch-notes/feature-transaction-concurrency-contract]]
+
+## 글감 / Topic seed
+
+- 한 문장 요지: Postgres/MySQL 등 DB vendor default isolation 차이를 skeleton contract에서 명시 pin/test로 다루는 이유를 정리한다.
+- 예상 제목 후보:
+  - DB isolation을 default에 맡기지 않은 이유
+  - Transaction isolation은 왜 skeleton contract가 되어야 할까
+
+## 핵심 주장 후보 / Claim candidates
+
+- 사실 후보:
+  - branch의 D3가 vendor default 차이와 pin/test 계약을 다룬다 — 근거 후보: [[raw/branch-notes/feature-transaction-concurrency-contract]] line `:116`, `:164-179`, `:287-292`.
+- 경험 후보:
+  - 기존 TransactionPort topic은 abstraction 중심이고, 이 글감은 isolation pin/test 계약을 별도로 다룬다.
+- 의견/해석 후보:
+  - transaction abstraction이 있어도 isolation default를 숨기면 concurrency behavior가 환경별로 달라질 수 있다.
+
+## Outline seed
+
+1. `@Transactional` 추상화와 isolation은 다른 문제다 — method boundary와 DB behavior를 분리한다.
+2. vendor default가 다른 이유를 글감으로 삼기 — Postgres/MySQL 차이를 project contract로 pin한다.
+3. pin만으로 충분하지 않다 — startup/test에서 실제 isolation을 확인해야 한다.
+
+## Canonical 전환 후보 / Canonical extraction candidates
+
+- `wiki/projects/ca-tmpl/transaction-boundary-abstraction.md` 후보:
+  - ca-tmpl transaction/concurrency isolation pin decision.
+- `wiki/concepts/transaction-isolation.md` 후보:
+  - isolation level, MVCC, gap lock 일반 개념.
+- 필요한 추가 검증:
+  - 실제 DB별 isolation check test와 configured value.
+
+## Sources / 근거 후보
+
+- [[raw/branch-notes/feature-transaction-concurrency-contract]] — D3 isolation pin 근거.
+- [[raw/blog-topics/transaction-port-abstraction-over-spring-transactional-2026-05-28]] — 인접한 TransactionPort topic.
+
+## 미해결 / Unknown
+
+- 아직 확인해야 할 사실: MySQL/Postgres 양쪽에서 실제 테스트했는지, 아니면 policy만 있는지.
+- 과장하면 안 되는 부분: 모든 concurrency anomaly를 isolation pin으로 해결한다고 쓰지 않는다.
+- 블로그로 쓰기 전에 필요한 canonical 정제: project implementation evidence와 general DB concept 분리.
+
+## Decision / 처리 결정
+
+- 액션: `promote-to-canonical`
+- 이유: `wiki/projects/ca-tmpl/transaction-boundary-abstraction.md` 에 transaction isolation vendor default pin 글감으로 반영했다.
+- 다음 단계: source canonical이 `verified` 상태이므로 이후 `blogify` 대상으로 삼을 수 있다. 단 모든 concurrency anomaly를 isolation pin으로 해결한다고 쓰지 않는다.
+
+## Related / 관련
+
+- 관련 branch: [[raw/branch-notes/feature-transaction-concurrency-contract]]
+- 관련 error:
+- 관련 interview prep:
+- derived blog: 생성 전. 생성 시 `wiki/blog/transaction-isolation-vendor-default-pin-YYYY-MM-DD.md` 후보
				`@@ -1 +0,0 @@`
				`../../vault/40-publish/blog-topics/transaction-isolation-vendor-default-pin-2026-07-02.md`