docs: [order] 재고생산 API 스펙 업데이트

- 생산지시 자동 처리 항목 추가 (절곡 공정, project_name, scheduled_date)
- 프론트엔드 체크리스트 업데이트
This commit is contained in:
김보곤
2026-03-16 22:24:24 +09:00
parent 3529feeb70
commit cd3ee4e817

View File

@@ -167,7 +167,7 @@ POST /api/v1/orders
```
❌ client_id, client_name, client_contact → 거래처 없음
❌ site_name → 현장 없음
❌ site_name → API가 '재고생산'으로 자동 설정
❌ quote_id → 견적 없음
❌ delivery_date, delivery_method_code → 납기/배송 불필요
❌ discount_rate, discount_amount → 할인 없음
@@ -240,19 +240,30 @@ DRAFT → CONFIRMED → IN_PROGRESS → COMPLETED
POST /api/v1/orders/{id}/production-order
```
수주와 동일하게 작업지시(WorkOrder)를 생성한다.
재고생산은 **절곡 공정이 자동 선택**된다 (API에서 처리). `process_ids` 전달 불필요.
```json
{
"process_ids": [1, 2, 3],
"priority": "normal",
"scheduled_date": "2026-03-20",
"memo": "재고생산 작업"
}
```
---
**API 자동 처리 항목** (STOCK 타입):
| 항목 | 일반 수주 | 재고생산 (자동) |
|------|----------|---------------|
| 현장명 (`project_name`) | `site_name` 또는 `client_name` | `'재고생산'` 고정 |
| 공정 | BOM item_id → process_items 매칭 | **절곡 공정 자동 선택** |
| 작업예정일 (`scheduled_date`) | `delivery_date` | **생성일 (now())** |
| 매출 생성 | `sales_recognition` 정책 적용 | **생성 안 함** |
> 프론트에서 `process_ids`, `scheduled_date`를 전달하지 않아도 API가 자동 처리
---
## 3. 채번 규칙
| 주문 유형 | 접두사 | 예시 |
@@ -326,6 +337,11 @@ POST /api/v1/orders/{id}/production-order
- [ ] 생산지시 생성 버튼: `POST /api/v1/orders/{id}/production-order`
- [ ] 상태 변경: `PATCH /api/v1/orders/{id}/status`
### 프론트엔드 — 생산지시 목록 수정
- [ ] 생산지시 목록에서 `order_type_code``STOCK`인 건: 납기 컬럼 `-` 표시
- [ ] 생산지시 생성 UI: STOCK 수주는 공정 선택 불필요 (API가 절곡 자동 선택)
### 백엔드 (API) — 완료
- [x] `Order::TYPE_STOCK = 'STOCK'` 상수 추가
@@ -335,6 +351,10 @@ POST /api/v1/orders/{id}/production-order
- [x] stats()에 `order_type` 필터 추가
- [x] STOCK 타입 확정 시 매출 자동 생성 스킵
- [x] options에 `production_reason`, `target_stock_qty` 필드 추가
- [x] store()에서 STOCK 타입 `site_name = '재고생산'` 자동 설정
- [x] createProductionOrder()에서 STOCK: `project_name = '재고생산'` 고정
- [x] createProductionOrder()에서 STOCK: 절곡 공정 자동 선택
- [x] createProductionOrder()에서 STOCK: `scheduled_date = now()` 자동 설정
---