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>
This commit is contained in:
co-authored by
Claude Opus 5
parent
43bccd08a8
commit
b2963105a8
@@ -72,7 +72,8 @@ docs/<프로젝트>/
|
||||
├── state.json 분석 상태 — 어디까지 봤나, 어느 리비전을 봤나
|
||||
├── source-index.md 분석한 코드의 목록
|
||||
├── analysis/ 모듈·서브시스템 단위 분석. 큰 저장소는 여기서 누적한다
|
||||
├── root-tree.md 글감 분해 계약 (선택 — json 을 쓰면 없어도 된다)
|
||||
│ 한 모듈을 끝까지 읽은 결과를 한 편으로 둔다
|
||||
├── notes/ · checkpoints/ 분석 중에 남긴 메모와 중간 저장
|
||||
├── final/ SSOT — 이 프로젝트에 대해 아는 것 전부
|
||||
│ ├── document.md 상세한 글
|
||||
│ ├── assets/ svg, drawio, 그림
|
||||
@@ -83,11 +84,18 @@ docs/<프로젝트>/
|
||||
│ ├── rendered/ raw 에서 만든 터미널 SVG (표현물)
|
||||
│ └── browser/ 브라우저 캡처 (Playwright MCP)
|
||||
└── tech-log-studio/ Studio 에 올릴 글만
|
||||
├── tech-log-tree.json 글감 목록. 항상 최신으로 둔다
|
||||
├── root-tree.md 사람이 쓴 분해 계약 — SSOT 의 sha256 을 물고 있다
|
||||
├── candidate-ledger.json · root-tree-source-manifest.json
|
||||
├── tech-log-tree.json 위에서 파생한 색인. 기록을 고치면 다시 만든다
|
||||
├── _meta/ 편집·검증 이력
|
||||
└── <주제 slug>/
|
||||
├── case/ concept/ reference/ question/ decision/
|
||||
```
|
||||
|
||||
**분해 계약이 정본이고 `tech-log-tree.json` 은 색인이다.** `root-tree.md` 는 글감마다 readiness·
|
||||
source anchor·classification·missing-verification 을 사람이 적는 자리이고, json 은 기록 파일을
|
||||
읽어 지금 상태를 비추는 것이다. 둘이 어긋나면 `root-tree.md` 가 맞다.
|
||||
|
||||
`final/` 이 정본이고 `tech-log-studio/` 는 거기서 뽑아낸 글이다. 증거는 `final/evidence/` 에만
|
||||
두고 기록에서는 그 파일을 가리킨다. 같은 파일을 양쪽에 두지 않는다.
|
||||
|
||||
@@ -147,9 +155,10 @@ Redis 20편은 한 글을 나눠 쓴 것이라 `docs/clean-architecture-backend-
|
||||
|---|---|
|
||||
| `ca-tmpl` | 실행 가능한 클린 아키텍처 — 선언이 아니라 빌드가 지키는 경계 |
|
||||
| `keycloak` | 브라우저 토큰에서 엣지 세션까지: Keycloak 인증 패턴 네 가지의 경계 설계 |
|
||||
| `keycloak-session-store` | 세션은 어디에 있는가 — Keycloak 다중 노드 실험 26건의 기록. `keycloak` 이 남긴 열린 질문 네 개에 측정으로 답한다 |
|
||||
| `n+1liner` | 하이라이트 피드 조회 성능 — N+1 진단과 조회 전략의 진화 |
|
||||
| `TechLog` | 계약이 먼저인 시스템에서 값이 사라지는 자리들 — TechLog를 만들며 만난 결함의 전수 기록 |
|
||||
| `clean-architecture-backend-template` | Redis를 정책 경계로 다루는 코드 (20편을 합침) |
|
||||
| `clean-architecture-backend-template` | 62개 leaf를 23편으로 읽은 통합 분석 · 기록 949건 |
|
||||
|
||||
## 검사
|
||||
|
||||
|
||||
Reference in New Issue
Block a user