Files
document-haness/docs/clean-architecture-backend-template/tech-log-studio/declaration-and-document-drift/reference/reference-messaging-schema-api-f03.md
T
DongHyeonkaandClaude Opus 5 b2963105a8 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

1.8 KiB

kind, slug, title, topic, project, status, sourceRevision, rootTreeNode, verifiedOn, source
kind slug title topic project status sourceRevision rootTreeNode verifiedOn source
REFERENCE messaging-schema-api-f03 도달성 판정은 단어가 아니라 import로 확인한다 declaration-and-document-drift clean-architecture-backend-template 게시 전 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916 reference:messaging-schema-api-f03
analysis/messaging/messaging-schema-api.md#L512

도달성 판정은 단어가 아니라 import로 확인한다

관계

  • 포맷 독립 진화 규칙이 호출되지 않고, 그것이 막으려던 중복이 실제로 생겼다 이 규칙의 근거는 같은 분석 리프의 판정이 소유한다.

목적

이 저장소에서 실제로 오탐이 났다. 단어 검색이 SchemaRegistry 2건을 맞췄고 둘 다 다른 타입이었다. 사람이 같은 실수를 한다.

규칙

  1. 같은 단순 이름이 여러 패키지에 있는지 먼저 확인한다 dev.caskeleton.messaging.schema.SchemaRegistry(이 leaf 의 port)와 com.networknt.schema.SchemaRegistry(JSON Schema 라이브러리)가 공존하고, 실제로 import 되는 것은 후자뿐이다.

  2. 판정은 import 문으로 한다 git grep -n 'import .*.SchemaRegistry;' -- src 가 그 판정을 준다.

  3. 이름 충돌 자체는 고치지 않아도 된다 충돌을 없애는 것보다 판정 방법을 고정하는 것이 싸다.

적용 조건

타입 참조 수를 세어 도달성·미사용을 판정하는 모든 조사.

예외

단순 이름이 저장소 안에서 유일하다고 확인된 경우에는 단어 검색으로 충분하다. 그 확인 자체가 이 규칙의 첫 단계다.

예시

evidence/raw/272 §C 의 검색 결과와 두 패키지의 공존.