Files
Pier_v1/RAG/design system_v0.1.1/A3/module.a3-handbook.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

178 lines
11 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 — M1 A3 시공상세도 편람 실행 명세 (Layer 3)
| 버전 | 수정일 | 수정자 | 주요 변경 내용 | 비고 |
| :--- | :--- | :--- | :--- | :--- |
| v0.1.0 | 2026-07-29 | HMCM | 신규 제정 — `design.modules.md §4.2` 착수 예정 스텁을 완전 실체화. 파생 절차 8단계 완료, 구조 검증 12항 통과 | `draft` → **`active`** 전환 |
| 메타 | 값 |
| :--- | :--- |
| 모듈 | **M1 `a3-handbook`** — A3 시공상세도 편람 |
| 계층 | Layer 3 (실행 명세 · **자기완결형**) |
| 대상 산출물 | A3 가로 다면 **편람** — 시공상세도 편람·기술 매뉴얼·기준서 등 **열람·참조용** 장(章) 구조 문서 |
| 상위 의존 | `Design.md` 0.1.2 · foundations 0.1.2 · medium.print 0.1.2 · components 0.1.1 · tokens.json 0.1.1 |
| M5와의 구분 | M5(`module.a3-explainer.md`)는 **1면=1주제 설명자료**, 본 모듈은 **장·절·색인을 갖춘 다면 편람**이다. 색인·상호참조·러닝헤드가 장식이 아니라 기본 인프라다 |
```yaml
module:
id: a3-handbook
name: A3 시공상세도 편람
version: 0.1.0
status: active
brand: saman
medium: print
dual_medium: false # 회의 투사 겸용 시 true → M5 §8 상향표 준용
format: A3-landscape # 420 × 297 mm
columns: 12
type_set: compact # 고밀도·참조형 (M5 expressive와 구분)
component_count: 19
variant_count: 33
patterns: [h1-tobira, h2-chapter-toc, h3-item, h4-item-dense, h5-table, h6-figure, h7-appendix]
overrides_strict:
- contrast_target: AAA # print 기본과 동일 (완화 아님)
- color_encoding: dual # 흑백 복사 빈발 → 형태+색 이중 부호화 전면 강제
depends_on: { foundations: 0.1.2, medium.print: 0.1.2, components: 0.1.1 }
```
---
## 1. 적용 조건
| 적용 | 제외 |
| :--- | :--- |
| 시공상세도 편람·기술 매뉴얼 (다면·장 구조·상시 개정) | 1~수 면 설명자료 → M5 (`A3/module.a3-explainer.md`) |
| 장별 부분 개정·차환(loose-leaf)이 필요한 기준서 | A4 보고서·지침서 → M6 (`A4/module.a4-document.md`) |
| 색인·용어집·상호참조가 필요한 참조 문서 | 발표 자료 → M2 (`ppt/`) |
**선행 자산**: 구 `temp/Design system_v0.1.0.md`(A3 Astryx)의 Pattern A/B/C·Item 1~10 매핑은 콘텐츠 자산으로 **패턴 배정 단계(§9-2)에서 재활용**한다.
---
## 2. 판면·그리드 (정본 값)
기하는 M5와 동일한 A3 가로 정본을 쓴다: **420×297mm · 여백 좌우 24/상 21/하 24 · 콘텐츠 372×252mm · 12col×25.5mm · 거터 6mm · 베이스라인 6mm×42행** · 존 폭 12→372 / 8→**246** / 6→183 / 4→120 / 3→88.5mm.
### 편람 고유 — 러닝헤드·러닝풋 (여백 영역)
| 요소 | 위치 | 내용 | 크기 |
| :--- | :--- | :--- | :--- |
| **러닝헤드** | 상단 여백 내 (베이스라인 y=15mm) | 좌면(verso): **장 제목** / 우면(recto): **절 제목** · 단면 인쇄 시 한 줄 병기 | `caption` 7.9pt `.label` 톤 |
| **러닝풋** | 하단 여백 내 (y=282mm) | **`<장>-<면>`** 페이지 번호 + 문서 버전 + 발행일 | `caption` 7.9pt |
| ID | 규칙 |
| :--- | :--- |
| **HB-1** | 장 도비라·부록 표지에는 러닝헤드를 넣지 않는다 (RH-4) |
| **HB-2** | 콘텐츠(21~273mm)는 러닝헤드·풋 영역을 침범하지 않는다 |
| **HB-3** | 양면 제본 시 안쪽 여백에 제본 여유 3~9mm를 가산한다 (MG-5) — 두께에 따라 결정하고 문서화한다 |
---
## 3. 타입·색 (정본 승계)
- **타입**: M5 §3과 동일 (base 10pt·행간 1.70·베이스라인 6mm 정합). **Compact 세트** — 본문면은 `title-sm`·`title` 중심, `display` 계열은 도비라 전용
- **본문 measure**: 기본 **3단**(4col 존 120mm = 34.0em) / 도판·표 40% 이상 면은 **4단**(3col 존 88.5mm = 25.1em) (CL-2)
- **색**: M5 §4와 동일 (등록 페어만, AAA, 본문 100% K). `color_encoding: dual` 강화 — **모든 구분 표기에 형태·기호 병기**(개정 뱃지는 `marked` 변형 필수)
- **각주**: 인쇄 매체이므로 허용 — 해당 면 하단, 절 단위 연속 번호, `caption` + hairline 구분선 (FN-1~4)
---
## 4. 편람 구조 (본 모듈의 지배 규정)
### 4.1 페이지 번호 · 절 번호
| 항목 | 규정 |
| :--- | :--- |
| 페이지 번호 | **`<장>-<면>`** (예: `3-15`). 장마다 1부터 재시작. 전권 통합 번호 병기 금지 (PN-1~3) — **장 단위 차환 개정**을 위한 장치 |
| 앞붙이 | 로마숫자 소문자 i, ii, iii (PN-4) |
| 부록 | `부록A-1` 형식 (PN-5) |
| 절 번호 | **ISO 2145** — 아라비아 숫자, 마침표 구분, **최종 번호 뒤 마침표 금지**(`3.7.4` ✓), 최대 4단계, 그 이하 가·나·다/①②③ (SN-1~6) |
| 상호참조 | **`(→ 3.4절, p.3-27)`** — 절 번호 + 면수 병기. 방향어 금지 (XR-1·XR-2) |
| 표·그림 번호 | `[표 3-4]` `[그림 3-4]` 장별 번호 (XR-3) |
### 4.2 색인·용어집 (정량 기준)
| 항목 | 기준 |
| :--- | :--- |
| 색인 총 항목 수 | 본문 면수의 **약 2배** |
| 면당 참조 수 | 5~6개 · 색인 분량 전체의 약 5% |
| 하위 항목 전환 | 한 표제어 면 번호 **6개 초과 시** 분할 |
| 표제어 출처 | 본문 장·절 제목에서 도출 |
| 용어집 | 가나다순 · 이표기 병기 + 정식 표기 지정 · 초출 위치 상호참조 · **전문용어 초출 정의율 100%** |
### 4.3 서문 필수 문구
- "본 편람은 **참조 사양**이며, 개정 시 기 시공분·기 배포분에 **소급 적용되지 않는다**" (DC-1·DC-2)
- "본 편람 준수가 **현장 적합성을 보증하지 않는다**" (DC-3)
---
## 5. 페이지 패턴 (7종)
| ID | 분할 | 구성 | 결론 존 | 적용 |
| :--- | :--- | :--- | :--- | :--- |
| **H1 장 도비라** | `12` | hero(장 번호+장 제목, display) + 장 개요 3~5행. 러닝헤드 없음 | hero | 장 시작 |
| **H2 장 목차면** | `4:8` | ①toc(절 목차+면수 병기, 2단계) ②장 적용 범위 scope + 개정 이력 badge | ② scope | 장 첫 면 (CH-1) |
| **H3 표준 항목면** | `4:4:4` | scope(상단 전폭) → 본문 3단 → **specsheet(항목 말미 고정)** | principle 또는 directive | 일반 항목 (기본형) |
| **H4 고밀도 항목면** | `3:3:3:3` | 본문 4단 — 도판·표 40% 이상 시 | 동일 | 도판·표 밀집 항목 |
| **H5 표 지배면** | `12` | 전폭 표(헤더 매 면 반복·"(계속)" 표기) + 하단 주석 | 표 캡션 | 수량·기준표 |
| **H6 도판 해설면** | `8:4` | ①mediaframe(크롭 원칙) ②해설·specsheet·xref 레일 | ② 상단 | 상세도 해설 |
| **H7 부록** | `12` 또는 `4:8` | 도면·양식·참고자료. 러닝헤드 없음(표지), `부록A-N` 번호 | — | 부록 |
| ID | 규칙 |
| :--- | :--- |
| **PT-H1** | 모든 항목은 **scope(적용/제외 조건)로 시작**하고 **specsheet(수치 명세)로 끝난다** — 위치 고정 (SC-1·SS-1) |
| **PT-H2** | 항목은 절 경계에서만 면을 나눈다. 표는 행 중간 분절 금지 (TB-2), 위도우·오펀 회피 (PG-1·PG-2) |
| **PT-H3** | 다면 절차에는 stepper를 **좌측 1열 고정** 배치한다 |
| **PT-H4** | 면 넘침 처리 순서: 분량 압축 → 단수 조정(3→4단) → 절 경계 면 분할 → 접지(최후). **body 크기 축소는 선택지에 없다** (print §9.5) |
---
## 6. 컴포넌트 선별 (19종 / 변형 33종)
`eyebrow`(2) · `header`(1) · `rule`(1) · `footer`(1) · `card`(4) · `stagecard`(3) · `connector`(1) · `principle`(1) · `table`(4) · `stat`(1) · `chartframe`(1) · **`specsheet`(1)** · `directive`(3) · `badge`(4) · `scope`(1) · `toc`(1) · `stepper`(1) · `xref`(1) · `mediaframe`(1)
**미선별**: `hero`(H1 도비라에서만 — print 조건부 △, 카탈로그 매트릭스 준수), screen 전용 5종.
편람 고유 규정: `badge`는 개정 구분(유지/보완/갱신/대체/신규)에 **`marked` 변형(기호 부착) 필수** — 색상만으로 구분 금지 (선행 Astryx 결함 재발 방지) · `specsheet` 열 구성은 전권 동일 (SS-2) · `header` 메타 4슬롯: 도면 분류·개정 상태·적용 공종·승인 단계.
---
## 7. 분량 예산
| 슬롯 | 권장 | 최대 | 근거 |
| :--- | :-: | :-: | :--- |
| 장 제목 (도비라 display) | 10자 | 18자 | 전폭 1행 |
| 절 제목 (`title`) | 15자 | 28자 | 명사형, 어미 통일 (§5.2 헤딩 규칙) |
| 항목 제목 (`title-sm`) | 12자 | 20자 | 4col 존 1행 |
| 본문 문단 | 3문장 | 5문장 | 브랜드 CW-1, 문장 ≤ 40어절 |
| 표 셀 | 20자 | 40자 | 초과 시 압축 + 원문 부록 이관 (TB-4) |
| specsheet 항목값 | 15자 | 25자 | 값 없음 `—` / 해당 없음 `N/A` |
| directive 진술 | 100자 | 130자 | M5 승계 |
| 캡션·각주 | 40자 | 60자 | caption 1~2행 |
| 색인 표제어 | 8자 | 12자 | 2열 색인면 기준 |
---
## 8. 검증 체크리스트 (총 76항 체계)
Layer 1 자동 9 + 육안 7 · print 자동 16(P1~P16) + 육안 10(Q1~Q10) · 컴포넌트 14 · 모듈 구조 12 + 산출 10 = **자동 37 / 육안 39**. 아래는 편람 고유 추가 판정 항목이다.
| # | 편람 고유 항목 | 기준 |
| :-: | :--- | :--- |
| HV1 | 페이지 번호 체계 | 전 면 `<장>-<면>`, 장별 재시작, 통합 번호 병기 0건 |
| HV2 | ISO 2145 | 최종 하위 번호 뒤 마침표 0건 (Word 자동 번호 서식 주의) |
| HV3 | 상호참조 유효성 | 전 참조의 절 번호·면수 실재 (샘플이 아니라 전수) |
| HV4 | 색인 정량 | 항목 수 ≈ 면수×2 · 분량 ≈ 5% · 6개 초과 표제어 분할 |
| HV5 | scope·specsheet 위치 | 전 항목 상단/말미 고정 100% |
| HV6 | 러닝헤드 | 도비라·부록 표지 제외 전 면 존재, verso/recto 정합 |
| HV7 | 개정 뱃지 | `marked` 변형 100% — 흑백 복사 후 판별 시험 |
| HV8 | 면책 문구 | 서문 DC-1~DC-3 수록 |
| HV9 | 발주 전 | 인쇄소 프로파일 확인 → CMYK 등록 → 교정쇄 승인 → 블리드·재단선 (print §11.3) |
### 구조 검증 결과 (modules §8.1 — `active` 전환 근거)
12항 전항 **PASS** (2026-07-29, HMCM): 스키마 충족 · depends_on 기록 · 정량 명시(19종/33변형 — §4.2 스텁의 TBD 확정) · `overrides_strict` 완화 0건(AAA 동일 + dual 강화) · 전 슬롯 예산 · 패턴-콘텐츠 매핑(H1~H7) · 분할 허용 목록 준수 · 결론 존 1개/면 · 존 폭 정합(246 정정 반영) · 카탈로그 외 0건 · 미사용 0건(hero 조건부 명시) · 역할 중복 0건
---
*본 모듈은 참조 사양이다 (DC-3). 편람 내용의 기술적 정확성·법규 적합성·현장 적합성은 별도 검증해야 한다.*