donghyeon.kang/document-haness
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

refactor: 문서 개선 중

Browse Source
This commit is contained in:
donghyeon-ka
2026-09-21 14:30:55 +09:00
parent c93cdea150
commit 805a18f486
1497 changed files with 525837 additions and 59152 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/keycloak-session-store/final/assets/not-applicable-conditions/not-applicable-conditions.alt.md
+11 -7
View File
@@ -10,13 +10,17 @@ Keycloak 26 미만이면 persistent-user-sessions 가 기본이 아니라 A층
## Elements and evidence
- **Keycloak 버전** (component): 26 미만이면 세션의 거처가 다르다. Evidence: L684–L690.
- **캐시 온도** (component): volatile 에서 DB 정지 시의 동작을 가른다. Evidence: L684–L692.
- **인스턴스 수** (component): 하나면 B층 질문이 생기지 않는다. Evidence: L684–L694.
- **시계 동기** (component): 이 수치들은 106초 보정을 거친 값이다. Evidence: L684–L696.
- **적용 범위 확인** (process): 이 기록의 결론을 옮기기 전에 환경 조건을 확인한다. Evidence: L1235–L1242.
- **Keycloak 버전** (component): 26 미만이면 A층 결론 중 셋이 뒤집힌다. Evidence: L1237–L1238.
- **캐시 온도** (component): volatile의 DB 정지 결과를 바꾼다. Evidence: L1239–L1239.
- **인스턴스 수** (component): 단일 인스턴스면 B층 질문이 생기지 않는다. Evidence: L1240–L1240.
- **cookie refresh** (component): 켜면 B-7a의 TTL 역산이 성립하지 않는다. Evidence: L1241–L1241.
- **시계 동기** (component): 이 실험대 수치는 106초 왜곡 보정을 전제로 한다. Evidence: L1242–L1242.
## Relationships
- **캐시 온도 → 인스턴스 수:** 다음 조건. Evidence: L684–L694.
- **인스턴스 수 → 시계 동기:** 수치 해석. Evidence: L684–L696.
- **Keycloak 버전 → 캐시 온도:** 선행 조건. Evidence: L684–L690.
- **적용 범위 확인 → 캐시 온도:** 캐시 확인. Evidence: L1239–L1239.
- **적용 범위 확인 → 시계 동기:** 시계 확인. Evidence: L1242–L1242.
- **적용 범위 확인 → cookie refresh:** 설정 확인. Evidence: L1241–L1241.
- **적용 범위 확인 → 인스턴스 수:** 개수 확인. Evidence: L1240–L1240.
- **적용 범위 확인 → Keycloak 버전:** 버전 확인. Evidence: L1237–L1237.
docs/keycloak-session-store/final/assets/not-applicable-conditions/not-applicable-conditions.d2
+16 -8
View File
@@ -1,18 +1,26 @@
# 이 기록이 적용되지 않는 조건
# Question: 이 결론들을 언제 그대로 쓰면 안 되는가
direction: down
n0: "Keycloak 버전" {
direction: right
n0: "적용 범위 확인" {
shape: rectangle
}
n1: "캐시 온도" {
n1: "Keycloak 버전" {
shape: rectangle
}
n2: "인스턴스 수" {
n2: "캐시 온도" {
shape: rectangle
}
n3: "시계 동기" {
n3: "인스턴스 수" {
shape: rectangle
}
n0 -> n1: "선행 조건"
n1 -> n2: "다음 조건"
n2 -> n3: "수치 해석"
n4: "cookie refresh" {
shape: rectangle
}
n5: "시계 동기" {
shape: rectangle
}
n0 -> n1: "버전 확인"
n0 -> n2: "캐시 확인"
n0 -> n3: "개수 확인"
n0 -> n4: "설정 확인"
n0 -> n5: "시계 확인"
docs/keycloak-session-store/final/assets/not-applicable-conditions/not-applicable-conditions.dot
+12 -8
View File
@@ -1,12 +1,16 @@
digraph techviz {
graph [rankdir=TB, splines=ortho, nodesep=0.55, ranksep=0.85];
graph [rankdir=LR, splines=ortho, nodesep=0.55, ranksep=0.85];
node [fontname=Helvetica, fontsize=11, margin="0.18,0.12", style="rounded,filled", fillcolor=white, color="#2d4357", penwidth=1.5];
edge [fontname=Helvetica, fontsize=10, color="#364b5f", penwidth=1.4, arrowsize=0.75];
n0 [label="Keycloak 버전", shape=box, style="rounded,filled"];
n1 [label="캐시 온도", shape=box, style="rounded,filled"];
n2 [label="인스턴스 수", shape=box, style="rounded,filled"];
n3 [label="시계 동기", shape=box, style="rounded,filled"];
n0 -> n1 [label="선행 조건", style=solid];
n1 -> n2 [label="다음 조건", style=solid];
n2 -> n3 [label="수치 해석", style=solid];
n0 [label="적용 범위 확인", shape=box, style="rounded,filled"];
n1 [label="Keycloak 버전", shape=box, style="rounded,filled"];
n2 [label="캐시 온도", shape=box, style="rounded,filled"];
n3 [label="인스턴스 수", shape=box, style="rounded,filled"];
n4 [label="cookie refresh", shape=box, style="rounded,filled"];
n5 [label="시계 동기", shape=box, style="rounded,filled"];
n0 -> n1 [label="버전 확인", style=solid];
n0 -> n2 [label="캐시 확인", style=solid];
n0 -> n3 [label="개수 확인", style=solid];
n0 -> n4 [label="설정 확인", style=solid];
n0 -> n5 [label="시계 확인", style=solid];
}
docs/keycloak-session-store/final/assets/not-applicable-conditions/not-applicable-conditions.drawio
+31 -15
View File
@@ -1,35 +1,51 @@
<?xml version="1.0" encoding="UTF-8"?>
<mxfile host="app.diagrams.net" modified="2026-07-23T00:00:00.000Z" agent="techviz-harness" version="24.7.17" type="device">
<diagram id="not-applicable-conditions" name="이 기록이 적용되지 않는 조건">
<mxGraphModel dx="680" dy="670" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="827" pageHeight="1169" math="0" shadow="0">
<mxGraphModel dx="680" dy="748" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="827" pageHeight="1169" math="0" shadow="0">
<root>
<mxCell id="0"/>
<mxCell id="1" parent="0"/>
<mxCell id="n_version" value="Keycloak 버전&lt;br/&gt;A-1 · A-2 · A-8" tooltip="26 미만이면 세션의 거처가 다르다. | Evidence: L684-L690" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#d97706;fillColor=#fffdf5;" vertex="1" parent="1">
<mxGeometry x="70.0" y="60.0" width="150.0" height="71.0" as="geometry"/>
<mxCell id="n_scope" value="적용 범위 확인&lt;br/&gt;환경 전제" tooltip="이 기록의 결론을 옮기기 전에 환경 조건을 확인한다. | Evidence: L1235-L1242" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#2563eb;strokeWidth=2;" vertex="1" parent="1">
<mxGeometry x="70.0" y="346.0" width="150.0" height="71.0" as="geometry"/>
</mxCell>
<mxCell id="n_cache" value="캐시 온도&lt;br/&gt;400 · 500 · 200" tooltip="volatile 에서 DB 정지 시의 동작을 가른다. | Evidence: L684-L692" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#d97706;fillColor=#fffdf5;" vertex="1" parent="1">
<mxGeometry x="70.0" y="227.0" width="150.0" height="71.0" as="geometry"/>
<mxCell id="n_cache" value="캐시 온도&lt;br/&gt;cold · warm" tooltip="volatile의 DB 정지 결과를 바꾼다. | Evidence: L1239-L1239" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#d97706;fillColor=#fffdf5;" vertex="1" parent="1">
<mxGeometry x="406.0" y="60.0" width="150.0" height="71.0" as="geometry"/>
</mxCell>
<mxCell id="n_instances" value="인스턴스 수" tooltip="하나면 B층 질문이 생기지 않는다. | Evidence: L684-L694" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;" vertex="1" parent="1">
<mxGeometry x="70.0" y="394.0" width="150.0" height="64.0" as="geometry"/>
<mxCell id="n_clock" value="시계 동기&lt;br/&gt;NTP · 106초" tooltip="이 실험대 수치는 106초 왜곡 보정을 전제로 한다. | Evidence: L1242-L1242" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#d97706;fillColor=#fffdf5;" vertex="1" parent="1">
<mxGeometry x="406.0" y="203.0" width="150.0" height="71.0" as="geometry"/>
</mxCell>
<mxCell id="n_clock" value="시계 동기&lt;br/&gt;NTP 미동기 환경" tooltip="이 수치들은 106초 보정을 거친 값이다. | Evidence: L684-L696" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#d97706;fillColor=#fffdf5;" vertex="1" parent="1">
<mxGeometry x="70.0" y="554.0" width="150.0" height="71.0" as="geometry"/>
<mxCell id="n_cookie-refresh" value="cookie refresh&lt;br/&gt;--cookie-refresh" tooltip="켜면 B-7a의 TTL 역산이 성립하지 않는다. | Evidence: L1241-L1241" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#d97706;fillColor=#fffdf5;" vertex="1" parent="1">
<mxGeometry x="406.0" y="346.0" width="150.0" height="71.0" as="geometry"/>
</mxCell>
<mxCell id="e_c-i" value="다음 조건" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_cache" target="n_instances">
<mxCell id="n_instances" value="인스턴스 수&lt;br/&gt;1 · 2+" tooltip="단일 인스턴스면 B층 질문이 생기지 않는다. | Evidence: L1240-L1240" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;" vertex="1" parent="1">
<mxGeometry x="406.0" y="489.0" width="150.0" height="71.0" as="geometry"/>
</mxCell>
<mxCell id="n_version" value="Keycloak 버전&lt;br/&gt;persistent-user-sessions" tooltip="26 미만이면 A층 결론 중 셋이 뒤집힌다. | Evidence: L1237-L1238" style="whiteSpace=wrap;html=1;rounded=1;strokeWidth=2;fontSize=14;fontStyle=1;fillColor=#ffffff;strokeColor=#2d4357;verticalAlign=middle;strokeColor=#d97706;fillColor=#fffdf5;" vertex="1" parent="1">
<mxGeometry x="380.0" y="632.0" width="202.0" height="71.0" as="geometry"/>
</mxCell>
<mxCell id="e_scope-cache" value="캐시 확인" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_scope" target="n_cache">
<mxGeometry relative="1" as="geometry">
<mxPoint x="169.0" y="346.0" as="offset"/>
<mxPoint x="337.0" y="227.5" as="offset"/>
</mxGeometry>
</mxCell>
<mxCell id="e_i-cl" value="수치 해석" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_instances" target="n_clock">
<mxCell id="e_scope-clock" value="시계 확인" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_scope" target="n_clock">
<mxGeometry relative="1" as="geometry">
<mxPoint x="169.0" y="506.0" as="offset"/>
<mxPoint x="337.0" y="304.5" as="offset"/>
</mxGeometry>
</mxCell>
<mxCell id="e_v-c" value="선행 조건" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_version" target="n_cache">
<mxCell id="e_scope-cookie-refresh" value="설정 확인" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_scope" target="n_cookie-refresh">
<mxGeometry relative="1" as="geometry">
<mxPoint x="169.0" y="179.0" as="offset"/>
<mxPoint x="313.0" y="353.5" as="offset"/>
</mxGeometry>
</mxCell>
<mxCell id="e_scope-instances" value="개수 확인" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_scope" target="n_instances">
<mxGeometry relative="1" as="geometry">
<mxPoint x="337.0" y="458.5" as="offset"/>
</mxGeometry>
</mxCell>
<mxCell id="e_scope-version" value="버전 확인" style="edgeStyle=orthogonalEdgeStyle;rounded=0;orthogonalLoop=1;jettySize=auto;html=1;strokeWidth=2;endArrow=block;endFill=1;" edge="1" parent="1" source="n_scope" target="n_version">
<mxGeometry relative="1" as="geometry">
<mxPoint x="324.0" y="535.5" as="offset"/>
</mxGeometry>
</mxCell>
</root>
docs/keycloak-session-store/final/assets/not-applicable-conditions/not-applicable-conditions.excalidraw
+500 -164
View File
@@ -4,12 +4,12 @@
"source": "techviz-harness",
"elements": [
{
"id": "edge-c-i",
"id": "edge-scope-cache",
"type": "arrow",
"x": 145.0,
"y": 298.0,
"width": 0.0,
"height": 96.0,
"x": 220.0,
"y": 95.5,
"width": 186.0,
"height": 263.99,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
@@ -22,9 +22,9 @@
"frameId": null,
"index": null,
"roundness": null,
"seed": 1394992055,
"seed": 1276068323,
"version": 1,
"versionNonce": 1287657761,
"versionNonce": 1220407396,
"isDeleted": false,
"boundElements": [],
"updated": 0,
@@ -33,29 +33,29 @@
"points": [
[
0.0,
263.99
],
[
93.0,
263.99
],
[
93.0,
0.0
],
[
0.0,
48.0
],
[
0.0,
48.0
],
[
0.0,
96.0
186.0,
0.0
]
],
"lastCommittedPoint": null,
"startBinding": {
"elementId": "node-cache",
"elementId": "node-scope",
"focus": 0,
"gap": 4
},
"endBinding": {
"elementId": "node-instances",
"elementId": "node-cache",
"focus": 0,
"gap": 4
},
@@ -64,10 +64,10 @@
"elbowed": true
},
{
"id": "edge-label-c-i",
"id": "edge-label-scope-cache",
"type": "text",
"x": 124.0,
"y": 334.0,
"x": 292.0,
"y": 215.495,
"width": 90,
"height": 24,
"angle": 0,
@@ -84,9 +84,9 @@
"roundness": {
"type": 3
},
"seed": 845382821,
"seed": 1377282434,
"version": 1,
"versionNonce": 672350008,
"versionNonce": 374796248,
"isDeleted": false,
"boundElements": [],
"updated": 0,
@@ -94,21 +94,21 @@
"locked": false,
"fontSize": 13,
"fontFamily": 5,
"text": "다음 조건",
"text": "캐시 확인",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "다음 조건",
"originalText": "캐시 확인",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "edge-i-cl",
"id": "edge-scope-clock",
"type": "arrow",
"x": 145.0,
"y": 458.0,
"width": 0.0,
"height": 96.0,
"x": 220.0,
"y": 238.5,
"width": 186.0,
"height": 131.995,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
@@ -121,9 +121,9 @@
"frameId": null,
"index": null,
"roundness": null,
"seed": 1210090264,
"seed": 1661315952,
"version": 1,
"versionNonce": 785522718,
"versionNonce": 484719392,
"isDeleted": false,
"boundElements": [],
"updated": 0,
@@ -132,24 +132,24 @@
"points": [
[
0.0,
131.995
],
[
93.0,
131.995
],
[
93.0,
0.0
],
[
0.0,
48.0
],
[
0.0,
48.0
],
[
0.0,
96.0
186.0,
0.0
]
],
"lastCommittedPoint": null,
"startBinding": {
"elementId": "node-instances",
"elementId": "node-scope",
"focus": 0,
"gap": 4
},
@@ -163,10 +163,10 @@
"elbowed": true
},
{
"id": "edge-label-i-cl",
"id": "edge-label-scope-clock",
"type": "text",
"x": 124.0,
"y": 494.0,
"x": 292.0,
"y": 292.4975,
"width": 90,
"height": 24,
"angle": 0,
@@ -183,9 +183,9 @@
"roundness": {
"type": 3
},
"seed": 1942890601,
"seed": 1815212688,
"version": 1,
"versionNonce": 1789277168,
"versionNonce": 1657531332,
"isDeleted": false,
"boundElements": [],
"updated": 0,
@@ -193,21 +193,21 @@
"locked": false,
"fontSize": 13,
"fontFamily": 5,
"text": "수치 해석",
"text": "시계 확인",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "수치 해석",
"originalText": "시계 확인",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "edge-v-c",
"id": "edge-scope-cookie-refresh",
"type": "arrow",
"x": 145.0,
"y": 131.0,
"width": 0.0,
"height": 96.0,
"x": 220.0,
"y": 381.5,
"width": 186.0,
"height": 0.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
@@ -220,9 +220,9 @@
"frameId": null,
"index": null,
"roundness": null,
"seed": 403906410,
"seed": 651846666,
"version": 1,
"versionNonce": 92100744,
"versionNonce": 321776145,
"isDeleted": false,
"boundElements": [],
"updated": 0,
@@ -234,26 +234,26 @@
0.0
],
[
0.0,
48.0
93.0,
0.0
],
[
0.0,
48.0
93.0,
0.0
],
[
0.0,
96.0
186.0,
0.0
]
],
"lastCommittedPoint": null,
"startBinding": {
"elementId": "node-version",
"elementId": "node-scope",
"focus": 0,
"gap": 4
},
"endBinding": {
"elementId": "node-cache",
"elementId": "node-cookie-refresh",
"focus": 0,
"gap": 4
},
@@ -262,10 +262,10 @@
"elbowed": true
},
{
"id": "edge-label-v-c",
"id": "edge-label-scope-cookie-refresh",
"type": "text",
"x": 124.0,
"y": 167.0,
"x": 268.0,
"y": 341.5,
"width": 90,
"height": 24,
"angle": 0,
@@ -282,9 +282,9 @@
"roundness": {
"type": 3
},
"seed": 974844838,
"seed": 250602290,
"version": 1,
"versionNonce": 1784347194,
"versionNonce": 165026805,
"isDeleted": false,
"boundElements": [],
"updated": 0,
@@ -292,19 +292,217 @@
"locked": false,
"fontSize": 13,
"fontFamily": 5,
"text": "선행 조건",
"text": "설정 확인",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "선행 조건",
"originalText": "설정 확인",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "node-version",
"id": "edge-scope-instances",
"type": "arrow",
"x": 220.0,
"y": 392.505,
"width": 186.0,
"height": 131.995,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
"fillStyle": "solid",
"strokeWidth": 2,
"strokeStyle": "solid",
"roughness": 1,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": null,
"seed": 1099071211,
"version": 1,
"versionNonce": 820226685,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"points": [
[
0.0,
0.0
],
[
93.0,
0.0
],
[
93.0,
131.995
],
[
186.0,
131.995
]
],
"lastCommittedPoint": null,
"startBinding": {
"elementId": "node-scope",
"focus": 0,
"gap": 4
},
"endBinding": {
"elementId": "node-instances",
"focus": 0,
"gap": 4
},
"startArrowhead": null,
"endArrowhead": "arrow",
"elbowed": true
},
{
"id": "edge-label-scope-instances",
"type": "text",
"x": 292.0,
"y": 446.5025,
"width": 90,
"height": 24,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
"fillStyle": "solid",
"strokeWidth": 1,
"strokeStyle": "solid",
"roughness": 0,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 1879231622,
"version": 1,
"versionNonce": 755165061,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 13,
"fontFamily": 5,
"text": "개수 확인",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "개수 확인",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "edge-scope-version",
"type": "arrow",
"x": 220.0,
"y": 403.51,
"width": 160.0,
"height": 263.99,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
"fillStyle": "solid",
"strokeWidth": 2,
"strokeStyle": "solid",
"roughness": 1,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": null,
"seed": 1499374310,
"version": 1,
"versionNonce": 1236450050,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"points": [
[
0.0,
0.0
],
[
80.0,
0.0
],
[
80.0,
263.99
],
[
160.0,
263.99
]
],
"lastCommittedPoint": null,
"startBinding": {
"elementId": "node-scope",
"focus": 0,
"gap": 4
},
"endBinding": {
"elementId": "node-version",
"focus": 0,
"gap": 4
},
"startArrowhead": null,
"endArrowhead": "arrow",
"elbowed": true
},
{
"id": "edge-label-scope-version",
"type": "text",
"x": 279.0,
"y": 523.505,
"width": 90,
"height": 24,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
"fillStyle": "solid",
"strokeWidth": 1,
"strokeStyle": "solid",
"roughness": 0,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 168144295,
"version": 1,
"versionNonce": 1668124584,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 13,
"fontFamily": 5,
"text": "버전 확인",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "버전 확인",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "node-scope",
"type": "rectangle",
"x": 70.0,
"y": 60.0,
"y": 346.0,
"width": 150.0,
"height": 71.0,
"angle": 0,
@@ -321,9 +519,9 @@
"roundness": {
"type": 3
},
"seed": 1543082172,
"seed": 1691255577,
"version": 1,
"versionNonce": 875483992,
"versionNonce": 373117947,
"isDeleted": false,
"boundElements": [],
"updated": 0,
@@ -331,10 +529,10 @@
"locked": false
},
{
"id": "node-label-version",
"id": "node-label-scope",
"type": "text",
"x": 80.0,
"y": 70.0,
"y": 356.0,
"width": 130.0,
"height": 51.0,
"angle": 0,
@@ -351,9 +549,9 @@
"roundness": {
"type": 3
},
"seed": 611451299,
"seed": 108056688,
"version": 1,
"versionNonce": 45886077,
"versionNonce": 1888604310,
"isDeleted": false,
"boundElements": [],
"updated": 0,
@@ -361,19 +559,19 @@
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "Keycloak 버전\nA-1 · A-2 · A-8",
"text": "적용 범위 확인\n환경 전제",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "Keycloak 버전\nA-1 · A-2 · A-8",
"originalText": "적용 범위 확인\n환경 전제",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "node-cache",
"type": "rectangle",
"x": 70.0,
"y": 227.0,
"x": 406.0,
"y": 60.0,
"width": 150.0,
"height": 71.0,
"angle": 0,
@@ -402,8 +600,8 @@
{
"id": "node-label-cache",
"type": "text",
"x": 80.0,
"y": 237.0,
"x": 416.0,
"y": 70.0,
"width": 130.0,
"height": 51.0,
"angle": 0,
@@ -430,88 +628,19 @@
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "캐시 온도\n400 · 500 · 200",
"text": "캐시 온도\ncold · warm",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "캐시 온도\n400 · 500 · 200",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "node-instances",
"type": "rectangle",
"x": 70.0,
"y": 394.0,
"width": 150.0,
"height": 64.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "#ffffff",
"fillStyle": "solid",
"strokeWidth": 2,
"strokeStyle": "solid",
"roughness": 1,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 1390139487,
"version": 1,
"versionNonce": 1507856559,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false
},
{
"id": "node-label-instances",
"type": "text",
"x": 80.0,
"y": 404.0,
"width": 130.0,
"height": 44.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
"fillStyle": "solid",
"strokeWidth": 1,
"strokeStyle": "solid",
"roughness": 0,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 1251526976,
"version": 1,
"versionNonce": 1629829201,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "인스턴스 수",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "인스턴스 수",
"originalText": "캐시 온도\ncold · warm",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "node-clock",
"type": "rectangle",
"x": 70.0,
"y": 554.0,
"x": 406.0,
"y": 203.0,
"width": 150.0,
"height": 71.0,
"angle": 0,
@@ -540,8 +669,8 @@
{
"id": "node-label-clock",
"type": "text",
"x": 80.0,
"y": 564.0,
"x": 416.0,
"y": 213.0,
"width": 130.0,
"height": 51.0,
"angle": 0,
@@ -568,11 +697,218 @@
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "시계 동기\nNTP 미동기 환경",
"text": "시계 동기\nNTP · 106초",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "시계 동기\nNTP 미동기 환경",
"originalText": "시계 동기\nNTP · 106초",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "node-cookie-refresh",
"type": "rectangle",
"x": 406.0,
"y": 346.0,
"width": 150.0,
"height": 71.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "#ffffff",
"fillStyle": "solid",
"strokeWidth": 2,
"strokeStyle": "solid",
"roughness": 1,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 94156978,
"version": 1,
"versionNonce": 10439088,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false
},
{
"id": "node-label-cookie-refresh",
"type": "text",
"x": 416.0,
"y": 356.0,
"width": 130.0,
"height": 51.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
"fillStyle": "solid",
"strokeWidth": 1,
"strokeStyle": "solid",
"roughness": 0,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 927575028,
"version": 1,
"versionNonce": 281436524,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "cookie refresh\n--cookie-refresh",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "cookie refresh\n--cookie-refresh",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "node-instances",
"type": "rectangle",
"x": 406.0,
"y": 489.0,
"width": 150.0,
"height": 71.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "#ffffff",
"fillStyle": "solid",
"strokeWidth": 2,
"strokeStyle": "solid",
"roughness": 1,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 1390139487,
"version": 1,
"versionNonce": 1507856559,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false
},
{
"id": "node-label-instances",
"type": "text",
"x": 416.0,
"y": 499.0,
"width": 130.0,
"height": 51.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
"fillStyle": "solid",
"strokeWidth": 1,
"strokeStyle": "solid",
"roughness": 0,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 1251526976,
"version": 1,
"versionNonce": 1629829201,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "인스턴스 수\n1 · 2+",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "인스턴스 수\n1 · 2+",
"autoResize": true,
"lineHeight": 1.25
},
{
"id": "node-version",
"type": "rectangle",
"x": 380.0,
"y": 632.0,
"width": 202.0,
"height": 71.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "#ffffff",
"fillStyle": "solid",
"strokeWidth": 2,
"strokeStyle": "solid",
"roughness": 1,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 1543082172,
"version": 1,
"versionNonce": 875483992,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false
},
{
"id": "node-label-version",
"type": "text",
"x": 390.0,
"y": 642.0,
"width": 182.0,
"height": 51.0,
"angle": 0,
"strokeColor": "#1e1e1e",
"backgroundColor": "transparent",
"fillStyle": "solid",
"strokeWidth": 1,
"strokeStyle": "solid",
"roughness": 0,
"opacity": 100,
"groupIds": [],
"frameId": null,
"index": null,
"roundness": {
"type": 3
},
"seed": 611451299,
"version": 1,
"versionNonce": 45886077,
"isDeleted": false,
"boundElements": [],
"updated": 0,
"link": null,
"locked": false,
"fontSize": 15,
"fontFamily": 5,
"text": "Keycloak 버전\npersistent-user-sessions",
"textAlign": "center",
"verticalAlign": "middle",
"containerId": null,
"originalText": "Keycloak 버전\npersistent-user-sessions",
"autoResize": true,
"lineHeight": 1.25
}
docs/keycloak-session-store/final/assets/not-applicable-conditions/not-applicable-conditions.manifest.json
+4 -4
View File
@@ -2,14 +2,14 @@
"harness_version": "0.2.0",
"spec_id": "not-applicable-conditions",
"spec_version": "1.1",
"spec_sha256": "cc2ba91ea4096487e29444735d814ff9f8a3a0efea524d5bd74fd5c06f316626",
"spec_sha256": "d2d468176923f9f38be9c4e515901d50ac5d45084f23d506fc1c6481bc78bae2",
"source_context": {
"document": "docs/keycloak-session-store/final/document.md",
"document_sha256": "1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe",
"document_sha256": "28aef96a2bbb94fbb10ade26a71238fee62a5a4d9fa6e7749ae98cfd0a65e560",
"anchor": {
"kind": "heading",
"value": "이 기록이 적용되지 않는 조건",
"line": 689
"line": 1235
}
},
"outputs": [
@@ -21,7 +21,7 @@
"not-applicable-conditions.excalidraw",
"not-applicable-conditions.alt.md"
],
"lint_issue_count": 0,
"lint_issue_count": 1,
"assumption_count": 0,
"assumptions_allowed": false,
"composition_profile": "component-flow",
docs/keycloak-session-store/final/assets/not-applicable-conditions/not-applicable-conditions.mmd
+12 -8
View File
@@ -1,10 +1,14 @@
%% 이 기록이 적용되지 않는 조건
%% question: 이 결론들을 언제 그대로 쓰면 안 되는가
flowchart TB
n0["Keycloak 버전"]
n1["캐시 온도"]
n2["인스턴스 수"]
n3["시계 동기"]
n0 -->|"선행 조건"| n1
n1 -->|"다음 조건"| n2
n2 -->|"수치 해석"| n3
flowchart LR
n0["적용 범위 확인"]
n1["Keycloak 버전"]
n2["캐시 온도"]
n3["인스턴스 수"]
n4["cookie refresh"]
n5["시계 동기"]
n0 -->|"버전 확인"| n1
n0 -->|"캐시 확인"| n2
n0 -->|"개수 확인"| n3
n0 -->|"설정 확인"| n4
n0 -->|"시계 확인"| n5
docs/keycloak-session-store/final/assets/not-applicable-conditions/not-applicable-conditions.svg
+49 -29
View File
@@ -1,8 +1,8 @@
<?xml version="1.0" encoding="UTF-8"?>
<svg xmlns="http://www.w3.org/2000/svg" width="680" height="670" viewBox="0 0 680 670" role="img" aria-labelledby="diagram-title diagram-description">
<svg xmlns="http://www.w3.org/2000/svg" width="680" height="748" viewBox="0 0 680 748" role="img" aria-labelledby="diagram-title diagram-description">
<title id="diagram-title">이 기록이 적용되지 않는 조건</title>
<desc id="diagram-description">Keycloak 26 미만이면 persistent-user-sessions 가 기본이 아니라 A층 결론 중 셋이 뒤집힌다. volatile 에서는 캐시가 더운지 찬지가 DB 정지 시의 동작을 가른다. 인스턴스가 하나면 B층 질문 자체가 생기지 않는다. oauth2-proxy 에서 cookie-refresh 를 켜면 TTL 역산 정리 규칙이 무너진다. 그리고 이 실험대는 106초 시계 왜곡이 있었고 여기 적힌 수치는 그것을 보정한 값이다.</desc>
<metadata>{&quot;techviz&quot;:{&quot;spec_version&quot;:&quot;1.1&quot;,&quot;id&quot;:&quot;not-applicable-conditions&quot;,&quot;profile&quot;:&quot;component-flow&quot;},&quot;source_context&quot;:{&quot;document&quot;:&quot;docs/keycloak-session-store/final/document.md&quot;,&quot;document_sha256&quot;:&quot;1d44cba1905544d92f1d26ae36a8deb64a3db3914d6b488fd30d6ae7f8cfbabe&quot;,&quot;anchor&quot;:{&quot;kind&quot;:&quot;heading&quot;,&quot;value&quot;:&quot;이 기록이 적용되지 않는 조건&quot;,&quot;line&quot;:689}},&quot;evidence_policy&quot;:&quot;Each factual element cites source lines or is marked assumption.&quot;,&quot;diagram_only&quot;:true}</metadata>
<metadata>{&quot;techviz&quot;:{&quot;spec_version&quot;:&quot;1.1&quot;,&quot;id&quot;:&quot;not-applicable-conditions&quot;,&quot;profile&quot;:&quot;component-flow&quot;},&quot;source_context&quot;:{&quot;document&quot;:&quot;docs/keycloak-session-store/final/document.md&quot;,&quot;document_sha256&quot;:&quot;28aef96a2bbb94fbb10ade26a71238fee62a5a4d9fa6e7749ae98cfd0a65e560&quot;,&quot;anchor&quot;:{&quot;kind&quot;:&quot;heading&quot;,&quot;value&quot;:&quot;이 기록이 적용되지 않는 조건&quot;,&quot;line&quot;:1235}},&quot;evidence_policy&quot;:&quot;Each factual element cites source lines or is marked assumption.&quot;,&quot;diagram_only&quot;:true}</metadata>
<defs>
<marker id="arrow" viewBox="0 0 10 10" refX="9" refY="5" markerWidth="7" markerHeight="7" orient="auto-start-reverse">
<path d="M 0 0 L 10 5 L 0 10 z" />
@@ -49,36 +49,56 @@
.timeline-detail { font-size: 11px; fill: #4b5563; text-anchor: middle; }
</style>
</defs>
<rect class="canvas" width="680" height="670" />
<polyline class="edge kind-request style-solid emphasis-normal" points="145.0,298.0 145.0,346.0 145.0,346.0 145.0,394.0" data-evidence="684-694" />
<rect class="edge-label-bg" x="143.2" y="332.0" width="51.5" height="22" rx="3" />
<text class="edge-label" x="169.0" y="347.0">다음 조건</text>
<polyline class="edge kind-request style-solid emphasis-normal" points="145.0,458.0 145.0,506.0 145.0,506.0 145.0,554.0" data-evidence="684-696" />
<rect class="edge-label-bg" x="143.2" y="492.0" width="51.5" height="22" rx="3" />
<text class="edge-label" x="169.0" y="507.0">수치 해석</text>
<polyline class="edge kind-request style-solid emphasis-normal" points="145.0,131.0 145.0,179.0 145.0,179.0 145.0,227.0" data-evidence="684-690" />
<rect class="edge-label-bg" x="143.2" y="165.0" width="51.5" height="22" rx="3" />
<text class="edge-label" x="169.0" y="180.0">선행 조건</text>
<g id="node-version">
<rect class="node-shape kind-component emphasis-warning role-source" data-evidence="684-690" x="70.0" y="60.0" width="150.0" height="71.0" rx="7" />
<text class="node-label" x="145.0" y="87.0">Keycloak 버전</text>
<line class="node-detail-divider" x1="84.0" y1="108.0" x2="206.0" y2="108.0" />
<text class="node-detail" x="86.0" y="125.0">A-1 · A-2 · A-8</text>
<rect class="canvas" width="680" height="748" />
<polyline class="edge kind-request style-solid emphasis-normal" points="220.0,359.5 313.0,359.5 313.0,95.5 406.0,95.5" data-evidence="1239-1239" />
<rect class="edge-label-bg" x="311.2" y="213.5" width="51.5" height="22" rx="3" />
<text class="edge-label" x="337.0" y="228.5">캐시 확인</text>
<polyline class="edge kind-request style-solid emphasis-normal" points="220.0,370.5 313.0,370.5 313.0,238.5 406.0,238.5" data-evidence="1242-1242" />
<rect class="edge-label-bg" x="311.2" y="290.5" width="51.5" height="22" rx="3" />
<text class="edge-label" x="337.0" y="305.5">시계 확인</text>
<polyline class="edge kind-request style-solid emphasis-normal" points="220.0,381.5 313.0,381.5 313.0,381.5 406.0,381.5" data-evidence="1241-1241" />
<rect class="edge-label-bg" x="287.2" y="339.5" width="51.5" height="22" rx="3" />
<text class="edge-label" x="313.0" y="354.5">설정 확인</text>
<polyline class="edge kind-request style-solid emphasis-normal" points="220.0,392.5 313.0,392.5 313.0,524.5 406.0,524.5" data-evidence="1240-1240" />
<rect class="edge-label-bg" x="311.2" y="444.5" width="51.5" height="22" rx="3" />
<text class="edge-label" x="337.0" y="459.5">개수 확인</text>
<polyline class="edge kind-request style-solid emphasis-normal" points="220.0,403.5 300.0,403.5 300.0,667.5 380.0,667.5" data-evidence="1237-1237" />
<rect class="edge-label-bg" x="298.2" y="521.5" width="51.5" height="22" rx="3" />
<text class="edge-label" x="324.0" y="536.5">버전 확인</text>
<g id="node-scope">
<rect class="node-shape kind-process emphasis-primary role-source" data-evidence="1235-1242" x="70.0" y="346.0" width="150.0" height="71.0" rx="7" />
<text class="node-label" x="145.0" y="373.0">적용 범위 확인</text>
<line class="node-detail-divider" x1="84.0" y1="394.0" x2="206.0" y2="394.0" />
<text class="node-detail" x="86.0" y="411.0">환경 전제</text>
</g>
<g id="node-cache">
<rect class="node-shape kind-component emphasis-warning role-control" data-evidence="684-692" x="70.0" y="227.0" width="150.0" height="71.0" rx="7" />
<text class="node-label" x="145.0" y="254.0">캐시 온도</text>
<line class="node-detail-divider" x1="84.0" y1="275.0" x2="206.0" y2="275.0" />
<text class="node-detail" x="86.0" y="292.0">400 · 500 · 200</text>
</g>
<g id="node-instances">
<rect class="node-shape kind-component emphasis-normal role-control" data-evidence="684-694" x="70.0" y="394.0" width="150.0" height="64.0" rx="7" />
<text class="node-label" x="145.0" y="424.0">인스턴스 수</text>
<rect class="node-shape kind-component emphasis-warning role-target" data-evidence="1239-1239" x="406.0" y="60.0" width="150.0" height="71.0" rx="7" />
<text class="node-label" x="481.0" y="87.0">캐시 온도</text>
<line class="node-detail-divider" x1="420.0" y1="108.0" x2="542.0" y2="108.0" />
<text class="node-detail" x="422.0" y="125.0">cold · warm</text>
</g>
<g id="node-clock">
<rect class="node-shape kind-component emphasis-warning role-target" data-evidence="684-696" x="70.0" y="554.0" width="150.0" height="71.0" rx="7" />
<text class="node-label" x="145.0" y="581.0">시계 동기</text>
<line class="node-detail-divider" x1="84.0" y1="602.0" x2="206.0" y2="602.0" />
<text class="node-detail" x="86.0" y="619.0">NTP 미동기 환경</text>
<rect class="node-shape kind-component emphasis-warning role-target" data-evidence="1242-1242" x="406.0" y="203.0" width="150.0" height="71.0" rx="7" />
<text class="node-label" x="481.0" y="230.0">시계 동기</text>
<line class="node-detail-divider" x1="420.0" y1="251.0" x2="542.0" y2="251.0" />
<text class="node-detail" x="422.0" y="268.0">NTP · 106초</text>
</g>
<g id="node-cookie-refresh">
<rect class="node-shape kind-component emphasis-warning role-target" data-evidence="1241-1241" x="406.0" y="346.0" width="150.0" height="71.0" rx="7" />
<text class="node-label" x="481.0" y="373.0">cookie refresh</text>
<line class="node-detail-divider" x1="420.0" y1="394.0" x2="542.0" y2="394.0" />
<text class="node-detail" x="422.0" y="411.0">--cookie-refresh</text>
</g>
<g id="node-instances">
<rect class="node-shape kind-component emphasis-normal role-target" data-evidence="1240-1240" x="406.0" y="489.0" width="150.0" height="71.0" rx="7" />
<text class="node-label" x="481.0" y="516.0">인스턴스 수</text>
<line class="node-detail-divider" x1="420.0" y1="537.0" x2="542.0" y2="537.0" />
<text class="node-detail" x="422.0" y="554.0">1 · 2+</text>
</g>
<g id="node-version">
<rect class="node-shape kind-component emphasis-warning role-target" data-evidence="1237-1238" x="380.0" y="632.0" width="202.0" height="71.0" rx="7" />
<text class="node-label" x="481.0" y="659.0">Keycloak 버전</text>
<line class="node-detail-divider" x1="394.0" y1="680.0" x2="568.0" y2="680.0" />
<text class="node-detail" x="396.0" y="697.0">persistent-user-sessions</text>
</g>
</svg>
Side by Side Swipe Overlay

Before

Width:  |  Height:  |  Size: 6.8 KiB

After

Width:  |  Height:  |  Size: 8.3 KiB