# 재공품 작업자화면 종합 개선

**날짜:** 2026-03-22
**작업자:** Claude Code

## 변경 개요

재공품(WIP) 절곡품의 작업자화면 전반을 개선했다. 검사 판정 로직, 작업일지 양식 분리, 자재투입 UX, 재고 품목유형 표시 등 다수의 항목을 수정했다.

## 수정 항목

### 1. 검사 측정값 허용오차 자동 판정

- 길이 도면치수 ±4mm, 간격 도면치수 ±2mm 초과 시 자동 부적합 판정
- 기존: 절곡상태(양호/불량)만 체크, 측정값은 무시

### 2. 재공품 작업일지 양식 분리

- `BendingWorkLogContent`에 `isWip` prop 추가
- 재공품일 때 수주 관련 필드(수주일, 수주처, 현장명, 출고예정일) 숨김
- 레이아웃은 기존 절곡 작업일지와 동일 유지
- MNG 문서양식관리에서 재공품 양식 기본필드도 정리 (수주 관련 제거)

### 3. 자재투입 UX 개선

| 기능 | 내용 |
|------|------|
| 매칭 정보 말풍선 | 각 자재 품목명 옆 ℹ️ 아이콘 → 매칭 기준/LOT 상태 표시 |
| 재고 검색 패널 | 재고 없는 자재 → 검색 패널 열어 유사 품목 검색 |
| 배정 현황 표시 | 상단에 "N/M 배정완료" 배지 |
| [DEV] 입고 강제생성 | 개발전용 버튼 → RM 원자재 매칭 + PT 재공품 재고 동시 생성 |

### 4. 입고 강제생성 API (`POST /api/v1/dev/force-receiving`)

- PT 품목의 `material` 속성(예: "EGI 1.55T")에서 RM 원자재 자동 매칭
- Receiving (검사완료) + Stock/StockLot (가용) + IQC Inspection (합격) 한번에 생성
- 상태값: `inspection_completed` (검사완료)

### 5. 재고 목록 품목유형 개선

- `stocks.item_type` 단축코드 통일 (`bent_part→PT`, `raw_material→RM` 등 194건 수정)
- `PT` → "부분품(재공품)" 라벨 표시
- 품목유형별 필터 추가: 전체 / 재공품 / 원자재 / 부자재 / 소모품

### 6. 기타

- 하위 공정 필터 뱃지 제거 (전체/절곡/재공품-가이드레일... → 항상 전체)
- PDF 생성 Puppeteer `PUPPETEER_EXECUTABLE_PATH` 환경변수 설정

## 수정된 파일

### React

| 파일 | 변경 내용 |
|------|----------|
| `InspectionInputModal.tsx` | 측정값 허용오차 판정, 테스트입력 7제품 대응 |
| `WorkLogModal.tsx` | 재공품 작업일지 공정 분기 |
| `BendingWorkLogContent.tsx` | isWip prop, 수주 필드 조건부 숨김 |
| `MaterialInputModal.tsx` | 매칭 말풍선, 검색 패널, 배정 현황, 강제입고 버튼 |
| `WorkerScreen/index.tsx` | 하위 공정 필터 제거 |
| `StockStatus/types.ts` | PT/FG/SF 품목유형 라벨 추가 |
| `StockStatus/StockStatusList.tsx` | 품목유형 탭 필터 추가 |
| `WorkerScreen/actions.ts` | searchStockByCode, forceCreateReceiving 추가 |

### API

| 파일 | 변경 내용 |
|------|----------|
| `ReceivingController.php` | forceCreate 메서드 (RM 매칭 + PT 재고 동시 생성) |
| `routes/api/v1/inventory.php` | `POST /dev/force-receiving` 라우트 |

### MNG (DB 직접 수정)

| 대상 | 변경 내용 |
|------|----------|
| 재공품 작업일지 양식 (69,71,73,75) | 수주일, 수주처, 현장명, 출고예정일 필드 제거 |
| 재공품 검사성적서 양식 (67,70,72,74,76) | 수주 LOT NO, 발주처, 현장명 필드 제거 |
| stocks 테이블 | item_type 영문→단축코드 194건 수정 |

## 관련 문서

- `changes/20260321_wip_inspection_report_fix.md` — 전일 검사부위 공백 수정
- `dev/guides/pdf-troubleshooting-guide.md` — PDF 트러블슈팅 가이드 (신규)
- `rules/wip-production-policy.md` — 재공품 생산 정책

---

**최종 업데이트**: 2026-03-22
