superport_v2/doc/frontend_auto_numbering_update.md

입출고·결재 번호 자동 부여 대응 가이드

프런트엔드 변경 시 유의해야 할 내용을 정리했습니다. 모든 일정은 백엔드 배포(문서 버전 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 채널로 공유 바랍니다.