DongHyeonkaandClaude Opus 5
b2963105a8
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>
2.8 KiB
kind, slug, title, topic, project, status, sourceRevision, rootTreeNode, questionStatus, verifiedOn
| kind | slug | title | topic | project | status | sourceRevision | rootTreeNode | questionStatus | verifiedOn |
|---|---|---|---|---|---|---|---|---|---|
| QUESTION | v2-state-machine-lanes-not-executed | V2 상태 기계 넷의 컨테이너 레인이 실행되지 않았다 | owner-safe-state-machines | clean-architecture-backend-template | 게시 전 | 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916 | open-question:v2-state-machine-lanes-not-executed | OPEN |
V2 상태 기계 넷의 컨테이너 레인이 실행되지 않았다
소유자 안전 상태 기계의 불변식은 실제 데이터베이스에서만 확인된다. 그 레인들을 이 리비전에서 돌리지 않았다.
사실
상태 기계 넷의 CAS 문장과 결정 트리를 코드로 확인했다.
리스 펜싱 마이그레이션과 그 제약을 확인했다.
이 컨테이너에 Docker 가 있고 기본 test 레인은 전부 돌았다. persistence-jpa 는 477 테스트가 통과했다.
특수 레인과 릴리스 게이트 태스크는 돌리지 않았다.
가정
기본 test 레인이 통과했으므로 상태 기계의 단위 수준 동작은 검증되었다고 전제하고 있다. 그러나 경합과 리스 만료는 단위 테스트에서 재현되지 않는 경우가 많다.
미지수
실제 PostgreSQL 에 대고 두 작업자가 같은 행을 경합할 때 CAS 튜플이 의도대로 동작하는가.
리스 만료 구간에서 인계와 조정 요구가 결정 트리대로 갈리는가.
펜싱 토큰이 밀려난 작업자의 최종 쓰기를 실제로 0 건으로 만드는가.
제약
컨테이너가 필요하다.
major 버전마다 별도 잡으로 나눠 돌려야 한다. 다중 선택은 거부된다.
애플리케이션 소스를 수정하지 않는다.
선택지
상태 기계 레인을 개별로 돌린다 실패를 격리하기 좋다.
릴리스 게이트를 돌려 한 번에 확인한다 게이트의 조립까지 함께 검증되지만 실패 지점을 좁히는 데 시간이 더 든다.
다음 검증
persistence-jpa 의 상태 기계 관련 컨테이너 레인을 실행하고 종료 코드와 실패 목록을 기록한다. 릴리스 게이트를 함께 돌리면 다른 미해결 질문도 같이 닫힌다.
레인이 통과하면 이 질문을 닫는다.
실패가 나오면 각각이 새 Case 후보가 되고, 그 실패가 CAS 튜플의 문제인지 리스 판정의 문제인지 구분해 기록한다.
관계
- 컨테이너가 필요한 특수 레인의 실제 결과를 실행으로 확인하지 않았다 이 질문의 상위 항목이다.
- CAS 튜플과 update count가 답이 되는 구조 이 질문이 검증하려는 메커니즘이다.
- 만료된 CLAIMED는 takeover하고 만료된 EXECUTING은 조정을 요구하도록 갈랐다 이 질문이 검증하려는 결정 트리다.