Files
C.E.L_Slide_test2/tests/matching/DOMAIN_TERMS_REPORT.md
T
KyeongminandClaude Opus 4.8 b836e79ee1 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

203 lines
11 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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. ✅ 사람 검수 통과