KyeongminandClaude Opus 4.8
b836e79ee1
- src: phase_z2 composition/mapper/pipeline/placement_planner/retry, ai_fallback(prompts/schema/validate), mdx_text_atoms 신규 - Front: PipelineTracePanel 신규, FramePanel/SlideCanvas/Home/designAgentApi 등 갱신 + 테스트 4종 추가 - templates/phase_z2: catalog(component_expansion_registry, node_slot_mapping 신규), frames, families, slide_base 갱신 - tests/matching: phase2~26 매칭 실험 스크립트·리포트·온톨로지 전체 (미커밋 진행분) - tests: b4_v4 evidence, task5~28.5 시리즈, regression(imp95 baseline) 등 신규 테스트 대량 추가 - docs/reference: MDX 구조 인벤토리, MDX→Frame 구조 계약 문서 - scripts: mdx 계약/parity/coverage/viewport 체크, gitea comment, run sync 유틸 - .gitignore: tmp*.json, chromedriver, .orchestrator, *.pkl, Front_test* 등 임시/스냅샷 제외 미완성 작업의 보존용 스냅샷 커밋 (2026-07-02) Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
49 lines
14 KiB
HTML
49 lines
14 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="ko"><head><meta charset="utf-8"><title>05. 구조 매칭 4 항목 상세</title>
|
|
<style>
|
|
@page { size: A4 portrait; margin: 12mm; }
|
|
* { box-sizing: border-box; }
|
|
body {
|
|
font-family: -apple-system, "Segoe UI", Pretendard, "Malgun Gothic", sans-serif;
|
|
background: white; color: #1e293b; margin: 0; font-size: 9.5pt; line-height: 1.4;
|
|
}
|
|
@media screen {
|
|
body { max-width: 210mm; margin: 10mm auto; box-shadow: 0 4px 24px rgba(0,0,0,0.12); padding: 12mm; background: #fff; }
|
|
}
|
|
h1 { font-size: 13pt; border-bottom: 2pt solid #2563eb; padding-bottom: 3pt; margin: 0 0 4pt 0; color: #0f172a; }
|
|
h2 { font-size: 10pt; color: #1e293b; margin: 6pt 0 3pt; padding: 2pt 5pt; background: #e0e7ff; border-left: 3pt solid #0a6; border-radius: 2pt; }
|
|
.meta { color: #64748b; font-size: 8pt; font-style: italic; margin-bottom: 5pt; }
|
|
.mdx-card { background: #f8fafc; border: 0.5pt solid #cbd5e1; border-radius: 3pt; padding: 5pt 8pt; margin: 3pt 0 5pt; }
|
|
.mdx-card .title { font-weight: 700; color: #0f172a; font-size: 9.5pt; margin-bottom: 2pt; }
|
|
.popup-tag { display: inline-block; padding: 1pt 5pt; background: #eef2ff; color: #3730a3; border-radius: 8pt; font-size: 7.5pt; font-weight: 700; margin-left: 4pt; vertical-align: middle; }
|
|
.mdx-card ul { margin: 2pt 0 0 0; padding-left: 12pt; font-size: 8pt; color: #475569; }
|
|
table { border-collapse: collapse; width: 100%; font-size: 9pt; }
|
|
th, td { border: 0.5pt solid #cbd5e1; padding: 3pt 5pt; text-align: left; vertical-align: top; }
|
|
th { background: #1e293b; color: white; font-weight: 700; font-size: 8.5pt; text-align: center; }
|
|
code { background: #f1f5f9; padding: 0 3pt; border-radius: 2pt; font-family: ui-monospace, Menlo, monospace; font-size: 8.5pt; color: #0f172a; }
|
|
.formula-box { background: #eff6ff; border: 0.7pt solid #93c5fd; border-radius: 3pt; padding: 5pt 8pt; margin: 3pt 0; font-size: 9pt; color: #1e3a8a; }
|
|
.label-use_as_is { background: #d1fae5; color: #065f46; padding: 1pt 5pt; border-radius: 2pt; font-size: 7.5pt; font-weight: 700; }
|
|
.label-light_edit { background: #dbeafe; color: #1e40af; padding: 1pt 5pt; border-radius: 2pt; font-size: 7.5pt; font-weight: 700; }
|
|
.label-restructure { background: #fef3c7; color: #92400e; padding: 1pt 5pt; border-radius: 2pt; font-size: 7.5pt; font-weight: 700; }
|
|
.label-reject { background: #fee2e2; color: #991b1b; padding: 1pt 5pt; border-radius: 2pt; font-size: 7.5pt; font-weight: 700; }
|
|
|
|
@page { size: A4 portrait; margin: 12mm; }
|
|
.sk-block { background: #fafafa; border: 0.7pt solid #cbd5e1; border-radius: 4pt; padding: 6pt 9pt; margin: 5pt 0; }
|
|
.sk-block .sk-title { font-size: 11pt; font-weight: 700; color: #2563eb; margin-bottom: 3pt; }
|
|
.sk-block .sk-title .num { display: inline-block; background: #2563eb; color: white; width: 18pt; height: 18pt; line-height: 18pt; text-align: center; border-radius: 50%; font-size: 9pt; margin-right: 6pt; }
|
|
.sk-block .sk-title .accuracy { float: right; font-size: 8pt; padding: 2pt 7pt; border-radius: 8pt; font-weight: 700; }
|
|
.sk-block .accuracy.good { background: #d1fae5; color: #065f46; }
|
|
.sk-block .accuracy.weak { background: #fee2e2; color: #991b1b; }
|
|
.sk-block .what { font-size: 9pt; color: #475569; margin: 3pt 0; }
|
|
.sk-block .what b { color: #0f172a; }
|
|
.sk-block .how { background: white; border-left: 2.5pt solid #2563eb; padding: 4pt 8pt; margin: 4pt 0; font-size: 8.5pt; line-height: 1.5; }
|
|
.sk-block .how b { color: #1e3a8a; }
|
|
.sk-block table.dict { width: 100%; font-size: 8pt; border-collapse: collapse; margin-top: 3pt; }
|
|
.sk-block table.dict th { background: #1e293b; color: white; padding: 2pt 5pt; font-size: 7.5pt; text-align: left; }
|
|
.sk-block table.dict td { border: 0.4pt solid #cbd5e1; padding: 2pt 5pt; vertical-align: top; }
|
|
.sk-block table.dict td.cat { font-weight: 700; color: #1e3a8a; width: 30%; background: #eff6ff; font-family: ui-monospace, monospace; font-size: 7.5pt; }
|
|
.sk-block table.dict td.kws { color: #475569; font-size: 7.5pt; }
|
|
.sk-block .example { background: #fffbeb; border: 0.5pt solid #f59e0b; border-radius: 2pt; padding: 4pt 7pt; margin-top: 4pt; font-size: 8pt; color: #78350f; }
|
|
.sk-block .example b { color: #92400e; }
|
|
.sk-block .limit { background: #fee2e2; color: #991b1b; padding: 1pt 5pt; border-radius: 2pt; font-size: 7.5pt; font-weight: 600; }
|
|
</style></head><body><h1>05. 구조 매칭 4 항목 — MDX 본문을 어떻게 분석하나</h1><div class="meta">DECK 04 의 「구조 매칭」 4 항목이 코드에서 실제로 어떻게 동작하는지 상세 설명. 각 항목별 정의 + 매칭 방법 + 사용하는 키워드 사전.</div><div class="sk-block"><div class="sk-title"><span class="num">1</span>콘텐츠 성격 (content_affinity)<span class="accuracy weak">정확도 약함</span></div><div class="what"><b>무엇인가</b> : MDX 콘텐츠가 어떤 종류의 정보를 담는가 (개념 정의 / 비교 / 정책·요구사항 / 단계 흐름 / 변화 / 역할 등 12 카테고리)</div><div class="how"><b>매칭 방법</b> : 사전 정의 12 카테고리의 키워드 사전을 가지고 MDX 본문에서 각 키워드 등장 횟수를 카운트 → <b>가장 많이 매칭된 카테고리 = primary</b>. (2위·3위 = secondary)</div><table class="dict"><thead><tr><th style="width:32%">카테고리 (영문 enum / 한글)</th><th>매칭 키워드</th></tr></thead><tbody><tr><td class="cat">concept_definition<br/><span style="color:#475569;font-weight:400">개념 정의</span></td><td class="kws">정의, 이란, 분류, 구분</td></tr><tr><td class="cat">concept_comparison<br/><span style="color:#475569;font-weight:400">개념 비교</span></td><td class="kws">비교, 대조, 차이, vs, VS, 상호관계</td></tr><tr><td class="cat">goal_axes<br/><span style="color:#475569;font-weight:400">목표 축</span></td><td class="kws">목표, 궁극적, 비전, 목적, 지향</td></tr><tr><td class="cat">persona_benefit<br/><span style="color:#475569;font-weight:400">대상별 효익</span></td><td class="kws">발주자, 설계자, 시공자, 기대효과, 혜택, 이익</td></tr><tr><td class="cat">process_steps<br/><span style="color:#475569;font-weight:400">단계 흐름</span></td><td class="kws">단계, 순서, Step, 1단계, 2단계, 흐름</td></tr><tr><td class="cat">before_after_change<br/><span style="color:#475569;font-weight:400">변화 / 전환</span></td><td class="kws">AS-IS, TO-BE, 전환, 혁신, 변화, 이중 변환, 과정 <span style="color:#dc2626">(STRONG 패턴 필수)</span></td></tr><tr><td class="cat">capability_requirements<br/><span style="color:#475569;font-weight:400">역량 / 요건</span></td><td class="kws">필수, 요건, 필요, 역량, S/W, 도구</td></tr><tr><td class="cat">comparative_matrix<br/><span style="color:#475569;font-weight:400">행렬형 비교</span></td><td class="kws">다면, 다축, 관점별, 여러 관점, 축</td></tr><tr><td class="cat">stakeholder_roles<br/><span style="color:#475569;font-weight:400">이해관계자 역할</span></td><td class="kws">역할, 책임, 주도</td></tr><tr><td class="cat">policy_requirements<br/><span style="color:#475569;font-weight:400">정책 / 요구사항</span></td><td class="kws">정책, 제도, 도입, 거버넌스, 전면 도입, 국외, 국내, 선진, 현황, 사례</td></tr><tr><td class="cat">tool_ecosystem<br/><span style="color:#475569;font-weight:400">도구 생태계</span></td><td class="kws">Revit, Navisworks, SketchUp, 소프트웨어, S/W 생태</td></tr><tr><td class="cat">interrelation<br/><span style="color:#475569;font-weight:400">상호관계</span></td><td class="kws">상호관계, 순환, 조화, 교차, 수렴, 3원, 순환도, 관계도</td></tr></tbody></table><div class="example"><b>예시 — MDX 01-2 (DX 와 BIM 의 구분)</b><br/>본문에 「국내, 도입, 사례, 현황」 다수 등장 → <code>policy_requirements</code> (정책/요구사항) 1위로 잘못 잡힘. <span class="limit">한계 : 단순 카운트라 부정확</span> (사람이 보면 「행렬형 비교」가 맞음)</div></div><div class="sk-block"><div class="sk-title"><span class="num">2</span>시각 의도 (structure_intent)<span class="accuracy weak">정확도 약함</span></div><div class="what"><b>무엇인가</b> : 콘텐츠를 어떤 방식으로 시각적으로 표현하려는지 (2 항목 비교 / 매트릭스 / 순환 / 단계 / 위계 / 강조 등 9 카테고리)</div><div class="how"><b>매칭 방법</b> : 사전 9 카테고리 키워드 매칭 (콘텐츠 성격과 동일 방식) + 일부 카테고리는 <b>STRONG 구절 패턴 추가 검증</b> 필수 (예: state_transition 은 「AS-IS / TO-BE」 같은 강한 구절 1개 이상)</div><table class="dict"><thead><tr><th style="width:32%">카테고리 (영문 enum / 한글)</th><th>매칭 키워드</th></tr></thead><tbody><tr><td class="cat">binary_compare<br/><span style="color:#475569;font-weight:400">2 항목 직접 비교</span></td><td class="kws">2개 비교, 2개 개념, 대조, 양분</td></tr><tr><td class="cat">state_transition<br/><span style="color:#475569;font-weight:400">상태 전환</span></td><td class="kws">AS-IS, TO-BE, 전환, 혁신, 이중 Transformation, 과정 <span style="color:#dc2626">(STRONG 필수)</span></td></tr><tr><td class="cat">cycle_interrelation<br/><span style="color:#475569;font-weight:400">순환 / 상호 관계</span></td><td class="kws">상호관계, 순환, 조화, 교차, 3원</td></tr><tr><td class="cat">multi_parallel<br/><span style="color:#475569;font-weight:400">다항목 병렬</span></td><td class="kws">3개 병렬, 4개 병렬, 카드 3열, 3관점</td></tr><tr><td class="cat">hierarchy<br/><span style="color:#475569;font-weight:400">위계</span></td><td class="kws"><i style="color:#64748b">단일 키워드 매칭 금지 — STRONG 구절 패턴만 인정</i></td></tr><tr><td class="cat">sequence<br/><span style="color:#475569;font-weight:400">순차 단계</span></td><td class="kws">단계, 순서, 흐름, step</td></tr><tr><td class="cat">matrix_coverage<br/><span style="color:#475569;font-weight:400">매트릭스 (모든 축 한눈에)</span></td><td class="kws">다면, 관점별, 여러 관점, 축별</td></tr><tr><td class="cat">persona_mapping<br/><span style="color:#475569;font-weight:400">주체별 매핑</span></td><td class="kws">주체별, 발주자/설계자/시공자, 역할별</td></tr><tr><td class="cat">singleton_emphasis<br/><span style="color:#475569;font-weight:400">단일 강조</span></td><td class="kws">강조, 문제, 진단, 약점</td></tr></tbody></table><div class="example"><b>예시 — MDX 01-2</b><br/>제목·본문에 「상호관계」 단어가 있어 <code>cycle_interrelation</code> (순환/상호 관계) 1위로 잡힘. <span class="limit">한계 : 도메인 키워드 사전이라 일반 표현은 못 잡음</span></div></div><div class="sk-block"><div class="sk-title"><span class="num">3</span>편집 슬롯 (slot)<span class="accuracy weak">표면적 검사만</span></div><div class="what"><b>무엇인가</b> : 프레임에서 텍스트 교체 가능한 영역 (예: 제목 / A 컬럼 라벨 / B 컬럼 라벨 / 행 데이터). MDX 콘텐츠가 이 슬롯들을 채울 수 있는가가 핵심.</div><div class="how"><b>매칭 방법</b> : MDX 본문에서 슬롯 후보를 자동 추출 → 후보의 라벨/본문 유무로 점수.<br/> · <b>슬롯 후보 추출 우선순위</b> :<br/> ① subsections (`##` 헤딩) 있으면 → 각 헤딩이 슬롯. label = 헤딩 텍스트, body = 헤딩 아래 본문<br/> ② 표 있으면 → 각 컬럼이 슬롯. label = 컬럼 헤더, body = 첫 행 데이터<br/> ③ 불릿 (`*`, `-`) 있으면 → 각 불릿이 슬롯. label = 불릿 첫 단어, body = 불릿 나머지<br/> · <b>점수 계산</b> (휴리스틱) :<br/> ① MDX 항목 수가 frame cardinality [min, max] 범위 안 → +0.5<br/> ② 모든 후보에 라벨이 비어있지 않음 → +0.3<br/> ③ 모든 후보에 본문이 비어있지 않음 → +0.2 / 최대 1.0</div><div class="example"><b>예시 — MDX 01-2 ↔ Frame 18</b><br/>MDX 본문에 표 발견 → 컬럼 2개 추출 :<br/> [1] label=<b>"DX"</b>, body="BIM << DX (Engineering + Management 통합)"<br/> [2] label=<b>"BIM"</b>, body="Only 3D (형상 구현 중심)"<br/>→ Frame 18 cardinality 2/2/2 범위 내 (+0.5) + 라벨 둘 다 있음 (+0.3) + 본문 둘 다 있음 (+0.2) = <b>1.00</b><br/><span class="limit">한계 1 : 표 첫 행만 추출, 나머지 행 (S/W·프로세스·성과품) 무시</span><br/><span class="limit">한계 2 : "BIM → col_a_label, DX → col_b_label" 같은 frame 슬롯과의 의미 매핑 없음</span> (후속 단계 텍스트 편집자 책임)</div></div><div class="sk-block"><div class="sk-title"><span class="num">4</span>항목 수 / 관계 (cardinality + relation_type)<span class="accuracy good">비교적 정확</span></div><div class="what"><b>무엇인가</b> : MDX 콘텐츠의 비교 단위 개수와 관계 유형. 관계 유형 = <code>compare</code>(비교) / <code>parallel</code>(병렬) / <code>sequence</code>(순서) 중 하나.</div><div class="how"><b>매칭 방법</b> : <code>detect_mdx_layout_v2</code> 함수가 MDX 본문에서 구조 패턴을 자동 감지 → <code>MDX_LAYOUT_STRUCTURE</code> 사전에서 해당 layout 의 family / relation_type / cardinality_ideal 가져옴.<br/> · 표 형태 (`|`, `|---|`) 패턴 → table family<br/> · `1.`, `2.`, `Step 1`, `→` 등 → sequence<br/> · 카드 나열 / `*` 불릿 N개 → parallel + cardinality</div><div class="example"><b>예시 — MDX 01-2</b><br/>본문이 4 행 표 (범위/SW/프로세스/성과품 × BIM/DX) → <code>compare-rows</code> layout 감지 → family=table, relation_type=compare, cardinality=2. <b style="color:#065f46">정확</b> (구조적 신호라 안정적)</div></div></body></html> |