wip: phase_z2 evidence 파이프라인 + matching 실험(phase2~26) + 프론트 trace 패널 진행분 스냅샷

- 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>
2026-07-02 17:03:42 +09:00
parent 97b7833a1b
commit b836e79ee1
527 changed files with 673036 additions and 717 deletions
@@ -0,0 +1,222 @@
+# Phase 21b — Ontology 기반 구조축 (tie-breaker)
+
+**공식**: `점수 = 0.5 × 키워드 + 0.3 × 내용 + 0.1 × 구조(ontology)`
+**결과: 4/4**
+
+**Phase 21 원본 대비 차이:**
+- 구조 매칭 로직: `structural_match_v2` (layout 문자열) → `structural_match_v3` (속성 교집합)
+- 구조 가중치: 0.2 → 0.1 (tie-breaker 수준)
+- 구조 ontology: layout 문자열 → `structure_ontology.yaml` 속성 schema
+- MDX 구조 감지: ### 서브섹션/표헤더/블릿 기반 schema emit
+- confidence 체크: low면 구조 점수 0
+
+## 테스트 결과
+
+| 콘텐츠 | 1순위 | 2순위 | 3순위 |
+|--------|-------|-------|-------|
+| **1. (MDX 1) 팝업 — DX와 BIM의 구분**<br>정답 Frame **18** | <div style='background:#fff3cd;border:3px solid #dc2626;padding:8px;border-radius:6px'>🎯 <b>정답</b><br>![18](../../data/figma_previews/18.png)<br>**18** (0.463)<br>BIM과 DX의 이해…</div> | ![29](../../data/figma_previews/29.png)<br>**29** (0.228)<br>좌측 배너 과정 (Proce… | ![25](../../data/figma_previews/25.png)<br>**25** (0.220)<br>3rd Party… |
+| **2. (MDX 2) 2.2 DX 시행 주체별 기대효과**<br>정답 Frame **14** | <div style='background:#fff3cd;border:3px solid #dc2626;padding:8px;border-radius:6px'>🎯 <b>정답</b><br>![14](../../data/figma_previews/14.png)<br>**14** (0.381)<br>…</div> | ![12](../../data/figma_previews/12.png)<br>**12** (0.311)<br>건설산업의 목표 (BIM의 … | ![13](../../data/figma_previews/13.png)<br>**13** (0.307)<br>필수조건… |
+| **3. (MDX 03) 1. DX 시행을 위한 필수요건**<br>정답 Frame **13** | <div style='background:#fff3cd;border:3px solid #dc2626;padding:8px;border-radius:6px'>🎯 <b>정답</b><br>![13](../../data/figma_previews/13.png)<br>**13** (0.464)<br>필수조건…</div> | ![15](../../data/figma_previews/15.png)<br>**15** (0.289)<br>정책목표… | ![28](../../data/figma_previews/28.png)<br>**28** (0.240)<br>현존 상용 S/W의 현실… |
+| **4. (MDX 03) 2. Process 혁신과 Product 변화**<br>정답 Frame **29** | <div style='background:#fff3cd;border:3px solid #dc2626;padding:8px;border-radius:6px'>🎯 <b>정답</b><br>![29](../../data/figma_previews/29.png)<br>**29** (0.346)<br>좌측 배너 과정 (Proce…</div> | ![18](../../data/figma_previews/18.png)<br>**18** (0.238)<br>BIM과 DX의 이해… | ![21](../../data/figma_previews/21.png)<br>**21** (0.227)<br>Solution Engn. … |
+
+## 테스트 결과 세부
+
+### 1. (MDX 1) 팝업 — DX와 BIM의 구분 — 정답 Frame **18**
+
+**MDX 구조 (v3 emit)**
+```yaml
+family: compare
+surface: table-multi-row
+semantic_role: bim-vs-dx
+columns: 2
+items: None
+has_table: True
+has_cards: False
+has_diagram: False
+confidence: high
+```
+
+**MDX 키워드 (29개)**: BIM, CIVIL, DX, Engineering, IT, 개념, 구체, 국내, 기술, 도면, 모델, 발주처, 범위, 상용, 설계, 설계사, 소극, 시공, 시공사, 오류, 운영, 융합, 의존, 적극, 전용, 토목, 프로세스, 해외, 활용
+
+**<span style='background:#fff3cd;border:2px solid #dc2626;padding:2px 8px;border-radius:3px'>🎯 1위 Frame 18 (정답)</span>**
+
+![18](../../data/figma_previews/18.png)
+
+- **매칭 내용**: BIM과 DX 용어 혼용 정리 — 개념 범위·S/W·프로세스·성과품·활용·확장성·수행개념·주체 등 관점별 행별 비교. 두 용어의 개념 차이와 상호관계 해설.
+- **매칭 키워드**: BIM, CIVIL, DX, IT, 구체, 국내, 발주처, 범위, 상용, 설계사, 소극, 시공사, 운영, 의존, 적극, 프로세스, 해외, 활용
+- **Figma schema**: family=`compare`, columns=None, role=`bim-vs-dx`, conf=`medium`
+- **구조 속성 정렬**: family:compare✓, has_table:True✓, has_cards:False✓, role:bim-vs-dx✓
+- **축별 점수**: 키워드 0.454 / 내용 0.536 / 구조 0.75
+- **최종**: **0.463**
+
+**2위 Frame 29**
+
+![29](../../data/figma_previews/29.png)
+
+- **매칭 내용**: Process 혁신과 Product 혁신 — 과정의 Analogue→Digital Transformation, 결과의 2D도면→3D모델 전환. AS-IS/TO-BE 대조와 GIS·BIM·Solution 제공 맥락 설명.
+- **매칭 키워드**: BIM
+- **Figma schema**: family=`compare`, columns=2, role=`process-vs-product`, conf=`high`
+- **구조 속성 정렬**: family:compare✓, columns:2✓, has_cards:False✓
+- **축별 점수**: 키워드 0.006 / 내용 0.500 / 구조 0.75
+- **최종**: **0.228**
+
+**3위 Frame 25**
+
+![25](../../data/figma_previews/25.png)
+
+- **매칭 내용**: 상용 Engineering S/W의 4가지 카테고리 — 조사/계획/분석, 해석, 단가/공정, Graphic별 대표 S/W 나열.
+- **매칭 키워드**: 상용
+- **Figma schema**: family=`compare`, columns=2, role=`sw-ecosystem`, conf=`high`
+- **구조 속성 정렬**: family:compare✓, columns:2✓
+- **축별 점수**: 키워드 0.009 / 내용 0.500 / 구조 0.65
+- **최종**: **0.220**
+
+### 2. (MDX 2) 2.2 DX 시행 주체별 기대효과 — 정답 Frame **14**
+
+**MDX 구조 (v3 emit)**
+```yaml
+family: cards
+surface: table-persona-3col
+semantic_role: persona-benefits
+columns: 3
+items: 3
+has_table: True
+has_cards: True
+has_diagram: False
+confidence: high
+```
+
+**MDX 키워드 (26개)**: Claim, Model, 건설, 관리, 기반, 기술, 도면, 디지털, 모델, 설계, 설계자, 성과물, 시공, 신뢰, 안전, 업무, 역량, 오류, 운영, 의존, 투자, 품질, 프로세스, 협업, 활용, 효율
+
+**<span style='background:#fff3cd;border:2px solid #dc2626;padding:2px 8px;border-radius:3px'>🎯 1위 Frame 14 (정답)</span>**
+
+![14](../../data/figma_previews/14.png)
+
+- **매칭 내용**: DX 시행 주체별 기대효과 — 발주자·시공자·설계자 각각의 역할별 목표와 기대 효과를 페르소나 카드로 정리.
+- **매칭 키워드**: Claim, 건설, 설계, 설계자, 시공, 품질, 협업
+- **Figma schema**: family=`cards`, columns=3, role=`persona-benefits`, conf=`high`
+- **구조 속성 정렬**: family:cards✓, columns:3✓, has_cards:True✓, role:persona-benefits✓
+- **축별 점수**: 키워드 0.144 / 내용 0.731 / 구조 0.90
+- **최종**: **0.381**
+
+**2위 Frame 12**
+
+![12](../../data/figma_previews/12.png)
+
+- **매칭 내용**: 건설산업 DX의 궁극적 목표 — 안전·품질·생산성의 3원 교차, 소통과 신뢰가 모두 포함되는 교차 영역으로 시각화.
+- **매칭 키워드**: 신뢰, 안전, 품질, 협업, 효율
+- **Figma schema**: family=`diagram`, columns=None, role=`safety-quality-productivity`, conf=`medium`
+- **구조 속성 정렬**: family:cards≠diagram, columns:3✓
+- **축별 점수**: 키워드 0.134 / 내용 0.730 / 구조 0.25
+- **최종**: **0.311**
+
+**3위 Frame 13**
+
+![13](../../data/figma_previews/13.png)
+
+- **매칭 내용**: DX 시행을 위한 3대 필수조건 — 기술(디지털) · 사람(역량) · 자연(여건)의 조화. 각 요소의 세부 조건 설명.
+- **매칭 키워드**: 기반, 기술, 디지털, 역량, 투자
+- **Figma schema**: family=`list`, columns=3, role=`prerequisites`, conf=`high`
+- **구조 속성 정렬**: family:cards≠list, columns:3✓, has_cards:True✓
+- **축별 점수**: 키워드 0.120 / 내용 0.706 / 구조 0.35
+- **최종**: **0.307**
+
+### 3. (MDX 03) 1. DX 시행을 위한 필수요건 — 정답 Frame **13**
+
+**MDX 구조 (v3 emit)**
+```yaml
+family: list
+surface: bullets-3
+semantic_role: prerequisites
+columns: 3
+items: 3
+has_table: False
+has_cards: True
+has_diagram: False
+confidence: high
+```
+
+**MDX 키워드 (22개)**: DX, Digital, Process, UX, 건설, 경험, 관리, 기술, 디지털, 사람, 사용자, 설계, 시공, 업무, 여건, 역량, 자연, 전문, 토목, 투자, 프로세스, 활용
+
+**<span style='background:#fff3cd;border:2px solid #dc2626;padding:2px 8px;border-radius:3px'>🎯 1위 Frame 13 (정답)</span>**
+
+![13](../../data/figma_previews/13.png)
+
+- **매칭 내용**: DX 시행을 위한 3대 필수조건 — 기술(디지털) · 사람(역량) · 자연(여건)의 조화. 각 요소의 세부 조건 설명.
+- **매칭 키워드**: DX, 경험, 기술, 디지털, 사람, 여건, 역량, 자연, 토목, 투자
+- **Figma schema**: family=`list`, columns=3, role=`prerequisites`, conf=`high`
+- **구조 속성 정렬**: family:list✓, columns:3✓, has_table:False✓, has_cards:True✓, role:prerequisites✓
+- **축별 점수**: 키워드 0.289 / 내용 0.731 / 구조 1.00
+- **최종**: **0.464**
+
+**2위 Frame 15**
+
+![15](../../data/figma_previews/15.png)
+
+- **매칭 내용**: 건설 DX 정책목표 4가지와 실행요건 — 성장동력 재도약, 공사비 30% 절감, 안전사고 40% 감소, 고부가가치 산업전환. 실행을 위한 능력·사고·경험 요건 제시.
+- **매칭 키워드**: DX, Process, UX, 디지털, 업무
+- **Figma schema**: family=`cards`, columns=4, role=`policy-goals`, conf=`high`
+- **구조 속성 정렬**: family:list≠cards, columns:3≠4, has_table:False✓, has_cards:True✓
+- **축별 점수**: 키워드 0.100 / 내용 0.729 / 구조 0.20
+- **최종**: **0.289**
+
+**3위 Frame 28**
+
+![28](../../data/figma_previews/28.png)
+
+- **매칭 내용**: 현존 상용 Engineering S/W의 현실 비판 — 토목 실무 전문성 부족, 비효율성, 토목 실무 적용 한계를 3개 강조 포인트로 정리.
+- **매칭 키워드**: 토목
+- **Figma schema**: family=`list`, columns=3, role=`sw-ecosystem`, conf=`high`
+- **구조 속성 정렬**: family:list✓, columns:3✓, has_table:False✓, has_cards:True✓
+- **축별 점수**: 키워드 0.011 / 내용 0.500 / 구조 0.85
+- **최종**: **0.240**
+
+### 4. (MDX 03) 2. Process 혁신과 Product 변화 — 정답 Frame **29**
+
+**MDX 구조 (v3 emit)**
+```yaml
+family: compare
+surface: banner-plus-2col
+semantic_role: process-vs-product
+columns: 2
+items: 2
+has_table: False
+has_cards: False
+has_diagram: False
+confidence: high
+```
+
+**MDX 키워드 (32개)**: Analogue, BIM, DX, Digital, GIS, Process, Product, Simulation, Solution, 개념, 건설, 관리, 규정, 기반, 도면, 디지털, 모델, 사용자, 설계, 성과물, 소통, 시공, 실체, 업무, 오류, 이슈, 참여자, 품질, 프로세스, 협업, 활용, 효율
+
+**<span style='background:#fff3cd;border:2px solid #dc2626;padding:2px 8px;border-radius:3px'>🎯 1위 Frame 29 (정답)</span>**
+
+![29](../../data/figma_previews/29.png)
+
+- **매칭 내용**: Process 혁신과 Product 혁신 — 과정의 Analogue→Digital Transformation, 결과의 2D도면→3D모델 전환. AS-IS/TO-BE 대조와 GIS·BIM·Solution 제공 맥락 설명.
+- **매칭 키워드**: Analogue, BIM, Digital, GIS, Process, Product, Solution, 성과물, 실체
+- **Figma schema**: family=`compare`, columns=2, role=`process-vs-product`, conf=`high`
+- **구조 속성 정렬**: family:compare✓, columns:2✓, has_table:False✓, has_cards:False✓, role:process-vs-product✓
+- **축별 점수**: 키워드 0.161 / 내용 0.552 / 구조 1.00
+- **최종**: **0.346**
+
+**2위 Frame 18**
+
+![18](../../data/figma_previews/18.png)
+
+- **매칭 내용**: BIM과 DX 용어 혼용 정리 — 개념 범위·S/W·프로세스·성과품·활용·확장성·수행개념·주체 등 관점별 행별 비교. 두 용어의 개념 차이와 상호관계 해설.
+- **매칭 키워드**: BIM, DX, 건설, 디지털, 프로세스, 활용
+- **Figma schema**: family=`compare`, columns=None, role=`bim-vs-dx`, conf=`medium`
+- **구조 속성 정렬**: family:compare✓, has_cards:False✓
+- **축별 점수**: 키워드 0.077 / 내용 0.500 / 구조 0.50
+- **최종**: **0.238**
+
+**3위 Frame 21**
+
+![21](../../data/figma_previews/21.png)
+
+- **매칭 내용**: Solution Engineering S/W — 협업·맞춤형·User 중심·시공 결론으로 이어지는 솔루션 엔지니어링 다이어그램.
+- **매칭 키워드**: Solution, 시공, 협업
+- **Figma schema**: family=`diagram`, columns=None, role=`sw-ecosystem`, conf=`medium`
+- **구조 속성 정렬**: family:compare≠diagram, columns:2✓, has_table:False✓, has_cards:False✓
+- **축별 점수**: 키워드 0.064 / 내용 0.500 / 구조 0.45
+- **최종**: **0.227**