건설산업 DX의 올바른 이해
+배경
[꼭지1] 용어의 혼용 — 문제제기 · intro
•**용어의 혼용** 건설산업의 디지털 전환 논의에서 DX(Digital Transformation)와 BIM(Building Information Modeling)이 개념적으로 명확히 정립되지 않은채 혼용되어 사용되고 있음 이로인해 BIM기술의 도입을 DX의 완성으로 오인하거나
•DX를 BIM 기술 도입 수준으로 한정하는 인식 확산
[꼭지4] 혼용 대표 사례 — 근거사례 · supporting
•**[스마트 건설 활성화 방안(2022.07)]** 추진과제 : 건설산업 디지털화 실행과제 : BIM 전면 도입
•BIM 전문인력 양성 **[제7차 건설기술진흥 기본계획(2023.12)]** 추진방향 : 디지털 전환을 통한 스마트 건설 확산 추진과제 : BIM 도입으로 건설산업 디지털화
본심
[꼭지2] 용어 정의 — 정의정립 · core
•* **건설산업** * 다양한 시설물을 각 산업마다의 광범위한 기술을 통합 및 융합하여 만들어내는 종합산업 * 목적 시설물의 품질 욕구를 충족시키면서 최단기간내에 최소 비용으로 편리하고 안전하며 우수한 성능의 시설물 완성을 목표로 함 * **BIM(Building Information Modeling) : 디지털 전환을 위한 핵심 기술** * 시설물의 생애주기동안 발생한 모든 정보를 3차원 모델 기반으로 통합·관리하는 정보 관리 도구 * 건설 정보와 절차를 표준화된 방식으로 연계하고 디지털 협업이 가능하도록 하는 핵심 인프라 기술
+
+
+
\ No newline at end of file
diff --git a/docs/run-001/05-execution/steps/stage_1_5b.html b/docs/run-001/05-execution/steps/stage_1_5b.html
new file mode 100644
index 0000000..5bb273f
--- /dev/null
+++ b/docs/run-001/05-execution/steps/stage_1_5b.html
@@ -0,0 +1,16 @@
+
+
+•color: '#999'
•marginTop: '5px'
•lineHeight: '1.4'
•paddingLeft: '0px' }}> *건설산업 BIM 기본지침
•국토교통부
•2020* * **DX(Digital Transformation) : 산업 패러다임의 변화** * 디지털 기술을 기반으로 산업 전반의 업무방식과 가치 창출 구조를 전환하는 과정 및 결과 * 단순한 기술 도입이 아닌
•고객 가치와 의사결정 방식의 근본적인 변화로 산업의 새로운 방향을 정립하는 것을 의미함
+•color: '#999'
•marginTop: '5px'
•lineHeight: '1.4'
•paddingLeft: '0px' }}> *Digital Transformation
•IBM Institute for Business Value
•2011 / What is Digital Transformation?
•Agile Elephant
•2015*
[꼭지3] 용어간 상호관계 — 관계설명 · core
•* DX는 BIM과 같은 디지털기술을 기반으로 산업 전반의 프로세스를 혁신하는 상위개념 * 건설산업의 DX는 GIS(공간정보)
•BIM
•디지털 트윈(가상환경)의 기술융합을 통해서만 실현 또는 구현 가능 * GIS의 역할 : 지리적 데이터를 공간 분석하여 시각적으로 표현
•위치기반 정보 제공 * BIM의 역할 : 형상정보와 내용정보가 포함된 3D모델로
•건설 정보 기반의 Process와 Product를 제공 
•color: '#999'
•marginTop: '5px'
•lineHeight: '1.4'
•paddingLeft: '0px' }}> *[그림 1] DX와 핵심기술간 상호관계*
첨부
[꼭지5] DX와 BIM의 구분 — 비교근거 · supporting
•| DX | 구분 | BIM | | :--- | :---: | ---: | | **BIM << DX** (Engineering + Management 통합) | **범위** | **Only 3D** (형상 구현 중심) | | **제작 및 운영**(상용 + 전용 40~80개) [Rhino
•Sketchup
•Blender..] + [EG-BIM 등] | **S/W** | **모델 제작용 상용 SW** [Revit
•Civil 3D
•Navisworks
•Autocad] | | **근본적 문제의식을 통한 개선** | **프로세스** | **기존 2D 설계 방식 유지** | | **공학 정보 및 콘텐츠 연계에 집중** **도면
•수량
•시공계획 등 일식** | **성과품** | **3D 모델 중심** **기존 성과품 유지** | | **설계/시공 생산성 혁신**(개념의 재정립) | **활용** | **3D 모델에 의한 일반적 이해 향상** | | **전 생애주기 활용 시스템** | **확장성** | **(설계/시공/운영) 분야별 단절** | | **구체화(복잡) - 적극적/구체적 실현 방안** | **수행 개념** | **단순화(오류) - 수동적/집단적 동질화** | | **적극적
•주체적인 기술 접목/융합** | **CIVIL + IT** | **소극적
•상용 기술에 의존** | | **자체 수행 능력 - 지속가능성 확보** | **주체** | **S/W 제작사 판매 정책에 의존** | | **차별화 및 경쟁력 확보
•해외 진출** | **발주처** | **평준화
•국내 중심** | | **IT + CIVIL ENG 220명 운영 + 기술 개발** | **설계사** | **소규모 BIM팀 운영 + 단순교육에 집중** | | **분야 확장 모델 및 시스템** | **시공사** | **국내 토목 소극적/해외 토목증가** |
결론
[꼭지6] 핵심 요약 — 결론강조 · conclusion
•BIM은 건설산업의 디지털전환(DX)을 수행하는 과정에서 **가장 기초가 되는 일부분**이다
Stage 1.5b: 디자인 예산
+영역별 available_height/width + fits 여부
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/run-001/05-execution/steps/stage_1_7.html b/docs/run-001/05-execution/steps/stage_1_7.html
new file mode 100644
index 0000000..9f492cb
--- /dev/null
+++ b/docs/run-001/05-execution/steps/stage_1_7.html
@@ -0,0 +1,16 @@
+
+
+건설산업 DX의 올바른 이해
+✅ 배경 (768×143px)
available: 5×740px
fits: True
✅ 본심 (768×326px)
available: 220×740px
fits: True
✅ 첨부 (412×490px)
available: 372×380px
fits: True
⚠️ 결론 (1200×60px)
available: 0×1160px
fits: False
Step 2: 블록 선택 (Stage 1.7)
+layer 기반 주종 판단. 컨테이너 위에 블록 표시.
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/run-001/05-execution/steps/stage_1a.html b/docs/run-001/05-execution/steps/stage_1a.html
new file mode 100644
index 0000000..8b5fb0f
--- /dev/null
+++ b/docs/run-001/05-execution/steps/stage_1a.html
@@ -0,0 +1,15 @@
+
+
+
+건설산업 DX의 올바른 이해
+배경 (768x143px)
quote-big-mark (default) default
본심 (768x326px)
card-dark-overlay (default) default
circle-gradient (default) default
첨부 (412x490px)
card-image-3col (default) default
결론 (1200x60px)
banner-gradient (default) default
Stage 1A/1B: Kei 꼭지 + 영역 배정
+| ID | 제목 | +purpose | layer | relation_type | +영역 |
|---|---|---|---|---|---|
| 1 | 용어의 혼용 | 문제제기 | intro | 배경 | |
| 2 | 용어 정의 | 정의정립 | core | 본심 | |
| 3 | 용어간 상호관계 | 관계설명 | core | 본심 | |
| 4 | 혼용 대표 사례 | 근거사례 | supporting | 배경 | |
| 5 | DX와 BIM의 구분 | 비교근거 | supporting | 첨부 | |
| 6 | 핵심 요약 | 결론강조 | conclusion | 결론 |
페이지 구조:
배경: topic_ids=[1, 4], weight=0.22
본심: topic_ids=[2, 3], weight=0.5
첨부: topic_ids=[5], weight=0.18
결론: topic_ids=[6], weight=0.1
\ No newline at end of file
diff --git a/docs/run-001/05-execution/steps/stage_1b.html b/docs/run-001/05-execution/steps/stage_1b.html
new file mode 100644
index 0000000..edd430c
--- /dev/null
+++ b/docs/run-001/05-execution/steps/stage_1b.html
@@ -0,0 +1,15 @@
+
+
+
+배경: topic_ids=[1, 4], weight=0.22
본심: topic_ids=[2, 3], weight=0.5
첨부: topic_ids=[5], weight=0.18
결론: topic_ids=[6], weight=0.1
Stage 1B: 컨셉 구체화
+Stage 1A의 꼭지에 source_data(원본 텍스트)와 summary가 추가됨
+| ID | 제목 | +영역 | layer | +source_data (미리보기) | summary |
|---|---|---|---|---|---|
| 1 | 용어의 혼용 | 배경 | intro | **용어의 혼용** 건설산업의 디지털 전환 논의에서 DX(Digital Transformation)와 BIM(Building Information Modeling)이 개념적으로 명확히 정립되지 않은채 혼용되어 사용되고 있음 이로인해 BIM기술의 도입을 DX의 완성으로 ... | **용어의 혼용** 건설산업의 디지털 전환 논의에서 DX(Digital Transformation)와 BIM(Building Information Modeling)이 개념적으로 명 |
| 2 | 용어 정의 | 본심 | core | * **건설산업** * 다양한 시설물을 각 산업마다의 광범위한 기술을 통합 및 융합하여 만들어내는 종합산업 * 목적 시설물의 품질 욕구를 충족시키면서 최단기간내에 최소 비용으로 편리하고 안전하며 우수한 성능의 시설물 완성을 목표로 함 * **BIM(Building In... | * **건설산업** * 다양한 시설물을 각 산업마다의 광범위한 기술을 통합 및 융합하여 만들어내는 종합산업 * 목적 시설물의 품질 욕구를 충족시키면서 최단기간내에 최소 비용으로 편 |
| 3 | 용어간 상호관계 | 본심 | core | * DX는 BIM과 같은 디지털기술을 기반으로 산업 전반의 프로세스를 혁신하는 상위개념 * 건설산업의 DX는 GIS(공간정보), BIM, 디지털 트윈(가상환경)의 기술융합을 통해서만 실현 또는 구현 가능 * GIS의 역할 : 지리적 데이터를 공간 분석하여 시각적으로 표... | * DX는 BIM과 같은 디지털기술을 기반으로 산업 전반의 프로세스를 혁신하는 상위개념 * 건설산업의 DX는 GIS(공간정보), BIM, 디지털 트윈(가상환경)의 기술융합을 통해서 |
| 4 | 혼용 대표 사례 | 배경 | supporting | **[스마트 건설 활성화 방안(2022.07)]** 추진과제 : 건설산업 디지털화 실행과제 : BIM 전면 도입, BIM 전문인력 양성 **[제7차 건설기술진흥 기본계획(2023.12)]** 추진방향 : 디지털 전환을 통한 스마트 건설 확산 추진과제 : BIM 도입으로... | **[스마트 건설 활성화 방안(2022.07)]** 추진과제 : 건설산업 디지털화 실행과제 : BIM 전면 도입, BIM 전문인력 양성 **[제7차 건설기술진흥 기본계획(2023. |
| 5 | DX와 BIM의 구분 | 첨부 | supporting | | DX | 구분 | BIM | | :--- | :---: | ---: | | **BIM << DX** (Engineering + Management 통합) | **범위** | **Only 3D** (형상 구현 중심) | | **제작 및 운영**(상용 + 전용 40~8... | | DX | 구분 | BIM | | :--- | :---: | ---: | | **BIM << DX** (Engineering + Management 통합) | **범위** | * |
| 6 | 핵심 요약 | 결론 | conclusion | BIM은 건설산업의 디지털전환(DX)을 수행하는 과정에서 **가장 기초가 되는 일부분**이다 | BIM은 건설산업의 디지털전환(DX)을 수행하는 과정에서 **가장 기초가 되는 일부분**이다 |
Stage 2: HTML 생성 결과
+영역별로 생성된 HTML (미리보기) + 서브 컨테이너 레이아웃
+본심 (body_html)
<div style="width:100%; height:100%; box-sizing:border-box; font-family:'Segoe UI',sans-serif; color:#0f172a; display:flex; flex-direction:column; gap:8px;"><div style="background:linear-gradient(135deg,#fff7ed 0%,#ffedd5 100%); border:1px solid #fdba74; border-radius:12px; padding:10px 12px; display:grid; grid-template-columns:1fr 1fr; gap:12px;"><div><div style="font-size:12px; font-weight:800; color:#c2410c; margin-bottom:6px;">용어의 혼용</div><ul style="font-size:10px; line-height:1.6; color:#7c...
첨부 (sidebar_html)
<div style="width:100%; height:100%; box-sizing:border-box; font-family:'Segoe UI',sans-serif; display:flex; flex-direction:column; gap:8px;"><div style="background:#ffffff; border:1px solid #cbd5e1; border-radius:12px; padding:10px 12px;"><div style="font-size:12px; font-weight:800; color:#1e293b; margin-bottom:8px;">용어 정의</div><div style="display:flex; flex-direction:column; gap:8px;"><div style="background:#ffffff; border:1px solid #cbd5e1; border-radius:10px; padding:10px 12px;"><div style="...
결론 (footer_html)
<div style="background:linear-gradient(135deg, #006aff 0%, #00aaff 100%); border-radius:10px; padding:10px 20px; text-align:center; color:#ffffff; width:100%; height:52px; display:flex; align-items:center; justify-content:center; box-sizing:border-box;"><div style="font-size:12px; font-weight:800; line-height:1.35;">BIM은 건설산업의 디지털전환(DX)을 수행하는 과정에서 가장 기초가 되는 일부분이다</div></div>
reasoning (reasoning)
retry regrouping by content importance: intro(problem+evidence), body(relation+comparison), sidebar(definitions), widths 66%/34%
Stage 3: 렌더링 조립
+ + \ No newline at end of file diff --git a/docs/run-001/05-execution/steps/stage_4.html b/docs/run-001/05-execution/steps/stage_4.html new file mode 100644 index 0000000..5c755c7 --- /dev/null +++ b/docs/run-001/05-execution/steps/stage_4.html @@ -0,0 +1,12 @@ + + + +Stage 4: 품질 게이트
+품질 점수: 60
+슬라이드: clientHeight=720px, scrollHeight=720px, overflow=False
+| 영역 | clientH | scrollH | excess |
|---|---|---|---|
| ❌ body | 483px | 561px | +78px |
| ✅ footer | 52px | 52px | +0px |
| ✅ sidebar | 483px | 483px | +0px |
Step 0: Kei 꼭지 (Stage 1A/1B)
+| ID | 제목 | +purpose | layer | relation_type | +영역 |
|---|---|---|---|---|---|
| 1 | 용어의 혼용 | 문제제기 | intro | cause_effect | 배경 |
| 2 | 용어 정의 | 정의정립 | core | definition | 본심 |
| 3 | 용어간 상호관계 | 관계설명 | core | hierarchy | 본심 |
| 4 | 혼용 대표 사례 | 근거사례 | supporting | evidence | 배경 |
| 5 | DX와 BIM의 구분 | 비교근거 | supporting | comparison | 첨부 |
| 6 | 핵심 요약 | 결론강조 | conclusion | none | 결론 |
페이지 구조:
배경: topic_ids=[1, 4], weight=0.22
본심: topic_ids=[2, 3], weight=0.5
첨부: topic_ids=[5], weight=0.18
결론: topic_ids=[6], weight=0.1
\ No newline at end of file
diff --git a/docs/run-001/05-execution/steps/step1_containers.html b/docs/run-001/05-execution/steps/step1_containers.html
new file mode 100644
index 0000000..6fac6a4
--- /dev/null
+++ b/docs/run-001/05-execution/steps/step1_containers.html
@@ -0,0 +1,16 @@
+
+
+배경: topic_ids=[1, 4], weight=0.22
본심: topic_ids=[2, 3], weight=0.5
첨부: topic_ids=[5], weight=0.18
결론: topic_ids=[6], weight=0.1
Step 1: 빈 컨테이너 (Stage 1.5a)
+비율 64:36
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/run-001/05-execution/steps/step1b_content.html b/docs/run-001/05-execution/steps/step1b_content.html
new file mode 100644
index 0000000..61df897
--- /dev/null
+++ b/docs/run-001/05-execution/steps/step1b_content.html
@@ -0,0 +1,16 @@
+
+
+건설산업 DX의 올바른 이해
+배경
768x143px / font:12.0px
768x143px / font:12.0px
본심
768x326px / font:12.0px
768x326px / font:12.0px
첨부
412x490px / font:11.0px
412x490px / font:11.0px
결론
1200x60px / font:14.0px
1200x60px / font:14.0px
Step 1b: 콘텐츠 배치 (꼭지 → 컨테이너)
+각 컨테이너에 배정된 꼭지의 source_data
+
+
+', '\n', text, flags=re.I)
+ text = re.sub(r'<[^>]+>', ' ', text)
+ text = text.replace('**', '').replace('*', ' ')
+ text = text.replace('<', '<').replace('>', '>').replace('&', '&')
+ text = re.sub(r'!\[[^\]]*\]\([^\)]*\)', ' ', text)
+ text = re.sub(r'\[[^\]]+\]\([^\)]*\)', ' ', text)
+ text = re.sub(r'\s+', ' ', text).strip()
+ return text
+
+def _markdown_section(text: str, start_marker: str, end_marker: str | None = None) -> str:
+ start = text.find(start_marker)
+ if start == -1:
+ return ''
+ chunk = text[start + len(start_marker):]
+ if end_marker:
+ end = chunk.find(end_marker)
+ if end != -1:
+ chunk = chunk[:end]
+ return chunk.strip()
+
+
+def _content_after_frontmatter(raw: str) -> str:
+ if raw.startswith('---'):
+ parts = raw.split('---', 2)
+ if len(parts) == 3:
+ return parts[2].strip()
+ return raw
+
+
+def _content_after_frontmatter(raw: str) -> str:
+ if raw.startswith('---'):
+ parts = raw.split('---', 2)
+ if len(parts) == 3:
+ return parts[2].strip()
+ return raw
+
+
+def _problem_bullets_from_raw(raw: str) -> list[str]:
+ content = _content_after_frontmatter(raw)
+ before_sep = content.split('
\n---', 1)[0] + bullets = [] + for line in before_sep.splitlines(): + stripped = line.strip() + if stripped.startswith('* ') and not stripped.startswith('* **'): + bullets.append(_plain_text(stripped[2:])) + return [b for b in bullets if b] + + +def _details_blocks(raw: str) -> list[str]: + return re.findall(r'
건설산업 DX의 올바른 이해
+배경
[꼭지1] 용어의 혼용 — 문제제기 · intro
•**용어의 혼용** 건설산업의 디지털 전환 논의에서 DX(Digital Transformation)와 BIM(Building Information Modeling)이 개념적으로 명확히 정립되지 않은채 혼용되어 사용되고 있음 이로인해 BIM기술의 도입을 DX의 완성으로 오인하거나
•DX를 BIM 기술 도입 수준으로 한정하는 인식 확산
[꼭지4] 혼용 대표 사례 — 근거사례 · supporting
•**[스마트 건설 활성화 방안(2022.07)]** 추진과제 : 건설산업 디지털화 실행과제 : BIM 전면 도입
•BIM 전문인력 양성 **[제7차 건설기술진흥 기본계획(2023.12)]** 추진방향 : 디지털 전환을 통한 스마트 건설 확산 추진과제 : BIM 도입으로 건설산업 디지털화
본심
[꼭지2] 용어 정의 — 정의정립 · core
•* **건설산업** * 다양한 시설물을 각 산업마다의 광범위한 기술을 통합 및 융합하여 만들어내는 종합산업 * 목적 시설물의 품질 욕구를 충족시키면서 최단기간내에 최소 비용으로 편리하고 안전하며 우수한 성능의 시설물 완성을 목표로 함 * **BIM(Building Information Modeling) : 디지털 전환을 위한 핵심 기술** * 시설물의 생애주기동안 발생한 모든 정보를 3차원 모델 기반으로 통합·관리하는 정보 관리 도구 * 건설 정보와 절차를 표준화된 방식으로 연계하고 디지털 협업이 가능하도록 하는 핵심 인프라 기술
+
+
+
\ No newline at end of file
diff --git a/docs/run-001/05-execution/steps/step2_blocks.html b/docs/run-001/05-execution/steps/step2_blocks.html
new file mode 100644
index 0000000..9f492cb
--- /dev/null
+++ b/docs/run-001/05-execution/steps/step2_blocks.html
@@ -0,0 +1,16 @@
+
+
+•color: '#999'
•marginTop: '5px'
•lineHeight: '1.4'
•paddingLeft: '0px' }}> *건설산업 BIM 기본지침
•국토교통부
•2020* * **DX(Digital Transformation) : 산업 패러다임의 변화** * 디지털 기술을 기반으로 산업 전반의 업무방식과 가치 창출 구조를 전환하는 과정 및 결과 * 단순한 기술 도입이 아닌
•고객 가치와 의사결정 방식의 근본적인 변화로 산업의 새로운 방향을 정립하는 것을 의미함
+•color: '#999'
•marginTop: '5px'
•lineHeight: '1.4'
•paddingLeft: '0px' }}> *Digital Transformation
•IBM Institute for Business Value
•2011 / What is Digital Transformation?
•Agile Elephant
•2015*
[꼭지3] 용어간 상호관계 — 관계설명 · core
•* DX는 BIM과 같은 디지털기술을 기반으로 산업 전반의 프로세스를 혁신하는 상위개념 * 건설산업의 DX는 GIS(공간정보)
•BIM
•디지털 트윈(가상환경)의 기술융합을 통해서만 실현 또는 구현 가능 * GIS의 역할 : 지리적 데이터를 공간 분석하여 시각적으로 표현
•위치기반 정보 제공 * BIM의 역할 : 형상정보와 내용정보가 포함된 3D모델로
•건설 정보 기반의 Process와 Product를 제공 
•color: '#999'
•marginTop: '5px'
•lineHeight: '1.4'
•paddingLeft: '0px' }}> *[그림 1] DX와 핵심기술간 상호관계*
첨부
[꼭지5] DX와 BIM의 구분 — 비교근거 · supporting
•| DX | 구분 | BIM | | :--- | :---: | ---: | | **BIM << DX** (Engineering + Management 통합) | **범위** | **Only 3D** (형상 구현 중심) | | **제작 및 운영**(상용 + 전용 40~80개) [Rhino
•Sketchup
•Blender..] + [EG-BIM 등] | **S/W** | **모델 제작용 상용 SW** [Revit
•Civil 3D
•Navisworks
•Autocad] | | **근본적 문제의식을 통한 개선** | **프로세스** | **기존 2D 설계 방식 유지** | | **공학 정보 및 콘텐츠 연계에 집중** **도면
•수량
•시공계획 등 일식** | **성과품** | **3D 모델 중심** **기존 성과품 유지** | | **설계/시공 생산성 혁신**(개념의 재정립) | **활용** | **3D 모델에 의한 일반적 이해 향상** | | **전 생애주기 활용 시스템** | **확장성** | **(설계/시공/운영) 분야별 단절** | | **구체화(복잡) - 적극적/구체적 실현 방안** | **수행 개념** | **단순화(오류) - 수동적/집단적 동질화** | | **적극적
•주체적인 기술 접목/융합** | **CIVIL + IT** | **소극적
•상용 기술에 의존** | | **자체 수행 능력 - 지속가능성 확보** | **주체** | **S/W 제작사 판매 정책에 의존** | | **차별화 및 경쟁력 확보
•해외 진출** | **발주처** | **평준화
•국내 중심** | | **IT + CIVIL ENG 220명 운영 + 기술 개발** | **설계사** | **소규모 BIM팀 운영 + 단순교육에 집중** | | **분야 확장 모델 및 시스템** | **시공사** | **국내 토목 소극적/해외 토목증가** |
결론
[꼭지6] 핵심 요약 — 결론강조 · conclusion
•BIM은 건설산업의 디지털전환(DX)을 수행하는 과정에서 **가장 기초가 되는 일부분**이다
Step 2: 블록 선택 (Stage 1.7)
+layer 기반 주종 판단. 컨테이너 위에 블록 표시.
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/docs/run-001/05-execution/steps/step4_final.html b/docs/run-001/05-execution/steps/step4_final.html
new file mode 100644
index 0000000..b5b3382
--- /dev/null
+++ b/docs/run-001/05-execution/steps/step4_final.html
@@ -0,0 +1,5 @@
+
+
+건설산업 DX의 올바른 이해
+배경 (768x143px)
quote-big-mark (default) default
본심 (768x326px)
card-dark-overlay (default) default
circle-gradient (default) default
첨부 (412x490px)
card-image-3col (default) default
결론 (1200x60px)
banner-gradient (default) default
Step 4: 최종 결과물 (Stage 2+3)
+ + \ No newline at end of file diff --git a/docs/run-001/06-validation/validation-result.md b/docs/run-001/06-validation/validation-result.md index 495fdcb..bb44d66 100644 --- a/docs/run-001/06-validation/validation-result.md +++ b/docs/run-001/06-validation/validation-result.md @@ -7,12 +7,12 @@ ## Validation Summary - 실행 경로 검증: 통과 -- 렌더링/측정 검증: 통과 +- 렌더링/측정 검증: 실패 - 최종 품질 판정: 재작업 필요 ## Render Gates - slide overflow: False -- body: overflowed=False excess_px=0 block_count=0 +- body: overflowed=True excess_px=78 block_count=0 - sidebar: overflowed=False excess_px=0 block_count=0 - footer: overflowed=False excess_px=0 block_count=0 @@ -30,26 +30,26 @@ "body": { "block_count": 0, "blocks": [], - "clientHeight": 474, - "excess_px": 0, - "overflowed": false, - "scrollHeight": 474 + "clientHeight": 483, + "excess_px": 78, + "overflowed": true, + "scrollHeight": 561 }, "footer": { "block_count": 0, "blocks": [], - "clientHeight": 56, + "clientHeight": 52, "excess_px": 0, "overflowed": false, - "scrollHeight": 56 + "scrollHeight": 52 }, "sidebar": { "block_count": 0, "blocks": [], - "clientHeight": 474, + "clientHeight": 483, "excess_px": 0, "overflowed": false, - "scrollHeight": 474 + "scrollHeight": 483 } } } @@ -59,7 +59,13 @@ - 판정: `revise` ## Failure Classification +- Verify-ComparisonVisible - Verify-DesignNarrative +- Verify-DesignStructure +- Verify-RenderZone ## Next Action -1. 원문 주요 소제목과 읽기 순서가 유지되도록 본문 서사를 재구성한다. +1. overflow가 발생한 zone(body)의 content budget, block 수, typography를 재조정한다. +2. 비교 핵심 4축(범위, 프로세스, 성과품, 확장성)을 화면에 바로 보이는 요약 블록으로 강제한다. +3. 핵심 관계를 설명하는 시각적 관계도 블록을 본문 중심 구조로 유지한다. +4. 원문 주요 소제목과 읽기 순서가 유지되도록 본문 서사를 재구성한다. diff --git a/docs/run-001/comments/step-6.md b/docs/run-001/comments/step-6.md index 530de2b..3e0eb11 100644 --- a/docs/run-001/comments/step-6.md +++ b/docs/run-001/comments/step-6.md @@ -1,7 +1,7 @@ 실행 요약 - iteration 1 기준으로 최종 산출물과 측정 결과를 다시 검증했다. - slide overflow: False -- zone overflow: 없음 +- zone overflow: body - 최종 판정은 `revise`이다. 산출물 경로 @@ -12,9 +12,12 @@ KPI / 판정 결과 - 판정: revise -- 실패 분류: Verify-DesignNarrative +- 실패 분류: Verify-ComparisonVisible, Verify-DesignNarrative, Verify-DesignStructure, Verify-RenderZone 수정 액션 +- overflow가 발생한 zone(body)의 content budget, block 수, typography를 재조정한다. +- 비교 핵심 4축(범위, 프로세스, 성과품, 확장성)을 화면에 바로 보이는 요약 블록으로 강제한다. +- 핵심 관계를 설명하는 시각적 관계도 블록을 본문 중심 구조로 유지한다. - 원문 주요 소제목과 읽기 순서가 유지되도록 본문 서사를 재구성한다. 다음 단계 전달물 diff --git a/scripts/run_from_artifacts.py b/scripts/run_from_artifacts.py index a017521..3c630f6 100644 --- a/scripts/run_from_artifacts.py +++ b/scripts/run_from_artifacts.py @@ -9,12 +9,16 @@ import sys from pathlib import Path DESIGN_AGENT_ROOT = Path(r'D:\ad-hoc\kei\design_agent') +REPO_ROOT = Path(__file__).resolve().parent.parent +LOCAL_TEMPLATES_DIR = REPO_ROOT / 'templates' if str(DESIGN_AGENT_ROOT) not in sys.path: sys.path.insert(0, str(DESIGN_AGENT_ROOT)) +import src.block_reference as block_reference_module from src.block_reference import select_and_generate_references from src.config import settings from src.content_verifier import generate_with_retry +import src.design_director as design_director_module import src.html_generator as html_generator from src.design_director import LAYOUT_PRESETS, select_preset from src.image_utils import embed_images, get_image_sizes @@ -31,6 +35,7 @@ from src.pipeline_context import ( Topic, create_context, ) +import src.renderer as renderer_module from src.renderer import render_slide_from_html from src.slide_measurer import capture_slide_screenshot, measure_rendered_heights @@ -39,6 +44,19 @@ if not hasattr(html_generator, 'SIDEBAR_PROMPT') and hasattr(html_generator, '_L if not hasattr(html_generator, 'FOOTER_PROMPT') and hasattr(html_generator, '_LEGACY_FOOTER_PROMPT'): html_generator.FOOTER_PROMPT = html_generator._LEGACY_FOOTER_PROMPT +if LOCAL_TEMPLATES_DIR.exists(): + block_reference_module.TEMPLATES_DIR = LOCAL_TEMPLATES_DIR + block_reference_module._jinja_env = None + renderer_module.TEMPLATES_DIR = LOCAL_TEMPLATES_DIR + renderer_module.CATALOG_PATH = LOCAL_TEMPLATES_DIR / 'catalog.yaml' + renderer_module._CATALOG_MAP = None + renderer_module._CATALOG_VARIANT_MAP = None + renderer_module._env = None + if hasattr(design_director_module, '_CATALOG_CACHE'): + design_director_module._CATALOG_CACHE = None + if hasattr(design_director_module, '_BLOCK_IDS_CACHE'): + design_director_module._BLOCK_IDS_CACHE = None + from src.space_allocator import ( ContainerSpec as LegacyContainerSpec, calculate_container_specs, @@ -290,127 +308,304 @@ def _extract_multiple_sentences(text: str, keywords: list[str], fallback: str, l return fallback +def _plain_text(value: str) -> str: + text = value or '' + text = re.sub(r'\n---', 1)[0] + bullets = [] + for line in before_sep.splitlines(): + stripped = line.strip() + if stripped.startswith('* ') and not stripped.startswith('* **'): + bullets.append(_plain_text(stripped[2:])) + return [b for b in bullets if b] + + +def _details_blocks(raw: str) -> list[str]: + return re.findall(r'
(.*?)
', raw, flags=re.S)
+
+
+def _evidence_bullets_from_raw(raw: str) -> list[str]:
+ blocks = _details_blocks(raw)
+ if not blocks:
+ return []
+ bullets = []
+ for line in blocks[0].splitlines():
+ stripped = line.strip()
+ if stripped.startswith('* '):
+ bullets.append(_plain_text(stripped[2:]))
+ return [b for b in bullets if b]
+
+
+def _definition_sections_from_raw(raw: str) -> list[dict[str, str]]:
+ match = re.search(r'##\s*1\.[^\n]*\n(.*?)##\s*2\.', raw, flags=re.S)
+ block = match.group(1) if match else ''
+ sections: list[dict[str, str]] = []
+ current_title = None
+ current_lines: list[str] = []
+ for line in block.splitlines():
+ stripped = line.strip()
+ if stripped.startswith('* **'):
+ if current_title and current_lines:
+ sections.append({'title': _plain_text(current_title), 'body': _plain_text(' '.join(current_lines))})
+ current_title = stripped[2:]
+ current_lines = []
+ elif stripped.startswith('* '):
+ current_lines.append(stripped[2:])
+ if current_title and current_lines:
+ sections.append({'title': _plain_text(current_title), 'body': _plain_text(' '.join(current_lines))})
+ return sections
+
+
+def _relation_bullets_from_raw(raw: str) -> list[str]:
+ start = re.search(r'##\s*2\.[^\n]*\n', raw)
+ if not start:
+ return []
+ block = raw[start.end():].split('', 1)[0]
+ bullets = []
+ for line in block.splitlines():
+ stripped = line.strip()
+ if stripped.startswith('* '):
+ content = _plain_text(stripped[2:])
+ if content and '[??' not in content:
+ bullets.append(content)
+ return bullets
+
+
+def _extract_image_src_from_raw(raw: str) -> str:
+ m = re.search(r'!\[[^\]]*\]\(([^\)]+)\)', raw)
+ return m.group(1).strip() if m else ''
+
+
+def _extract_caption_from_raw(raw: str) -> str:
+ m = re.search(r'\*\[[^\]]+\][^*]+\*', raw)
+ if m:
+ return _plain_text(m.group(0))
+ return 'relation diagram'
+
+
+def _parse_comparison_rows_from_raw(raw: str) -> list[tuple[str, str, str]]:
+ blocks = _details_blocks(raw)
+ if len(blocks) < 2:
+ return []
+ rows: list[tuple[str, str, str]] = []
+ for line in blocks[1].splitlines():
+ stripped = line.strip()
+ if not stripped.startswith('|'):
+ continue
+ parts = [p.strip() for p in stripped.strip('|').split('|')]
+ if len(parts) != 3:
+ continue
+ if parts[0].startswith(':---') or parts[1].startswith(':---') or parts[2].startswith('---'):
+ continue
+ dx, axis, bim = (_plain_text(parts[0]), _plain_text(parts[1]), _plain_text(parts[2]))
+ if dx == 'DX' and bim == 'BIM':
+ continue
+ rows.append((axis, dx, bim))
+ return rows
+
+
+def _conclusion_from_raw(raw: str) -> str:
+ m = re.search(r':::note\[[^\]]+\](.*?):::', raw, flags=re.S)
+ block = m.group(1) if m else ''
+ for line in block.splitlines():
+ stripped = line.strip()
+ if stripped.startswith('* '):
+ return _plain_text(stripped[2:])
+ return _plain_text(block)
+
+
+def _relation_visual(image_src: str, caption: str) -> str:
+ if image_src:
+ return f'
'
+ return (
+ '{_trim_visible_copy(item, floor=90, ceiling=220)} '
+ for item in problem_bullets
+ )
+ evidence_items_html = ''.join(
+ f'{_trim_visible_copy(item, floor=80, ceiling=180)} '
+ for item in evidence_bullets
+ )
+ relation_items_html = ''.join(
+ f'{_trim_visible_copy(item, floor=80, ceiling=210)} '
+ for item in relation_bullets
+ )
- footer_html = f"""
-'
+ f'{_trim_visible_copy(dx, floor=55, ceiling=120)} '
+ f'{axis} '
+ f'{_trim_visible_copy(bim, floor=55, ceiling=120)} '
+ ' '
+ )
+
+ intro_html = (
+ '` = 원 좌표와 같은 공간 → 위치 100% 정확
+- `radialGradient`/`linearGradient` → 고급 그라데이션
+- `filter` → 글로우/그림자
+- 수학적 계산 (cos/sin) → N개 자동 배치 (Phase 2)
+- **AI 이미지로 시각화 만들면 안 됨** — 원 위치 맞출 수 없음
+
+| 파일 | 설명 | 언제 사용 |
+|------|------|---------|
+| `venn-diagram.html` | **SVG premium** 벤 다이어그램 (그라데이션+글로우) | 포함 관계, 기술 융합 (**★단독 배치**) |
+| `circle-gradient.html` | 파란 그라데이션 원 + 중앙 텍스트 | 섹션 전환 키워드 강조 |
+| `compare-pill-pair.html` | 이중 테두리 둥근 박스 2개 + VS | 2개 개념 시각 대비 (표 위 헤더) |
+| `process-horizontal.html` | 파란 번호 원 + 카드 + → 화살표 (가로) | 논리적 프로세스 흐름 |
+| `flow-arrow-horizontal.html` | 색상 캡슐 + 화살표 (SVG, 컴팩트) | 기술 발전/전환 흐름 간결하게 |
+| `keyword-circle-row.html` | SVG 원형 안 큰 글자 + 라벨 + 설명 | 약어 풀이 (G-S-I-M) |
+
+---
+
+## 📁 emphasis/ (10개) — 강조, 인용, 결론
+
+| 파일 | 설명 | 언제 사용 |
+|------|------|---------|
+| `quote-big-mark.html` | ❝❞ 큰따옴표 장식 + 인용+출처 | 임팩트 인용, 핵심 발언 |
+| `quote-question.html` | 파란 배경+테두리 + 큰 질문 텍스트 | 독자에게 질문, 전환점 |
+| `comparison-2col.html` | 좌 파란 vs 우 빨간 헤더 + 본문 | A vs B 직접 비교 |
+| `banner-gradient.html` | 파란 그라데이션 배너 + 중앙 흰 텍스트 | 섹션 구분, 핵심 선언 |
+| `dark-bullet-list.html` | 짙은 남색 배경 + 파란 제목 + 흰 불릿 | 핵심 포인트 강조 (무게감) |
+| `highlight-strip.html` | 가로 색상 구간 + 흰 라벨 | 카테고리 색상 분류 바 |
+| `callout-solution.html` | 파란 배경+테두리 + 아이콘 + 제목+설명 | 해결책, 솔루션, 방향성 |
+| `callout-warning.html` | 빨간 배경+테두리 + 아이콘 + 제목+설명 | 문제점, 주의, 잘못된 접근 |
+| `tab-label-row.html` | 가로 탭 버튼 (선택됨=색상, 나머지=회색) | 카테고리 전환/분류 표시 |
+| `divider-text.html` | 좌우 회색 선 + 중앙 텍스트 | 가벼운 섹션 구분, 휴식점 |
+
+---
+
+## 📁 media/ (5개) — 이미지/미디어
+
+| 파일 | 설명 | 언제 사용 |
+|------|------|---------|
+| `image-row-2col.html` | 이미지 2장 나란히 (354px) | 시공 사진 2장, 현장 비교 |
+| `image-grid-2x2.html` | 이미지 4장 2x2 격자 (200px) | 현장 사진 4장, 갤러리 |
+| `image-side-text.html` | 좌:이미지(320px) + 우:제목+설명+불릿 | 이미지 설명, 시스템 소개 |
+| `image-full-caption.html` | 전체 너비 이미지 1장 + 캡션 | 핵심 도표, 대형 다이어그램 |
+| `image-before-after.html` | Before(회색) + → + After(파란) | 변화 전후 비교 |
+
+---
+
+## 추가 규칙
+
+1. **이름 규칙:** `{유형}-{특징}.html`
+2. **모든 변형은 catalog.yaml에 등록** — 미등록 = 팀장이 모름
+3. **각 파일 상단에 HTML 주석으로 용도/슬롯 명시**
+4. **디자인 토큰 사용** — 하드코딩 색상 금지 (가능한 범위에서)
+5. **높이 고정 금지** — 모드 독립적 (슬라이드/웹 겸용)
+6. **visuals/는 SVG로 제작** — CSS 원/AI 이미지 금지
diff --git a/templates/blocks/cards/card-compare-3col.html b/templates/blocks/cards/card-compare-3col.html
new file mode 100644
index 0000000..42d9aaf
--- /dev/null
+++ b/templates/blocks/cards/card-compare-3col.html
@@ -0,0 +1,74 @@
+
+
+{{ slide_title | default('슬라이드') }}
+
+
+
+
+{% for page in pages %}
+
'
+ '
'
+ )
+
+
+
def _build_stage2_retry_html(ctx: PipelineContext, retry_plan: dict) -> dict:
- title = ctx.analysis.title
+ raw = ctx.raw_content or ''
problem_topic = _topic(ctx, 1)
- evidence_topic = _topic(ctx, 4)
+ definitions_topic = _topic(ctx, 2)
relation_topic = _topic(ctx, 3)
+ evidence_topic = _topic(ctx, 4)
comparison_topic = _topic(ctx, 5)
- conclusion_topic = _topic(ctx, 6)
- dx_topic = _topic(ctx, 2)
- problem_text = _trim_visible_copy(_prefer_source_text(problem_topic, '건설산업 디지털 전환 논의에서 DX와 BIM이 혼용되며 BIM 도입을 DX 완성으로 오인하는 문제가 발생하고 있다.'), floor=120, ceiling=260)
- relation_source = _prefer_source_text(relation_topic, 'DX와 GIS, BIM, Digital Twin의 관계를 시각적으로 드러낸다.')
- relation_text = _trim_visible_copy(relation_source, floor=110, ceiling=180)
- gis_line = _trim_visible_copy(_extract_sentence(relation_source, 'GIS', 'GIS는 공간 분석과 위치 기반 정보를 제공한다.'), floor=60, ceiling=140)
- bim_line = _trim_visible_copy(_extract_sentence(relation_source, 'BIM', 'BIM은 형상정보와 내용정보를 함께 다루는 핵심 인프라 기술이다.'), floor=60, ceiling=160)
- evidence_source = _prefer_source_text(evidence_topic, '정책 문서에서도 DX와 BIM이 혼용되며 이를 바로잡을 필요가 있다.')
- evidence_text = _trim_visible_copy(evidence_source, floor=90, ceiling=170)
- dx_source = _prefer_source_text(dx_topic, 'DX는 상위 개념이고 BIM은 이를 실행하는 핵심 기술이다.')
- dx_text = _trim_visible_copy(dx_source, floor=110, ceiling=220)
- compare_source = _prefer_source_text(comparison_topic, '범위·프로세스·성과품·확장성의 4개 비교축으로 DX와 BIM 차이를 짧고 직접적으로 보여준다.')
- compare_text = _trim_visible_copy(compare_source, floor=90, ceiling=120)
- conclusion_text = _trim_visible_copy(_prefer_source_text(conclusion_topic, '결론: BIM은 건설산업 DX를 수행하는 과정의 가장 기초가 되는 일부분이다.'), floor=70, ceiling=180)
- problem_title = problem_topic.title if problem_topic and problem_topic.title else 'DX와 BIM의 혼용 문제'
- dx_title = dx_topic.title if dx_topic and dx_topic.title else 'DX의 정의와 위치'
- relation_title = relation_topic.title if relation_topic and relation_topic.title else 'BIM과 핵심기술의 관계'
- comparison_title = comparison_topic.title if comparison_topic and comparison_topic.title else 'DX와 BIM 비교 핵심 포인트'
- evidence_title = evidence_topic.title if evidence_topic and evidence_topic.title else '정책 혼용 사례'
+ problem_title = problem_topic.title if problem_topic and problem_topic.title else 'Problem'
+ definitions_title = definitions_topic.title if definitions_topic and definitions_topic.title else 'Definitions'
+ relation_title = relation_topic.title if relation_topic and relation_topic.title else 'Relationship'
+ evidence_title = evidence_topic.title if evidence_topic and evidence_topic.title else 'Evidence'
+ comparison_title = comparison_topic.title if comparison_topic and comparison_topic.title else 'Comparison'
- body_html = f"""
-
-
-""".strip()
+ intro_len = sum(len(x) for x in problem_bullets + evidence_bullets)
+ defs_len = sum(len(s['body']) for s in definition_sections)
+ relation_len = sum(len(x) for x in relation_bullets)
+ sidebar_width = '34%' if defs_len >= relation_len else '31%'
+ main_width = '66%' if defs_len >= relation_len else '69%'
+ relation_visual_height = '210px' if intro_len > 320 else '230px'
- sidebar_html = f"""
-
-
+ problem_bullets = _problem_bullets_from_raw(raw)[:2]
+ evidence_bullets = _evidence_bullets_from_raw(raw)[:4]
+ definition_sections = _definition_sections_from_raw(raw)[:3]
+ relation_bullets = _relation_bullets_from_raw(raw)[:4]
+ comparison_rows = _parse_comparison_rows_from_raw(raw)
- {problem_title}
- {problem_text}
-
-
+ image_src = _extract_image_src_from_raw(raw)
+ if image_src and ctx.base_path:
+ candidate = Path(ctx.base_path) / image_src.lstrip('/\\').replace('/', '\\')
+ if not candidate.exists():
+ image_src = ''
+ else:
+ image_src = ''
+ image_caption = _extract_caption_from_raw(raw)
+ conclusion_text = _conclusion_from_raw(raw)
-
-
+ preferred_axes = ['??', '????', '???', '???']
+ picked_rows = [row for row in comparison_rows if row[0] in preferred_axes]
+ if len(picked_rows) < 4:
+ seen = {row[0] for row in picked_rows}
+ for row in comparison_rows:
+ if row[0] not in seen:
+ picked_rows.append(row)
+ seen.add(row[0])
+ if len(picked_rows) >= 4:
+ break
+ picked_rows = picked_rows[:4]
-
-
- {dx_title}
- {dx_text}
- [그림 1] DX와 핵심기술간 상호관계
-
-
-
-
-
-
- DX
- →
-
-
- GIS
- BIM
- Digital Twin
-
-
-
-
- {relation_title}
- {relation_text}
-
-
-
-
- GIS 역할
- {gis_line}
-
-
- BIM 역할
- {bim_line}
-
-
-
-
- {comparison_title}
- {compare_text}
-
-
- 범위
DX는 BIM을 포함하는 상위 개념
- DX는 BIM을 포함하는 상위 개념
프로세스
DX는 근본적 개선, BIM은 기존 2D 연장
- DX는 근본적 개선, BIM은 기존 2D 연장
성과품
DX는 공학 정보 연계, BIM은 3D 모델 중심
- DX는 공학 정보 연계, BIM은 3D 모델 중심
확장성
DX는 전 생애주기, BIM은 분야별 단절 위험
- DX는 전 생애주기, BIM은 분야별 단절 위험
-
-""".strip()
+ problem_items_html = ''.join(
+ f'
-
- 용어 정의
-
-
- 건설산업
- 다양한 기술을 통합해 시설물을 구현하는 종합 산업
- BIM
- 3차원 모델 기반의 정보관리 도구이자 협업 인프라
출처: 국토교통부 BIM 기본지침
- 출처: 국토교통부 BIM 기본지침
DX
- 디지털 기술 기반으로 업무방식과 가치구조를 전환하는 상위 개념
-
-
-{evidence_title}
- {evidence_text}
-
-
-""".strip()
+ definition_cards_html = ''
+ for section in definition_sections:
+ definition_cards_html += (
+ '{conclusion_text}
-'
+ f'
'
+ )
+
+ comparison_rows_html = ''
+ for axis, dx, bim in picked_rows:
+ comparison_rows_html += (
+ '{section["title"]}
'
+ f'{_trim_visible_copy(section["body"], floor=120, ceiling=250)}
'
+ ''
+ f''
+ f''
+ '
'
+ )
+
+ relation_html = (
+ f'{problem_title}
- {problem_items_html}
{evidence_title}
- {evidence_items_html}
'
+ '
'
+ )
+
+ comparison_html = (
+ ''
+ f'{_relation_visual(image_src, image_caption).replace("height:220px", f"height:{relation_visual_height}")}'
+ f'
'
+ '{image_caption}
'
+ ''
+ f'
'
+ '{relation_title}
'
+ f'- {relation_items_html}
'
+ f'{comparison_rows_html}
'
+ '
'
+ )
+
+ body_html = (
+ '{comparison_title}
'
+ f''
+ f'{intro_html}'
+ f'{relation_html}'
+ f'{comparison_html}'
+ '
'
+ )
+
+ sidebar_html = (
+ ''
+ f''
+ '
'
+ )
+
+ footer_html = (
+ '{definitions_title}
{definition_cards_html}
'
+ f'
'
+ )
return {
'body_html': body_html,
'sidebar_html': sidebar_html,
'footer_html': footer_html,
- 'reasoning': f"stage_2 retry regeneration from rollback plan: {retry_plan.get('rollback_stage', 'stage_2')} with design-domain-guided slide composition",
+ 'reasoning': f"retry regrouping by content importance: intro(problem+evidence), body(relation+comparison), sidebar(definitions), widths {main_width}/{sidebar_width}",
}
diff --git a/templates/blocks/INDEX.md b/templates/blocks/INDEX.md
new file mode 100644
index 0000000..664af8a
--- /dev/null
+++ b/templates/blocks/INDEX.md
@@ -0,0 +1,104 @@
+# 블록 라이브러리 인덱스 (38개)
+
+디자인 팀장이 콘텐츠에 맞는 블록을 선택할 때 참조하는 라이브러리.
+각 카테고리 안에 변형이 여러 개 있으며, 콘텐츠 성격에 따라 적절한 변형을 선택한다.
+
+**시각화(visuals/)는 SVG로 제작한다** — CSS/AI 이미지 금지.
+
+---
+
+## 📁 headers/ (5개) — 타이틀, 꼭지 헤더
+
+| 파일 | 설명 | 언제 사용 |
+|------|------|---------|
+| `section-title-with-bg.html` | 배경 이미지 위 영문+한글 타이틀 (500px) | 페이지 맨 첫 화면, 배경 이미지 있을 때 |
+| `section-header-bar.html` | 파란 바 + 중앙 흰 제목 (컴팩트) | 섹션 시작 가볍게, 주제 전환 |
+| `topic-left-right.html` | 좌:파란 제목 + 우:설명 | 질문+답변 구조, 주장+근거 |
+| `topic-center.html` | 중앙 정렬 대제목 + 서브+설명 | 단독 강조, 주제 선언 |
+| `topic-numbered.html` | 번호 원형 + 제목 + 구분선 + 설명 | 순서 있는 꼭지 (1번, 2번, 3번) |
+
+---
+
+## 📁 cards/ (9개) — 카드 계열
+
+| 파일 | 설명 | 언제 사용 |
+|------|------|---------|
+| `card-image-3col.html` | 이미지(160px) + 색상 제목 + 영문 + 불릿 (3열) | 단계별 설명에 이미지 핵심 |
+| `card-dark-overlay.html` | 다크 이미지 배경 + 흰 제목 + 짧은 설명 (3~5열) | 키워드 시각 강조, 임팩트 |
+| `card-tag-image.html` | 색상 태그 라벨 + 이미지 + 제목 + 설명 (3열) | 카테고리별 분류 (제조/건축/토목) |
+| `card-icon-desc.html` | 큰 이모지 아이콘 + 제목 + 설명 (2~4열) | 기능/특성/장점 아이콘 나열 |
+| `card-compare-3col.html` | 색상 헤더 카드 3열 + 불릿 | 3개 카테고리 비교 (상용/범용/전문) |
+| `card-step-vertical.html` | 좌 색상 마커 + 우 콘텐츠 (세로, 연결선) | 생애주기 단계별 (이미지+설명) |
+| `card-image-round.html` | 원형 이미지(140px) + 제목 + 설명 (2~3열) | 포트폴리오형, 비전/가치 |
+| `card-stat-number.html` | 큰 숫자(36px) + 단위 + 라벨 (2~4열) | KPI, 성과 수치, 비용 절감율 |
+| `card-numbered.html` | 색상 원형 번호 + 제목 + 설명 (세로) | 순서 있는 항목 (실행 단계, 조건) |
+
+---
+
+## 📁 tables/ (3개) — 표/비교 계열
+
+| 파일 | 설명 | 언제 사용 |
+|------|------|---------|
+| `compare-3col-badge.html` | A \| VS배지 \| B 3단 비교 (행별) | 두 개념 다항목 비교 (BIM vs DX) |
+| `compare-2col-split.html` | 파란 헤더 좌/구분/우 + 행별 비교 | 두 기술 항목별 상세 비교 (GIS vs BIM) |
+| `table-simple-striped.html` | 남색 헤더 + 줄무늬 행. 범용 | 스펙표, 일정표, 수치 목록 |
+
+---
+
+## 📁 visuals/ (6개) — 시각 요소 (**SVG**)
+
+**SVG 노하우:**
+- `{conclusion_text}
'
+ '
+ {% for card in cards %}
+
+
+
diff --git a/templates/blocks/cards/card-dark-overlay.html b/templates/blocks/cards/card-dark-overlay.html
new file mode 100644
index 0000000..ccb28f8
--- /dev/null
+++ b/templates/blocks/cards/card-dark-overlay.html
@@ -0,0 +1,77 @@
+
+
+
+ 
+ {% endif %}
+ {% if card.bullets %}
+
+ {% endfor %}
+
+
+ {% if card.image %}
+ {{ card.title }}
+ {% if card.subtitle %}{{ card.subtitle }}
{% endif %}
+ -
+ {% for item in card.bullets %}
+
- {{ item }} + {% endfor %} +
+ {% for card in cards %}
+
+
+
diff --git a/templates/blocks/cards/card-icon-desc--compact.html b/templates/blocks/cards/card-icon-desc--compact.html
new file mode 100644
index 0000000..1be2aa4
--- /dev/null
+++ b/templates/blocks/cards/card-icon-desc--compact.html
@@ -0,0 +1,52 @@
+
+
+
+ {% if card.image %}
+
+ {% else %}
+
+ {% endif %}
+
+ {% endfor %}
+
+
+ {{ card.title }}
+ {% if card.description %}{{ card.description }}
{% endif %}
+
+ {% for card in cards %}
+
+
+
diff --git a/templates/blocks/cards/card-icon-desc.html b/templates/blocks/cards/card-icon-desc.html
new file mode 100644
index 0000000..b2d31e1
--- /dev/null
+++ b/templates/blocks/cards/card-icon-desc.html
@@ -0,0 +1,48 @@
+
+
+
+ {% if card.icon %}
+ {% endfor %}
+{{ card.icon }}
{% endif %}
+ {{ card.title }}
+ {% if card.description %}{{ card.description }}
{% endif %}
+
+ {% for card in cards %}
+
+
+
diff --git a/templates/blocks/cards/card-image-3col.html b/templates/blocks/cards/card-image-3col.html
new file mode 100644
index 0000000..5b73d4c
--- /dev/null
+++ b/templates/blocks/cards/card-image-3col.html
@@ -0,0 +1,96 @@
+
+
+
+ {% if card.icon %}
+ {% endfor %}
+{{ card.icon }}
{% endif %}
+ {{ card.title }}
+ {% if card.description %}{{ card.description }}
{% endif %}
+
+ {% for card in cards %}
+
+
+
diff --git a/templates/blocks/cards/card-image-round.html b/templates/blocks/cards/card-image-round.html
new file mode 100644
index 0000000..5ff7b8a
--- /dev/null
+++ b/templates/blocks/cards/card-image-round.html
@@ -0,0 +1,62 @@
+
+
+
+ {% if card.image %}
+
+ {% endif %}
+
+ {% endfor %}
+
+
+ {{ card.title }}
+ {% if card.title_en %}{{ card.title_en }}
{% endif %}
+
+ -
+ {% for item in card.bullets %}
+
- {{ item }} + {% endfor %} +
{{ card.source }}
{% endif %}
+
+ {% for card in cards %}
+
+
+
diff --git a/templates/blocks/cards/card-numbered--horizontal.html b/templates/blocks/cards/card-numbered--horizontal.html
new file mode 100644
index 0000000..278c2e1
--- /dev/null
+++ b/templates/blocks/cards/card-numbered--horizontal.html
@@ -0,0 +1,60 @@
+
+
+
+ {% if card.image %}
+
+ {% endfor %}
+
+
+
+ {% endif %}
+ {{ card.title }}
+ {% if card.description %}{{ card.description }}
{% endif %}
+
+ {% for item in items %}
+
+
+
diff --git a/templates/blocks/cards/card-numbered.html b/templates/blocks/cards/card-numbered.html
new file mode 100644
index 0000000..2a5f7cb
--- /dev/null
+++ b/templates/blocks/cards/card-numbered.html
@@ -0,0 +1,60 @@
+
+
+
+
+ {% endfor %}
+{{ loop.index }}
+
+
+ {{ item.title }}
+ {{ item.description }}
+
+ {% for item in items %}
+
+
+
diff --git a/templates/blocks/cards/card-stat-number.html b/templates/blocks/cards/card-stat-number.html
new file mode 100644
index 0000000..ff3752e
--- /dev/null
+++ b/templates/blocks/cards/card-stat-number.html
@@ -0,0 +1,57 @@
+
+
+
+
+ {% endfor %}
+{{ loop.index }}
+
+
+ {{ item.title }}
+ {% if item.description %}{{ item.description }}
{% endif %}
+
+ {% for stat in stats %}
+
+
+
diff --git a/templates/blocks/cards/card-step-vertical.html b/templates/blocks/cards/card-step-vertical.html
new file mode 100644
index 0000000..c0a65cd
--- /dev/null
+++ b/templates/blocks/cards/card-step-vertical.html
@@ -0,0 +1,93 @@
+
+
+
+
+ {% endfor %}
+
+ {{ stat.number }}{{ stat.unit | default('') }}
+
+ {{ stat.label }}
+ {% if stat.description %}{{ stat.description }}
{% endif %}
+
+ {% for step in steps %}
+
+
+
diff --git a/templates/blocks/cards/card-tag-image.html b/templates/blocks/cards/card-tag-image.html
new file mode 100644
index 0000000..eb9751a
--- /dev/null
+++ b/templates/blocks/cards/card-tag-image.html
@@ -0,0 +1,63 @@
+
+
+
+
+ {% if not loop.last %}
+
+
+ {{ step.phase }}
+
+ 
+ {% endif %}
+ {% if step.description %}
+ {{ step.title }}
+ {% if step.image %}
+ {{ step.description }}
{% endif %}
+
+
+
+ {% endif %}
+ {% endfor %}
+
+ {% for card in cards %}
+
+
+
diff --git a/templates/blocks/emphasis/banner-gradient.html b/templates/blocks/emphasis/banner-gradient.html
new file mode 100644
index 0000000..95671cd
--- /dev/null
+++ b/templates/blocks/emphasis/banner-gradient.html
@@ -0,0 +1,33 @@
+
+
+
+
+ {% endif %}
+ {% if card.title %}
+ {% endfor %}
+{{ card.tag }}
+ {% if card.image %}
+ {{ card.title }}
{% endif %}
+ {% if card.description %}{{ card.description }}
{% endif %}
+
+
+
+
diff --git a/templates/blocks/emphasis/callout-solution.html b/templates/blocks/emphasis/callout-solution.html
new file mode 100644
index 0000000..7041a85
--- /dev/null
+++ b/templates/blocks/emphasis/callout-solution.html
@@ -0,0 +1,55 @@
+
+
+{{ text }}
+ {% if sub_text %}{{ sub_text }}
{% endif %}
+
+ {% if icon %}
+
+
diff --git a/templates/blocks/emphasis/callout-warning.html b/templates/blocks/emphasis/callout-warning.html
new file mode 100644
index 0000000..2b0796d
--- /dev/null
+++ b/templates/blocks/emphasis/callout-warning.html
@@ -0,0 +1,45 @@
+
+
+{{ icon }}
{% endif %}
+
+
+{{ title }}
+ {{ description }}
+ {% if source %}{{ source }}
{% endif %}
+
+ {% if icon %}
+
+
diff --git a/templates/blocks/emphasis/comparison-2col--cards-in-container.html b/templates/blocks/emphasis/comparison-2col--cards-in-container.html
new file mode 100644
index 0000000..df5edde
--- /dev/null
+++ b/templates/blocks/emphasis/comparison-2col--cards-in-container.html
@@ -0,0 +1,97 @@
+
+
+{{ icon }}
{% endif %}
+
+
+{{ title }}
+ {{ description }}
+
+
+
+
diff --git a/templates/blocks/emphasis/comparison-2col.html b/templates/blocks/emphasis/comparison-2col.html
new file mode 100644
index 0000000..133535b
--- /dev/null
+++ b/templates/blocks/emphasis/comparison-2col.html
@@ -0,0 +1,52 @@
+
+
+
+{{ container_label }}
+ {% if container_desc %}{{ container_desc }}
{% endif %}
+
+ {% for card in cards %}
+
+
+ {% if card.letter %}
+
+ {% endfor %}
+ {{ card.letter }}
+ {% endif %}
+ {{ card.label }}
+ {% if card.description %}{{ card.description }}
{% endif %}
+
+
+
+
diff --git a/templates/blocks/emphasis/dark-bullet-list--before-after.html b/templates/blocks/emphasis/dark-bullet-list--before-after.html
new file mode 100644
index 0000000..40844a4
--- /dev/null
+++ b/templates/blocks/emphasis/dark-bullet-list--before-after.html
@@ -0,0 +1,65 @@
+
+
+
+
+
+ {{ left_title }}
+ {% if left_subtitle %}{{ left_subtitle }}
{% endif %}
+ {{ left_content }}
+
+
+{{ right_title }}
+ {% if right_subtitle %}{{ right_subtitle }}
{% endif %}
+ {{ right_content }}
+
+ {% if title %}
+
+
diff --git a/templates/blocks/emphasis/dark-bullet-list.html b/templates/blocks/emphasis/dark-bullet-list.html
new file mode 100644
index 0000000..024d8cf
--- /dev/null
+++ b/templates/blocks/emphasis/dark-bullet-list.html
@@ -0,0 +1,48 @@
+
+
+{{ title }}
{% endif %}
+
+ {% for item in changes %}
+
+
+
+ {% endfor %}
+ {{ item.label }}
+ {{ item.before }}
+ → {{ item.after }}
+
+ {% if title %}
+
+
diff --git a/templates/blocks/emphasis/divider-text.html b/templates/blocks/emphasis/divider-text.html
new file mode 100644
index 0000000..726bce3
--- /dev/null
+++ b/templates/blocks/emphasis/divider-text.html
@@ -0,0 +1,32 @@
+
+
+{{ title }}
{% endif %}
+ -
+ {% for item in bullets %}
+
- {{ item }} + {% endfor %} +
+
+
+
+
diff --git a/templates/blocks/emphasis/highlight-strip.html b/templates/blocks/emphasis/highlight-strip.html
new file mode 100644
index 0000000..dcd38db
--- /dev/null
+++ b/templates/blocks/emphasis/highlight-strip.html
@@ -0,0 +1,31 @@
+
+
+{{ text }}
+
+
+ {% for seg in segments %}
+
+
+
diff --git a/templates/blocks/emphasis/quote-big-mark.html b/templates/blocks/emphasis/quote-big-mark.html
new file mode 100644
index 0000000..d6c2518
--- /dev/null
+++ b/templates/blocks/emphasis/quote-big-mark.html
@@ -0,0 +1,59 @@
+
+
+
+ {{ seg.label }}
+
+ {% endfor %}
+
+
+
+
diff --git a/templates/blocks/emphasis/quote-question.html b/templates/blocks/emphasis/quote-question.html
new file mode 100644
index 0000000..1cd1f32
--- /dev/null
+++ b/templates/blocks/emphasis/quote-question.html
@@ -0,0 +1,37 @@
+
+
+❝
+
+
+ {{ quote_text }}
+ {% if source %}— {{ source }}
{% endif %}
+ ❞
+
+
+
+
diff --git a/templates/blocks/emphasis/tab-label-row.html b/templates/blocks/emphasis/tab-label-row.html
new file mode 100644
index 0000000..fddae2c
--- /dev/null
+++ b/templates/blocks/emphasis/tab-label-row.html
@@ -0,0 +1,39 @@
+
+
+{{ question }}
+ {% if description %}{{ description }}
{% endif %}
+
+ {% for tab in tabs %}
+
+
+
diff --git a/templates/blocks/headers/section-header-bar.html b/templates/blocks/headers/section-header-bar.html
new file mode 100644
index 0000000..1aa637c
--- /dev/null
+++ b/templates/blocks/headers/section-header-bar.html
@@ -0,0 +1,32 @@
+
+
+
+ {{ tab.label }}
+
+ {% endfor %}
+
+
+
+
diff --git a/templates/blocks/headers/section-title-with-bg.html b/templates/blocks/headers/section-title-with-bg.html
new file mode 100644
index 0000000..3b25aba
--- /dev/null
+++ b/templates/blocks/headers/section-title-with-bg.html
@@ -0,0 +1,69 @@
+
+
+{{ title }}
+ {% if subtitle %}{{ subtitle }}
{% endif %}
+
+ {% if bg_image %}
+ 
+ {% else %}
+
+ {% endif %}
+ {% if breadcrumb %}
+
+
+
diff --git a/templates/blocks/headers/topic-center.html b/templates/blocks/headers/topic-center.html
new file mode 100644
index 0000000..f141b4d
--- /dev/null
+++ b/templates/blocks/headers/topic-center.html
@@ -0,0 +1,41 @@
+
+
+{{ breadcrumb }}
+ {% endif %}
+
+ {% if title_en %}
+{{ title_en }}
{% endif %}
+ {{ title_ko }}
+
+
+
+
diff --git a/templates/blocks/headers/topic-left-right.html b/templates/blocks/headers/topic-left-right.html
new file mode 100644
index 0000000..99bcf83
--- /dev/null
+++ b/templates/blocks/headers/topic-left-right.html
@@ -0,0 +1,39 @@
+
+
+{{ title }}
+ {% if subtitle %}{{ subtitle }}
{% endif %}
+ {% if description %}{{ description }}
{% endif %}
+
+
+
+
diff --git a/templates/blocks/headers/topic-numbered.html b/templates/blocks/headers/topic-numbered.html
new file mode 100644
index 0000000..7f2a011
--- /dev/null
+++ b/templates/blocks/headers/topic-numbered.html
@@ -0,0 +1,57 @@
+
+
+{{ title }}
+ {{ description }}
+
+
+
+
diff --git a/templates/blocks/media/image-before-after.html b/templates/blocks/media/image-before-after.html
new file mode 100644
index 0000000..26e198a
--- /dev/null
+++ b/templates/blocks/media/image-before-after.html
@@ -0,0 +1,60 @@
+
+
+
+
+
+ {% if description %}{{ number }}
+ {{ title }}
+ {{ description }}
{% endif %}
+
+
+{% if caption %}
+ 
+
+ {{ before_label | default('Before') }}
+ →
+
+ 
+
+{{ after_label | default('After') }}
+ {{ caption }}
{% endif %}
+
+
diff --git a/templates/blocks/media/image-full-caption.html b/templates/blocks/media/image-full-caption.html
new file mode 100644
index 0000000..a83da8a
--- /dev/null
+++ b/templates/blocks/media/image-full-caption.html
@@ -0,0 +1,32 @@
+
+
+
+ 
+ {% if caption %}
+
+
diff --git a/templates/blocks/media/image-grid-2x2.html b/templates/blocks/media/image-grid-2x2.html
new file mode 100644
index 0000000..ea07bef
--- /dev/null
+++ b/templates/blocks/media/image-grid-2x2.html
@@ -0,0 +1,42 @@
+
+
+{{ caption }}
{% endif %}
+
+ {% for img in images %}
+
+
+
diff --git a/templates/blocks/media/image-row-2col.html b/templates/blocks/media/image-row-2col.html
new file mode 100644
index 0000000..dc81f85
--- /dev/null
+++ b/templates/blocks/media/image-row-2col.html
@@ -0,0 +1,40 @@
+
+
+
+ 
+ {% if img.caption %}
+ {% endfor %}
+{{ img.caption }}
{% endif %}
+
+ {% for img in images %}
+
+
+
diff --git a/templates/blocks/media/image-side-text.html b/templates/blocks/media/image-side-text.html
new file mode 100644
index 0000000..343579b
--- /dev/null
+++ b/templates/blocks/media/image-side-text.html
@@ -0,0 +1,71 @@
+
+
+
+
+ {% if img.caption %}
+ {% endfor %}
+{{ img.caption }}
{% endif %}
+
+
+
+
diff --git a/templates/blocks/tables/compare-2col-split.html b/templates/blocks/tables/compare-2col-split.html
new file mode 100644
index 0000000..81deac3
--- /dev/null
+++ b/templates/blocks/tables/compare-2col-split.html
@@ -0,0 +1,71 @@
+
+
+
+ 
+
+
+ {% if title %}
+{{ title }}
{% endif %}
+ {% if description %}{{ description }}
{% endif %}
+ {% if bullets %}
+ -
+ {% for item in bullets %}
+
- {{ item }} + {% endfor %} +
+
+
+
diff --git a/templates/blocks/tables/compare-3col-badge.html b/templates/blocks/tables/compare-3col-badge.html
new file mode 100644
index 0000000..29d1c16
--- /dev/null
+++ b/templates/blocks/tables/compare-3col-badge.html
@@ -0,0 +1,110 @@
+
+
+
+
+ {% for row in rows %}
+ {{ left_title }}
+ 구분
+ {{ right_title }}
+
+
+ {% endfor %}
+{{ row.left }}
+ {{ row.criteria }}
+ {{ row.right }}
+
+
+
+
+
+
+
diff --git a/templates/blocks/tables/table-simple-striped.html b/templates/blocks/tables/table-simple-striped.html
new file mode 100644
index 0000000..802ead6
--- /dev/null
+++ b/templates/blocks/tables/table-simple-striped.html
@@ -0,0 +1,58 @@
+
+
+| + {% if loop.index == 2 %}{{ header }}{% else %}{{ header }}{% endif %} + | + {% endfor %} +
|---|
| {{ cell }} | + {% endfor %} +
+
+
+
+
+
+
diff --git a/templates/blocks/visuals/circle-gradient.html b/templates/blocks/visuals/circle-gradient.html
new file mode 100644
index 0000000..5bdd25c
--- /dev/null
+++ b/templates/blocks/visuals/circle-gradient.html
@@ -0,0 +1,58 @@
+
+
+| {{ h }} | + {% endfor %} +
|---|
| {{ cell }} | + {% endfor %} +
+
+
+
diff --git a/templates/blocks/visuals/compare-pill-pair.html b/templates/blocks/visuals/compare-pill-pair.html
new file mode 100644
index 0000000..d876931
--- /dev/null
+++ b/templates/blocks/visuals/compare-pill-pair.html
@@ -0,0 +1,74 @@
+
+
+
+
+
+
+ {{ label }}
+ {% if sub_label %}{{ sub_label }}
{% endif %}
+
+
+
+
diff --git a/templates/blocks/visuals/flow-arrow-horizontal.html b/templates/blocks/visuals/flow-arrow-horizontal.html
new file mode 100644
index 0000000..412af0e
--- /dev/null
+++ b/templates/blocks/visuals/flow-arrow-horizontal.html
@@ -0,0 +1,34 @@
+
+
+
+
+
+
+
+
+ {{ left_label }}
+ {% if left_sub %}{{ left_sub }}
{% endif %}
+ VS
+
+
+
+
+
+
+ {{ right_label }}
+ {% if right_sub %}{{ right_sub }}
{% endif %}
+
+
+
+
+
diff --git a/templates/blocks/visuals/keyword-circle-row.html b/templates/blocks/visuals/keyword-circle-row.html
new file mode 100644
index 0000000..23414c3
--- /dev/null
+++ b/templates/blocks/visuals/keyword-circle-row.html
@@ -0,0 +1,56 @@
+
+
+
+ {% for kw in keywords %}
+
+
+
diff --git a/templates/blocks/visuals/process-horizontal.html b/templates/blocks/visuals/process-horizontal.html
new file mode 100644
index 0000000..e3d2a4b
--- /dev/null
+++ b/templates/blocks/visuals/process-horizontal.html
@@ -0,0 +1,61 @@
+
+
+
+
+ {% endfor %}
+{{ kw.label }}
+ {% if kw.description %}{{ kw.description }}
{% endif %}
+
+ {% for step in steps %}
+
+
+
diff --git a/templates/blocks/visuals/venn-diagram.html b/templates/blocks/visuals/venn-diagram.html
new file mode 100644
index 0000000..3a8e9e8
--- /dev/null
+++ b/templates/blocks/visuals/venn-diagram.html
@@ -0,0 +1,125 @@
+
+
+
+
+ {% if not loop.last %}
+ {{ step.number | default(loop.index) }}
+ {{ step.title }}
+ {% if step.description %}{{ step.description }}
{% endif %}
+ →
+ {% endif %}
+ {% endfor %}
+
+ {% if outer_r is defined %}
+ {# ═══ P2-B: 동적 N개 배치 ═══ #}
+
+
+ {% else %}
+ {# ═══ Phase 1 fallback: 3개 고정 ═══ #}
+
+ {% endif %}
+
+ {% if description %}
+
+
+
diff --git a/templates/catalog.yaml b/templates/catalog.yaml
new file mode 100644
index 0000000..c5de5a7
--- /dev/null
+++ b/templates/catalog.yaml
@@ -0,0 +1,1844 @@
+version: '4.0'
+blocks:
+- id: section-title-with-bg
+ name: 배경 이미지 타이틀
+ category: headers
+ template: blocks/headers/section-title-with-bg.html
+ height_cost: large
+ min_height_px: 300
+ relation_types: []
+ visual: 전체 너비 배경 이미지(파란 그라데이션+웨이브) 위에 흰색 영문 소제목(15px) + 한글 대제목(35px). 높이 약 500px.
+ when: 자세히보기(detail) 페이지의 맨 첫 화면 전용. 배경 이미지 위에 타이틀을 올려 페이지 주제를 시각적으로 강렬하게 선언할 때.
+ not_for: 일반 슬라이드 내부 소제목 → topic-left-right 또는 topic-center 사용. 배경 이미지 없이 텍스트만 →
+ topic-center. 높이 200px 이하 → section-header-bar.
+ purpose_fit: []
+ slots:
+ required:
+ - title_ko
+ optional:
+ - title_en
+ - breadcrumb
+ - bg_image
+ schema:
+ title_ko:
+ max_lines: 2
+ font_size: 35
+ ref_chars:
+ body: 20
+ note: 35px bold white, 대제목
+ title_en:
+ max_lines: 1
+ font_size: 15
+ ref_chars:
+ body: 30
+ note: 15px white, 영문 소제목
+ breadcrumb:
+ max_lines: 1
+ font_size: 13
+ ref_chars:
+ body: 40
+ note: 13px, 상단 경로
+ padding_overhead_px: 0
+ padding_h_px: 60
+- id: section-header-bar
+ name: 섹션 헤더 바
+ category: headers
+ template: blocks/headers/section-header-bar.html
+ height_cost: compact
+ min_height_px: 40
+ relation_types: []
+ visual: 전체 너비 파란 배경 바(~50px) + 중앙 흰색 제목. 섹션 구분용. 컴팩트.
+ when: 같은 페이지 안에서 주제 전환이 필요할 때. 높이 예산이 적을 때 섹션 구분.
+ not_for: 페이지 전체 타이틀 → section-title-with-bg. 꼭지별 소제목 → topic-left-right 또는 topic-numbered.
+ purpose_fit: []
+ slots:
+ required:
+ - title
+ optional:
+ - subtitle
+ schema:
+ title:
+ max_lines: 1
+ font_size: 18
+ ref_chars:
+ body: 25
+ sidebar: 20
+ note: 18px bold white, 중앙정렬
+ subtitle:
+ max_lines: 1
+ font_size: 13
+ ref_chars:
+ body: 40
+ sidebar: 30
+ note: 13px, 1줄
+ padding_overhead_px: 28
+ padding_h_px: 32
+- id: topic-left-right
+ name: 좌우 꼭지 헤더
+ category: headers
+ template: blocks/headers/topic-left-right.html
+ height_cost: compact
+ min_height_px: 50
+ relation_types: []
+ visual: 좌측에 파란 굵은 제목(24px, 240px 고정) + 우측에 본문 설명(16px). 가로 2단.
+ visual_diff: '유사 블록과의 차이:
+
+ - topic-center: 중앙 정렬 대제목(26px) + 서브타이틀 + 설명. 단독 강조형. 좌우 분리 없음
+
+ - topic-numbered: 번호 원형(①②③) + 제목 + 구분선 + 설명. 순서형 세로 배치
+
+ - 이 블록: 좌측 240px 고정폭에 파란 굵은 제목 + 우측에 본문 설명. 가로 2단 배치
+
+ 적합: 좌측에 핵심 주장/키워드, 우측에 근거/설명을 대비시킬 때. 문제 제기 도입부
+
+ 부적합: 중앙 강조 → topic-center, 순서형 번호 → topic-numbered
+
+ '
+ when: '좌측에 핵심 주장/질문, 우측에 근거/설명을 배치하는 구조. 문제 제기의 도입부로 적합. 예: "용어의 혼용" + "DX와 BIM이
+ 혼용되고 있다..."'
+ not_for: 중앙 정렬 대제목 → topic-center. 번호가 붙은 순서형 → topic-numbered. 섹션 전체 타이틀 → section-title-with-bg.
+ purpose_fit:
+ - 문제제기
+ slots:
+ required:
+ - title
+ - description
+ optional: []
+ schema:
+ title:
+ max_lines: 2
+ font_size: 24
+ ref_chars:
+ body: 20
+ note: 24px bold, 240px 고정폭
+ description:
+ max_lines: 2
+ font_size: 16
+ ref_chars:
+ body: 100
+ note: 16px, 510px 너비
+ padding_overhead_px: 24
+ padding_h_px: 40
+- id: topic-center
+ name: 중앙 정렬 꼭지 헤더
+ category: headers
+ template: blocks/headers/topic-center.html
+ height_cost: medium
+ min_height_px: 60
+ relation_types: []
+ visual: 중앙 정렬 대제목(26px 굵게) + 파란 서브타이틀 + 하단 설명. 단독 강조.
+ visual_diff: '유사 블록과의 차이:
+
+ - topic-left-right: 좌측 제목(240px) + 우측 설명. 가로 2단 분리. 주장+근거 구조
+
+ - topic-numbered: 번호 원형 + 제목 + 구분선 + 설명. 순서형 세로 배치
+
+ - 이 블록: 중앙 정렬 대제목(26px) + 파란 서브타이틀 + 설명. 단독으로 주제를 크게 선언
+
+ 적합: 하나의 주제를 페이지 중심에 크게 선언. sidebar 섹션 라벨. 좌우 분리 불필요할 때
+
+ 부적합: 좌:제목 우:설명 대비 → topic-left-right, 순서형 → topic-numbered
+
+ '
+ when: 하나의 주제를 페이지 중심에 크게 선언할 때. sidebar 영역의 섹션 라벨로도 사용 가능.
+ not_for: 좌:제목 우:설명 구조 → topic-left-right. 번호 순서 → topic-numbered.
+ purpose_fit: []
+ slots:
+ required:
+ - title
+ optional:
+ - subtitle
+ - description
+ schema:
+ title:
+ max_lines: 1
+ font_size: 26
+ ref_chars:
+ body: 25
+ sidebar: 20
+ note: 26px bold
+ subtitle:
+ max_lines: 1
+ font_size: 14
+ ref_chars:
+ body: 40
+ sidebar: 30
+ note: 14px accent
+ description:
+ max_lines: 3
+ font_size: 16
+ ref_chars:
+ body: 120
+ sidebar: 80
+ note: 16px
+ padding_overhead_px: 40
+ padding_h_px: 0
+- id: topic-numbered
+ name: 번호 꼭지 헤더
+ category: headers
+ template: blocks/headers/topic-numbered.html
+ height_cost: compact
+ min_height_px: 45
+ relation_types: []
+ visual: 파란 원형 번호(①②③) + 굵은 제목 + 파란 구분선 + 설명. 세로 배치.
+ visual_diff: '유사 블록과의 차이:
+
+ - topic-left-right: 좌측 제목 + 우측 설명. 가로 2단. 번호 없음
+
+ - topic-center: 중앙 정렬 대제목 + 서브타이틀. 번호 없이 단독 강조
+
+ - 이 블록: 파란 원형 번호(①②③) + 굵은 제목 + 파란 구분선 + 설명. 세로 배치. 순서형 꼭지 전용
+
+ 적합: 순서가 있는 꼭지(1번, 2번, 3번). 단계별 섹션 시작점
+
+ 부적합: 순서 없는 꼭지 → topic-left-right/topic-center, 카드 안의 순서 → card-numbered
+
+ '
+ when: 순서가 있는 꼭지를 시작할 때. 1번, 2번, 3번 식의 단계별 섹션.
+ not_for: 순서 없는 꼭지 → topic-left-right 또는 topic-center. 카드 안의 순서 → card-numbered.
+ purpose_fit: []
+ slots:
+ required:
+ - number
+ - title
+ optional:
+ - description
+ - color
+ schema:
+ number:
+ max_lines: 1
+ font_size: 16
+ ref_chars:
+ body: 2
+ note: 16px, 36px 원 안의 번호
+ title:
+ max_lines: 1
+ font_size: 20
+ ref_chars:
+ body: 25
+ sidebar: 18
+ note: 20px bold
+ description:
+ max_lines: 2
+ font_size: 15
+ ref_chars:
+ body: 80
+ sidebar: 50
+ note: 15px, line-height 1.7
+ padding_overhead_px: 28
+ padding_h_px: 40
+- id: card-image-3col
+ name: 이미지 카드 3열
+ category: cards
+ template: blocks/cards/card-image-3col.html
+ height_cost: large
+ min_height_px: 250
+ relation_types: []
+ min_items: 2
+ max_items: 3
+ visual: 3열 카드. 각 카드 상단에 이미지(160px) + 하단에 색상 밑줄 제목 + 불릿 목록.
+ visual_diff: '유사 블록과의 차이:
+
+ - card-icon-desc: 이모지 아이콘 + 제목 + 설명. 이미지 없이 아이콘만 사용
+
+ - card-dark-overlay: 다크 배경 이미지 위 그라데이션 + 흰 텍스트. 짧은 키워드 강조
+
+ - card-numbered: 번호 원형 + 제목 + 설명. 이미지 없고 순서 중심
+
+ - card-stat-number: 큰 숫자 + 단위 + 라벨. 수치 데이터 전용
+
+ - card-tag-image: 좌상단 색상 태그 + 이미지. 카테고리 태그가 핵심 구분자
+
+ - 이 블록: 상단에 실제 이미지(160px 높이) + 색상 밑줄 제목 + 불릿 목록. 이미지가 콘텐츠의 핵심
+
+ 적합: 이미지(사진/도표)가 각 항목의 핵심이고, 하단에 불릿으로 세부 설명이 필요할 때
+
+ 부적합: 이미지 없음 → card-icon-desc, 카테고리 태그 분류 → card-tag-image, 키워드만 → card-dark-overlay
+
+ '
+ when: '이미지가 핵심인 항목 3개를 나란히. 예: 설계단계(3D모델) / 시공단계(현장) / 유지관리(자산).'
+ not_for: 이미지 없이 텍스트만 → card-icon-desc. 키워드+짧은 설명만 → card-dark-overlay. 2개 비교 → compare-pill-pair.
+ purpose_fit:
+ - 핵심전달
+ - 근거사례
+ slots:
+ required:
+ - cards[]
+ optional: []
+ schema:
+ card_title:
+ max_lines: 1
+ font_size: 14
+ ref_chars:
+ body: 15
+ note: 14px bold, 색상 밑줄
+ card_title_en:
+ max_lines: 1
+ font_size: 12
+ ref_chars:
+ body: 20
+ note: 12px, 영문 부제
+ bullet_item:
+ max_lines: 1
+ font_size: 13
+ ref_chars:
+ body: 40
+ note: 13px, line-height 1.7
+ max_bullets_per_card:
+ body: 4
+ note: 카드당 불릿 수
+ source:
+ max_lines: 1
+ font_size: 11
+ ref_chars:
+ body: 25
+ note: 11px, 하단 출처
+ max_cards:
+ body: 3
+ note: 카드 수
+ padding_overhead_px: 16
+ padding_h_px: 0
+- id: card-dark-overlay
+ name: 다크 오버레이 카드
+ category: cards
+ template: blocks/cards/card-dark-overlay.html
+ height_cost: medium
+ min_height_px: 100
+ relation_types: []
+ min_items: 3
+ max_items: 5
+ visual: 3~5열 카드. 다크 배경 이미지 + 그라데이션 오버레이 + 흰색 굵은 제목 + 짧은 설명.
+ visual_diff: '유사 블록과의 차이:
+
+ - card-icon-desc: 밝은 배경 + 이모지 아이콘 + 설명(3줄). 정보 전달 중심
+
+ - card-image-3col: 밝은 배경 + 상단 이미지 + 색상 밑줄 제목 + 불릿. 이미지 콘텐츠 중심
+
+ - card-numbered: 밝은 배경 + 번호 원형 + 설명. 순서 나열
+
+ - card-stat-number: 큰 숫자 강조. 수치 데이터 전용
+
+ - card-tag-image: 밝은 배경 + 색상 태그 + 이미지. 카테고리 분류
+
+ - 이 블록: 다크 배경 이미지 위에 그라데이션 오버레이 + 흰색 텍스트. 시각적 임팩트 극대화. 설명 2줄 이내
+
+ 적합: 키워드를 시각적으로 강렬하게 강조. 짧은 텍스트(제목+1~2줄)만 필요할 때
+
+ 부적합: 긴 설명(3줄+) → card-icon-desc, 이미지가 콘텐츠 → card-image-3col, 순서 → card-numbered
+
+ '
+ when: '키워드를 시각적으로 강조할 때. 짧은 설명(2줄 이내)과 함께. 예: 협업지원 / 오류감소 / 생산성향상.'
+ not_for: 긴 설명(3줄+) → card-icon-desc. 이미지가 크게 보여야 함 → card-image-3col. 순서/단계 → process-horizontal.
+ purpose_fit:
+ - 핵심전달
+ - 구조시각화
+ zone: full-width-only
+ slots:
+ required:
+ - cards[]
+ optional: []
+ schema:
+ card_title:
+ max_lines: 1
+ font_size: 18
+ ref_chars:
+ body: 15
+ note: 18px bold white, 1줄
+ card_description:
+ max_lines: 2
+ font_size: 12
+ ref_chars:
+ body: 30
+ note: 12px white, 1~2줄
+ max_cards:
+ body: 5
+ note: 카드 수
+ padding_overhead_px: 32
+ padding_h_px: 40
+- id: card-tag-image
+ name: 태그 이미지 카드
+ category: cards
+ template: blocks/cards/card-tag-image.html
+ height_cost: large
+ min_height_px: 250
+ relation_types: []
+ min_items: 2
+ max_items: 3
+ visual: 3열 카드. 좌상단 색상 태그 라벨 + 이미지 + 제목 + 설명.
+ visual_diff: '유사 블록과의 차이:
+
+ - card-icon-desc: 이모지 아이콘 + 제목 + 설명. 태그/이미지 없음
+
+ - card-image-3col: 상단 이미지 + 색상 밑줄 제목 + 불릿. 태그 없이 이미지가 핵심
+
+ - card-dark-overlay: 다크 배경 이미지 + 흰 텍스트. 키워드 강조용
+
+ - card-numbered: 번호 원형 + 제목 + 설명. 순서형
+
+ - card-stat-number: 큰 숫자 + 단위. 수치 전용
+
+ - 이 블록: 좌상단에 색상 태그 라벨이 카드를 분류. 태그 색상으로 카테고리 시각 구분 + 이미지 + 제목
+
+ 적합: 카테고리 태그로 분류하는 것이 핵심일 때. 업종/유형별 색상 구분이 필요한 경우
+
+ 부적합: 태그 불필요 → card-image-3col, 이미지 없음 → card-icon-desc, 수치 → card-stat-number
+
+ '
+ when: '카테고리 태그로 분류가 핵심일 때. 예: 제조업(파란) / 건축(초록) / 인프라(빨간).'
+ not_for: 태그 불필요 → card-image-3col. 이미지 없음 → card-icon-desc.
+ purpose_fit:
+ - 핵심전달
+ slots:
+ required:
+ - cards[]
+ optional: []
+ schema:
+ tag:
+ max_lines: 1
+ font_size: 12
+ ref_chars:
+ body: 8
+ note: 12px bold white, 좌상단 태그
+ card_title:
+ max_lines: 1
+ font_size: 14
+ ref_chars:
+ body: 15
+ note: 14px bold
+ card_description:
+ max_lines: 2
+ font_size: 13
+ ref_chars:
+ body: 40
+ note: 13px
+ max_cards:
+ body: 3
+ note: 카드 수
+ padding_overhead_px: 14
+ padding_h_px: 0
+- id: card-icon-desc
+ name: 아이콘 설명 카드
+ category: cards
+ template: blocks/cards/card-icon-desc.html
+ height_cost: medium
+ min_height_px: 120
+ relation_types:
+ - definition
+ min_items: 2
+ max_items: 4
+ variants:
+ - id: default
+ description: 아이콘 + 제목 + 설명 (기본 그리드)
+ - id: compact
+ description: 아이콘 축소, 설명 2줄 제한, 패딩 축소 (높이 부족 시)
+ template: blocks/cards/card-icon-desc--compact.html
+ when: 컨테이너 높이가 150px 미만일 때
+ visual: 2~4열. 중앙 큰 이모지 아이콘(2.5rem) + 굵은 제목 + 설명. 밝은 배경.
+ visual_diff: '유사 블록과의 차이:
+
+ - card-image-3col: 상단에 실제 이미지(160px) + 색상 밑줄 제목 + 불릿 목록
+
+ - card-dark-overlay: 다크 배경 이미지 위 그라데이션 + 흰 텍스트. 키워드 강조용
+
+ - card-numbered: 번호 원형(①②③) + 제목 + 설명. 순서 있는 나열
+
+ - card-stat-number: 큰 숫자(36px) + 단위 + 라벨. 수치 데이터 전용
+
+ - card-tag-image: 좌상단 색상 태그 + 이미지 + 제목. 카테고리 분류 강조
+
+ - 이 블록: 이모지 아이콘(2.5rem)이 중앙에 크게 + 제목 + 설명. 밝은 배경 그리드. 이미지 없이 아이콘으로 시각 구분
+
+ 적합: 이미지 없이 독립적 개념/특성을 나열. 순서 없고 아이콘으로 직관적 구분이 가능할 때
+
+ 부적합: 실제 사진 필요 → card-image-3col, 순서 번호 → card-numbered, 수치 → card-stat-number
+
+ '
+ when: '독립적인 항목/개념/특성을 이모지 아이콘과 함께 나열. 순서 없는 개별 항목. 예: 🔧기술기반 / 💻S/W역량 / 🌏여건조성.'
+ not_for: 이미지(사진) 필요 → card-image-3col. 순서 번호 필요 → card-numbered. 텍스트만(아이콘 불필요) →
+ dark-bullet-list.
+ purpose_fit:
+ - 핵심전달
+ - 근거사례
+ - 구조시각화
+ zone: full-width-only
+ slots:
+ required:
+ - cards[]
+ optional: []
+ schema:
+ card_title:
+ max_lines: 1
+ font_size: 15
+ ref_chars:
+ body: 10
+ note: 15px bold, 1줄
+ card_description:
+ max_lines: 3
+ font_size: 13
+ ref_chars:
+ body: 60
+ note: 13px, 3줄 이내
+ max_cards:
+ body: 4
+ note: 카드 수 (3열 grid)
+ padding_overhead_px: 40
+ padding_h_px: 32
+- id: card-compare-3col
+ name: 3단 비교 카드
+ category: cards
+ template: blocks/cards/card-compare-3col.html
+ height_cost: large
+ min_height_px: 200
+ relation_types:
+ - comparison
+ min_items: 3
+ max_items: 3
+ visual: 3열 카드. 각 카드 상단 색상 헤더(제목+서브) + 이미지 + 불릿 목록.
+ visual_diff: '유사 블록과의 차이:
+
+ - compare-2col-split: 표 형식 2단 비교, 중앙 기준 라벨. 2개 대상 전용
+
+ - compare-3col-badge: 표 형식 3열, VS 배지. 행 단위 비교
+
+ - comparison-2col: 좌우 텍스트 블록, 2개 대비. 표/카드 아님
+
+ - compare-pill-pair: 둥근 박스 2개 + VS. 헤더 역할만
+
+ - 이 블록: 3개 독립 카드가 나란히. 카드마다 고유 색상 헤더+이미지+불릿. 카드형 비교
+
+ 적합: 3개 카테고리를 각각 독립적으로 설명하면서 비교. 카테고리별 색상 구분이 필요할 때
+
+ 부적합: 2개 비교 → comparison-2col/compare-pill-pair, 행별 대조 → compare-3col-badge
+
+ '
+ when: '3개 카테고리를 비교할 때. 각 카테고리에 다른 색상 헤더. 예: 상용SW(회색) vs 3rd Party(파랑) vs 전문SW(빨강).'
+ not_for: 2개 비교 → compare-pill-pair + compare-2col-split. 다항목 표 → compare-3col-badge.
+ purpose_fit:
+ - 핵심전달
+ zone: full-width-only
+ slots:
+ required:
+ - cards[]
+ optional: []
+ schema:
+ card_title:
+ max_lines: 1
+ font_size: 15
+ ref_chars:
+ body: 15
+ note: 15px bold white, 1줄
+ bullet_item:
+ max_lines: 1
+ font_size: 13
+ ref_chars:
+ body: 40
+ note: 13px, 불릿 1개당
+ max_bullets_per_card:
+ body: 5
+ note: 카드당 불릿 수
+ padding_overhead_px: 26
+ padding_h_px: 0
+- id: card-step-vertical
+ name: 세로 단계 카드
+ category: cards
+ template: blocks/cards/card-step-vertical.html
+ height_cost: xlarge
+ min_height_px: 250
+ relation_types:
+ - sequence
+ min_items: 2
+ max_items: 4
+ visual: 세로 나열. 좌측 색상 마커(단계명) + 우측 콘텐츠 박스(제목+이미지+설명). 연결선.
+ when: '생애주기/프로세스 단계별 설명. 각 단계에 이미지+상세 설명. 예: 설계→시공→운영 단계.'
+ not_for: 가로 흐름(간단) → process-horizontal. 높이 예산 부족 → card-numbered. 독립 사례(순서 아님)
+ → card-icon-desc.
+ purpose_fit:
+ - 핵심전달
+ - 구조시각화
+ slots:
+ required:
+ - steps[]
+ optional: []
+ schema:
+ step_title:
+ max_lines: 1
+ font_size: 16
+ ref_chars:
+ body: 15
+ sidebar: 12
+ note: 16px bold
+ step_description:
+ max_lines: 3
+ font_size: 14
+ ref_chars:
+ body: 60
+ sidebar: 40
+ note: 14px, 2~3줄
+ max_steps:
+ body: 4
+ sidebar: 3
+ note: 단계 수
+ padding_overhead_px: 24
+ padding_h_px: 0
+- id: card-image-round
+ name: 원형 이미지 카드
+ category: cards
+ template: blocks/cards/card-image-round.html
+ height_cost: large
+ min_height_px: 200
+ relation_types: []
+ min_items: 2
+ max_items: 3
+ visual: 2~3열. 원형 이미지(140px, 테두리+그림자) + 제목 + 설명. 중앙 정렬.
+ when: 포트폴리오형 나열. 비전/가치 표현. 원형 이미지가 있는 경우.
+ not_for: 사각형 이미지 → card-image-3col. 이미지 없음 → card-icon-desc.
+ purpose_fit: []
+ slots:
+ required:
+ - cards[]
+ optional: []
+ schema:
+ card_title:
+ max_lines: 1
+ font_size: 15
+ ref_chars:
+ body: 12
+ note: 15px bold, 중앙정렬
+ card_description:
+ max_lines: 2
+ font_size: 13
+ ref_chars:
+ body: 40
+ note: 13px, max-width 200px
+ max_cards:
+ body: 3
+ note: 카드 수
+ padding_overhead_px: 12
+ padding_h_px: 0
+- id: card-stat-number
+ name: 통계 숫자 카드
+ category: cards
+ template: blocks/cards/card-stat-number.html
+ height_cost: medium
+ min_height_px: 80
+ relation_types: []
+ min_items: 2
+ max_items: 4
+ visual: 2~4열. 매우 큰 숫자(36px, 색상) + 단위 + 라벨 + 설명.
+ visual_diff: '유사 블록과의 차이:
+
+ - card-icon-desc: 이모지 아이콘 + 제목 + 설명. 텍스트 중심의 개념 나열
+
+ - card-image-3col: 상단 이미지 + 밑줄 제목 + 불릿. 이미지 콘텐츠 중심
+
+ - card-dark-overlay: 다크 배경 + 흰 텍스트. 키워드 강조
+
+ - card-numbered: 번호 원형 + 제목 + 설명. 순서형 나열
+
+ - card-tag-image: 색상 태그 + 이미지. 카테고리 분류
+
+ - 이 블록: 숫자가 36px로 매우 크게 표시 + 색상 강조 + 단위 + 라벨. 수치 데이터 시각화 전용
+
+ 적합: KPI, 성과 수치, 달성률 등 숫자 자체가 핵심 메시지인 경우
+
+ 부적합: 텍스트 설명 중심 → card-icon-desc, 순서 나열 → card-numbered, 이미지 → card-image-3col
+
+ '
+ when: 'KPI, 성과 수치, 달성률, 비용 절감율 등 숫자가 핵심인 데이터. 예: 30% 절감 / 220명+.'
+ not_for: 숫자가 아닌 텍스트 항목 → card-icon-desc. 비교 구조 → compare-3col-badge.
+ purpose_fit:
+ - 핵심전달
+ - 근거사례
+ slots:
+ required:
+ - stats[]
+ optional: []
+ schema:
+ number:
+ max_lines: 1
+ font_size: 36
+ ref_chars:
+ body: 5
+ note: 36px bold 색상, 핵심 숫자
+ unit:
+ max_lines: 1
+ font_size: 18
+ ref_chars:
+ body: 5
+ note: 18px, 숫자 옆 단위
+ label:
+ max_lines: 1
+ font_size: 14
+ ref_chars:
+ body: 10
+ note: 14px bold, 항목명
+ description:
+ max_lines: 1
+ font_size: 12
+ ref_chars:
+ body: 20
+ note: 12px, 부연 설명
+ max_stats:
+ body: 4
+ note: 통계 항목 수
+ padding_overhead_px: 40
+ padding_h_px: 24
+- id: card-numbered
+ name: 번호 항목 카드
+ category: cards
+ template: blocks/cards/card-numbered.html
+ height_cost: medium
+ min_height_px: 55
+ relation_types:
+ - definition
+ min_items: 1
+ max_items: 5
+ variants:
+ - id: default
+ description: 번호 + 제목 + 설명 (세로 나열)
+ - id: horizontal
+ description: 항목을 가로 2열로 배치 (사례 비교, 같은 구조 항목 나란히)
+ template: blocks/cards/card-numbered--horizontal.html
+ when: 같은 구조의 항목 2-3개를 나란히 비교할 때
+ visual: 세로 나열. 색상 원형 번호(①②③) + 제목 + 설명. 밝은 배경 카드.
+ visual_diff: '유사 블록과의 차이:
+
+ - card-icon-desc: 이모지 아이콘 + 제목 + 설명 그리드. 순서 없이 독립 항목 나열
+
+ - card-image-3col: 상단 이미지 + 색상 밑줄 제목 + 불릿. 이미지 중심
+
+ - card-dark-overlay: 다크 배경 이미지 + 흰 텍스트. 키워드 강조
+
+ - card-stat-number: 큰 숫자(36px) + 단위. 수치 데이터 전용
+
+ - card-tag-image: 좌상단 색상 태그 + 이미지. 카테고리 분류
+
+ - 이 블록: 색상 원형 번호(①②③)가 핵심 구분자. 세로 나열. 순서/정의 목록에 최적
+
+ 적합: 번호가 의미 있는 순서형 나열 또는 번호로 구분되는 정의 목록. sidebar에도 적합
+
+ 부적합: 순서 없는 독립 항목 → card-icon-desc, 이미지 필요 → card-image-3col, 수치 → card-stat-number
+
+ '
+ when: 번호가 의미 있는 항목 나열. 순서가 있는 단계(1→2→3)이거나, 번호로 구분되는 정의 목록. sidebar 용어 정의에 적합(1.건설산업
+ 2.BIM 3.DX). 조건/요구사항 나열.
+ not_for: 순서 없는 독립 항목 → card-icon-desc. 이미지 포함 단계 → card-step-vertical. 가로 흐름 → process-horizontal.
+ purpose_fit:
+ - 용어정의
+ - 핵심전달
+ slots:
+ required:
+ - items[]
+ optional: []
+ schema:
+ item_title:
+ max_lines: 1
+ font_size: 15
+ ref_chars:
+ body: 15
+ sidebar: 12
+ note: 15px bold
+ item_description:
+ max_lines: 2
+ font_size: 13
+ ref_chars:
+ body: 60
+ sidebar: 40
+ note: 13px
+ max_items:
+ body: 5
+ sidebar: 4
+ note: 항목 수
+ padding_overhead_px: 22
+ padding_h_px: 32
+- id: compare-3col-badge
+ name: VS 배지 비교표
+ category: tables
+ template: blocks/tables/compare-3col-badge.html
+ height_cost: large
+ min_height_px: 150
+ relation_types:
+ - comparison
+ visual: 3단 테이블. 좌(하늘색 헤더) | 중앙(파란 VS 배지) | 우(파란 헤더). 행별 비교.
+ visual_diff: '유사 블록과의 차이:
+
+ - compare-2col-split: 중앙에 ''기준 라벨'' 열이 있는 3열 표. 비교 기준이 행마다 명시됨
+
+ - comparison-2col: 표가 아닌 좌우 텍스트 블록. CSS var로 색상 구분
+
+ - compare-pill-pair: 둥근 박스 2개 + VS. 비교 헤더 역할만 수행
+
+ - card-compare-3col: 3개 독립 카드로 비교. 카드별 색상 헤더+이미지+불릿
+
+ - 이 블록: VS 배지가 중앙 열에 고정된 3열 표. 좌/우 헤더 색상이 다르고 행 단위로 대조
+
+ 적합: 두 개념의 다항목(5행+) 체계적 비교. 비교 기준 없이 좌/우 값만 대조할 때
+
+ 부적합: 비교 기준 라벨 필요 → compare-2col-split, 3개 카테고리 비교 → card-compare-3col
+
+ '
+ when: '두 개념의 다항목 비교(5행 이상). 구분 기준(중앙)을 두고 좌우로 비교. 예: BIM vs DX — S/W, 프로세스, 성과물
+ 비교.'
+ not_for: 시각적 대비(짧음) → compare-pill-pair. 2단 분할 → compare-2col-split. 범용 데이터 → table-simple-striped.
+ A vs B 간단 비교(2~3행) → comparison-2col.
+ purpose_fit:
+ - 핵심전달
+ slots:
+ required:
+ - headers[]
+ - rows[][]
+ optional: []
+ schema:
+ cell:
+ max_lines: 2
+ font_size: 13
+ ref_chars:
+ body: 30
+ sidebar: 20
+ note: 13px, 셀당 1~2줄
+ max_rows:
+ body: 7
+ sidebar: 5
+ note: 헤더 제외 행 수
+ padding_overhead_px: 28
+ padding_h_px: 0
+- id: compare-2col-split
+ name: 2단 분할 비교표
+ category: tables
+ template: blocks/tables/compare-2col-split.html
+ height_cost: large
+ min_height_px: 150
+ relation_types:
+ - comparison
+ visual: 파란 헤더(좌/구분/우) + 행별 좌:항목 | 중앙:기준 라벨(파란) | 우:항목. 상세 비교.
+ visual_diff: '유사 블록과의 차이:
+
+ - compare-3col-badge: 3열 표에 VS 배지가 중앙에 있고 행별 비교. 헤더가 좌/우만 구분
+
+ - comparison-2col: CSS var 기반 좌우 텍스트 비교. 표가 아니라 자유 텍스트 블록
+
+ - compare-pill-pair: 둥근 박스 2개 + VS. 비교 헤더 역할만 하고 세부 항목 없음
+
+ - card-compare-3col: 3개 독립 카드로 비교. 각 카드에 색상 헤더+불릿
+
+ - 이 블록: 중앙에 ''기준 라벨'' 열이 있는 3열 표. 행마다 비교 기준(정의/범위/역할 등)이 명시됨
+
+ 적합: 비교 기준이 명확하고 항목별(5행+) 상세 대조가 필요한 경우
+
+ 부적합: 간단한 2~3항목 비교 → comparison-2col, 시각적 대비만 → compare-pill-pair
+
+ '
+ when: '두 기술/개념의 항목별 상세 비교. 중앙에 비교 기준 라벨. 예: DX vs BIM — 정의/범위/역할 비교. 원본에 이미 비교표
+ 데이터가 있을 때.'
+ not_for: VS 배지 → compare-3col-badge. 범용 데이터 → table-simple-striped. 간단 A vs B(2~3항목)
+ → comparison-2col.
+ purpose_fit:
+ - 핵심전달
+ zone: full-width-only
+ slots:
+ required:
+ - left_title
+ - right_title
+ - rows[]
+ optional: []
+ schema:
+ cell:
+ max_lines: 1
+ font_size: 13
+ ref_chars:
+ body: 30
+ note: 13px, 셀당
+ max_rows:
+ body: 7
+ note: 행 수
+ padding_overhead_px: 24
+ padding_h_px: 0
+- id: table-simple-striped
+ name: 범용 줄무늬 테이블
+ category: tables
+ template: blocks/tables/table-simple-striped.html
+ height_cost: medium
+ min_height_px: 100
+ relation_types: []
+ visual: 진한 남색 헤더 + 줄무늬 행 교차. 첫 열 굵은 글씨. 범용 데이터 표.
+ when: '비교가 아닌 일반 데이터 표. 스펙표, 일정표, 항목 목록. 예: 구분/현재/목표/비고.'
+ not_for: A vs B 비교 → compare-3col-badge 또는 compare-2col-split.
+ purpose_fit:
+ - 핵심전달
+ - 근거사례
+ slots:
+ required:
+ - headers[]
+ - rows[][]
+ optional: []
+ schema:
+ header_cell:
+ max_lines: 1
+ font_size: 13
+ ref_chars:
+ body: 15
+ sidebar: 10
+ note: 13px bold white, 남색 배경
+ body_cell:
+ max_lines: 2
+ font_size: 13
+ ref_chars:
+ body: 20
+ sidebar: 15
+ note: 13px, 줄무늬 행
+ max_rows:
+ body: 8
+ sidebar: 5
+ note: 행 수
+ padding_overhead_px: 19
+ padding_h_px: 0
+- id: venn-diagram
+ name: SVG 벤 다이어그램
+ category: visuals
+ template: blocks/visuals/venn-diagram.html
+ height_cost: xlarge
+ min_height_px: 300
+ relation_types:
+ - hierarchy
+ - inclusion
+ min_items: 2
+ max_items: 5
+ visual: SVG. 진한 파란 큰 원(중심) + 3~5개 작은 원(주황/민트/골드 등). 그라데이션+글로우. 동적 N-item 지원.
+ when: '상위-하위 포함 관계를 시각화. 기술 융합/포함 구조. 예: DX 안에 GIS/BIM/디지털트윈. relation_type=hierarchy
+ 또는 inclusion일 때. ★ 반드시 단독 배치. 다른 블록과 같은 zone에 쌓으면 공간 부족.'
+ not_for: 텍스트로 관계 설명 가능하면 사용 금지. sidebar(35%) 배치 금지. 높이 300px 미만 금지. 순차 흐름(A→B→C)
+ → process-horizontal. 대등 비교 → compare-pill-pair.
+ purpose_fit:
+ - 핵심전달
+ - 구조시각화
+ slots:
+ required:
+ - center_label
+ - items[]
+ optional:
+ - center_sub
+ - description
+ schema:
+ center_label:
+ max_lines: 1
+ font_size: 24
+ ref_chars:
+ body: 6
+ note: 24px bold, SVG 중심 원
+ center_sub:
+ max_lines: 1
+ font_size: 13
+ ref_chars:
+ body: 10
+ note: 13px, 중심 원 아래
+ item_label:
+ max_lines: 1
+ font_size: 14
+ ref_chars:
+ body: 8
+ note: 12-20px 동적, 작은 원 안
+ description:
+ max_lines: 2
+ font_size: 14
+ ref_chars:
+ body: 60
+ note: 14px, SVG 아래 설명
+ max_items:
+ body: 5
+ note: 아이템 수 (원 개수)
+ padding_overhead_px: 22
+ padding_h_px: 0
+ min_display_width_px: 200
+- id: circle-gradient
+ name: 원형 라벨
+ category: visuals
+ template: blocks/visuals/circle-gradient.html
+ height_cost: compact
+ min_height_px: 50
+ relation_types: []
+ visual: 파란 그라데이션 원(190px) + 이중 테두리 + 중앙 흰색 텍스트.
+ when: 섹션 전환점에서 키워드를 원형으로 강조. 아래에 카드/표가 올 때 주제 선언.
+ not_for: 본문 텍스트 → topic-header 계열. 결론 한 줄 → banner-gradient. 단독 사용 비추.
+ purpose_fit: []
+ slots:
+ required:
+ - label
+ optional:
+ - sub_label
+ schema:
+ label:
+ max_lines: 1
+ font_size: 22
+ ref_chars:
+ body: 6
+ sidebar: 6
+ note: 22px bold white, 원 안
+ sub_label:
+ max_lines: 1
+ font_size: 12
+ ref_chars:
+ body: 15
+ sidebar: 12
+ note: 12px, 원 아래
+ padding_overhead_px: 16
+ padding_h_px: 0
+ min_display_width_px: 150
+- id: compare-pill-pair
+ name: 둥근 박스 VS
+ category: visuals
+ template: blocks/visuals/compare-pill-pair.html
+ height_cost: compact
+ min_height_px: 60
+ relation_types:
+ - comparison
+ visual: 이중 테두리 둥근 박스 2개 나란히 + 'VS'. 하늘색 테두리 + 시안 텍스트.
+ visual_diff: '유사 블록과의 차이:
+
+ - compare-2col-split: 3열 표, 행별 기준 라벨+좌우 항목. 상세 비교용
+
+ - compare-3col-badge: 3열 표, VS 배지 중앙. 다항목 비교용
+
+ - comparison-2col: 좌우 텍스트 블록, 파란/빨간 밑줄. 문단형 비교
+
+ - card-compare-3col: 3개 독립 카드, 색상 헤더+불릿
+
+ - 이 블록: 둥근 필(pill) 박스 2개 + VS 텍스트만. 세부 항목 없이 대비 선언만 수행
+
+ 적합: 비교 테이블 위에 헤더로 배치. 두 개념의 시각적 대비를 짧게 선언할 때
+
+ 부적합: 세부 비교 항목 필요 → compare-3col-badge/compare-2col-split, 텍스트 설명 → comparison-2col
+
+ '
+ when: '2개 개념 시각적 대비. 비교 테이블 위 헤더로 사용. 예: "DX 협업 프로세스" VS "BIM 정보 관리".'
+ not_for: 상세 비교(5행+) → compare-3col-badge. 3개 이상 → card-compare-3col.
+ purpose_fit:
+ - 핵심전달
+ zone: full-width-only
+ slots:
+ required:
+ - left_label
+ - right_label
+ optional:
+ - left_sub
+ - right_sub
+ schema:
+ left_label:
+ max_lines: 1
+ font_size: 18
+ ref_chars:
+ body: 10
+ note: 18px bold, 350px 필 안
+ right_label:
+ max_lines: 1
+ font_size: 18
+ ref_chars:
+ body: 10
+ note: 18px bold, 350px 필 안
+ padding_overhead_px: 40
+ padding_h_px: 40
+ min_display_width_px: 200
+- id: process-horizontal
+ name: 가로 단계 흐름
+ category: visuals
+ template: blocks/visuals/process-horizontal.html
+ height_cost: medium
+ min_height_px: 100
+ relation_types:
+ - sequence
+ min_items: 2
+ max_items: 5
+ visual: 가로 방향. 파란 원형 번호 + 제목 + 설명(카드). → 화살표 연결.
+ visual_diff: '유사 블록과의 차이:
+
+ - flow-arrow-horizontal: SVG 캡슐 + 화살표만. 라벨 8자 이내. 설명 없이 흐름만 표현. 컴팩트(50px)
+
+ - 이 블록: 파란 원형 번호 + 제목 + 설명이 있는 카드 + 화살표 연결. 각 단계에 상세 설명 포함
+
+ 적합: 각 단계에 제목+설명이 필요한 상세 프로세스 흐름. 라벨이 긴 경우(8자 초과)
+
+ 부적합: 짧은 키워드만으로 흐름 표현 → flow-arrow-horizontal, 높이 예산 부족 → flow-arrow-horizontal
+
+ '
+ when: 논리적 순서가 있는 단계를 가로로. A→B→C→D 프로세스 흐름. 각 단계에 제목+설명이 필요할 때.
+ not_for: 독립 사례 나열(순서 없음) → card-icon-desc 또는 dark-bullet-list. 세로 나열 → card-numbered.
+ 간결한 흐름(설명 불필요) → flow-arrow-horizontal.
+ purpose_fit:
+ - 핵심전달
+ - 구조시각화
+ slots:
+ required:
+ - steps[]
+ optional: []
+ schema:
+ step_number:
+ max_lines: 1
+ font_size: 15
+ ref_chars:
+ body: 2
+ note: var(--font-body), 36px 원 안
+ step_title:
+ max_lines: 1
+ font_size: 15
+ ref_chars:
+ body: 10
+ sidebar: 8
+ note: var(--font-body) bold
+ step_description:
+ max_lines: 2
+ font_size: 13
+ ref_chars:
+ body: 40
+ sidebar: 25
+ note: var(--font-caption)
+ max_steps:
+ body: 5
+ sidebar: 3
+ note: 단계 수
+ padding_overhead_px: 0
+ padding_h_px: 0
+ min_display_width_px: 250
+- id: flow-arrow-horizontal
+ name: 가로 흐름 화살표
+ category: visuals
+ template: blocks/visuals/flow-arrow-horizontal.html
+ height_cost: compact
+ min_height_px: 50
+ relation_types:
+ - sequence
+ min_items: 2
+ max_items: 6
+ visual: SVG. 색상 둥근 캡슐이 가로 나열 + 사이 화살표. 컴팩트. 각 캡슐 120px 폭.
+ visual_diff: '유사 블록과의 차이:
+
+ - process-horizontal: 파란 원형 번호 + 제목 + 설명 카드 + 화살표. 각 단계에 제목+설명이 있는 상세 흐름
+
+ - 이 블록: SVG 캡슐(120px)이 가로 나열 + 사이 화살표. 라벨만(8자 이내). 설명 없이 흐름만 표현. 컴팩트
+
+ 적합: 짧은 키워드(8자 이내)로 순서/흐름만 간결하게 보여줄 때. 높이 예산이 적을 때
+
+ 부적합: 각 단계에 설명 필요 → process-horizontal, 라벨 8자 초과 → process-horizontal
+
+ '
+ when: '명확한 시간 순서 또는 인과 흐름이 있을 때만 사용. A→B→C 순서가 핵심. 예: GIS→SPCC→토공→BIM (기술 발전 순서).
+ ★ 각 라벨은 8자 이내로 짧아야 함(120px 캡슐 안에 들어가야 함).'
+ not_for: 독립 사례/증거 나열(순서 없음) → dark-bullet-list 또는 card-icon-desc. 정책 문서 나열 → dark-bullet-list.
+ 각 단계에 설명 필요 → process-horizontal. 라벨이 길면(8자 초과) → process-horizontal 또는 card-numbered.
+ purpose_fit:
+ - 구조시각화
+ zone: full-width-only
+ slots:
+ required:
+ - steps[]
+ optional: []
+ schema:
+ step_label:
+ max_lines: 1
+ font_size: 13
+ ref_chars:
+ body: 8
+ note: 13px bold, 120px 캡슐 안. 8자 이내 필수.
+ max_steps:
+ body: 6
+ note: 단계 수
+ padding_overhead_px: 20
+ padding_h_px: 0
+ min_display_width_px: 200
+- id: keyword-circle-row
+ name: 키워드 원형 행
+ category: visuals
+ template: blocks/visuals/keyword-circle-row.html
+ height_cost: medium
+ min_height_px: 120
+ relation_types:
+ - hierarchy
+ min_items: 2
+ max_items: 5
+ visual: SVG 그라데이션 원 안에 큰 글자(G,S,I,M 등 약어) + 아래 라벨 + 설명.
+ when: '약어 풀이. 핵심 키워드를 원형으로 시각 강조. 예: G(Geographic) + S(Structure) + I(Information)
+ + M(Model).'
+ not_for: 아이콘+설명 → card-icon-desc. 용어 정의(문장형) → card-numbered. 약어가 아닌 일반 텍스트 → 사용
+ 금지.
+ purpose_fit:
+ - 구조시각화
+ slots:
+ required:
+ - keywords[]
+ optional: []
+ schema:
+ letter:
+ max_lines: 1
+ font_size: 14
+ ref_chars:
+ body: 2
+ sidebar: 2
+ note: 약어 1~2글자
+ label:
+ max_lines: 1
+ font_size: 14
+ ref_chars:
+ body: 10
+ sidebar: 8
+ note: 14px bold, 1줄
+ description:
+ max_lines: 2
+ font_size: 12
+ ref_chars:
+ body: 25
+ sidebar: 20
+ note: 12px, 140px 폭, 2줄
+ max_keywords:
+ body: 5
+ sidebar: 3
+ note: 키워드 수
+ padding_overhead_px: 20
+ padding_h_px: 0
+ min_display_width_px: 200
+- id: quote-big-mark
+ name: 큰따옴표 인용
+ category: emphasis
+ template: blocks/emphasis/quote-big-mark.html
+ height_cost: medium
+ min_height_px: 80
+ relation_types: []
+ visual: 좌상단 ❝ + 우하단 ❞ 큰따옴표 장식. 연한 배경 박스 + 인용문 + 우측 출처.
+ visual_diff: '유사 블록과의 차이:
+
+ - quote-question: 파란 배경 + 파란 테두리 + 큰 질문(22px). 독자에게 질문을 던지는 구조
+
+ - callout-warning: 빨간 배경 + 경고 아이콘 + 설명. 문제점/위험 경고용
+
+ - callout-solution: 파란 배경 + 솔루션 아이콘 + 설명. 해결책 제시용
+
+ - 이 블록: 큰따옴표(❝❞) 장식이 좌상/우하에 배치. 연한 배경 + 인용문 텍스트 + 출처. 인용 형식
+
+ 적합: 출처가 있는 인용문. 권위 있는 발언/보고서를 인용 형태로 강조할 때
+
+ 부적합: 질문형 → quote-question, 문제 경고 → callout-warning, 해결책 → callout-solution
+
+ '
+ when: 임팩트 있는 인용문. 문제 제기를 인용 형태로 강조. 출처가 있는 인용.
+ not_for: 짧은 질문(1~2줄) → quote-question. 결론 한 줄 강조 → banner-gradient. 불릿 나열 → dark-bullet-list.
+ purpose_fit:
+ - 문제제기
+ - 근거사례
+ slots:
+ required:
+ - quote_text
+ optional:
+ - source
+ schema:
+ quote_text:
+ max_lines: 3
+ font_size: 16
+ ref_chars:
+ body: 120
+ sidebar: 70
+ note: 16px, 큰따옴표 장식 안, 3줄 이내
+ source:
+ max_lines: 1
+ font_size: 14
+ ref_chars:
+ body: 30
+ sidebar: 20
+ note: caption, 1줄
+ padding_overhead_px: 48
+ padding_h_px: 56
+- id: quote-question
+ name: 질문형 강조
+ category: emphasis
+ template: blocks/emphasis/quote-question.html
+ height_cost: medium
+ min_height_px: 80
+ relation_types: []
+ visual: 밝은 파란 배경 + 파란 테두리 + 큰 질문 텍스트(22px) + 부연 설명.
+ visual_diff: '유사 블록과의 차이:
+
+ - quote-big-mark: 큰따옴표 장식 + 인용문 + 출처. 타인의 말을 인용하는 형식
+
+ - callout-warning: 빨간 배경 + 경고 아이콘. 문제점 경고. 부정적 톤
+
+ - callout-solution: 파란 배경 + 솔루션 아이콘. 해결책 제시. 긍정적 톤
+
+ - 이 블록: 파란 배경+테두리 + 큰 질문(22px bold). 독자에게 직접 질문하는 구조. 부연 설명 포함
+
+ 적합: 독자에게 질문을 던져 문제 인식을 유도하는 전환점. 물음표로 끝나는 핵심 질문
+
+ 부적합: 타인 인용(출처) → quote-big-mark, 경고 → callout-warning, 해결책 → callout-solution
+
+ '
+ when: '독자에게 질문을 던져 문제 인식을 유도. 전환점. 예: "지금의 방식으로도 가능할까?"'
+ not_for: 인용(출처 있음) → quote-big-mark. 결론 선언 → banner-gradient. 경고/문제 → callout-warning.
+ purpose_fit:
+ - 문제제기
+ slots:
+ required:
+ - question
+ optional:
+ - description
+ schema:
+ question:
+ max_lines: 1
+ font_size: 22
+ ref_chars:
+ body: 35
+ sidebar: 25
+ note: 22px bold, 1줄 권장
+ description:
+ max_lines: 3
+ font_size: 14
+ ref_chars:
+ body: 120
+ sidebar: 80
+ note: 14px, 3줄 이내
+ padding_overhead_px: 56
+ padding_h_px: 48
+- id: comparison-2col
+ name: 2단 병렬 비교
+ category: emphasis
+ template: blocks/emphasis/comparison-2col.html
+ height_cost: medium
+ min_height_px: 80
+ relation_types:
+ - comparison
+ variants:
+ - id: default
+ description: 좌우 2단 텍스트 비교 (기본)
+ - id: cards-in-container
+ description: 큰 박스 안에 카드 N개 (포함 관계 시각화, DX⊃BIM)
+ template: blocks/emphasis/comparison-2col--cards-in-container.html
+ when: hierarchy/inclusion — A 안에 B,C,D가 포함됨을 보여줄 때. 포함 관계 시각화
+ visual: 좌우 2단. 좌 파란 헤더(밑줄) + 우 빨간 헤더(밑줄). 중앙 구분선. 서브타이틀+본문.
+ visual_diff: '유사 블록과의 차이:
+
+ - compare-2col-split: 표 형식. 행마다 기준 라벨+좌우 셀. 정형화된 비교
+
+ - compare-3col-badge: 표 형식. VS 배지 중앙 열. 다항목 행별 비교
+
+ - compare-pill-pair: 둥근 박스 2개 + VS. 헤더 역할만, 세부 내용 없음
+
+ - card-compare-3col: 3개 독립 카드, 카드별 색상 헤더+불릿
+
+ - 이 블록: 자유 텍스트 좌우 블록. 좌=파란 밑줄, 우=빨간 밑줄. CSS var 사용. 표가 아니라 문단형
+
+ 적합: 2~3항목의 간결한 대비. 장단점, Before/After. 자유로운 텍스트 비교
+
+ 부적합: 5행+ 다항목 비교 → compare-3col-badge/compare-2col-split, 3개 비교 → card-compare-3col
+
+ '
+ when: 'A vs B 간단 비교. 2~3개 항목을 좌우로 대비. 장단점, Before/After 등 대비 구조. 예: BIM(하위기술) vs
+ DX(상위개념).'
+ not_for: 다항목 표(5행+) → compare-3col-badge. 결론 한 줄 강조 → banner-gradient. 핵심 메시지 선언
+ → banner-gradient. footer에서 결론 강조용으로 쓰지 마라.
+ purpose_fit:
+ - 핵심전달
+ slots:
+ required:
+ - left_title
+ - left_content
+ - right_title
+ - right_content
+ optional:
+ - left_subtitle
+ - right_subtitle
+ schema:
+ left_title:
+ max_lines: 1
+ font_size: 18
+ ref_chars:
+ body: 15
+ note: var(--font-subtitle) bold, 파란 밑줄
+ left_subtitle:
+ max_lines: 1
+ font_size: 13
+ ref_chars:
+ body: 20
+ note: var(--font-caption)
+ left_content:
+ max_lines: 5
+ font_size: 15
+ ref_chars:
+ body: 150
+ note: var(--font-body)
+ right_title:
+ max_lines: 1
+ font_size: 18
+ ref_chars:
+ body: 15
+ note: var(--font-subtitle) bold, 빨간 밑줄
+ right_subtitle:
+ max_lines: 1
+ font_size: 13
+ ref_chars:
+ body: 20
+ note: var(--font-caption)
+ right_content:
+ max_lines: 5
+ font_size: 15
+ ref_chars:
+ body: 150
+ note: var(--font-body)
+ padding_overhead_px: 0
+ padding_h_px: 0
+- id: banner-gradient
+ name: 그라데이션 배너
+ category: emphasis
+ template: blocks/emphasis/banner-gradient.html
+ height_cost: compact
+ min_height_px: 40
+ relation_types: []
+ visual: 전체 너비 파란 그라데이션 배경(둥근 모서리 8px) + 중앙 흰색 굵은 텍스트(16px) + 선택적 서브텍스트.
+ when: '★ 결론 강조에 가장 적합. 핵심 메시지 한 줄 선언. footer 배치에 최적(compact, 50~60px). 페이지의 "기억해야
+ 할 단 하나의 문장". 예: "BIM은 DX의 기초가 되는 일부분이다. DX ≠ BIM"'
+ not_for: 인용(출처) → quote-big-mark. 긴 설명(3줄+) → callout-solution. A vs B 비교 → comparison-2col.
+ purpose_fit:
+ - 결론강조
+ slots:
+ required:
+ - text
+ optional:
+ - sub_text
+ schema:
+ text:
+ max_lines: 1
+ font_size: 16
+ ref_chars:
+ body: 38
+ sidebar: 18
+ note: 16px bold white, 1줄
+ sub_text:
+ max_lines: 1
+ font_size: 12
+ ref_chars:
+ body: 50
+ sidebar: 30
+ note: 12px, 1줄
+ padding_overhead_px: 32
+ padding_h_px: 60
+- id: dark-bullet-list
+ name: 다크 배경 불릿
+ category: emphasis
+ template: blocks/emphasis/dark-bullet-list.html
+ height_cost: medium
+ min_height_px: 80
+ relation_types:
+ - cause_effect
+ min_items: 2
+ max_items: 5
+ variants:
+ - id: default
+ description: 다크 배경 + 불릿 나열 (기본)
+ - id: before-after
+ description: Before→After 2열 구조 (프로세스 변화, 전환)
+ template: blocks/emphasis/dark-bullet-list--before-after.html
+ when: 기존 방식 → 새 방식으로의 전환/변화를 보여줄 때. 각 항목이 before/after 쌍일 때
+ visual: 짙은 남색 배경 + 파란 제목 + 흰 텍스트 불릿. 파란 불릿 마커. 시각적 무게감.
+ when: ★ 독립적인 사례/증거/포인트를 나열할 때 적합. 순서 없는 항목을 강조하며 나열. 정책 문서 사례, 근거 자료 나열.
+ not_for: 밝은 배경 → card-icon-desc 또는 card-numbered. 순서가 있는 단계 → card-numbered 또는 process-horizontal.
+ 시각화(다이어그램) → venn-diagram.
+ purpose_fit:
+ - 근거사례
+ - 문제제기
+ - 핵심전달
+ slots:
+ required:
+ - bullets[]
+ optional:
+ - title
+ schema:
+ title:
+ max_lines: 1
+ font_size: 16
+ ref_chars:
+ body: 30
+ sidebar: 20
+ note: 16px bold, 1줄
+ bullet_item:
+ max_lines: 1
+ font_size: 14
+ ref_chars:
+ body: 86
+ sidebar: 41
+ note: 14px, 1불릿 기준
+ max_bullets:
+ body: 5
+ sidebar: 4
+ note: 불릿 수
+ padding_overhead_px: 32
+ padding_h_px: 48
+- id: highlight-strip
+ name: 강조 분류 스트립
+ category: emphasis
+ template: blocks/emphasis/highlight-strip.html
+ height_cost: compact
+ min_height_px: 35
+ relation_types: []
+ visual: 가로 색상 구간들. 각 구간에 흰 라벨. 카테고리 색상 분류 바.
+ when: '카테고리별 색상 분류를 한 줄로. 예: 상용(회색) | 3rd Party(파랑) | 전문SW(빨강).'
+ not_for: 탭 전환 → tab-label-row. 결론 강조 → banner-gradient. 독립 항목 나열 → dark-bullet-list.
+ purpose_fit:
+ - 구조시각화
+ slots:
+ required:
+ - segments[]
+ optional: []
+ schema:
+ label:
+ max_lines: 1
+ font_size: 14
+ ref_chars:
+ body: 15
+ sidebar: 10
+ note: 14px bold white, nowrap, 세그먼트당
+ max_segments:
+ body: 4
+ sidebar: 3
+ note: 세그먼트 수
+ padding_overhead_px: 20
+ padding_h_px: 32
+- id: callout-solution
+ name: 솔루션 콜아웃
+ category: emphasis
+ template: blocks/emphasis/callout-solution.html
+ height_cost: medium
+ min_height_px: 80
+ relation_types:
+ - cause_effect
+ visual: 밝은 파란 배경 + 파란 테두리 + 아이콘 + 파란 제목 + 설명 + 출처.
+ visual_diff: '유사 블록과의 차이:
+
+ - quote-big-mark: 큰따옴표 장식 + 인용문 + 출처. 인용 형식
+
+ - quote-question: 파란 배경 + 큰 질문(22px). 독자에게 질문하는 구조
+
+ - callout-warning: 빨간 배경 + 경고 아이콘 + 빨간 텍스트. 문제점/위험 경고용
+
+ - 이 블록: 파란 배경+테두리 + 솔루션 아이콘 + 파란 제목 + 설명(최대 4줄) + 출처. 긍정적/해결책 톤
+
+ 적합: 핵심 해결책, 방향성, 솔루션을 강조. 긴 설명(3~4줄)과 출처가 필요할 때
+
+ 부적합: 경고/문제 → callout-warning, 인용 → quote-big-mark, 질문 → quote-question
+
+ '
+ when: '핵심 해결책, 솔루션, 방향성을 강조. 예: "💡 Solution 제시 포인트".'
+ not_for: 경고/문제 → callout-warning. 인용 → quote-big-mark. 결론 한 줄 → banner-gradient.
+ purpose_fit:
+ - 핵심전달
+ slots:
+ required:
+ - title
+ - description
+ optional:
+ - icon
+ - source
+ schema:
+ title:
+ max_lines: 1
+ font_size: 17
+ ref_chars:
+ body: 40
+ sidebar: 25
+ note: 17px bold, 1줄
+ description:
+ max_lines: 4
+ font_size: 14
+ ref_chars:
+ body: 150
+ sidebar: 90
+ note: 14px, 3~4줄
+ padding_overhead_px: 40
+ padding_h_px: 48
+- id: callout-warning
+ name: 경고 콜아웃
+ category: emphasis
+ template: blocks/emphasis/callout-warning.html
+ height_cost: medium
+ min_height_px: 80
+ relation_types:
+ - cause_effect
+ visual: 연한 빨간 배경 + 빨간 테두리 + 아이콘 + 빨간 제목 + 진한 빨간 설명.
+ visual_diff: '유사 블록과의 차이:
+
+ - quote-big-mark: 큰따옴표 장식 + 인용문 + 출처. 인용 형식으로 중립적 톤
+
+ - quote-question: 파란 배경 + 큰 질문. 독자에게 질문을 던지는 구조
+
+ - callout-solution: 파란 배경 + 솔루션 아이콘 + 설명. 해결책/긍정적 메시지
+
+ - 이 블록: 빨간 배경+테두리 + 경고 아이콘 + 빨간 제목/설명. 부정적/경고 톤. 문제점 강조 전용
+
+ 적합: 문제점 지적, 잘못된 인식 경고, 위험 요소 강조. 빨간색으로 시각적 경고 전달
+
+ 부적합: 해결책 → callout-solution, 인용 → quote-big-mark, 질문 → quote-question
+
+ '
+ when: '문제점 지적, 잘못된 인식 경고, 주의사항. 문제 제기 purpose에 적합. 예: "⚠️ 현재 접근 방식의 한계".'
+ not_for: 해결책 → callout-solution. 인용 → quote-big-mark. 결론 → banner-gradient.
+ purpose_fit:
+ - 문제제기
+ slots:
+ required:
+ - title
+ - description
+ optional:
+ - icon
+ schema:
+ title:
+ max_lines: 1
+ font_size: 17
+ ref_chars:
+ body: 40
+ sidebar: 25
+ note: 17px bold 빨간색
+ description:
+ max_lines: 4
+ font_size: 14
+ ref_chars:
+ body: 150
+ sidebar: 90
+ note: 14px 진한 빨간
+ padding_overhead_px: 40
+ padding_h_px: 48
+- id: tab-label-row
+ name: 탭 라벨 행
+ category: emphasis
+ template: blocks/emphasis/tab-label-row.html
+ height_cost: compact
+ min_height_px: 35
+ relation_types: []
+ visual: 가로 탭 버튼. 선택됨=색상 배경+흰 텍스트, 나머지=회색. 밝은 바탕.
+ when: '카테고리 전환/분류 표시. 현재 선택된 항목 강조. 예: 제조 | 건축 | [인프라/토목].'
+ not_for: 색상 바 → highlight-strip. 실제 클릭 전환 미지원.
+ purpose_fit: []
+ slots:
+ required:
+ - tabs[]
+ optional: []
+ schema:
+ tab_label:
+ max_lines: 1
+ font_size: 14
+ ref_chars:
+ body: 10
+ sidebar: 8
+ note: 14px bold, 탭당
+ max_tabs:
+ body: 5
+ sidebar: 3
+ note: 탭 수
+ padding_overhead_px: 8
+ padding_h_px: 0
+- id: divider-text
+ name: 텍스트 구분선
+ category: emphasis
+ template: blocks/emphasis/divider-text.html
+ height_cost: compact
+ min_height_px: 25
+ relation_types: []
+ visual: 좌우 가는 회색 선 + 중앙 작은 회색 텍스트(13px bold). 시각적 휴식점.
+ when: 'sidebar 영역의 섹션 라벨. 주제 전환점에 가벼운 구분. 예: ── 용어 정의 ──'
+ not_for: 강한 구분 → section-header-bar. 결론 → banner-gradient. body 영역 메인 제목 → topic
+ 계열.
+ purpose_fit: []
+ slots:
+ required:
+ - text
+ optional: []
+ schema:
+ text:
+ max_lines: 1
+ font_size: 13
+ ref_chars:
+ body: 20
+ sidebar: 15
+ note: 13px bold, nowrap, 중앙정렬
+ padding_overhead_px: 16
+ padding_h_px: 0
+- id: image-row-2col
+ name: 이미지 2열
+ category: media
+ template: blocks/media/image-row-2col.html
+ height_cost: large
+ min_height_px: 200
+ relation_types: []
+ visual: 이미지 2장 나란히. 각 캡션 선택.
+ when: 시공 사진 2장 나란히, 현장 비교.
+ not_for: 4장 → image-grid-2x2. 이미지+텍스트 → image-side-text. 1장 → image-full-caption.
+ purpose_fit:
+ - 근거사례
+ slots:
+ required:
+ - images[]
+ optional: []
+ schema:
+ caption:
+ max_lines: 1
+ font_size: 11
+ ref_chars:
+ body: 30
+ sidebar: 20
+ note: 11px, 이미지 아래
+ max_images:
+ body: 2
+ note: 이미지 수
+ padding_overhead_px: 0
+ padding_h_px: 0
+- id: image-grid-2x2
+ name: 이미지 2x2 그리드
+ category: media
+ template: blocks/media/image-grid-2x2.html
+ height_cost: large
+ min_height_px: 350
+ relation_types: []
+ visual: 이미지 4장 2x2 격자. 각 캡션 선택.
+ when: 현장 사진 4장, 4개 관점 이미지.
+ not_for: 2장 → image-row-2col. 이미지+텍스트 → image-side-text.
+ purpose_fit:
+ - 근거사례
+ slots:
+ required:
+ - images[]
+ optional: []
+ schema:
+ caption:
+ max_lines: 1
+ font_size: 11
+ ref_chars:
+ body: 30
+ note: 11px, 이미지 아래
+ max_images:
+ body: 4
+ note: 이미지 수 (2x2)
+ padding_overhead_px: 8
+ padding_h_px: 0
+- id: image-side-text
+ name: 이미지+텍스트 가로
+ category: media
+ template: blocks/media/image-side-text.html
+ height_cost: medium
+ min_height_px: 150
+ relation_types: []
+ visual: 좌측 이미지(320px 고정) + 우측 제목+설명+불릿. 가로 배치.
+ when: 이미지에 대한 설명. 제품/시스템 소개. 다이어그램+해설.
+ not_for: 이미지만 → image-row-2col. 여러 장 → image-grid-2x2.
+ purpose_fit:
+ - 핵심전달
+ - 근거사례
+ slots:
+ required:
+ - image_src
+ optional:
+ - image_alt
+ - title
+ - description
+ - bullets
+ schema:
+ title:
+ max_lines: 1
+ font_size: 18
+ ref_chars:
+ body: 20
+ note: 18px bold
+ description:
+ max_lines: 3
+ font_size: 14
+ ref_chars:
+ body: 100
+ note: 14px
+ bullet_item:
+ max_lines: 1
+ font_size: 13
+ ref_chars:
+ body: 40
+ note: 13px, 불릿당
+ max_bullets:
+ body: 4
+ note: 불릿 수
+ padding_overhead_px: 4
+ padding_h_px: 0
+- id: image-full-caption
+ name: 전체 너비 이미지
+ category: media
+ template: blocks/media/image-full-caption.html
+ height_cost: large
+ min_height_px: 200
+ relation_types: []
+ visual: 전체 너비 이미지 1장(둥근 모서리) + 하단 캡션.
+ when: 핵심 도표, 대형 다이어그램, 전경 사진을 크게.
+ not_for: 2장+ → image-row-2col/image-grid-2x2. 이미지+텍스트 → image-side-text.
+ purpose_fit:
+ - 핵심전달
+ slots:
+ required:
+ - src
+ optional:
+ - alt
+ - caption
+ schema:
+ caption:
+ max_lines: 1
+ font_size: 12
+ ref_chars:
+ body: 40
+ note: 12px, 이미지 아래
+ padding_overhead_px: 0
+ padding_h_px: 0
+- id: image-before-after
+ name: Before/After 이미지
+ category: media
+ template: blocks/media/image-before-after.html
+ height_cost: large
+ min_height_px: 200
+ relation_types:
+ - comparison
+ visual: 좌 Before(회색 라벨) + → 화살표(파란) + 우 After(파란 라벨). 각 이미지 180px.
+ when: 변화 전후 비교. 디지털 전환 전후, 공정 개선 전후.
+ not_for: 이미지 단순 나열 → image-row-2col. 텍스트 비교 → comparison-2col.
+ purpose_fit:
+ - 핵심전달
+ - 근거사례
+ slots:
+ required:
+ - before_src
+ - after_src
+ optional:
+ - before_label
+ - after_label
+ - caption
+ schema:
+ before_label:
+ max_lines: 1
+ font_size: 13
+ ref_chars:
+ body: 8
+ note: 13px bold white, 라벨
+ after_label:
+ max_lines: 1
+ font_size: 13
+ ref_chars:
+ body: 8
+ note: 13px bold white, 라벨
+ caption:
+ max_lines: 1
+ font_size: 12
+ ref_chars:
+ body: 40
+ note: 12px, 하단 캡션
+ padding_overhead_px: 0
+ padding_h_px: 0
+layouts:
+- id: 65-35
+ name: 6.5:3.5 좌우 분할
+ grid_columns: 6.5fr 3.5fr
+ when: 좌측 메인 + 우측 보조
+- id: 50-50
+ name: 5:5 균등 분할
+ grid_columns: 1fr 1fr
+ when: 대등한 비교
+- id: single
+ name: 단일 컬럼
+ grid_columns: 1fr
+ when: 순차 구조
+- id: 35-65
+ name: 3.5:6.5 좌우 분할
+ grid_columns: 3.5fr 6.5fr
+ when: 좌측 보조 + 우측 메인
diff --git a/templates/slide-base.html b/templates/slide-base.html
new file mode 100644
index 0000000..c89019b
--- /dev/null
+++ b/templates/slide-base.html
@@ -0,0 +1,61 @@
+
+
+
+
+{{ description }}
+ {% endif %}
+
+ {% if loop.first and slide_title %}
+
+{% endfor %}
+
+
+
{{ slide_title }}
+ {% endif %}
+
+ {% for block in page.blocks %}
+
+ {{ block.html }}
+
+ {% endfor %}
+