번호 자동 부여 대응 및 API 공통 처리 보강

doc/frontend_auto_numbering_update.md

@@ -0,0 +1,34 @@
+# 입출고·결재 번호 자동 부여 대응 가이드
+
+프런트엔드 변경 시 유의해야 할 내용을 정리했습니다. 모든 일정은 백엔드 배포(문서 버전 v4) 이후 적용을 권장합니다.
+
+## 주요 변경 요약
+- 서버가 `transaction_no`와 `approval_no`를 자동 생성합니다. 포맷은 `TRX-YYYYMMDDNNNN`, `APP-YYYYMMDDNNNN`이며 일자별 4자리 시퀀스를 사용합니다.
+- 생성 요청 본문에서 두 필드를 제거해야 합니다. 백엔드가 값을 무시하므로 전송 시 불필요한 필드 오류가 날 수 있습니다.
+- 생성 응답(`POST /stock-transactions`, `POST /approvals`)에 포함된 번호를 UI에 표기하거나 후속 액션에 사용해야 합니다.
+
+## 작업 항목
+1. **트랜잭션 생성 화면**
+   - 번호 입력 필드 제거 및 레이아웃 정리.
+   - 생성 직후 응답(`data.transaction_no`)을 받아 상세 화면/알림에 표기.
+2. **결재 생성/상신 화면**
+   - `approval.approval_no` 필드 제거.
+   - 응답(`data.approval.approval_no`)을 활용해 결재 상세 링크/알림 업데이트.
+3. **API 클라이언트 수정**
+   - 공유 DTO/타입스크립트 인터페이스에서 `transaction_no`, `approval_no`를 삭제.
+   - E2E/단위 테스트에서 하드코딩된 번호 값 삭제 및 응답 값 기반 검증으로 변경.
+4. **리스트/검색 기능**
+   - 표시 포맷이 바뀌었는지 확인하고 필요 시 날짜·시퀀스 분리 표시 적용.
+
+## 검증 체크리스트
+- [ ] 트랜잭션 생성 요청 payload에 `transaction_no`가 포함되지 않는다.
+- [ ] 결재 생성 요청 payload에 `approval_no`가 포함되지 않는다.
+- [ ] 생성 이후 상세 페이지/알림에 새 번호가 반영된다.
+- [ ] 기존 북마크/딥링크가 새 번호 포맷(`-` 포함 13자리)과 호환되는지 확인한다.
+- [ ] QA 환경에서 동일 일자 다건 생성 시 번호가 0001, 0002… 순으로 증가하는지 확인한다.
+
+## 참고 문서
+- `stock_approval_system_api_v4.md` 4.1, 5.1 섹션(요청 본문 변경 사항)
+- `stock_approval_system_spec_v4.md` 3.14, 3.19 테이블(번호 관리 규칙)
+
+문의 사항은 #inventory-backend 채널로 공유 바랍니다.