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,202 @@
+# Phase 23b — Domain Terms 검수 리포트 (정제판)
+
+> **개선 범위**: 노이즈 필터 강화 · safe_normalization 자동 분류 · 약어 regex 확장 · corpus 설명 정확화.
+> **synonyms.yaml은 6개 canonical로 동결** — 본 리포트 결과로 즉시 변경 안 함.
+
+## 0. 메타
+
+- **Phase**: 23b
+- **Purpose**: 검수용 도메인 용어 카탈로그 (synonyms.yaml/hierarchy.yaml 승격 전 단계)
+- **Corpus 구성**:
+  - BEPS: 1 (본문 source)
+  - Figma_frames: 33개 프레임 → 79개 파일 (texts/analysis/flat)
+  - MDX: 3개
+  - total_sources: 82
+- **노이즈 필터 후 2회+ 등장 용어**: 1527개
+- **Note**: synonyms.yaml은 현재 6개 canonical로 동결. 이 파일은 승격 후보만 제공.
+
+## 1. 반복 등장 상위 용어 (노이즈 제거 후)
+
+| 순위 | 용어 | 등장 횟수 | 소스 다양성 |
+|-----|------|----------|------------|
+| 1 | `정보` | 284 | 25개 |
+| 2 | `BIM` | 239 | 28개 |
+| 3 | `건설` | 238 | 30개 |
+| 4 | `기반` | 231 | 33개 |
+| 5 | `시공` | 218 | 30개 |
+| 6 | `모델` | 217 | 23개 |
+| 7 | `관리` | 210 | 22개 |
+| 8 | `기술` | 203 | 34개 |
+| 9 | `설계` | 196 | 27개 |
+| 10 | `디지털` | 150 | 30개 |
+| 11 | `개발` | 143 | 24개 |
+| 12 | `산업` | 135 | 25개 |
+| 13 | `공사` | 113 | 8개 |
+| 14 | `계획` | 110 | 14개 |
+| 15 | `업무` | 102 | 21개 |
+| 16 | `현장` | 96 | 13개 |
+| 17 | `전환` | 95 | 21개 |
+| 18 | `효율` | 88 | 15개 |
+| 19 | `중심` | 88 | 16개 |
+| 20 | `품질` | 86 | 19개 |
+| 21 | `개념` | 77 | 21개 |
+| 22 | `단계` | 74 | 17개 |
+| 23 | `안전` | 72 | 13개 |
+| 24 | `현황` | 72 | 11개 |
+| 25 | `작업` | 72 | 8개 |
+| 26 | `향상` | 72 | 18개 |
+| 27 | `시스템` | 71 | 12개 |
+| 28 | `생산` | 70 | 18개 |
+| 29 | `작성` | 67 | 15개 |
+| 30 | `목표` | 67 | 19개 |
+| 31 | `유지` | 67 | 20개 |
+| 32 | `지원` | 64 | 7개 |
+| 33 | `공정` | 64 | 9개 |
+| 34 | `tagged` | 64 | 32개 |
+| 35 | `이해` | 63 | 19개 |
+| 36 | `혁신` | 63 | 16개 |
+| 37 | `데이터` | 62 | 9개 |
+| 38 | `Bold` | 62 | 10개 |
+| 39 | `확인` | 61 | 7개 |
+| 40 | `Solution` | 59 | 18개 |
+| 41 | `위치` | 58 | 11개 |
+| 42 | `토목` | 58 | 19개 |
+| 43 | `사업` | 57 | 9개 |
+| 44 | `전문` | 56 | 14개 |
+| 45 | `비용` | 56 | 12개 |
+| 46 | `협업` | 55 | 13개 |
+| 47 | `시각` | 54 | 14개 |
+| 48 | `운영` | 54 | 12개 |
+| 49 | `기능` | 54 | 10개 |
+| 50 | `발전` | 53 | 10개 |
+
+## 2. Safe Normalization — 승격/보류/폐기 자동 분류
+
+### 2-1. Promote 후보 (3개) — synonyms.yaml 승격 검토 가능
+
+| Canonical | Variants | 사유 | 검수 |
+|-----------|----------|------|------|
+| `의사소통` | `의사 소통`, `의사소통` | 도메인 일반어 공백 변형 | ⬜ 승격 / ⬜ 보류 |
+| `시행착오` | `시행 착오`, `시행착오` | 도메인 일반어 공백 변형 | ⬜ 승격 / ⬜ 보류 |
+| `BIGRoom` | `BIG Room`, `BIGRoom` | 도메인 일반어 공백 변형 | ⬜ 승격 / ⬜ 보류 |
+
+### 2-2. Hold (2개) — 고유 제품명/브랜드, 치환 위험
+
+| Variants | 사유 |
+|----------|------|
+| `Watch BIM`, `WatchBIM` | 고유 제품명/브랜드 — 치환 위험 |
+| `Twin Highway`, `TwinHighway` | 고유 제품명/브랜드 — 치환 위험 |
+
+### 2-3. Discard (2개) — 노이즈/메타 조각
+
+| Variants | 사유 |
+|----------|------|
+| `Engn. S`, `Engn.S` | 토큰에 마침표 포함 — Kiwi 분해 노이즈 |
+| `rd Party`, `rdParty` | 서수 접미사 조각 (rdParty 등) |
+
+## 3. 약어-풀네임 후보 (확장 regex)
+
+**주의**: 상위 몇 개는 신뢰 가능. 하위는 regex가 주변 문맥 잘못 잡은 경우 포함 → 수동 검수 필수.
+
+| 약어 | 풀네임 | 등장 횟수 | 관계 분류 (검수) |
+|------|--------|----------|----------------|
+| `BIM` | `Building Information Modeling` | 4 | ⬜ 동의어 / ⬜ 번역 / ⬜ 노이즈 |
+| `DX` | `디지털전환` | 4 | ⬜ 동의어 / ⬜ 번역 / ⬜ 노이즈 |
+| `DX` | `디지털 전환` | 4 | ⬜ 동의어 / ⬜ 번역 / ⬜ 노이즈 |
+| `GIS` | `Geographic Information System` | 2 | ⬜ 동의어 / ⬜ 번역 / ⬜ 노이즈 |
+| `OSC` | `Off Site Construction` | 2 | ⬜ 동의어 / ⬜ 번역 / ⬜ 노이즈 |
+| `BIM` | `건설정보모델링` | 2 | ⬜ 동의어 / ⬜ 번역 / ⬜ 노이즈 |
+| `CAE` | `Computer Aided Engineering` | 2 | ⬜ 동의어 / ⬜ 번역 / ⬜ 노이즈 |
+| `DX` | `Digital Transformation` | 2 | ⬜ 동의어 / ⬜ 번역 / ⬜ 노이즈 |
+| `BIM` | `도로사업 중심` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 노이즈 |
+| `TA` | `Technical Assistance` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 노이즈 |
+| `GIS` | `지리정보시스템` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 노이즈 |
+| `API` | `Application Program Interface` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 노이즈 |
+| `BCMF` | `BIM based Construction Management Framework` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 노이즈 |
+| `PMC` | `Project Management Consultant` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 노이즈 |
+| `AIA` | `미 건축가 협회` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 노이즈 |
+| `MA` | `Design for Manufacture and Assembly` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 노이즈 |
+| `DX` | `치 산업으로의 전환 건설산업의 디지털전환` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 노이즈 |
+| `IDC` | `독립 설계 검토` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 노이즈 |
+| `CCTV` | `현장 관제` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 노이즈 |
+| `KAIA` | `랫폼 기반 건설공간정보 통합운영 기술개발` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 노이즈 |
+| `KAIA` | `가상건설시스템개발연구단` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 노이즈 |
+| `KAIA` | `디지털 국토정보기술 개발사업` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 노이즈 |
+| `CM` | `동시에 실제 공사단계에서 공사관리` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 노이즈 |
+| `HOW` | `어떻게 연계` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 노이즈 |
+| `WHEN` | `언제 사용` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 노이즈 |
+| `DX` | `타이틀
+
+디지털 전환` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 노이즈 |
+| `DX` | `건설산업의 디지털전환` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 노이즈 |
+| `DX` | `내용
+디지털 전환` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 노이즈 |
+| `DX` | `은 건설산업의 디지털전환` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 노이즈 |
+| `UX` | `행착오를 포함한 수행 경험과 사용자 경험` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 노이즈 |
+| `GIS` | `지반 등 위치정보` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 노이즈 |
+
+## 4. 한영 병기 패턴 (evidence only — 신뢰도 낮음)
+
+**주의**: regex가 주변 문맥까지 삼키는 경우 많음. 그대로 synonym 하면 안 됨.
+
+| 한글 | 영문 | 등장 횟수 | 분류 (검수) |
+|------|------|----------|------------|
+| `실측 기록` | `flat` | 14 | ⬜ 동의어 / ⬜ 번역 / ⬜ 설명 / ⬜ 노이즈 |
+| `토목공학 지식` | `Domain knowledge` | 3 | ⬜ 동의어 / ⬜ 번역 / ⬜ 설명 / ⬜ 노이즈 |
+| `쉬운 이해와 명확한 의사소통` | `Communication` | 2 | ⬜ 동의어 / ⬜ 번역 / ⬜ 설명 / ⬜ 노이즈 |
+| `산체계의 디지털화 중심으로 발전` | `Smart Factory` | 2 | ⬜ 동의어 / ⬜ 번역 / ⬜ 설명 / ⬜ 노이즈 |
+| `내외장재 제품` | `Object` | 2 | ⬜ 동의어 / ⬜ 번역 / ⬜ 설명 / ⬜ 노이즈 |
+| `기반 정보물` | `Information Data and Products` | 2 | ⬜ 동의어 / ⬜ 번역 / ⬜ 설명 / ⬜ 노이즈 |
+| `을 활용한 과정` | `Process` | 2 | ⬜ 동의어 / ⬜ 번역 / ⬜ 설명 / ⬜ 노이즈 |
+| `무슨 정보` | `What` | 2 | ⬜ 동의어 / ⬜ 번역 / ⬜ 설명 / ⬜ 노이즈 |
+| `내용 속성` | `Contents` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 설명 / ⬜ 노이즈 |
+| `검측 계획 기반 검측 체크리스트` | `Checklist` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 설명 / ⬜ 노이즈 |
+| `속성정보` | `User Dependent` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 설명 / ⬜ 노이즈 |
+| `속성정보` | `Software Dependent` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 설명 / ⬜ 노이즈 |
+| `시스템 구성도` | `System Process` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 설명 / ⬜ 노이즈 |
+| `제조업` | `Digital Twin` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 설명 / ⬜ 노이즈 |
+| `를 위치 정보` | `Spatial Information` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 설명 / ⬜ 노이즈 |
+| `영을 위한 디지털 모델링은 제품` | `Object` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 설명 / ⬜ 노이즈 |
+| `건축업` | `BIM` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 설명 / ⬜ 노이즈 |
+| `독립 설계 검토` | `IDC` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 설명 / ⬜ 노이즈 |
+| `와 연계하여 개별 객체` | `Object` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 설명 / ⬜ 노이즈 |
+| `시각적 확인 및 검증` | `Vision Inspection` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 설명 / ⬜ 노이즈 |
+| `과   내용 속성` | `Contents` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 설명 / ⬜ 노이즈 |
+| `표출 속성` | `Attribute` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 설명 / ⬜ 노이즈 |
+| `과 정의 속성` | `Property` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 설명 / ⬜ 노이즈 |
+| `및 업무수행 방식` | `Process` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 설명 / ⬜ 노이즈 |
+| `시공 모델` | `Watch BIM` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 설명 / ⬜ 노이즈 |
+| `후 공사모델` | `Watch BIM` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 설명 / ⬜ 노이즈 |
+| `현장 관제` | `CCTV` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 설명 / ⬜ 노이즈 |
+| `운영 모델` | `Twin Highway` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 설명 / ⬜ 노이즈 |
+| `지관리 정보모델을 통한 운영모델` | `Twin Highway` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 설명 / ⬜ 노이즈 |
+| `차적 목표 다양한 제품` | `Library` | 1 | ⬜ 동의어 / ⬜ 번역 / ⬜ 설명 / ⬜ 노이즈 |
+
+## 5. 명시적 수동 검수 필요 (관계 모호)
+
+- ⬜ 발주자 vs 발주처 (역할 vs 기관)
+- ⬜ 시공자 vs 시공사 (역할 vs 회사)
+- ⬜ 설계자 vs 설계사 (역할 vs 회사)
+- ⬜ Engineering S/W vs Engn. S/W (약어 — 동의어 가능)
+- ⬜ Engineering S/W vs Solution S/W (상하위 or 분류)
+- ⬜ Engineering S/W vs Application S/W (상하위 or 분류)
+
+---
+
+## 6. 검수 후 분기
+
+| 분류 | 반영 위치 |
+|------|----------|
+| Promote 승격 | `synonyms.yaml` (production) |
+| Hold / Discard | 폐기 또는 보류, synonyms.yaml에 넣지 않음 |
+| 약어-풀네임 확정 | `synonyms.yaml` 추가 (매칭 영향 확인 후) |
+| 한영 병기 확정 | 동일 |
+| 근접어 / 기관vs역할 | `hierarchy.yaml` (Phase 25 연동 예정) |
+| 상하위 관계 (Engineering S/W 계열) | `hierarchy.yaml` (taxonomy 구축) |
+
+**Production 승격 체크리스트:**
+
+1. ✅ 실데이터 증거 (corpus 등장)
+2. ✅ 치환해도 의미 불변 (문맥 독립)
+3. ✅ Phase 19 재실행 시 점수 불변 or 개선 (악화 없음)
+4. ✅ 사람 검수 통과