docs: [receiving] 원자재로트번호 자동채번 프론트엔드 요청서 추가

This commit is contained in:
김보곤
2026-03-17 20:33:15 +09:00
parent 9b6d5bebc9
commit 3b99197157
2 changed files with 77 additions and 0 deletions

View File

@@ -285,6 +285,7 @@ DB 도메인별:
| [stock-production-react-request.md](plans/stock-production-react-request.md) | 재고생산관리 React 구현 요청서 (수주 화면 단순화, API 스펙 포함) |
| [bending-lot-react-request.md](plans/bending-lot-react-request.md) | 절곡품 LOT 재고생산 React 구현 요청서 (캐스케이딩 드롭다운, LOT 자동생성, 취소 복원) |
| [barobill-react-improvement-request.md](plans/barobill-react-improvement-request.md) | 바로빌 React 개선 요청서 (동기화 버튼, 인증서/잔액 표시, 계좌/카드 목록, Server Action 6개) |
| [receiving-lot-auto-generate-request.md](plans/receiving-lot-auto-generate-request.md) | 입고등록 원자재로트번호 자동채번 적용 요청 (읽기전용 변경, API 자동생성) |
### frontend/integration/ — 프론트엔드 개발 가이드

View File

@@ -0,0 +1,76 @@
# 입고등록 — 원자재로트번호 자동채번 적용 요청
**날짜:** 2026-03-17
**요청자:** R&D실 (백엔드)
**대상:** React 프론트엔드
---
## 변경 요약
입고등록 화면의 **원자재로트번호** 필드를 **읽기 전용(자동채번)**으로 변경한다.
---
## 대상 화면
```
URL: /material/receiving-management/new/mode-new
/material/receiving-management/[id]?mode=edit
컴포넌트: ReceivingDetail.tsx
```
---
## 변경 내용
### 원자재로트번호 (`lot_no`) 필드
| 항목 | 변경 전 | 변경 후 |
|------|--------|--------|
| 입력 방식 | 사용자 직접 입력 (프론트 `generateLotNo()` 호출) | **읽기 전용** (API 자동 생성) |
| 신규 등록 시 | 프론트에서 랜덤 생성 후 전송 | `lot_no` 미전송 → API가 자동 채번 |
| 저장 후 표시 | — | API 응답의 `lot_no` 값을 표시 |
| 수정 모드 | 편집 가능 | **읽기 전용** (기존 값 표시) |
### UI 처리
```
✅ input 요소에 readOnly 또는 disabled 속성 적용
✅ 배경색을 회색(비활성) 처리하여 자동생성임을 시각적으로 표현
✅ 신규 등록 시 placeholder: "저장 시 자동 생성" 또는 빈 값
✅ 저장 후 API 응답에서 lot_no를 받아 화면에 표시
❌ 프론트의 generateLotNo() 함수 호출 제거 (또는 미사용 처리)
```
### API 동작
```
POST /api/v1/receivings (신규 등록)
→ lot_no 미전송 시 API가 채번규칙 기반 자동 생성
→ 응답: { "data": { "lot_no": "260317-01", ... } }
PUT /api/v1/receivings/{id} (수정)
→ lot_no 변경 불가 (프론트에서 전송하지 않음)
POST /api/v1/receivings/{id}/process (입고처리)
→ lot_no 미전송 시 API가 자동 생성
→ 응답에 최종 lot_no 포함
```
### 채번 형식
```
YYMMDD-NN (일별 시퀀스, 01부터 시작)
예: 260317-01, 260317-02, ...
260318-01 (다음날 리셋)
```
> 채번 형식은 MNG 채번규칙 관리에서 테넌트별로 변경 가능. 프론트는 형식에 의존하지 않고 API 응답값을 그대로 표시하면 된다.
---
## 참고
- API 변경 커밋: `feat: [receiving] 원자재로트번호 채번규칙 연동`
- 채번규칙 문서: `docs/rules/numbering-rules.md`