994852d920
8/8 실효성 평가가 "남은 것: 신뢰출처 판정 자체. 목록만 정해지면
cleared_reference 와 같은 패턴으로 바로 붙는다"로 남겨둔 항목이다. 전제였던
"호스트가 저장 시점에 파괴되는" 문제는 9/18 에 고쳤고, 저장 위치는 지식DB 로
정해졌다.
지식DB 의 trusted_host 항목 — 이름이 호스트, 별칭이 같은 주체의 다른 도메인
신뢰 철회는 기존 활성/비활성 수명주기 그대로 (두 번째 스위치를 만들지 않는다)
핵심은 **행 단위 제외**라는 것이다. 케이스 단위로 끄면 자사 사본이 있다는
이유로 스크래퍼 게시까지 덮인다. 실측: 우리 CDN 완전일치 + 블로그 게시가 같이
있을 때 신뢰 등록 전 80/high, 등록 후 35/medium — 블로그만 남는다.
제외된 행은 점수에서 빠지되 사유로는 남는다("신뢰 출처 posar.info — 위험
점수에서 제외"). 증거 목록에는 그 행이 그대로 보이므로, 왜 점수가 증거보다
조용한지 운영자에게 말해주지 않으면 도구를 불신하게 된다.
경계 처리:
서브도메인은 같은 주체다 (cdn.posar.info)
posar.info.evil.test 는 접미사가 아니라 다른 도메인이다
점 없는 값은 무시한다 — "com" 하나가 웹 전체를 신뢰 처리하면 안 된다
엔티티 라벨은 영향 없다 — "어디에 떠 있나"가 아니라 "무엇이 찍혔나"다
신선한 CSE 행은 host 키가 없어 domain(displayLink)에서 해석한다
호스트 해석이 store_serialization._result_host 와 따로 사는 이유는 층 때문이다.
analysis 는 server 를 import 할 수 없고, 한쪽은 값을 영속화하고 다른 쪽은
운영자 목록과 대조한다. 우선순위는 같게 맞추고 그 사실을 양쪽 주석에 적었다.
빈 목록이면 v3 과 동작이 같다. 등록하지 않은 배포는 아무것도 달라지지 않는다.
다이어그램 사실 게이트(9/21 신설)가 v3 -> v4 를 3개 다이어그램에서 자동으로
잡았다. 스펙을 고치고 rebuild-diagrams.ps1 로 재생성했다 — 게이트의 첫 실사용이고
의도대로 동작했다.
검증: ruff clean, pytest 632 passed (스코어러 7건 + 스토어 3건 추가).
Co-Authored-By: Claude Opus 5 (1M context) <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 의 다이어그램 절과 부채 표에 있다.