cw2007/POSA_Copyrighter
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
POSA_Copyrighter/docs/diagrams
History
changukyu 29534f441a docs: 심사 가이드 다이어그램 — archify workflow 5번째, 운영자 관점의 심사 절차 
docs/operations/review-guide.md 의 6단계를 3레인(읽기·근거 확인 / 판정 / 기준 DB 에 남는 것)
workflow 로: 한 줄 요약 → 점수 구성 → 증거 열기 → 근거 표시 → 판정 → 다음 미심사.
분기는 미수행 하한(보류 후 재분석)과 판정 뒤 DB(주의 후보 자동 · 클리어 기준 등록 수동).

첫 안은 4레인·3항목 카드로 1440x900 에서 127px 넘쳐 레인 병합·제목 한 줄·카드 2항목으로
압축했고, 노드 폭 148 로 높이 예산(종횡비 1.52)을 맞췄다. validate 9/9 showcase,
visual-check 4개 뷰포트 containment pass, manifest 5종 갱신. rebuild 스크립트·manifest
갱신기 목록에 등록, PROJECT_MAP 표 추가. 문서·다이어그램만 변경.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01BStHFrjQj2VypecSG9ex1V
2026-09-23 19:51:54 +09:00
..
evidence-dataflow.dataflow.json feat: 스코어러 v6 — 외부 검색 미수행(일일 한도)의 조용한 통과를 막는다 2026-09-22 11:06:58 +09:00
evidence-dataflow.html feat: 스코어러 v6 — 외부 검색 미수행(일일 한도)의 조용한 통과를 막는다 2026-09-22 11:06:58 +09:00
manifest.json docs: 심사 가이드 다이어그램 — archify workflow 5번째, 운영자 관점의 심사 절차 2026-09-23 19:51:54 +09:00
operator-review-workflow.html feat: 스코어러 v6 — 외부 검색 미수행(일일 한도)의 조용한 통과를 막는다 2026-09-22 11:06:58 +09:00
operator-review-workflow.workflow.json feat: 스코어러 v6 — 외부 검색 미수행(일일 한도)의 조용한 통과를 막는다 2026-09-22 11:06:58 +09:00
README.md test: 코드↔그림 리터럴 드리프트 게이트, 다이어그램을 내부 문서로 확정 2026-09-21 11:32:12 +09:00
review-guide.html docs: 심사 가이드 다이어그램 — archify workflow 5번째, 운영자 관점의 심사 절차 2026-09-23 19:51:54 +09:00
review-guide.workflow.json docs: 심사 가이드 다이어그램 — archify workflow 5번째, 운영자 관점의 심사 절차 2026-09-23 19:51:54 +09:00
submission-lifecycle.html feat: 스코어러 v5 — 축 예산을 총합 기준으로 재배분, 실이미지 100점 포화 20/20 → 0/20 2026-09-22 10:31:53 +09:00
submission-lifecycle.lifecycle.json docs: 다이어그램 4종 세트 완성, 범례 한글화 2026-09-19 00:34:51 +09:00
system-architecture.architecture.json feat: 스코어러 v6 — 외부 검색 미수행(일일 한도)의 조용한 통과를 막는다 2026-09-22 11:06:58 +09:00
system-architecture.html feat: 스코어러 v6 — 외부 검색 미수행(일일 한도)의 조용한 통과를 막는다 2026-09-22 11:06:58 +09:00

README.md

구조 다이어그램

내부 문서다 (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 의 다이어그램 절과 부채 표에 있다.