# SINO VR WMS — WMS 교육 시뮬레이터

WMS 업무를 게임처럼 학습하는 교육 프로그램. **Unity 6 LTS** 기반.
첫 모듈은 **입고(Inbound)** — 탑다운 뷰 + PDA 바코드 스캔.

자세한 설계는 [docs/design.md](docs/design.md) 참고.

## 현재 포함된 것 (코드 골격)
Unity 에디터 없이 먼저 잡아둔 비즈니스 로직 + 데이터 모델입니다.

```
Assets/
  Scripts/
    Core/      InboundStep            # 미션 단계 enum
    Data/      StorageZone            # 보관 조건
               ItemDefinition         # 품목 마스터 (ScriptableObject)
               LocationDefinition     # 로케이션 마스터 (ScriptableObject)
               InboundScenario        # 입고 시나리오 (ScriptableObject)
    Inbound/   LineProgress           # 라인별 런타임 상태
               ScanService            # 바코드 스캔 검증
               PutawayService         # 적치 규칙(존/용량) 검증
               ScoringSystem          # 점수/오류 집계
               InboundManager         # 전체 흐름 오케스트레이터 (MonoBehaviour)
  Resources/Scenarios/
               inbound_basic.json     # 샘플 시나리오 (수량 차이 함정 포함)
```

## Unity에서 시작하기
1. **Unity 6 LTS** (6.3 권장) 설치 후 빈 3D 프로젝트 생성
2. 이 저장소의 `Assets/` 폴더를 Unity 프로젝트의 `Assets/`로 복사
3. 빈 GameObject에 `InboundManager` 컴포넌트 추가
4. `Create > SinoWMS > ...` 메뉴로 Item / Location / Scenario `.asset` 생성
   (또는 `inbound_basic.json`을 로더로 읽도록 연결)
5. `InboundManager.StartMission()` 호출로 미션 시작
6. UI(PdaView 등)에서 `HandleScan / HandleInspect / HandlePutaway` 호출, `StepChanged / Feedback / Completed` 이벤트 구독

## 미션 흐름
입고예정 확인 → 바코드 스캔 → 검수(수량) → 로케이션 선택 → 적치 → 채점

오류 케이스(감점): 오스캔 / 수량차이 미처리 / 보관조건 위반 / 용량초과 / 검수 전 적치

## 다음 작업
- [ ] Unity 프로젝트 생성 + Assets 연결
- [ ] 탑다운 카메라 + 창고 그리드 씬
- [ ] PDA UI 프리팹 (UI Toolkit 또는 uGUI)
- [ ] JSON → ScriptableObject 로더
- [ ] 채점 결과 화면
- [ ] 2번째 모듈(피킹)