docs(keycloak-session-store): import the session-storage lab as a new project

The keycloak project ended with four open questions that design could not settle. A two-VM lab was built to answer them by measurement, and this is that material: 26 experiments, 125 raw command outputs, 22 browser captures. Follows the import procedure in README.md. source/ the originating repository verbatim — 78 documents, 28 SVGs, 8 manifests, plus .source-revision recording the commit final/ the SSOT document.md 729 lines written from the 29 experiment documents, not concatenated: what was predicted, what was measured, and where the measurement itself was wrong evidence/raw 125 outputs, flattened to <experiment>__<file> because the originals collided (01-baseline.txt appeared three times) and the audit only globs the top level evidence/meta one per raw file; command and exitCode are null and the README says why rather than inventing them evidence/browser 22 captures assets/ three diagrams through techviz .techviz/ their VizSpecs A separate project rather than an addition to keycloak: the B-layer answers that project's four questions, but the A, C and D layers are about cluster failure, SSO and operations, and one document.md should hold one subject. The four question records there can point here through 관계. Recorded rather than papered over: only three of the 28 diagrams were remade. The repository forbids hand-drawn SVG and forbids titles inside the canvas; all 28 originals carry both, so converting them is redrawing, not reformatting. They stay in source/ and the gap is written into the document. verify-pipeline.py passes. audit-records.py reports no issues. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-04 22:51:59 +09:00
parent 43bccd08a8
commit b2963105a8
5017 changed files with 372751 additions and 4943 deletions
@@ -0,0 +1,68 @@
+---
+kind: QUESTION
+slug: conditional-evaluation-order-unverified
+title: '@ConditionalOnBean 사슬의 실제 평가 순서를 확인하지 않았다'
+topic: assembly-ownership
+project: clean-architecture-backend-template
+status: 게시 전
+sourceRevision: 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916
+rootTreeNode: open-question:conditional-evaluation-order-unverified
+questionStatus: OPEN
+verifiedOn:            # 이 기록은 이번 회차에 실행 확인을 하지 않았다
+---
+
+# @ConditionalOnBean 사슬의 실제 평가 순서를 확인하지 않았다
+
+조건이 거짓인 이유는 뿌리 타입 부재일 수도 있고 평가 시점일 수도 있다. 정적으로는 전자로 보이지만 둘은 같은 증상을 낸다.
+
+## 사실
+
+이 저장소에 평가 시점 함정의 실제 사례가 기록되어 있다. Import 로 들어오는 설정의 클래스 수준 조건이 파싱 시점에 평가되어 여덟 빈이 사라졌다.
+
+그 회피를 위해 루트가 검증기를 직접 생성한다.
+
+outbox 사슬의 경우 JdbcOutboxRepository 에 스프링 스테레오타입이 없고, 그것을 생성하는 main 코드가 0 이며, OutboxEnvelopeFactory 를 Bean 으로 만드는 곳은 테스트 하나뿐이다.
+
+## 가정
+
+정적 측정이 보여 주는 뿌리 부재가 런타임 사유와 일치할 것이라고 전제하고 있다. 두 원인이 같은 증상을 내므로 이 전제는 확인 전까지 가정이다.
+
+## 미지수
+
+현재 리비전의 조건부 빈들이 각각 어느 시점에 평가되는가.
+
+outbox 사슬이 뿌리 부재인가 평가 시점인가.
+
+## 제약
+
+런타임 사유 문자열은 debug 부팅으로만 얻을 수 있다.
+
+애플리케이션 소스를 수정하지 않는다.
+
+## 선택지
+
+debug 부팅으로 부정 매치 사유를 읽는다
+가장 직접적이다. OnBeanCondition 이 남기는 사유가 뿌리 타입 부재를 지목하는지가 갈림점이다.
+
+정적 측정만으로 뿌리 부재로 확정한다
+생산자가 어디에도 없다는 측정은 강하지만, 평가 시점 문제가 함께 있을 가능성을 배제하지 못한다.
+
+## 다음 검증
+
+debug 를 켜고 부팅해 시작 로그의 부정 매치 사유 문자열을 읽는다.
+
+사유가 뿌리 타입 부재를 지목하면 해당 Case 의 원인 분류가 확정된다.
+
+평가 시점 문제로 드러나면 분류와 조치가 바뀐다.
+
+## 관계
+
+- **outbox가 둘이고, 출하되는 것은 messaging 플랫폼 쪽이 아니다**
+  이 질문이 원인을 확정하려는 사례다.
+- **ConditionalOnBean(DataSource)이 클래스 파싱 시점에 평가되어 여덟 빈이 사라졌다**
+  같은 함정이 실제로 일어난 기록이다.
+- **조건부 빈의 평가 시점 — 파싱 시점과 등록 시점**
+  이 질문이 다루는 메커니즘이다.
+- **부팅 한 번으로 확증 가능한 두 건이 아직 정적 추론으로만 남아 있다**
+  같은 부팅으로 함께 확인된다.
+
@@ -0,0 +1,71 @@
+---
+kind: QUESTION
+slug: one-boot-would-settle-two-findings
+title: 부팅 한 번으로 확증 가능한 두 건이 아직 정적 추론으로만 남아 있다
+topic: assembly-ownership
+project: clean-architecture-backend-template
+status: 게시 전
+sourceRevision: 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916
+rootTreeNode: open-question:one-boot-would-settle-two-findings
+questionStatus: OPEN
+verifiedOn:            # 이 기록은 이번 회차에 실행 확인을 하지 않았다
+---
+
+# 부팅 한 번으로 확증 가능한 두 건이 아직 정적 추론으로만 남아 있다
+
+관측 no-op 과 outbox 사슬 미조립은 둘 다 정적 도달성으로 판정했다. 브로커 없이 부팅 한 번이면 둘 다 직접 관측된다.
+
+## 사실
+
+messagingPublisher 빈이 6인자 생성자를 호출하고 그 생성자가 NO_OBSERVATION 을 넘긴다.
+
+관측 방출자 넷의 main 참조가 0 이다.
+
+outbox 와 inbox 저장소 구현의 main 참조가 0 이다.
+
+JdbcOutboxRepository 에 스프링 스테레오타입이 없고 그것을 생성하는 main 코드도 없다.
+
+## 가정
+
+액추에이터 메트릭 목록이 조립되지 않은 관측을 시리즈 부재로 드러낼 것이라고 전제하고 있다. 다른 경로로 같은 이름의 시리즈가 등록될 가능성은 배제하지 않았다.
+
+## 미지수
+
+actuator 메트릭에 messaging 으로 시작하는 시리즈가 실제로 없는가.
+
+조건 평가 리포트가 outbox 사슬 미충족을 어떤 사유로 보고하는가.
+
+## 제약
+
+브로커 없이 부팅해야 한다. 이 확인에 실제 카프카는 필요하지 않다.
+
+애플리케이션 소스를 수정하지 않는다.
+
+## 선택지
+
+한 번 부팅해 둘을 함께 캡처한다
+messaging 을 켜고 브로커를 카프카로 지정하고 debug 를 켜서 부팅한다. 메트릭 목록과 시작 로그의 부정 매치를 한 번에 얻는다.
+
+정적 판정을 유지하고 확인하지 못한 것으로 남긴다
+비용은 없지만 두 Case 의 확인하지 못한 것 항목이 계속 남는다.
+
+## 다음 검증
+
+app.messaging.enabled 를 참으로, app.messaging.broker 를 kafka 로, debug 를 참으로 두고 한 번 부팅한다. 그다음 두 가지를 캡처한다.
+
+액추에이터 메트릭의 시리즈 목록
+시작 로그의 부정 매치 중 MessagingReliabilityAutoConfiguration 항목
+
+브로커가 없어도 둘 다 가능하다.
+
+두 관측이 정적 판정과 일치하면 두 Case 의 확인하지 못한 것을 지우고 이 질문을 닫는다.
+
+어긋나면 모듈 분석을 먼저 갱신한다.
+
+## 관계
+
+- **관측을 필수 생성자 인자로 만든 수정을 조립이 6인자 생성자로 되돌렸다**
+  이 질문이 확증하려는 첫 번째 판정이다.
+- **outbox가 둘이고, 출하되는 것은 messaging 플랫폼 쪽이 아니다**
+  이 질문이 확증하려는 두 번째 판정이다.
+