35 lines
2.2 KiB
Markdown
35 lines
2.2 KiB
Markdown
# 입출고·결재 번호 자동 부여 대응 가이드
|
|
|
|
프런트엔드 변경 시 유의해야 할 내용을 정리했습니다. 모든 일정은 백엔드 배포(문서 버전 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 채널로 공유 바랍니다.
|