be5d42a418
용도를 내부 문서로 못박았다. 고객 인수물이 아니므로 납품 품질 기준을 적용하지 않는다 — 감사에서 나온 한글 폰트 미번들과 영어 뷰어 UI 는 archify 한계라 spec 으로는 못 고치는데, 사내 머신에는 한글 폰트가 있으므로 low 로 내렸다. 승격 조건(그 둘이 먼저 blocker)을 PROJECT_MAP 다이어그램 절에 적어 두었다. 그 위에 두 번째 게이트를 올린다. 기존 test_diagram_sync 가 "산출물이 spec 보다 낡았나"를 본다면, test_diagram_facts 는 "spec 이 코드보다 낡았나"를 본다. 그림에는 코드에서 뽑은 상수가 라벨과 카드 문장으로 하드카피돼 있어서, SCORER_VERSION 을 올리거나 믹스인을 하나 추가하면 코드는 통과하고 그림만 조용히 틀려졌다. CLAUDE.md 가 그 값들을 규칙으로 못박아 두었는데 정작 같은 값을 그린 다이어그램에는 보호가 없었다. SCORER_VERSION · SCHEMA_VERSION · 믹스인 개수 · app-*.js 개수 · 바디 상한 · 인증 실패 10회/60초 · 프롬프트 12행 상한 · 풀 상한 60/20 · 기본 모델 · 런타임 의존성 3종 "지문 유사도 0.9+ -> 80점" 은 이름 있는 상수가 아니라 risk_scoring 안의 인라인 리터럴이라, import 대신 실제로 채점해서 확인한다. 라벨이 주장하는 값과 스코어러가 내는 값이 같은지를 직접 본다. 차단을 실증했다 — SCORER_VERSION v3->v4 로 3건, MAX_PROMPT_EVIDENCE 12->16 으로 2건이 실패한다. 영향받는 다이어그램 전부에서 잡힌다. 발견 가능성도 정리했다. 감사에서 "3.3MB 산출물이 어떤 문서 색인에도 없다"가 나왔으므로 README 색인에 등재하고, PROJECT_MAP 까지 가지 않아도 되도록 docs/diagrams/README.md 에 직접 수정 금지·재생성 명령·CSP 주의를 두었다. 검증: ruff clean, pytest 619 passed (사실 게이트 +19). Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01BStHFrjQj2VypecSG9ex1V
42 lines
2.3 KiB
Markdown
42 lines
2.3 KiB
Markdown
# 구조 다이어그램
|
|
|
|
**내부 문서다** (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)에 있다.
|