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,48 @@
+# 같은 IDENTITY 매핑을 두 접근 방식으로 선언해 가드에 넘긴다
+  @Entity
+  static class FieldAccessIdentity {
+    @Id @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id;
+  }
+
+  @Entity
+  static class PropertyAccessIdentity {
+    private Long id;
+
+    @Id
+    @GeneratedValue(strategy = GenerationType.IDENTITY)
+    public Long getId() {
+      return id;
+    }
+
+    public void setId(Long id) {
+      this.id = id;
+    }
+  }
+
+
+프로파일 batchingRequired : true
+FieldAccessIdentity     IDENTITY 탐지 true   검증 거절
+PropertyAccessIdentity  IDENTITY 탐지 false  검증 통과
+
+# 하이버네이트는 그 둘을 어떻게 읽는가 — 시퀀스를 대조군으로 둔다
+필드 접근         식별자 멤버 Field         삽입 200  프리페어드 스테이트먼트 200
+프로퍼티 접근       식별자 멤버 Method        삽입 200  프리페어드 스테이트먼트 200
+시퀀스(대조군)      식별자 멤버 Field         삽입 200  프리페어드 스테이트먼트 6
+
+# 가드의 거절이 근거로 삼는 측정과 그것이 도는 레인
+22:@Tag("jpa-contract")
+25:  private static final int BATCH_SIZE = 50;
+26:  private static final int ROWS = 200;
+43:  @DisplayName("a sequence entity really produces JDBC batches")
+59:          .isGreaterThan(1L);
+64:  @DisplayName("an IDENTITY entity produces no JDBC batch at all")
+80:          .isZero();
+85:  @DisplayName("the sequence assigns identifiers before the flush, so entities are complete")
+103:  @DisplayName("an IDENTITY key only exists after the insert has been executed")
+250:def jpaPlatformContractTest = registerJpaPlatformLane(
+251-        'jpaPlatformContractTest',
+252-        'jpa-contract',
+jpa-nightly.yml:49:          :adapter:outbound:persistence-jpa:jpaPlatformContractTest
+jpa-pr.yml:86:          :adapter:outbound:persistence-jpa:jpaPlatformContractTest
+gradlew :adapter:outbound:persistence-jpa:jpaPlatformContractTest --console=plain
+gradlew :adapter:outbound:persistence-jpa:jpaPlatformContractTest :adapter:outbound:persistence-jpa:jpaPlatformFailureTest --console=plain