# 구조 다이어그램

**내부 문서다** (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 이고, 재생성은 스크립트 하나다 (저장소 루트에서 실행):

```powershell
.\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 의 다이어그램 절과 부채 표](../PROJECT_MAP.md)에 있다.