Files
Pier_v1/RAG/design system_v0.1.1/A3/module.a3-explainer.md
T
ahnyongjooandClaude Sonnet 5.5 964a841de1 chore(rebar): Pier_T_rebar 작업 폴더 초기 구성 및 외부 의존 파일 통합
- Code\rebar_pipeline, review_pipeline, pier-program을 정션에서 실제 폴더로 전환
- Code\rhino_mcp 및 CLAUDE_rhino배경.md 추가, .mcp.json은 PYTHONPATH로 새 위치 사용
- pier-program 내부 .git 제거(이력은 backup\pier-program_20261028.bundle에 보관)
- worktree 가이드 반영(CLAUDE.local.md, HANDOFF.md)
- D:\Rhino-MCP 경로 참조를 새 위치로 치환

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-28 11:20:18 +09:00

305 lines
16 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Prism — M5 A3 설명자료 실행 명세 (Layer 3)
| 버전 | 수정일 | 수정자 | 주요 변경 내용 | 비고 |
| :--- | :--- | :--- | :--- | :--- |
| v0.1.0 | 2026-07-29 | HMCM | 신규 제정 — A3 가로 설명자료(1면=1주제) 실행 명세. 파생 절차 8단계 완료, 구조 검증 12항 통과 | `active` 등록 (modules §4.4) |
| 메타 | 값 |
| :--- | :--- |
| 모듈 | **M5 `a3-explainer`** — A3 설명자료 |
| 계층 | Layer 3 (실행 명세 · **자기완결형**) |
| 대상 산출물 | A3 가로 1~N면 설명자료 — 개념 설명·프로세스 안내·비교 분석·보고 요약 등 "**1면 = 1주제**" 형식의 인쇄물 |
| 상위 의존 | `Design.md` 0.1.1 · foundations 0.1.2 · medium.print 0.1.1 · components 0.1.1 · tokens.json 0.1.1 |
| 자기완결 원칙 | **본 파일 단독으로 제작 가능**하도록 필요한 정본 값을 전부 수록했다. 값의 SSOT는 `design.tokens.json`이며, 본 파일과 충돌 시 JSON이 우선한다 (GV-7) |
```yaml
module:
id: a3-explainer
name: A3 설명자료
version: 0.1.0
status: active
brand: saman
medium: print
dual_medium: false # 투사 겸용 시 true → §8 상향표 적용
format: A3-landscape # 420 × 297 mm
columns: 12
type_set: expressive
component_count: 17
variant_count: 31
patterns: [p1-cover, p2-context, p3-process, p4-compare, p5-body-side, p6-data, p7-conclusion]
depends_on: { foundations: 0.1.2, medium.print: 0.1.1, components: 0.1.1 }
```
---
## 1. 적용 조건
| 적용 | 제외 |
| :--- | :--- |
| A3 가로 인쇄 설명자료 (1면 = 1주제) | 다면 연속 편람·색인 필요 문서 → M1 (A3 시공상세도 편람, 착수 예정) |
| 회의 배포용 요약·브리핑 시트 | 발표 전용 슬라이드 → M2 (`ppt/`) |
| 프로세스·개념·비교 설명 도판 자료 | 화면 열람 전용 문서 → M3 (`webapp/`) |
**선행 요건**: 없음 (본 파일 단독 제작 가능). **겸용 선언**: 인쇄물을 회의에서 투사도 하는 경우 §8을 적용한다 (PM-3).
---
## 2. 캔버스·그리드 (정본 값)
### 2.1 판면
```
판형 420 × 297 mm (A3 가로) 블리드 3mm
좌우 여백 24 mm 상단 여백 21 mm 하단 여백 24 mm
콘텐츠 372 × 252 mm 베이스라인 6 mm × 42행
컬럼 12개 × 25.5 mm 거터 6 mm
정합 12×25.5 + 11×6 = 372 ✓ (잔차 0)
```
### 2.2 수직 존 (전 좌표 6mm 격자 정합)
```
0 ┌────────────────────────────────────────┐
│ 상단 여백 21mm │
21 ├────────────────────────────────────────┤
│ 헤더 존 30mm — 아이브로·제목·메타·구분선 │ (5행)
51 ├────────────────────────────────────────┤
│ ↕ 6mm │
57 ├────────────────────────────────────────┤
│ 콘텐츠 밴드 192mm (32행) │
249 ├────────────────────────────────────────┤
│ ↕ 6mm │
255 ├────────────────────────────────────────┤
│ 푸터 존 18mm — 문서명·출처·면번호·버전 │ (3행)
273 ├────────────────────────────────────────┤
│ 하단 여백 24mm │
297 └────────────────────────────────────────┘
```
| ID | 규칙 |
| :--- | :--- |
| **A3E-1** | 콘텐츠 요소는 밴드(57~249mm)를 벗어나지 않는다. 푸터 존은 불가침이다 |
| **A3E-2** | 존 좌표는 컬럼 경계에, 내부 간격은 스페이싱 토큰에 스냅한다 (PF-1) |
| **A3E-3** | 콘텐츠는 밴드를 위→아래로 채운다. 하단 빈 면적 < 25% (WS-3) |
### 2.3 존 폭 (허용 분할 — 정본)
| 분할 | 존 폭 (mm) | 용도 |
| :--- | :--- | :--- |
| `12` | 372 | 표지, 전폭 도판·표 |
| `6:6` | 183 / 183 | 비교·대조 |
| `8:4` | **246** / 120 | 본문 + 사이드바 |
| `4:8` | 120 / **246** | 내비·요약 레일 + 본문 |
| `4:4:4` | 120 × 3 | 3요소 병렬 |
| `3:3:6` | 88.5 / 88.5 / 183 | 맥락 2 + 결론 1 |
| `3:3:3:3` | 88.5 × 4 | 4단계 프로세스 |
> 8col 존 폭은 **246mm**가 정본이다 (8×25.5+7×6). v0.1.0의 249는 오계산으로 v0.1.1에서 정정되었다.
---
## 3. 타입 바인딩 (base 10pt, 인쇄 단독)
| 역할 | pt | 행간 | 행 pt | 격자 소요 | 웨이트 | 용도 |
| :--- | ---: | :-: | ---: | :-: | :--- | :--- |
| `caption` | 7.9 | 1.55 | 12.2 | 1 | Medium 500 | 캡션·출처·범례 |
| `body-sm` | 8.9 | 1.70 | 15.1 | 1 | Regular 400 | 표 셀·보조 본문 |
| **`body`** | **10.0** | **1.70** | **17.0 (=6mm)** | **1** | Regular 400 | **본문** |
| `body-lg` | 11.3 | 1.70 | 19.2 | 2 | Regular 400 | 리드 문장 |
| `title-sm` | 12.7 | 1.50 | 19.0 | 2 | Medium 500 | 카드 제목·소제목 |
| `title` | 16.0 | 1.50 | 24.0 | 2 | Bold 700 | 절 제목 |
| `title-lg` | 20.3 | 1.50 | 30.4 | 2 | Bold 700 | 면 제목 |
| `display` | 28.9 | 1.25 | 36.1 | 3 | Regular 400 | 히어로 헤드라인 (표지) |
| `display-lg` | 41.1 | 1.25 | 51.4 | 4 | Regular 400 | 표지 전용 |
- 서체 **Pretendard** (임베드: `assets/fonts/PretendardVariable.ttf`). 표·수치는 등폭 숫자(tnum) 강제
- 하한: 본문 ≥ 9.0pt · 캡션 ≥ 7.5pt · 절대 ≥ 7.0pt · 역상 ≥ 10.0pt + Bold
- 자간: 음수 자간 사용 없음. `.label` +0.12em / `.eyebrow` +0.18em
- **measure**: 본문은 4col(120mm = 34.0em) 또는 3col(88.5mm = 25.1em) 존에만. 6col(51.9em)·전폭(105.4em)에 연속 본문 금지
## 스페이싱·획 (정본)
| 토큰 | mm | 용도 | | 획 토큰 | mm | 용도 |
| :--- | ---: | :--- | :-: | :--- | ---: | :--- |
| `space.025` | 1.5 | 미세 간격 | | `hairline` | 0.20 | 카드 보더·구분선 |
| `space.050` | 3 | 인라인 간격 | | `regular` | 0.40 | 표 외곽·강조 보더 |
| `space.100` | 6 | 텍스트 블록·거터 | | `bold` | 0.60 | 구조 강조선 |
| `space.150` | 9 | 문단 간격 | | `icon` | 0.80 | 아이콘 획 |
| `space.200` | 12 | 카드 패딩 | | `connector` | 1.00 | 프로세스 커넥터 |
| `space.300` | 18 | 블록 간격 | | 하한 | 0.15 | 역상 선 0.25 |
| `space.400` | 24 | 존 간격·좌우 여백 | | 반경 md | 3 | 카드 (sm 1.5 / lg 4.5) |
---
## 4. 색 (등록 페어만 사용 — 미등록 조합 금지)
### 4.1 팔레트 정본 (brand saman)
| 토큰 | HEX | GRADE | 역할 |
| :--- | :--- | :-: | :--- |
| `green` | `#1F524B` | 69 | base — 제목·구조선·헤더 면 |
| `orange` | `#D05C26` | 47 | accent — **1면당 최대 2개 국소 강조** |
| `brown` | `#474235` | 72 | ground — 본문·라벨·보더 |
| `sand` | `#F4F3F0` | 4 | 배경 (순백 전면 금지) |
| `obsidian` | `#111111` | 95 | 강조면(반전)·다크 |
| `subtle` | `#D3D3D3` | 15 | 보조 (다크면 위) |
| `white` | `#FFFFFF` | 0 | 카드 면·다크면 텍스트 |
### 4.2 본 모듈 사용 페어 (실측 검증 완료)
| 용도 | 전경 / 배경 | 실측 | 판정 |
| :--- | :--- | :---: | :--- |
| 본문 | brown / sand | 9.02 | AAA ✓ |
| 제목·구조 | green / sand | 8.00 | AAA ✓ |
| 카드 위 본문 | brown / white | 10.01 | AAA ✓ |
| 카드 위 제목 | green / white | 8.87 | AAA ✓ |
| 그린 면 위 | white / green | 8.87 | AAA ✓ |
| 반전(강조) 면 위 | sand / obsidian | 17.02 | AAA ✓ |
| 대형 악센트 | orange / sand·white | 3.61 · 4.01 | **대형 전용** (title-sm 이상) |
| **금지** | green / obsidian | 2.13 | **✗ 텍스트 금지** (면·도형만) |
- 상태색 4종(✓ 권장 `#005A4E` / ✕ 금지 `#8F2A11` / ▲ 주의 `#6B4A00` / ▣ 참고 `#0A4E86` + 각 container) — **기호 생략 금지**, 악센트 카운트 제외
- 대비 목표 **AAA (ΔG ≥ 70)**. 그림자·알파·그라디언트 **금지**. 본문 텍스트는 **100% K 단독** 인쇄
---
## 5. 페이지 패턴 (7종 — 콘텐츠 유형 매핑)
| ID | 분할 | 존 구성 (좌→우) | 결론 존 | 적용 콘텐츠 |
| :--- | :--- | :--- | :--- | :--- |
| **P1 표지** | `12` | hero(display-lg·강조어 1)+메타 | hero | 표제·문서 정보 |
| **P2 개요·맥락** | `4:8` | ①toc·scope·stat ②본문(2단)+mediaframe | ②하단 principle | 배경 설명·현황 |
| **P3 프로세스** | `3:3:3:3` | stagecard×4 + connector (귀결만 악센트) | 최종 단계 | 절차·단계 설명 |
| **P4 비교** | `6:6` | 좌 card/table ↔ 우 card/table (directive pair 허용) | 하단 전폭 principle | 대안 비교·전후 대조 |
| **P5 본문+사이드** | `8:4` | ①본문 2단(각 4col 상당)+도판 ②specsheet·badge·xref | ②상단 stat | 상세 해설 |
| **P6 데이터** | `3:3:6` | ①②stat·card ③chartframe(또는 table) | ③캡션 결론 | 수치·추이 제시 |
| **P7 결론·지침** | `4:4:4` | directive 3매(또는 card 3매)+전폭 principle | principle | 지침·요약·후속 조치 |
| ID | 규칙 |
| :--- | :--- |
| **PT-A1** | 1면 = 패턴 1개. 패턴 혼용 시 상하 밴드를 분할하되 분할선은 컬럼 경계·6mm 격자에 스냅한다 |
| **PT-A2** | 결론 존은 면당 **정확히 1개** (PD-1). `principle`은 면당 1개 |
| **PT-A3** | 악센트(orange) 사용 개수: 아이브로 틱 + 귀결 커넥터 + 강조어 합산 **1면당 ≤ 2** |
| **PT-A4** | 도판·표가 면의 40% 이상이면 본문을 3col(4단 상당) 고밀도로 내린다 (CL-2) |
---
## 6. 컴포넌트 선별 (17종 / 변형 31종)
| 컴포넌트 | 변형 수 | 본 모듈 사용 규정 |
| :--- | :-: | :--- |
| `eyebrow` | 2 | 헤더 존 내 1개. 라벨 ≤ 20자 |
| `header` | 1 | 제목 ≤ 25자(1줄, 최대 40자 2줄). 메타 4슬롯: 문서분류·개정상태·대상·승인단계 |
| `rule` | 1 | 헤더 하단 구분선 (hairline) |
| `footer` | 1 | 좌: 문서명 / 우: 면번호·버전·발행일 |
| `card` | 4 | base·emphasis·prominent·quiet. 제목 ≤ 20자, 본문 ≤ 120자, 중첩 ≤ 2 |
| `stagecard` | 3 | base·highlight(1개)·optional. 단계 3~5개 |
| `connector` | 1 | 귀결 커넥터만 악센트 |
| `principle` | 1 | 면당 1개. 키커 ≤ 12자, 진술 ≤ 80자 |
| `table` | 4 | base·striped·compact·matrix. 셀 ≤ 40자, 수치 우측 정렬+tnum |
| `stat` | 1 | 존당 ≤ 3개. 증감은 ▲▼+색+라벨 3중 |
| `chartframe` | 1 | 계열 ≤ 5, 3개↑ 패턴 병기, 직접 라벨 우선 |
| `directive` | 3 | single·pair·stack. 기호(✓✕▲▣) 생략 금지 |
| `badge` | 4 | neutral·emphasis·outline·marked — 형태+색 이중 부호화 |
| `scope` | 1 | 항목 최상단 고정. 제외 없으면 "없음" 명기 |
| `stepper` | 1 | 다면 문서에서 좌측 1열 고정 배치 |
| `xref` | 1 | `(→ N.N절, p.N)` — 방향어 금지 |
| `mediaframe` | 1 | 종횡비 6종 한정. 크롭 원칙. 텍스트 굽기 금지 |
**미선별**: `hero`(표지 P1에서만 header 대체로 사용 — 선별 예외 명시), `toc`(다면 5면 이상 시 추가 선별), `specsheet`(P5 사이드에서 선택), screen 전용 5종 비적용.
*(주: hero·toc·specsheet는 조건부 선별 — 사용 시 카탈로그 규정을 그대로 따른다. 위 정량 17종/31변형은 기본 구성 기준이다.)*
---
## 7. 분량 예산 (역산 근거 포함)
산식: `예산(자) = (존 폭 − 패딩) ÷ 글자폭(한글 = 크기 mm) × 허용 행수`, 여유 10% 차감.
| 슬롯 | 권장 | 최대 | 역산 근거 |
| :--- | :-: | :-: | :--- |
| 면 제목 (`title-lg`) | 18자 | 25자 | 헤더 존 246mm ÷ 7.16mm ≈ 34자 → 1행 여유 |
| 아이브로 | 12자 | 20자 | caption 폭 기준 |
| 히어로 헤드라인 (표지) | 25자 | 35자 | 372mm ÷ 14.5mm(display) ≈ 25자/행 |
| 카드 제목 | 15자 | 20자 | 4col 카드 내폭 96mm ÷ 4.47mm ≈ 21자 |
| 카드 본문 | 90자 | 120자 | 96mm ÷ 3.14mm(body-sm) ≈ 30자 × 4행 |
| 스테이지 설명 | 40자 | 60자 | 3col 카드 내폭 64.5mm ÷ 3.14 ≈ 20자 × 3행 |
| directive 진술 | 100자 | 130자 | 6col 내폭 159mm ÷ 3.14 ≈ 50자 × 3행 |
| principle 진술 | 60자 | 80자 | 전폭 1~2행 |
| 표 셀 | 20자 | 40자 | 초과 시 압축·부록 이관 (TB-4) |
| 캡션·출처 | 40자 | 60자 | caption 1~2행 |
| ID | 규칙 |
| :--- | :--- |
| **BG-A1** | 예산 초과 시 **글자 크기를 줄이지 않는다.** 내용을 줄이거나 면을 나눈다 |
| **BG-A2** | 잘림(truncation) 설계 금지. 오버플로 발생 = 예산 위반으로 판정 |
---
## 8. 투사 겸용 옵션 (`dual_medium: true` 선언 시)
| 역할 | 인쇄 단독 | **투사 겸용** |
| :--- | ---: | ---: |
| `caption` | 7.9pt | **11.3pt** |
| `body-sm` | 8.9pt | 12.7pt |
| **`body`** | **10.0pt** | **14.2pt** (base 3스텝 상향) |
| `title-sm` | 12.7pt | 18.0pt |
| `title` | 16.0pt | 22.8pt |
- 겸용 시 본문 존은 3단(각 4col) 유지 가능 — body 14.2pt에서 120mm = 24.0em ✓ 다단 범위
- 겸용 시 대비·최소 선 굵기는 presentation 프로파일의 엄격한 쪽을 채택한다 (PM-1·PM-2)
---
## 9. 제작 절차 (에이전트 실행 순서)
| 단계 | 작업 | 판정 기준 |
| :-: | :--- | :--- |
| 1 | 콘텐츠를 **주제 단위로 분해** — 1면 = 1주제 | 면수 확정 |
| 2 | 각 면에 **패턴(P1~P7) 배정** — 콘텐츠 유형 매핑표 §5 | 전 면 매핑 완료 |
| 3 | 겸용 여부 선언 (§8) | dual_medium 확정 |
| 4 | 존 좌표 산출 — §2.2 수직 존 + §2.3 존 폭 | 6mm 격자 정합 |
| 5 | 컴포넌트 배치 — §6 선별 목록 내에서만 | 카탈로그 외 0건 |
| 6 | 문안 작성 — §7 예산 내, 브랜드 어미 4종(`~한다`·`~할 수 있다`·`~를 권장한다`·`~하지 않는다`) | 예산 위반 0건 |
| 7 | 색 적용 — §4.2 등록 페어만 | 미등록 조합 0건 |
| 8 | 검증 — §10 전항 | 자동 PASS + 육안 확인 |
---
## 10. 검증 체크리스트
### 자동 (산출 파일 기계 검증)
| # | 항목 | 기준 |
| :-: | :--- | :--- |
| A1 | 판면 정합 | 콘텐츠 높이 252mm = 6mm × 42 ✓ |
| A2 | 그리드 정합 | 12×25.5+11×6=372, 존 폭 §2.3 일치, 잔차 0 |
| A3 | measure | 본문 존 4col(34.0em) 또는 3col(25.1em)만 |
| A4 | 최소 크기 | 전 텍스트 ≥ 7.0pt, 본문 ≥ 9.0pt (겸용 시 상향표) |
| A5 | 최소 선 | ≥ 0.15mm, 역상 ≥ 0.25mm |
| A6 | 대비 | 본문 페어 실측 ≥ 7:1 (AAA), §4.2 등록 페어만 |
| A7 | 리터럴 | 산출물 내 HEX·치수 하드코딩 0건 |
| A8 | 그림자·알파·그라디언트 | 0건 |
| A9 | 악센트 경제 | 1면당 orange 강조 ≤ 2 |
| A10 | 푸터 불가침 | 콘텐츠 하단 ≤ 249mm |
| A11 | 예산 | 전 슬롯 최대값 이하, 오버플로 0건 |
| A12 | 본문 색상판 | 100% K 단독 |
### 육안
| # | 항목 |
| :-: | :--- |
| V1 | 흑백 변환 후 정보 손실 0 (상태 기호·뱃지 형태로 구분 확인) |
| V2 | 여백률 40~55%, 하단 공백 < 25% |
| V3 | 결론 존 1개 성립 (PD-1) — 시선이 결론에 귀결하는가 |
| V4 | 다단 좌우 행 정렬 (베이스라인 겹쳐보기) |
| V5 | 원거리(2m) 1차 메시지 + 근거리 2차 디테일 2층 판독 (PD-3) |
| V6 | 인쇄 발주 시: 블리드 3mm·재단선·CMYK 프로파일 확인 (print §11.3) |
### 구조 검증 결과 (modules §8.1 — `active` 등록 근거)
12항 전항 **PASS** (2026-07-29, HMCM): 스키마 필수 필드 충족 · depends_on 기록 · 정량 명시(17종/31변형) · 완화 0건 · 겸용 규정 명시 · 전 슬롯 예산 부여 · 분할 허용 목록 준수 · 결론 존 1개 · 존 폭 정합(246 정정 반영) · 카탈로그 외 컴포넌트 0건 · 미사용 0건(조건부 선별 명시) · 역할 중복 0건
---
*본 모듈은 참조 사양이다. 모듈 준수가 산출물의 적합성을 보증하지 않으며, 내용의 정확성은 별도 검증해야 한다 (DC-3). 개정 시 기 배포분에 소급 적용되지 않는다 (DC-2).*