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,149 @@
+# Phase 17 — MDX ↔ Figma 매칭 체계
+
+## 1. 수행 프로세스 (요약)
+
+| Step 1. Figma 정리 | Step 2. 단어 가중치 정리 | Step 3. MDX 키워드 추출 | Step 4. 유사도 계산 | Step 5. 최종 선정 |
+|-------------------|------------------------|-----------------------|---------------------|-------------------|
+| 각 Figma 프레임마다 analysis.md 작성 (내용 요약 1문장 + 후보 키워드 15~25개) | 32개 프레임에서 각 키워드 등장 프레임 수(df) 세어 3단계 가중치 부여<br>핵심(1~3개)×1.0, 중간(4~9개)×0.5, 일반(10개↑)×0.1 | MDX 본문을 Kiwi 형태소 분석기로 추출 → Figma 키워드 DB에 있는 단어만 남김 | 공식: `점수 = 0.5 × 키워드 겹침 + 0.3 × 내용 유사도`<br>① 키워드: IDF 가중 Jaccard<br>② 내용: ko-reranker(Cross-encoder) 로컬 모델 | 32개 프레임 전부 점수 계산 → Top-1 선정 |
+| Frame 13 (필수조건)<br>![13](../../data/figma_previews/13.png)<br>내용: "DX 시행 3대 필수조건 — 기술/사람/자연"<br>키워드: 필수조건, 기술, 디지털기술, 사람, 역량, 자연, 여건, 기반, 창의성, 3요소… | '필수조건' 1/32 → 핵심 ×1.0<br>'여건' 1/32 → 핵심 ×1.0<br>'디지털' 5/32 → 중간 ×0.5 | MDX03-1 원문: "DX 시행을 위한 필수 요건 — 기술·사람·자연"<br>Kiwi → 127개 토큰<br>Figma DB 교집합 → 22개: DX, 필수, 요건, 기술, 디지털, 사람, 역량, 자연, 여건… | MDX03-1 vs Frame 13<br>키워드 점수: 0.289<br>내용 점수: 0.731<br>최종: 0.5×0.289 + 0.3×0.731 = **0.364** | MDX03-1 결과<br>1위 Frame 13 → 0.364<br>2위 Frame 15 → 0.269<br>3위 Frame 18 → 0.193 |
+
+---
+
+## 2. 테스트 결과
+
+**결과: 4/4 정답**
+
+| 콘텐츠 | 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.388)<br>BIM과 DX의 이해</div> | ![04](../../data/figma_previews/04.png)<br>**04** (0.199)<br>국내 | ![24](../../data/figma_previews/24.png)<br>**24** (0.186)<br>Engn. S/W의 구성 과… |
+| **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.301)<br></div> | ![12](../../data/figma_previews/12.png)<br>**12** (0.298)<br>건설산업의 목표 (BIM의 … | ![13](../../data/figma_previews/13.png)<br>**13** (0.271)<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.364)<br>필수조건</div> | ![15](../../data/figma_previews/15.png)<br>**15** (0.269)<br>정책목표 | ![18](../../data/figma_previews/18.png)<br>**18** (0.193)<br>BIM과 DX의 이해 |
+| **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.246)<br>좌측 배너 과정 (Proce…</div> | ![14](../../data/figma_previews/14.png)<br>**14** (0.205)<br> | ![12](../../data/figma_previews/12.png)<br>**12** (0.193)<br>건설산업의 목표 (BIM의 … |
+
+---
+
+## 3. 테스트 결과 세부
+
+### 1. (MDX 1) 팝업 — DX와 BIM의 구분 — 정답 Frame **18**
+
+**MDX 추출 사항**
+
+- **내용**: 건설산업 DX의 올바른 이해 / 2. 용어간 상호관계
+- **키워드** (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, 구체, 국내, 발주처, 범위, 상용, 설계사, 소극, 시공사, 운영, 의존, 적극, 프로세스, 해외, 활용
+- **매칭 점수**: **0.388**
+
+**2위 Frame 04**
+
+![04](../../data/figma_previews/04.png)
+
+- **매칭 내용**: 국내 BIM 수행 주체 간 관계 다이어그램 — 건설관리사·설계사·시공사·정부기관(발주처)의 지침·규정·기술 형식 관계.
+- **매칭 키워드**: 국내, 발주처, 설계사, 시공사
+- **매칭 점수**: **0.199**
+
+**3위 Frame 24**
+
+![24](../../data/figma_previews/24.png)
+
+- **매칭 내용**: Engineering S/W의 구성과 특징 — 상용·3rd Party·전용 S/W 3가지 유형을 개념·특징·개발주체·성과품 관점으로 비교.
+- **매칭 키워드**: 개념, 상용, 전용
+- **매칭 점수**: **0.186**
+
+### 2. (MDX 2) 2.2 DX 시행 주체별 기대효과 — 정답 Frame **14**
+
+**MDX 추출 사항**
+
+- **내용**: DX의 시행 목표 및 기대효과 / 2. DX 기반 Process 혁신에 따른 주체별 기대효과 / 2.2 DX 시행 주체별 기대효과
+- **키워드** (27개): 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, 건설, 설계, 설계자, 소통, 시공, 품질, 협업
+- **매칭 점수**: **0.301**
+
+**2위 Frame 12**
+
+![12](../../data/figma_previews/12.png)
+
+- **매칭 내용**: 건설산업 DX의 궁극적 목표 — 안전·품질·생산성의 3원 교차, 소통과 신뢰가 모두 포함되는 교차 영역으로 시각화.
+- **매칭 키워드**: 소통, 신뢰, 안전, 품질, 협업, 효율
+- **매칭 점수**: **0.298**
+
+**3위 Frame 13**
+
+![13](../../data/figma_previews/13.png)
+
+- **매칭 내용**: DX 시행을 위한 3대 필수조건 — 기술(디지털) · 사람(역량) · 자연(여건)의 조화. 각 요소의 세부 조건 설명.
+- **매칭 키워드**: 기반, 기술, 디지털, 역량, 투자
+- **매칭 점수**: **0.271**
+
+### 3. (MDX 03) 1. DX 시행을 위한 필수요건 — 정답 Frame **13**
+
+**MDX 추출 사항**
+
+- **내용**: DX 실행 체계 구축 방안 / 1. DX 시행을 위한 필수 요건
+- **키워드** (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, 경험, 기술, 디지털, 사람, 여건, 역량, 자연, 토목, 투자
+- **매칭 점수**: **0.364**
+
+**2위 Frame 15**
+
+![15](../../data/figma_previews/15.png)
+
+- **매칭 내용**: 건설 DX 정책목표 4가지와 실행요건 — 성장동력 재도약, 공사비 30% 절감, 안전사고 40% 감소, 고부가가치 산업전환. 실행을 위한 능력·사고·경험 요건 제시.
+- **매칭 키워드**: DX, Process, UX, 디지털, 업무
+- **매칭 점수**: **0.269**
+
+**3위 Frame 18**
+
+![18](../../data/figma_previews/18.png)
+
+- **매칭 내용**: BIM과 DX 용어 혼용 정리 — 개념 범위·S/W·프로세스·성과품·활용·확장성·수행개념·주체 등 관점별 행별 비교. 두 용어의 개념 차이와 상호관계 해설.
+- **매칭 키워드**: DX, 건설, 디지털, 프로세스, 활용
+- **매칭 점수**: **0.193**
+
+### 4. (MDX 03) 2. Process 혁신과 Product 변화 — 정답 Frame **29**
+
+**MDX 추출 사항**
+
+- **내용**: DX 실행 체계 구축 방안 / 2. Process의 혁신과 Product의 변화
+- **키워드** (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, 성과물, 실체
+- **매칭 점수**: **0.246**
+
+**2위 Frame 14**
+
+![14](../../data/figma_previews/14.png)
+
+- **매칭 내용**: DX 시행 주체별 기대효과 — 발주자·시공자·설계자 각각의 역할별 목표와 기대 효과를 페르소나 카드로 정리.
+- **매칭 키워드**: DX, 건설, 설계, 소통, 시공, 품질, 협업
+- **매칭 점수**: **0.205**
+
+**3위 Frame 12**
+
+![12](../../data/figma_previews/12.png)
+
+- **매칭 내용**: 건설산업 DX의 궁극적 목표 — 안전·품질·생산성의 3원 교차, 소통과 신뢰가 모두 포함되는 교차 영역으로 시각화.
+- **매칭 키워드**: 소통, 품질, 협업, 효율
+- **매칭 점수**: **0.193**