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
+182
View File
@@ -0,0 +1,182 @@
# Phase 18 — 키워드만 (baseline)
**공식**: `점수 = 1.0 × 키워드`
**결과: 4/4 정답**
## 1. 수행 프로세스
**MDX에서 형태소 추출 → Figma 키워드 DB와 겹침만으로 매칭 (baseline).**
| 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>Kiwi 형태소 추출 →<br>Figma vocab 교집합 | 공식:<br>`점수 = 1.0 × 키워드`<br>① 키워드: IDF 가중 Jaccard | 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 | MDX03-1 본문 →<br>Kiwi 127개 →<br>Figma vocab ∩ 22개:<br>DX, 필수, 요건, 기술, 사람, 여건… | MDX03-1 ↔ Frame 13<br>키워드: 0.289<br>최종: 1.0×0.289 = **0.289** | MDX03-1 결과<br>1위 Frame 13<br>2위 Frame 15<br>3위 Frame 18 |
## 1-B. Figma 기준 추출 키워드 (매칭 pool)
**32개 프레임 analysis.md의 후보 키워드 합집합 = 349개** (이 pool이 매칭의 기준이며 **Phase 18/19 동일**)
- 핵심 (1~3 프레임만 등장, `×1.0`): **341개**
- 중간 (4~9 프레임, `×0.5`): **8개**
- 일반 (10+ 프레임, `×0.1`): **0개**
### 핵심 키워드 예시 (distinctive, 1~3 프레임만 등장) — 상위 30개
`3rdParty`, `3열비교`, `BIM수행`, `Solution`, `건설산업`, `다이어그램`, `디지털전환`, `특징`, `표`, `협업`, `3D모델`, `3산업`, `GIS`, `Process`, `S/W개발`, `split-panel`, `개념부재`, `개요`, `건설`, `건축`, `결론`, `고부가가치`, `구성`, `국내`, `기술기반`, `기술예속`, `민원관리`, `발전방향`, `발주처`, `보상현황`
<br>... (전체 341개 중 30개)
### 중간 키워드 전체 (8개, 4~9 프레임)
`DX` (df=6), `EngineeringSW` (df=5), `디지털` (df=5), `BIM` (df=4), `Engn.S/W` (df=4), `S/W` (df=4), `상용` (df=4), `토목` (df=4)
### 일반 키워드
(없음 — corpus 규모가 작아 10+ 프레임 등장 키워드 없음)
## 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.454)<br>BIM과 DX의 이해</div> | ![04](../../data/figma_previews/04.png)<br>**04** (0.097)<br>국내 | ![24](../../data/figma_previews/24.png)<br>**24** (0.072)<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.163)<br></div> | ![12](../../data/figma_previews/12.png)<br>**12** (0.158)<br>건설산업의 목표 (BIM의 … | ![18](../../data/figma_previews/18.png)<br>**18** (0.118)<br>BIM과 DX의 이해 |
| **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.289)<br>필수조건</div> | ![15](../../data/figma_previews/15.png)<br>**15** (0.100)<br>정책목표 | ![18](../../data/figma_previews/18.png)<br>**18** (0.085)<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.161)<br>좌측 배너 과정 (Proce…</div> | ![14](../../data/figma_previews/14.png)<br>**14** (0.110)<br> | ![12](../../data/figma_previews/12.png)<br>**12** (0.086)<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.454
- **매칭 점수 (최종)**: **0.454**
**2위 Frame 04**
![04](../../data/figma_previews/04.png)
- **매칭 내용**: 국내 BIM 수행 주체 간 관계 다이어그램 — 건설관리사·설계사·시공사·정부기관(발주처)의 지침·규정·기술 형식 관계.
- **매칭 키워드**: 국내, 발주처, 설계사, 시공사
- **축별 점수**: 키워드 0.097
- **매칭 점수 (최종)**: **0.097**
**3위 Frame 24**
![24](../../data/figma_previews/24.png)
- **매칭 내용**: Engineering S/W의 구성과 특징 — 상용·3rd Party·전용 S/W 3가지 유형을 개념·특징·개발주체·성과품 관점으로 비교.
- **매칭 키워드**: 개념, 상용, 전용
- **축별 점수**: 키워드 0.072
- **매칭 점수 (최종)**: **0.072**
### 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.163
- **매칭 점수 (최종)**: **0.163**
**2위 Frame 12**
![12](../../data/figma_previews/12.png)
- **매칭 내용**: 건설산업 DX의 궁극적 목표 — 안전·품질·생산성의 3원 교차, 소통과 신뢰가 모두 포함되는 교차 영역으로 시각화.
- **매칭 키워드**: 소통, 신뢰, 안전, 품질, 협업, 효율
- **축별 점수**: 키워드 0.158
- **매칭 점수 (최종)**: **0.158**
**3위 Frame 18**
![18](../../data/figma_previews/18.png)
- **매칭 내용**: BIM과 DX 용어 혼용 정리 — 개념 범위·S/W·프로세스·성과품·활용·확장성·수행개념·주체 등 관점별 행별 비교. 두 용어의 개념 차이와 상호관계 해설.
- **매칭 키워드**: 건설, 디지털, 운영, 의존, 프로세스, 활용
- **축별 점수**: 키워드 0.118
- **매칭 점수 (최종)**: **0.118**
### 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.289
- **매칭 점수 (최종)**: **0.289**
**2위 Frame 15**
![15](../../data/figma_previews/15.png)
- **매칭 내용**: 건설 DX 정책목표 4가지와 실행요건 — 성장동력 재도약, 공사비 30% 절감, 안전사고 40% 감소, 고부가가치 산업전환. 실행을 위한 능력·사고·경험 요건 제시.
- **매칭 키워드**: DX, Process, UX, 디지털, 업무
- **축별 점수**: 키워드 0.100
- **매칭 점수 (최종)**: **0.100**
**3위 Frame 18**
![18](../../data/figma_previews/18.png)
- **매칭 내용**: BIM과 DX 용어 혼용 정리 — 개념 범위·S/W·프로세스·성과품·활용·확장성·수행개념·주체 등 관점별 행별 비교. 두 용어의 개념 차이와 상호관계 해설.
- **매칭 키워드**: DX, 건설, 디지털, 프로세스, 활용
- **축별 점수**: 키워드 0.085
- **매칭 점수 (최종)**: **0.085**
### 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.161
- **매칭 점수 (최종)**: **0.161**
**2위 Frame 14**
![14](../../data/figma_previews/14.png)
- **매칭 내용**: DX 시행 주체별 기대효과 — 발주자·시공자·설계자 각각의 역할별 목표와 기대 효과를 페르소나 카드로 정리.
- **매칭 키워드**: DX, 건설, 설계, 소통, 시공, 품질, 협업
- **축별 점수**: 키워드 0.110
- **매칭 점수 (최종)**: **0.110**
**3위 Frame 12**
![12](../../data/figma_previews/12.png)
- **매칭 내용**: 건설산업 DX의 궁극적 목표 — 안전·품질·생산성의 3원 교차, 소통과 신뢰가 모두 포함되는 교차 영역으로 시각화.
- **매칭 키워드**: 소통, 품질, 협업, 효율
- **축별 점수**: 키워드 0.086
- **매칭 점수 (최종)**: **0.086**