6017750bae
첫 실측이 보인 원인은 축 예산의 합(245 vs 상한 100)이었다. 캡 없는 두 축만 캡하는 시뮬레이션(80/50, 60/40)으로는 20/20 이 그대로 100 이라 총합 기준으로 다시 짰다. 예산: 등록 권리 대상 일치 80(단독 high) · 웹 존재 40(검색결과 사본 유사도·Vision 매치· CSE 페이지가 제공자 무관 한 풀, 뷰 강도로만 40/30/10) · 인물 30/10 · 이름 있는 검색 승격 15 · 라벨 10 → 등록 제외 최대 95. 외부 검색 실패는 +30/행 가산 대신 medium 하한. 검색결과 사본 행은 knowledge_entry_id 부재 + url/source_evidence_ids 로 웹 풀에 간다. 격자 432: high 92→75%, 포화 80→44%(남은 포화는 전부 등록 강한 일치 조합), 웹 신호만 high 13/24→0/24. 실이미지 20장 리스코어: 100점 20→0, 구별 점수 1→4(75/80/92/95), 밴드는 전부 high 유지(전부 웹에 있는 인물 사진 — medium/low 임계는 여전히 미검증). 다이어그램 spec 3종 v5 + 재생성(archify 2.17). operator-review-workflow 는 새 desktop-readability 검사에 HEAD 그대로 걸려 노드 폭 132→124 로 통과시켰고, 그 확대로 1440x900 세로 13px 넘침이 남는다(visual-check containment) — INDEX 에 기록. verify.ps1: ruff clean, 654 passed. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01BStHFrjQj2VypecSG9ex1V |
||
|---|---|---|
| .. | ||
| evidence-dataflow.dataflow.json | ||
| evidence-dataflow.html | ||
| manifest.json | ||
| operator-review-workflow.html | ||
| operator-review-workflow.workflow.json | ||
| README.md | ||
| submission-lifecycle.html | ||
| submission-lifecycle.lifecycle.json | ||
| system-architecture.architecture.json | ||
| system-architecture.html | ||
구조 다이어그램
내부 문서다 (2026-09-21 결정). 고객 인수물이 아니므로 납품 품질 기준을 적용하지 않는다 — 한글 폰트 미번들과 영어 뷰어 UI 가 부채 표에서 low 인 이유가 이것이다. 인수물로 승격한다면 그 둘이 먼저 blocker 가 된다.
| 파일 | 내용 | 타입 |
|---|---|---|
system-architecture.html |
시스템 구성. 폐쇄망 경계와 그 밖의 외부 검색 API | architecture |
evidence-dataflow.html |
증거 데이터 흐름. 라운드트립 불변식이 중심 | dataflow |
operator-review-workflow.html |
운영자 심사 4레인. 비상 차단 시 경로 포함 | workflow v2 |
submission-lifecycle.html |
제출물 상태 전이. 분석으로 되돌아오는 두 고리 | lifecycle |
.html 을 직접 고치지 않는다
소스는 같은 폴더의 spec JSON 이다. HTML 은 archify deliver 산출물이라 다음 재생성에서
조용히 덮인다. 고칠 것은 언제나 JSON 이고, 재생성은 스크립트 하나다 (저장소 루트에서 실행):
.\scripts\rebuild-diagrams.ps1 # validate -> deliver -> visual-check -> manifest
.\scripts\rebuild-diagrams.ps1 -SkipVisualCheck # 브라우저 없는 호스트
이 계약은 말이 아니라 테스트가 강제한다 — HTML 을 손으로 고치면
tests/test_diagram_sync.py 의 sha256 대조에서 verify.ps1 이 실패한다.
열람
file:// 로 연다. 운영자 콘솔의 static_root 로 서빙하면 app-shell CSP
(script-src 'self', http_app.py:514)가 인라인 스크립트를 차단해 그림은 뜨되
테마 전환·Export·가이드 뷰가 죽는다. 서빙이 필요하면 CSP 완화가 아니라 별도
라우트에서 nonce 정책을 쓴다.
재생성 요구사항 (문서 전용, 런타임 아님)
Node 18+ 와 archify 스킬($env:ARCHIFY_HOME, 기본값 ~/.claude/skills/archify),
visual-check 단계에만 Chrome/Chromium. 폐쇄망 타깃에는 필요 없다.
산출 당시 generator 는 manifest.json 에 기록된다. 스킬 버전이 바뀌면 같은 spec 에서도
바이트가 달라지므로, 해시가 깨졌을 때 코드 변경과 툴 변경을 구분하는 근거가 된다.
자세한 부채 목록은 PROJECT_MAP 의 다이어그램 절과 부채 표에 있다.