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>
This commit is contained in:
2026-07-02 17:03:42 +09:00
co-authored by Claude Opus 4.8
parent 97b7833a1b
commit b836e79ee1
527 changed files with 673036 additions and 717 deletions
+189
View File
@@ -0,0 +1,189 @@
# Phase 21 — synonym + 키워드 + 내용 + 구조
**공식**: `점수 = 0.5 × 키워드 + 0.3 × 내용 + 0.2 × 구조`
**결과: 4/4 정답**
## 1. 수행 프로세스
**키워드 + 내용 + 구조(표 헤더/섹션 감지)까지 3축 합산.**
| Step 1. Figma 정리 | Step 2. 단어 가중치 정리 | Step 3. MDX 키워드 추출 | Step 4. 유사도 계산 | Step 5. 최종 선정 |
|-------|-------|-------|-------|-------|
| 각 Figma 프레임에 analysis.md 작성<br>(내용 1문장 + 후보 키워드 15~25개) | 32개 프레임에서 키워드 등장 빈도(df) 기반 3단계 가중치<br>핵심×1.0, 중간×0.5, 일반×0.1 | 원문 →<br>**synonym 치환** →<br>Kiwi 형태소 추출 →<br>Figma vocab 교집합 | 공식:<br>`점수 = 0.5 × 키워드 + 0.3 × 내용 + 0.2 × 구조`<br>① 키워드: IDF 가중 Jaccard<br>② 내용: ko-reranker<br>(Cross-encoder 로컬)<br>③ 구조: MDX 표헤더/섹션 감지 → Figma layout family 매칭 | 32개 프레임 점수 계산 → 1위 선정 |
| Frame 13 (필수조건)<br>![13](../../data/figma_previews/13.png)<br>내용: "DX 시행 3대 필수조건"<br>키워드: 필수조건, 기술, 디지털기술, 사람, 역량, 자연, 여건… | '필수조건' 1/32→핵심×1.0<br>'여건' 1/32→핵심×1.0<br>'디지털' 5/32→중간×0.5 | '필수 요건'→'필수조건'<br>'디지털 전환'→'DX'<br>MDX03-1 본문 →<br>Kiwi 127개 →<br>Figma vocab ∩ 22개:<br>DX, 필수, 요건, 기술, 사람, 여건… | MDX03-1 ↔ Frame 13<br>키워드: 0.289<br>내용: 0.731<br>구조: 1.00<br>최종: 0.5×0.289 + 0.3×0.731 + 0.2×1.00 = **0.564** | MDX03-1 결과<br>1위 Frame 13<br>2위 Frame 15<br>3위 Frame 18 |
## 2. 테스트 결과
| 콘텐츠 | 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.588)<br>BIM과 DX의 이해</div> | ![24](../../data/figma_previews/24.png)<br>**24** (0.326)<br>Engn. S/W의 구성 과… | ![17](../../data/figma_previews/17.png)<br>**17** (0.314)<br>현황 및 문제점 |
| **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.491)<br></div> | ![13](../../data/figma_previews/13.png)<br>**13** (0.422)<br>필수조건 | ![12](../../data/figma_previews/12.png)<br>**12** (0.316)<br>건설산업의 목표 (BIM의 … |
| **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.564)<br>필수조건</div> | ![20](../../data/figma_previews/20.png)<br>**20** (0.345)<br>디지털 전환(DX)은 S/W… | ![14](../../data/figma_previews/14.png)<br>**14** (0.335)<br> |
| **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.446)<br>좌측 배너 과정 (Proce…</div> | ![23](../../data/figma_previews/23.png)<br>**23** (0.329)<br>Application S/W… | ![07](../../data/figma_previews/07.png)<br>**07** (0.310)<br> |
## 3. 테스트 결과 세부
### 1. (MDX 1) 팝업 — DX와 BIM의 구분 — 정답 Frame **18**
**MDX 추출 사항**
- **내용**: 건설산업 DX의 올바른 이해 / 2. 용어간 상호관계
- **키워드** (29개): BIM, CIVIL, DX, Engineering, IT, 개념, 구체, 국내, 기술, 도면, 모델, 발주처, 범위, 상용, 설계, 설계사, 소극, 시공, 시공사, 오류, 운영, 융합, 의존, 적극, 전용, 토목, 프로세스, 해외, 활용
- **구조**: compare-rows
**<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 구조**: `compare-rows`
- **구조 매칭 사유**: `compare-rows``compare-rows`**정확 일치 (동일 구조)** → 점수 1.00
- **축별 점수**: 키워드 0.454 / 내용 0.536 / 구조 1.00
- **매칭 점수 (최종)**: **0.588**
**2위 Frame 24**
![24](../../data/figma_previews/24.png)
- **매칭 내용**: Engineering S/W의 구성과 특징 — 상용·3rd Party·전용 S/W 3가지 유형을 개념·특징·개발주체·성과품 관점으로 비교.
- **매칭 키워드**: 개념, 상용, 전용
- **Figma 구조**: `table-3col`
- **구조 매칭 사유**: `compare-rows``table-3col`**부분 호환 (일부 축 공유)** → 점수 0.70
- **축별 점수**: 키워드 0.072 / 내용 0.500 / 구조 0.70
- **매칭 점수 (최종)**: **0.326**
**3위 Frame 17**
![17](../../data/figma_previews/17.png)
- **매칭 내용**: BIM 수행 현황과 문제점 — 개념 부재(CAD 확장판 오인), 잘못된 접근방식(도구로만 인식), 방향성 상실(대형 S/W 의존), 전제조건 오류(건축·토목 혼용).
- **매칭 키워드**: 오류
- **Figma 구조**: `paired-rows`
- **구조 매칭 사유**: `compare-rows``paired-rows`**매우 호환 (2/3열 동일, 표현만 다름)** → 점수 0.75
- **축별 점수**: 키워드 0.027 / 내용 0.500 / 구조 0.75
- **매칭 점수 (최종)**: **0.314**
### 2. (MDX 2) 2.2 DX 시행 주체별 기대효과 — 정답 Frame **14**
**MDX 추출 사항**
- **내용**: DX의 시행 목표 및 기대효과 / 2. DX 기반 Process 혁신에 따른 주체별 기대효과 / 2.2 DX 시행 주체별 기대효과
- **키워드** (26개): Claim, Model, 건설, 관리, 기반, 기술, 도면, 디지털, 모델, 설계, 설계자, 성과물, 시공, 신뢰, 안전, 업무, 역량, 오류, 운영, 의존, 투자, 품질, 프로세스, 협업, 활용, 효율
- **구조**: persona-3col
**<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 구조**: `persona-3col`
- **구조 매칭 사유**: `persona-3col``persona-3col`**정확 일치 (동일 구조)** → 점수 1.00
- **축별 점수**: 키워드 0.144 / 내용 0.731 / 구조 1.00
- **매칭 점수 (최종)**: **0.491**
**2위 Frame 13**
![13](../../data/figma_previews/13.png)
- **매칭 내용**: DX 시행을 위한 3대 필수조건 — 기술(디지털) · 사람(역량) · 자연(여건)의 조화. 각 요소의 세부 조건 설명.
- **매칭 키워드**: 기반, 기술, 디지털, 역량, 투자
- **Figma 구조**: `3col-parallel`
- **구조 매칭 사유**: `persona-3col``3col-parallel`**매우 호환 (2/3열 동일, 표현만 다름)** → 점수 0.75
- **축별 점수**: 키워드 0.120 / 내용 0.706 / 구조 0.75
- **매칭 점수 (최종)**: **0.422**
**3위 Frame 12**
![12](../../data/figma_previews/12.png)
- **매칭 내용**: 건설산업 DX의 궁극적 목표 — 안전·품질·생산성의 3원 교차, 소통과 신뢰가 모두 포함되는 교차 영역으로 시각화.
- **매칭 키워드**: 신뢰, 안전, 품질, 협업, 효율
- **Figma 구조**: `cycle-3way`
- **구조 매칭 사유**: `persona-3col``cycle-3way`**거의 무관** → 점수 0.15
- **축별 점수**: 키워드 0.134 / 내용 0.730 / 구조 0.15
- **매칭 점수 (최종)**: **0.316**
### 3. (MDX 03) 1. DX 시행을 위한 필수요건 — 정답 Frame **13**
**MDX 추출 사항**
- **내용**: DX 실행 체계 구축 방안 / 1. DX 시행을 위한 필수 요건
- **키워드** (22개): DX, Digital, Process, UX, 건설, 경험, 관리, 기술, 디지털, 사람, 사용자, 설계, 시공, 업무, 여건, 역량, 자연, 전문, 토목, 투자, 프로세스, 활용
- **구조**: 3col-parallel
**<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 구조**: `3col-parallel`
- **구조 매칭 사유**: `3col-parallel``3col-parallel`**정확 일치 (동일 구조)** → 점수 1.00
- **축별 점수**: 키워드 0.289 / 내용 0.731 / 구조 1.00
- **매칭 점수 (최종)**: **0.564**
**2위 Frame 20**
![20](../../data/figma_previews/20.png)
- **매칭 내용**: 디지털 전환(DX) 실현을 위한 S/W 필수성 — BIM·디지털·전면설계 관점에서 고부가가치 실현을 3열 카드로 정리.
- **매칭 키워드**: DX, 디지털
- **Figma 구조**: `3col-cards`
- **구조 매칭 사유**: `3col-parallel``3col-cards`**매우 호환 (2/3열 동일, 표현만 다름)** → 점수 0.90
- **축별 점수**: 키워드 0.020 / 내용 0.517 / 구조 0.90
- **매칭 점수 (최종)**: **0.345**
**3위 Frame 14**
![14](../../data/figma_previews/14.png)
- **매칭 내용**: DX 시행 주체별 기대효과 — 발주자·시공자·설계자 각각의 역할별 목표와 기대 효과를 페르소나 카드로 정리.
- **매칭 키워드**: DX, 건설, 설계, 시공
- **Figma 구조**: `persona-3col`
- **구조 매칭 사유**: `3col-parallel``persona-3col`**매우 호환 (2/3열 동일, 표현만 다름)** → 점수 0.75
- **축별 점수**: 키워드 0.070 / 내용 0.500 / 구조 0.75
- **매칭 점수 (최종)**: **0.335**
### 4. (MDX 03) 2. Process 혁신과 Product 변화 — 정답 Frame **29**
**MDX 추출 사항**
- **내용**: DX 실행 체계 구축 방안 / 2. Process의 혁신과 Product의 변화
- **키워드** (32개): Analogue, BIM, DX, Digital, GIS, Process, Product, Simulation, Solution, 개념, 건설, 관리, 규정, 기반, 도면, 디지털, 모델, 사용자, 설계, 성과물, 소통, 시공, 실체, 업무, 오류, 이슈, 참여자, 품질, 프로세스, 협업, 활용, 효율
- **구조**: compare-2banner
**<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 구조**: `compare-2banner-top-2col-bottom`
- **구조 매칭 사유**: `compare-2banner``compare-2banner-top-2col-bottom`**정확 일치 (동일 구조)** → 점수 1.00
- **축별 점수**: 키워드 0.161 / 내용 0.552 / 구조 1.00
- **매칭 점수 (최종)**: **0.446**
**2위 Frame 23**
![23](../../data/figma_previews/23.png)
- **매칭 내용**: Application S/W 2가지 구분 — Package와 Solution의 정의·특징·장점·단점·고객 차이를 2열 표로 비교.
- **매칭 키워드**: Solution
- **Figma 구조**: `table-2col`
- **구조 매칭 사유**: `compare-2banner``table-2col`**매우 호환 (2/3열 동일, 표현만 다름)** → 점수 0.85
- **축별 점수**: 키워드 0.018 / 내용 0.500 / 구조 0.85
- **매칭 점수 (최종)**: **0.329**
**3위 Frame 07**
![07](../../data/figma_previews/07.png)
- **매칭 내용**: BIGRoom 시스템 구성 — H/W(Server·Network·회의·CCTV·Drone·Sensor) + S/W(C.C.P·WatchBIM·Domainer) 상세 설명.
- **매칭 키워드**: (없음)
- **Figma 구조**: `2col-paired`
- **구조 매칭 사유**: `compare-2banner``2col-paired`**매우 호환 (2/3열 동일, 표현만 다름)** → 점수 0.80
- **축별 점수**: 키워드 0.000 / 내용 0.500 / 구조 0.80
- **매칭 점수 (최종)**: **0.310**