Files
document-haness/docs/clean-architecture-backend-template/final/evidence/meta/a05-f026-enqueue.json
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

15 lines
3.0 KiB
JSON

{
"assetKey": "a05-f026-enqueue",
"kind": "terminal",
"command": "Q=adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/fileserver/JpaRecoveryQueue.java\nR=adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/fileserver/repository/FileserverRecoveryRepository.java\nV=adapter/outbound/persistence-jpa/src/main/resources/db/migration/jpa/fileserver/V2__fileserver_recovery_and_staging_cleanup.sql\nE=adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/fileserver/entity/RecoveryItemEntity.java\nT=adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/transaction/SpringTransactionPort.java\n\necho '# javadoc 은 넣기를 upsert 로 정의한다'\ngrep -n '' \"$Q\" | sed -n '19,22p'\necho '# 저장소 javadoc 은 최신 이유가 이긴다고 적는다'\ngrep -n '' \"$R\" | sed -n '24,30p'\n\necho\necho '# 구현은 갱신하고, 0 이면 저장한다'\ngrep -n '' \"$Q\" | sed -n '42,50p'\necho '# 그 저장이 persist 로 갈지 merge 로 갈지 정하는 것'\necho -n '# 엔티티의 @Version 필드: '\ngrep -c '@Version' \"$E\"\necho -n '# Persistable 구현: '\ngrep -c 'Persistable' \"$E\"\n\necho\necho '# 데이터베이스가 파일당 열린 항목을 하나로 강제한다'\ngrep -n -B1 -A3 'CREATE UNIQUE INDEX uq_fs_recovery_open' \"$V\"\n\necho\necho '# 호출자가 실제로 받는 예외'\ngrep -n -A9 'private <T> T executeLegacy' \"$T\"\ngrep -n '\"23505\"' adapter/outbound/persistence-jpa/src/main/java/dev/caskeleton/adapter/outbound/persistence/failure/StandardSqlStateErrorMapping.java\n\necho\necho '# 이 넣기를 부르는 프로덕션 코드와 그 경계'\ngrep -rn 'recoveryQueue\\.enqueue(' --include=*.java --exclude-dir=build . | grep '/main/' | sed 's|^\\./||'\nsed -n '318,326p' application-core/src/main/java/dev/caskeleton/application/fileserver/upload/DefaultFinalizeUploadService.java\necho -n '# 조정 쪽 진입점을 부르는 프로덕션 코드: '\ngrep -rn 'reconcileRecoverable(' --include=*.java --exclude-dir=build . | grep '/main/' | grep -vc 'FileReconciliationService.java\\|DefaultFileReconciliationService.java'\necho '# 조정이 집어 올리는 대상의 조건'\ngrep -n 'STALE_AFTER' application-core/src/main/java/dev/caskeleton/application/fileserver/recovery/DefaultFileReconciliationService.java\n\necho\necho '# 같은 저장소가 승패를 데이터베이스에 물어보는 자리'\ngrep -rn 'ON CONFLICT' --include=*.java --include=*.sql --exclude-dir=build . | grep -i 'do nothing' | sed 's|^\\./||' | head -3",
"cwd": "/shared/codebase/clean-architecture-backend-template/src",
"exitCode": 0,
"executedAt": "2026-09-02T05:03:14+00:00",
"sourceRevision": "21234e38cdb9a926cbc92bb97a2aee2e4a7d2916",
"raw": "evidence/raw/a05-f026-enqueue.txt",
"svg": "evidence/rendered/a05-f026-enqueue.svg",
"rawSha256": "e986fdaf7ef26fd4e383c697a66bed13250aea7be7c29c5c91abe51a1c8d39a6",
"lines": 69,
"redaction": "none — 코드베이스 정적 검색"
}