# ADR-0014 — Phase 5 범위·완성 기준

상태: **Accepted (2026-05-08, 야간 자율 사이클 9)**

---

## 결정

Phase 5 = **사양 결정 모듈 데이터 모델 + 일본어/독일어 로컬화 + 매출 후 가치 단계 상승 인프라**.
실 토크 산정 알고리즘은 산업 표준 모터 카탈로그 / 기어 효율 데이터 의존 → **Phase 6 (사용자 자료 + 외부 컨설팅) 입력**.
Phase 5는 **데이터 모델 + 인터페이스 + 시드 + 영어/일본어/독일어 라벨까지** 자율 진행.

## 완성 기준 (체크리스트)

### A. 사양 결정 모듈 — 데이터 모델

- [ ] `MotionSample` 입력 스키마 — Part id × 시간별 position/rotation 샘플
- [ ] `SpecResult` 출력 스키마 — 권장 모터 토크/출력/기어비/안전계수
- [ ] `ISpecCalculator` 인터페이스 — 알고리즘 swap 가능
- [ ] `SimpleHeuristicCalculator` Phase 5 PoC (단순 운동 평균 → 추정값)
- [ ] JSON 직렬화 + 라운드트립 단위 테스트
- [ ] FeatureGate `SpecCalculator` (Phase 5+ Pro Plus 차별화)

### B. 일본어 / 독일어 로컬화

- [ ] `Resources/Localization/ja.json` (35키 일본어)
- [ ] `Resources/Localization/de.json` (35키 독일어)
- [ ] 누락 키 fallback: en → ko 순서 (기존 default ko에 ko/en만 있음을 4단계 fallback으로 확장)
- [ ] 단위 테스트 — ja/de 키 로드 + format args

### C. 자동 검증

- [ ] Phase 5 통합 테스트 (Specification + 다국어 + dirty 통합)
- [ ] Unit Tests 누적 115+ PASS
- [ ] 컴파일 13차 누적 클린

### D. 협업자 자료

- [ ] ADR-0015 Phase 5 봉인
- [ ] /home + /home/en + /home/ja + /home/de 검토 (실 페이지는 ja/de 자율 가능)
- [ ] index.html R2 + PDF v5

### E. 자율 진행 외 (Phase 6 입력)

- 실 토크 산정 알고리즘 (모터 카탈로그 외부 자료 + 컨설팅 필요)
- 일본어/독일어 BD 채널 시연
- 가격 재평가 (사양 결정 모듈 추가 후 Pro Plus 단가 결정)
- 라이선스 키 백엔드 (자체 호스팅 / LemonSqueezy / Paddle)
- 첫 매출 + 영업 활동

## 사양 결정 모듈 — Phase 5 PoC 알고리즘 (자율)

```
Input:  MotionSample[] (Part id × t × pos × rot 샘플)
        + Part 속성 (mass, friction, gearRatio)

Step 1. 시간 미분으로 각속도 ω(t) + 각가속도 α(t) 추정
Step 2. 토크 추정 T = inertia × α  (간단 스칼라)
Step 3. 출력 추정 P = T × ω  (peak)
Step 4. 안전계수 1.5x 적용 → 권장 토크/출력
Step 5. 기어비 추정 — 사용자 명시 없으면 1.0x

PoC 한계:
  - 실 부하(마찰·관성·기어 효율) 정확도 낮음
  - 모터 카탈로그 매칭 없음 (Phase 6 외부 자료)
  - 안전계수 1.5x는 일반 가정 — 산업별 맞춤 Phase 6
```

## 가치 단계 상승 — 사양 결정 모듈

| 사용 단계 | 가치 | Pro 단가 (현재) | Pro Plus (Phase 6+) |
|---|---|---|---|
| Phase 1~4 | 동작 검증 (충돌/시퀀스/PLC) | $1.5K~$3.8K | — |
| Phase 5 (데이터 모델만) | 시뮬 데이터 export | 동일 | — |
| Phase 6+ (실 알고리즘) | **사양 결정 도구** (단가 재평가) | — | **$3K~$8K** |

## 일본어 / 독일어 시장 진입 근거

- **일본어**: 일본 자동화 OEM 다수 (Mitsubishi · Fanuc · Yaskawa · Omron · Keyence) — 영어 자료보다 일본어 자료가 BD 채널에 더 효율적
- **독일어**: 독일 산업 자동화 (Siemens · Beckhoff · Bosch Rexroth · KUKA) — 독일어권 머신빌더 진입 시 필수
- 한국어/영어 35키 이미 SSOT — 일본어/독일어 35키 추가는 자율 가능

## 참고

- ADR-0001~0013 — 기존
- ADR-0008 — 60fps 성능 예산 (Specification 모듈도 60fps 안에 처리 가능 추정)
- 사용자 야간 자율 진행 지시 — `wiki/journal/2026-05-08.md`