jklee
08ea11ea37
- Unity 6.4 URP 프로젝트 베이스 - Inbound 비즈니스 로직: Scan/Putaway/Scoring 서비스 + InboundManager - 데이터 모델: Item/Location/Scenario (ScriptableObject) + StorageZone - 샘플 시나리오 inbound_basic.json, 설계문서/목업 포함 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
49 lines
2.3 KiB
Markdown
49 lines
2.3 KiB
Markdown
# 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번째 모듈(피킹)
|