feat: 수주 관리 Phase 3 - Frontend API 연동

- createOrderFromQuote(): 견적→수주 변환 API 호출
- createProductionOrder(): 생산지시 생성 API 호출
- WorkOrder 타입 및 변환 함수 추가
- 변경 내역 문서 작성
This commit is contained in:
2026-01-08 20:17:55 +09:00
parent 6632943c7e
commit 3d2dea6118
2 changed files with 293 additions and 0 deletions

View File

@@ -0,0 +1,113 @@
# 수주 관리 Phase 3 - 고급 기능
**날짜:** 2025-01-08
**Phase:** Phase 3 - 고급 기능
**관련 Plan:** docs/plans/order-management-plan.md
## 변경 개요
수주 관리 시스템에 견적→수주 변환 및 생산지시 생성 기능 추가.
## API 추가 사항
### 1. 견적에서 수주 생성
- **Endpoint**: `POST /api/v1/orders/from-quote/{quoteId}`
- **기능**: 기존 견적서를 기반으로 수주를 자동 생성
- **검증**: 이미 수주가 생성된 견적은 중복 생성 방지
### 2. 생산지시 생성
- **Endpoint**: `POST /api/v1/orders/{id}/production-order`
- **기능**: 확정된 수주에서 작업지시(WorkOrder) 생성
- **검증**: CONFIRMED 상태의 수주만 생산지시 가능
## 수정된 파일
### API (Laravel)
#### 1. `app/Services/OrderService.php`
- `createFromQuote(int $quoteId, array $data)`: 견적→수주 변환 로직
- `createProductionOrder(int $orderId, array $data)`: 생산지시 생성 로직
- `generateWorkOrderNo(int $tenantId)`: 작업지시번호 자동 생성
#### 2. `app/Http/Controllers/Api/V1/OrderController.php`
- `createFromQuote()`: 견적→수주 액션
- `createProductionOrder()`: 생산지시 생성 액션
#### 3. `app/Http/Requests/Order/CreateFromQuoteRequest.php` (신규)
- 견적→수주 변환 요청 검증
- 선택 필드: delivery_date, memo
#### 4. `app/Http/Requests/Order/CreateProductionOrderRequest.php` (신규)
- 생산지시 생성 요청 검증
- 선택 필드: process_type, assignee_id, team_id, scheduled_date, memo
#### 5. `routes/api.php`
- `POST /orders/from-quote/{quoteId}`: 견적→수주 라우트
- `POST /orders/{id}/production-order`: 생산지시 라우트
#### 6. `lang/ko/message.php`
- `order.created_from_quote`: 견적에서 수주가 생성되었습니다.
- `order.production_order_created`: 생산지시가 생성되었습니다.
#### 7. `lang/ko/error.php`
- `order.already_created_from_quote`: 이미 해당 견적에서 수주가 생성되었습니다.
- `order.must_be_confirmed_for_production`: 확정 상태의 수주만 생산지시를 생성할 수 있습니다.
- `order.production_order_already_exists`: 이미 생산지시가 존재합니다.
- `quote.not_found`: 견적을 찾을 수 없습니다.
### Frontend (React)
#### 1. `src/components/orders/actions.ts`
- 타입 추가: `CreateFromQuoteData`, `CreateProductionOrderData`, `WorkOrder`, `ProductionOrderResult`
- API 인터페이스 추가: `ApiWorkOrder`, `ApiProductionOrderResponse`
- `createOrderFromQuote(quoteId, data)`: 견적→수주 API 호출
- `createProductionOrder(orderId, data)`: 생산지시 생성 API 호출
- `transformWorkOrderApiToFrontend()`: WorkOrder 데이터 변환
## 비즈니스 로직
### 견적→수주 변환 흐름
```
Quote (견적)
↓ createFromQuote()
Order (수주) - DRAFT 상태
- quote_id 연결
- client, site_name 복사
- items 변환 (quantity=calculated_quantity)
- 금액 재계산
```
### 생산지시 생성 흐름
```
Order (수주) - CONFIRMED 상태
↓ createProductionOrder()
WorkOrder (작업지시) - PENDING 상태
- sales_order_id 연결
- project_name = site_name
- process_type 설정
Order 상태 → IN_PROGRESS
```
### 상태 전환 규칙 (기존)
```
DRAFT → CONFIRMED → IN_PROGRESS → COMPLETED
↓ ↓ ↓
CANCELLED (어느 단계에서든 취소 가능)
```
## 테스트 체크리스트
- [ ] 견적→수주 생성 (정상 케이스)
- [ ] 견적→수주 생성 (중복 방지)
- [ ] 견적→수주 생성 (존재하지 않는 견적)
- [ ] 생산지시 생성 (정상 케이스)
- [ ] 생산지시 생성 (CONFIRMED 아닌 수주)
- [ ] 생산지시 생성 (중복 방지)
- [ ] 수주 상태 자동 변경 (CONFIRMED → IN_PROGRESS)
## 연관 작업
- Phase 1: Order API 백엔드 구현 (커밋: de19ac9)
- Phase 2: Frontend API 연동 (커밋: 572ffe8)
- Phase 3: 고급 기능 (현재)