Files
C.E.L_Slide_test2/tests/matching/SYNONYMS_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

75 lines
4.3 KiB
Markdown

# Synonym 사전 관리 기준 — 이원화
> **초안 검수 결과 반영 판**: 기준과 실제 사전의 모순을 해소하기 위해 production/candidate로 분리.
## 1. 운영 원칙 (v2)
- **이원화**: `synonyms.yaml` (production, 최소본) + `synonyms_candidates.yaml` (검수 대기)
- **production 진입 기준 (엄격)**:
1. 실제 데이터(MDX + Figma)에 **등장 확인**
2. **매칭 케이스에 직접 영향** 확인
3. **일반 용어/유의어 아님** (엄밀 동의어)
- **candidate 승격 프로세스**:
1. 실패 케이스 분석
2. candidate에서 해당 항목 확인
3. 회귀 테스트 통과 시 production으로 이동
- 일반 용어는 **영구적으로 제외** (reject 처리)
## 2. Production 사전 (6개 canonical)
실전 매칭에 사용. 변경은 회귀 테스트 필수.
| Canonical | Variants | 등록 이유 |
|-----------|----------|-----------|
| `필수조건` | `필수 요건`, `필수요건` | MDX03-1 정답 매칭에 필수 |
| `DX` | `디지털 전환`, `디지털전환` | MDX/Figma 전반 빈번 |
| `과정혁신` | `과정의 혁신`, `Process 혁신` | MDX03-2 정답 매칭에 필수 |
| `결과혁신` | `결과의 혁신`, `Product의 변화` | MDX03-2 정답 매칭에 필수 |
| `3D모델` | `3D 모델`, `3차원 모델` | MDX 전반 띄어쓰기 혼용 |
| `2D도면` | `2D 도면` | MDX 전반 띄어쓰기 혼용 |
**총 variants 11개** (데이터 기반 검증 완료)
## 3. Candidate 사전 (검수 대기: 9개, 거부: 7개)
### 3-1. Evidence Only (데이터 등장 확인, production 승격 여부 검토)
| Canonical | Variants | 등장 위치 | 상태 | 메모 |
|-----------|----------|----------|------|------|
| `BIM` | `Building Information Modeling` | MDX/01.mdx | evidence_only | MDX01에 1회만 등장. 풀네임-약어 쌍. |
| `발주자` | `발주처` | MDX/01.mdx, Figma/1171281175/texts.md | evidence_only | Figma DB에 '발주처'도 이미 등록됨 (1171281195 analysis.md). canonical 어느 쪽으로 갈지 결정 필요. |
| `시공자` | `시공사`, `건설사` | MDX/01.mdx, Figma/1171281175 | evidence_only | Figma DB에 '시공사'도 등록됨. canonical 정책 필요. |
| `설계자` | `설계사`, `엔지니어링사` | MDX/01.mdx, Figma/1171281175 | evidence_only | 위와 동일. |
| `디지털기술` | `디지털 기술`, `Digital Technology` | MDX/01.mdx, MDX/03.mdx | evidence_only | 일반 용어 성격. 기술 전반에 쓰임. |
| `전문지식` | `전문 지식` | MDX/03.mdx, Figma/1171281192 | evidence_only | 일반 용어 성격. |
| `성장동력` | `성장 동력` | Figma/1171281192 | evidence_only | Figma 한 곳에만 등장. 효과 미미 예상. |
| `기대효과` | `기대 효과` | Figma/1171281191/analysis.md | evidence_only | Figma analysis.md에만 등장 (제가 태깅 시 쓴 단어). 실질 효과 낮음. |
| `주체별` | `역할별` | Figma/1171281191/analysis.md | evidence_only | Figma analysis.md에서 1회 (제가 태깅 시 사용). |
### 3-2. Reject (등록 기준 위반, 사전에서 제외)
| Canonical | 이유 |
|-----------|------|
| `고부가가치` | 일반 용어. 띄어쓰기 변형도 데이터에 없음. |
| `건설산업` | 일반 용어. 데이터에는 공백 없는 '건설산업' 한 형태로만 등장. |
| `역량목표` | 일반 용어. 띄어쓰기 변형 데이터 없음. |
| `실행요건` | 일반 용어. 띄어쓰기 변형 데이터 없음. |
| `정책목표` | 일반 용어. 띄어쓰기 변형 데이터 없음. |
| `3요소` | 수량 표현. 띄어쓰기/유의어 변형 데이터 없음. |
| `4문제` | 수량 표현. 데이터 없음. |
## 4. 초안 대비 변경 요약
| 항목 | 초안 | 수정판 |
|------|------|--------|
| 총 canonical | 22 | 6 (production) + 16 (candidate 대기/거부) |
| 총 variants | 55 | 10 (production) + 나머지는 candidate |
| 일반 용어 포함 여부 | ❌ 기준 위반 포함됨 | ✓ production 제외, candidate에서 reject |
| 데이터 검증 | ❌ 55개 중 31개 미검증 | ✓ production은 전부 데이터 검증 완료 |
## 5. 다음 액션
1. **Phase 18~22 재실행** — production 최소본으로 돌려서 점수 변화 확인
2. **candidate evidence_only 9개 검토** — 매칭 실패 케이스 발생 시 승격
3. **data mining 스크립트 준비** — 놓친 variants 자동 발굴 (다음 단계)