# 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 자동 발굴 (다음 단계)