권혁성
db63fcff85
- 개발팀 전용 폴더 dev/ 생성 (standards, guides, quickstart, changes, deploys, data, history, dev_plans 이동) - 프론트엔드 전용 폴더 frontend/ 생성 (api/ → frontend/api-specs/) - 기획팀 폴더 requests/ 생성 - plans/ → dev/dev_plans/ 이름 변경 - README.md 신규 (사람용 안내), INDEX.md 재작성 (Claude Code용) - resources.md 신규 (노션 링크용, assets/brochure 이관 예정) - CURRENT_WORKS.md 삭제, TODO.md → dev/ 이동 - 전체 참조 경로 업데이트 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
95 lines
3.5 KiB
Markdown
95 lines
3.5 KiB
Markdown
# 변경 내용 요약
|
|
|
|
**날짜:** 2025-01-08
|
|
**작업자:** Claude Code
|
|
**이슈:** Order Management API Phase 1.1
|
|
|
|
## 📋 변경 개요
|
|
수주관리(Order Management) API의 기본 CRUD 및 상태 관리 기능을 구현했습니다.
|
|
WorkOrderService/Controller 패턴을 참고하여 SAM API 규칙을 준수하는 OrderService와 OrderController를 생성했습니다.
|
|
|
|
## 📁 수정/추가된 파일
|
|
|
|
### 신규 생성 (7개)
|
|
- `app/Services/OrderService.php` - 수주 비즈니스 로직 서비스
|
|
- `app/Http/Controllers/Api/V1/OrderController.php` - 수주 API 컨트롤러
|
|
- `app/Http/Requests/Order/StoreOrderRequest.php` - 생성 요청 검증
|
|
- `app/Http/Requests/Order/UpdateOrderRequest.php` - 수정 요청 검증
|
|
- `app/Http/Requests/Order/UpdateOrderStatusRequest.php` - 상태 변경 요청 검증
|
|
- `app/Swagger/v1/OrderApi.php` - Swagger API 문서
|
|
|
|
### 수정 (5개)
|
|
- `routes/api.php` - OrderController import 및 라우트 추가
|
|
- `lang/ko/message.php` - 수주 관련 메시지 키 추가
|
|
- `lang/en/message.php` - 수주 관련 메시지 키 추가
|
|
- `lang/ko/error.php` - 수주 에러 메시지 키 추가
|
|
- `lang/en/error.php` - 수주 에러 메시지 키 추가
|
|
|
|
## 🔧 상세 변경 사항
|
|
|
|
### 1. OrderService
|
|
**기능:**
|
|
- `index()` - 목록 조회 (검색/필터링/페이징)
|
|
- `stats()` - 통계 조회 (상태별 건수/금액)
|
|
- `show()` - 단건 조회
|
|
- `store()` - 생성 (수주번호 자동생성)
|
|
- `update()` - 수정 (완료/취소 상태 수정 불가)
|
|
- `destroy()` - 삭제 (진행중/완료 상태 삭제 불가)
|
|
- `updateStatus()` - 상태 변경 (전환 규칙 검증)
|
|
|
|
**내부 메서드:**
|
|
- `validateStatusTransition()` - 상태 전환 규칙 검증
|
|
- `calculateItemAmounts()` - 품목 금액 계산 (공급가, 세액, 합계)
|
|
- `generateOrderNo()` - 수주번호 자동 생성 (ORD{YYYYMMDD}{0001})
|
|
|
|
### 2. OrderController
|
|
**엔드포인트:**
|
|
- `GET /api/v1/orders` - 목록 조회
|
|
- `GET /api/v1/orders/stats` - 통계 조회
|
|
- `POST /api/v1/orders` - 생성
|
|
- `GET /api/v1/orders/{id}` - 단건 조회
|
|
- `PUT /api/v1/orders/{id}` - 수정
|
|
- `DELETE /api/v1/orders/{id}` - 삭제
|
|
- `PATCH /api/v1/orders/{id}/status` - 상태 변경
|
|
|
|
### 3. FormRequest 클래스
|
|
**StoreOrderRequest:**
|
|
- 주문유형, 카테고리, 거래처 정보, 금액, 배송, 품목 배열 검증
|
|
|
|
**UpdateOrderRequest:**
|
|
- Store와 유사하나 order_no 제외 (수정 불가)
|
|
|
|
**UpdateOrderStatusRequest:**
|
|
- status 필드만 검증 (Rule::in 사용)
|
|
|
|
### 4. 상태 전환 규칙
|
|
```
|
|
DRAFT → CONFIRMED, CANCELLED
|
|
CONFIRMED → IN_PROGRESS, CANCELLED
|
|
IN_PROGRESS → COMPLETED, CANCELLED
|
|
COMPLETED → (변경 불가)
|
|
CANCELLED → DRAFT (복구 가능)
|
|
```
|
|
|
|
### 5. Swagger 문서
|
|
**스키마:**
|
|
- Order, OrderItem, OrderPagination, OrderStats
|
|
- OrderCreateRequest, OrderUpdateRequest, OrderItemRequest, OrderStatusRequest
|
|
|
|
## ✅ 검증 완료 항목
|
|
- [x] Pint 코드 스타일 검사 (6개 파일 자동 수정)
|
|
- [x] Swagger 문서 생성 (`php artisan l5-swagger:generate`)
|
|
- [x] Service-First 아키텍처 준수
|
|
- [x] FormRequest 검증 패턴 사용
|
|
- [x] i18n 메시지 키 사용
|
|
- [x] Multi-tenancy (BelongsToTenant) 지원
|
|
- [x] 감사 로그 컬럼 (created_by, updated_by, deleted_by)
|
|
|
|
## ⚠️ 배포 시 주의사항
|
|
- Order 모델은 기존에 이미 존재함 (마이그레이션 불필요)
|
|
- Swagger UI에서 API 테스트 가능: http://api.sam.kr/api-docs/index.html
|
|
|
|
## 🔗 관련 문서
|
|
- 계획 문서: `docs/dev_plans/order-management-plan.md`
|
|
- 참고 패턴: `app/Services/WorkOrderService.php`, `app/Http/Controllers/Api/V1/WorkOrderController.php`
|