Files
sam-docs/changes/20260322_wip_worker_screen_improvements.md

89 lines
3.6 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 재공품 작업자화면 종합 개선
**날짜:** 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