sam-docs/changes/20260322_wip_worker_screen_improvements.md

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

날짜: 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