# ADR-0021 — 한국 단일 시장 회귀 + 툴 방향성 재정의

상태: **Accepted (2026-05-08, 사용자 명시 결정)**

---

## 결정

1. **한국 외 다른 국가도 비용 쓰지 않는다** — 일본·독일 등 해외 시장 진입 자료/기능에 자원 투입 X
2. **한국 기준 개발 완료에 집중** — 모든 자원을 한국 자동화 SI · 설비 설계사 · 머신빌더 · 교육기관에 투입
3. **툴 방향성**: 누구나 쉽게 사용 가능 + STP 파일 빠르고 쉽게 입력 → 즉시 적용

## 사용자 명시

- 2026-05-08: "한국 외 다른 국가도 비용 쓰지 않는다 일단 한국 기준 개발 완료에 집중한다. 누구나 쉽게 사용할 수 있고 stp파일을 빠르고 쉽게 입력하여 툴에 적용할 수 있음을 툴의 방향성으로 한다."

## 폐기 (archive 처리)

위치: `archive/2026-05-08-non-korea-localization-discard/`

### i18n 리소스 2종 (Assets/Resources/Localization/)

| 파일 | 사유 |
|---|---|
| ja.json (35키 일본어) | Mitsubishi/FANUC 시장 진입 폐기 |
| de.json (35키 독일어) | Siemens/Beckhoff 시장 진입 폐기 |

### 시연 시나리오 3종 (wiki/topics/demo/)

| 파일 | 사유 |
|---|---|
| 0002-english-demo-scenario.md | 글로벌/영어권 BD 채널 폐기 |
| 0003-japanese-demo-scenario.md | 일본 시장 진입 폐기 |
| 0004-german-demo-scenario.md | 독일 시장 진입 폐기 |

### 단위 테스트 2종 (UnitTests.cs)

- Test_Localization_jaResource (ja 리소스 검증)
- Test_Localization_deResource (de 리소스 검증)

## 보존 (한국 단일 + 영어 fallback)

| 파일/기능 | 보존 사유 |
|---|---|
| ko.json (35키 한국어) | **정식** 한국 시장 UI |
| en.json (35키 영어) | 코드 디버깅 fallback + 영어권 협업자 1~2명 가능성 (예: 외국인 학생 인턴) |
| LocalizationManager.cs (en fallback chain) | ko 누락 키 → en → 키 자체. 코드 변경 최소 |
| Test_Localization_enFallback | en fallback 동작 검증 |
| Test_Localization_supportedLangs | 2 supported langs (ko + en) 검증 |

`SupportedLanguages = { "ko", "en" }` — 4개 → 2개로 축소.

## 툴 방향성 4원칙 (재정의)

기존 ADR-0001 4원칙 위에 보강:

1. **STP 빠르고 쉬운 입력**
   - 드래그앤드롭 한 번으로 STP → glb 자동 변환
   - 사용자가 메시 후처리 / decimation / LOD 수동 조작할 필요 0
   - 변환 백엔드 (cadquery-ocp + Blender Draco) subprocess 격리 → 실패 시에도 본체 영향 X
   - 검증 완료: 261MB 산업 어셈블리 → 19MB (93% 압축, 평균 3.7× 인스턴싱, 부품명 100% 보존)

2. **누구나 사용 가능 (비코딩 + 비CAD-전문)**
   - Python·DSL·스크립팅 학습 X
   - Inspector TreeView + 검색 + 자동 펼침 — 8763 부품도 30초 내 원하는 부품 찾기
   - 속성 패널 (type · movable · transform · movement) — 토글 + 슬라이더로 모든 조작
   - 시뮬 동작은 운동학 (수학 transform) — Rigidbody 미사용으로 NaN/jitter 없음

3. **즉시 적용 (학습 비용 최소)**
   - 신규 사용자 30분 시연 가능 — Phase 1 협업자 시연 시나리오 (`wiki/topics/demo/0001`) 참고
   - 데모 모드: STP 파일 → 자동 Constraint 생성 → 자동 시뮬 시작
   - JSON 프로젝트 파일 라운드트립 — 이메일/메신저로 .factory.json 공유 가능

4. **한국 시장 단일 집중**
   - 도메인 톤·BD 채널·가격대·PLC 벤더 우선순위 모두 한국 기준
   - 해외 진출은 첫 매출 5~10건 + 파일럿 안정화 후 재검토

## 메트릭 영향

| 지표 | 폐기 전 | 폐기 후 |
|---|---|---|
| Unit Tests | 130/130 | **124/124** (-6 ja/de Check) |
| 통합 테스트 누적 | 78/78 | 78/78 (변경 없음) |
| 컴파일 | 17차 클린 | **18차** 누적 클린 |
| 시연 시나리오 | 4언어 | **한국어 1종** |
| i18n | 4언어 (ko/en/ja/de) | **한국어 ko + en fallback** |
| 활성 ADR | 17건 | **활성 18건** (0021 추가) |
| Archive ADR/리소스 | 결제 5+테스트 19+통합 1 | + ja/de 리소스 + en/ja/de demo + ja/de 테스트 |

## 후속 작업 (자율 진행)

- [x] ja.json / de.json archive
- [x] 0002~0004 시연 시나리오 archive (한국어 0001만 유지)
- [x] LocalizationManager SupportedLanguages 한국 단일 + en fallback
- [x] UnitTests.cs ja/de 테스트 호출 + 정의 archive
- [x] Unity batch 컴파일 검증 — Unit 124/124 PASS · 컴파일 18차 클린
- [x] wiki/index.html 핵심 메시지 + 메트릭 + 툴 방향성 재정렬
- [ ] INDEX.md 갱신
- [ ] PDF 재생성

## Phase 6 진행 영역 (한국 시장 우선 후속)

- 첫 매출 5~10건 (한국 자동화 SI 송금 모델)
- 한국 STP 자료 입수 (사용자 추후 전달)
- 한국 5사 파일럿 모집 + 케이스 스터디
- 한국 PLC 벤더 통합 (Mitsubishi MELSEC / LS Electric / Beckhoff Korea / Siemens Korea)
- WebGL 영업 데모 모드 (한국어)
- 60fps 측정 후 DOTS/ECS 마이그레이션 결정
- 교육기관 무료 라이선스 → 졸업생 SI 입사 후 Pro 추진

## 참고

- ADR-0001 제품 비전 4원칙 (보강)
- ADR-0019 Open-Core 라이선스 모델
- ADR-0020 결제 시스템 폐기 + 직접 송금 모델
- archive/2026-05-08-non-korea-localization-discard/