docs: [sales] 재고생산관리 문서 보강

- 재공품(WIP) 개념 설명 추가
- Phase 1/2 구현 범위 정리
- 작업자 화면 절곡 탭 향후 과제 기록
- 전체 메뉴 영향범위 검토 결과 추가
This commit is contained in:
김보곤
2026-03-16 22:59:43 +09:00
parent 029d4b6f02
commit 077a0a3331

View File

@@ -94,7 +94,49 @@ orders 테이블
---
## 5. API
## 5. 재공품(WIP) 개념
재고생산의 대상 품목은 **재공품(Work-In-Process)**이다.
- 수주를 받지 않았지만, 회사 내에서 **이미 정해진 절곡품**을 미리 생산
- 작업자들의 **유휴시간에 앞으로 나갈 물건을 미리 제작**하는 행위
- 실제 수주가 들어오면 이미 만들어둔 재공품을 사용하여 **납기 단축**
```
유휴시간 → 재공품 미리 생산 → 재고 적재
실제 수주 → 재고에서 재공품 사용 → 납기 단축
```
### 5.1 현재 구현 범위 (Phase 1)
- ✅ 재고생산 등록/목록/상세/수정/삭제
- ✅ 생산지시 생성 (절곡 공정 자동 선택)
- ✅ 생산지시 목록에 표시
- ✅ 작업지시 목록에 표시
- ✅ 생산현황판에 표시
- ✅ 작업실적 조회에 표시
### 5.2 향후 과제 (Phase 2)
> **작업자 화면 절곡 탭 — 재공품 사양 정보 연동**
현재 STOCK 건은 OrderNode(개소)가 없어 BendingInfoBuilder가 동작하지 않는다.
절곡 작업자 화면에서 다음 정보가 누락된다:
| 누락 정보 | 원인 | 해결 방향 |
|----------|------|----------|
| W/H (가로/세로) | OrderNode.options 없음 | 품목 마스터에 규격 정보 보유 → 등록 시 가져오기 |
| bending_info | BendingInfoBuilder 실패 (rootNodes 없음) | 품목별 표준 BOM 활용 또는 수동 입력 |
| 동적 자재 목록 | dynamic_bom 미생성 | 품목별 표준 BOM에서 자재 목록 생성 |
| 제품코드 | nodeOptions 없음 | 품목 마스터의 item_code 활용 |
**해결 전략**: 재공품은 이미 정해진 규격품이므로, 품목관리의 품목 정보(규격, BOM)를
재고생산 등록 시 `work_order_item.options`에 채워넣는 방식으로 해결 가능.
---
## 6. API
기존 수주관리 API를 그대로 사용한다. `order_type=STOCK` 파라미터로 필터링한다.
@@ -102,6 +144,19 @@ orders 테이블
---
## 7. 영향범위 검토 결과
| 메뉴 | 수정 필요 | 비고 |
|------|:--------:|------|
| 재고생산관리 (신규) | ✅ React 구현 | 수주 화면 단순화 |
| 생산지시 목록 | ⚠️ 소규모 | 납기/거래처 `-` 표시 (프론트) |
| 생산현황판 | ❌ 없음 | project_name='재고생산' 정상 표시 |
| 작업지시 목록 | ❌ 없음 | null fallback 처리 완비 |
| 작업실적 조회 | ❌ 없음 | Order 정보 미참조 |
| 작업자 화면 (절곡) | ⚠️ Phase 2 | bending_info/W/H 누락 (향후 과제) |
---
## 관련 문서
- [재고생산관리 API 명세](../../frontend/api-specs/stock-production-api.md)