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.6 KiB
2.6 KiB
kind, slug, title, topic, project, status, sourceRevision, rootTreeNode, verifiedOn
| kind | slug | title | topic | project | status | sourceRevision | rootTreeNode | verifiedOn |
|---|---|---|---|---|---|---|---|---|
| REFERENCE | local-with-a-different-db-is-a-different-system | 로컬이 다른 DB면 로컬 테스트는 다른 시스템에 대한 진술이다 | schema-ownership-and-capability-streams | clean-architecture-backend-template | 게시 전 | 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916 | reference:local-with-a-different-db-is-a-different-system |
로컬이 다른 DB면 로컬 테스트는 다른 시스템에 대한 진술이다
목적
로컬에서 초록불이라는 사실을 배포 대상에 대한 증거로 읽는 것을 막는다.
규칙
-
로컬 데이터베이스가 다르면 결과도 다른 시스템의 것이다 방언과 타입 매핑과 제약 처리와 잠금 동작이 다르다.
-
스키마를 엔티티에서 만드는 구성은 스키마 불일치를 원리적으로 발견하지 못한다 생성 소스와 검증 소스가 같으면 어긋날 수 없다.
-
실제 데이터베이스에 대한 레인을 별도로 둔다 그 레인이 없으면 이 계열의 결함은 배포 시점에 처음 나타난다.
-
로컬 설정이 값을 덮어쓰면 기본값의 결함이 로컬에서 보이지 않는다 기본값을 검증하는 경로가 따로 필요하다.
-
어느 결함이 어느 환경에서만 보이는지 기록한다 그 정보가 다음 사람이 레인을 고를 때 쓰인다.
적용 조건
로컬과 배포 대상의 데이터베이스가 다른 모든 프로젝트
프로파일별로 설정 기본값이 덮이는 구성
예외
데이터베이스에 의존하지 않는 순수 로직 테스트는 이 규칙의 대상이 아니다.
예시
고정 길이와 가변 길이 컬럼 타입 불일치가 실제 PostgreSQL 검증에서 기동 실패를 냈고, 로컬이 H2 로 도는 동안에는 보이지 않았다. H2 구성은 엔티티에서 스키마를 만들므로 엔티티와 어긋날 수 없다.
풀 커넥션 타임아웃 기본값의 형식 오류가 prod 와 dev 배포를 전부 실패시켰고 로컬만 통과했다. 로컬 프로파일 파일이 그 값을 덮어쓴다.
관계
- char(64)와 varchar(64) 불일치를 H2가 가리고 있었다 이 규칙을 만든 사례다.
- connection-timeout이 5s 문자열로 출하되어 prod와 dev 배포가 전부 시작에 실패했다 네 번째 규칙의 사례다.
- 컨테이너가 필요한 특수 레인의 실제 결과를 실행으로 확인하지 않았다 실제 데이터베이스 레인의 현재 상태에 대한 질문이다.