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>
47 lines
2.9 KiB
Plaintext
47 lines
2.9 KiB
Plaintext
# README 가 스스로 정한 세 축과 그 증거
|
|
| 축 | 뜻 | 증거 |
|
|
| --- | --- | --- |
|
|
| **API 구현** | 타입·정책·contract test가 존재한다 | `:adapter:outbound:cache-redis:test` |
|
|
| **Spring composition 구현** | `APP_REDIS_ENABLED=true`에서 실제 bean이 조립된다 | `RedisSdkAutoConfigurationTest` |
|
|
| **실서버 qualification** | 지원 topology·버전에서 실제 서버로 증명됐다 | `redisTopologyTest` lane evidence |
|
|
|
|
# 준비도 표
|
|
| Capability | API 구현 | Spring composition 구현 | 실서버 qualification |
|
|
| --- | --- | --- | --- |
|
|
| Redis SDK typed API (`…cache.redis.sdk`) | 있음 | settings bind + validate 까지만 | 없음 |
|
|
| Topology client / connection lifecycle | 없음 | 없음 | 없음 |
|
|
| cache / session / idempotency / rate limit / lease semantic port | 없음 | 없음 | 없음 |
|
|
| role-aware health·readiness contributor | 없음 | 없음 | 없음 |
|
|
|
|
# 표 아래 두 문단
|
|
즉 현재 `APP_REDIS_ENABLED=true`가 하는 일은 `RedisSdkSettings`를 bind하고 cross-field 규칙을
|
|
fail-fast로 검증하는 것까지다. client, connection, gateway, semantic adapter, health contributor는
|
|
아직 조립되지 않는다. 남은 단계와 순서는
|
|
`docs/superpowers/plans/2026-08-10-redis-optionality-and-composition.md`에 있다.
|
|
readiness registry에도 `selected` card가 없으므로 Redis R2 release claim은 없다. 아래 절들은
|
|
이전 세대 semantic adapter 세트의 설계 결정을 기록한 것이며, 그 코드는 현재 이 leaf에 없다.
|
|
복구 범위는 위 plan의 Phase E가 소유한다.
|
|
|
|
# 세 줄 뒤 같은 README 의 산문
|
|
모듈은 Lettuce connection lifecycle,
|
|
finite command timeout, reconnect replay 차단, finite request queue/admission, positive/negative
|
|
TTL, absolute soft/hard expiry, deterministic bounded TTL jitter, digest-protected v2 binary
|
|
envelope, HMAC physical key,
|
|
invalidation, closed-catalog
|
|
`EVALSHA -> NOSCRIPT -> SCRIPT LOAD -> digest verify -> EVALSHA` recovery를 제공한다.
|
|
`app.cache.redis.client-mode=external`이면 프로젝트가 제공한 `RedisClient` 호환 경로를 사용하고
|
|
managed connection을 생성하지 않는다.
|
|
|
|
# 둘째 열의 증거로 지목된 시험이 단언하는 것
|
|
context -> {
|
|
assertThat(context).hasNotFailed();
|
|
assertThat(context).hasSingleBean(RedisSdkSettings.class);
|
|
RedisSdkSettings settings = context.getBean(RedisSdkSettings.class);
|
|
assertThat(settings.isEnabled()).isTrue();
|
|
assertThat(settings.getNodes()).containsExactly("redis-a:6379");
|
|
assertThat(context).hasSingleBean(RedisRuntimeClient.class);
|
|
assertThat(context.getBean(RedisRuntimeClient.class).mode())
|
|
.isEqualTo(RedisDeploymentMode.STANDALONE);
|
|
assertThat(context).hasSingleBean(RedisRuntimeOwner.class);
|
|
assertThat(settings.getNamespace().getEnvironment()).isEqualTo("prod");
|