sam-hotfix/testcase/TC_ORDER_MANAGEMENT.md

TC - 수주관리 (Order Management)

페이지: https://dev.codebridge-x.com/sales/order 작성일: 2026-01-29 대상: QC Playwright AI 테스트용

---

⚠️ 테스트 환경 안내

항목	내용
환경 유형	개발/테스트 환경 (Development Environment)
운영 환경 여부	❌ 아니오 - 운영 환경이 아닙니다
데이터 특성	테스트용 시드 데이터 및 개발 중 생성된 샘플 데이터
테스트 정책	CRUD 전체 테스트 가능 (생성, 수정, 삭제 포함)

테스트 실행 지침

1. CRUD 테스트 허용: 이 환경은 개발/테스트 목적으로, 데이터 생성·수정·삭제를 포함한 전체 기능 테스트를 수행해야 합니다.

2. 데이터 생성 테스트: 수주 등록(D-020~D-033) 테스트 시 실제 데이터를 생성하여 기능 검증을 수행합니다.

3. 데이터 삭제 테스트: 삭제 테스트(D-120~D-124)는 테스트 중 생성한 데이터를 대상으로 실행합니다.

---

0. 사이드바 메뉴 탐색 (공통 전제 조건)

0.1 메뉴 펼치기

TC#	구분	테스트 항목	기대 결과
NAV-001	전제	사이드바 최상단 스크롤	사이드바가 최상단으로 스크롤
NAV-002	전제	"모두 펼치기" 버튼 클릭	사이드바의 모든 메뉴가 펼쳐짐
NAV-003	전제	메뉴 펼침 대기	2초 대기 후 모든 메뉴 펼침 완료
NAV-004	기능	1차 메뉴 찾기	스크롤 없이 1차 메뉴(판매관리) 클릭 가능
NAV-005	기능	2차 메뉴 클릭	펼쳐진 서브메뉴에서 수주관리 클릭
NAV-006	기능	페이지 로드 확인	404 없이 정상 페이지 로드

💡 참고: "모두 펼치기" 버튼으로 전체 메뉴를 펼친 후 메뉴를 탐색하면 1차 메뉴를 누르지 못해 찾지 못하는 문제를 방지할 수 있습니다.

---

1. 목록 페이지 (List View)

1.1 페이지 로딩

TC#	구분	테스트 항목	기대 결과
L-001	기본	페이지 접근	/sales/order-management-sales 정상 로딩, 테이블 표시
L-002	기본	통계 카드 표시	"이번 달 수주", "분할 대기", "생산지시 대기", "출하 대기" 4개 카드
L-003	기본	기본 정렬	최신순(등록일 내림차순) 정렬
L-004	기본	빈 목록	데이터 없을 때 빈 상태 메시지 표시

1.2 테이블 컬럼

TC#	구분	테스트 항목	기대 결과
L-010	기본	컬럼 구성	번호, 로트번호, 견적번호, 발주처, 현장명, 상태, 출고예정일, 배송방식
L-011	UI	상태 뱃지 색상	수주등록=파랑, 수주확정=초록, 생산지시완료=보라, 미수=빨강
L-012	UI	배송방식 표시	택배/상차/직배송 텍스트 표시

1.3 상태 탭 필터

TC#	구분	테스트 항목	기대 결과
L-020	기능	전체 탭	모든 수주 표시
L-021	기능	수주등록 탭	수주등록 상태만 필터링
L-022	기능	수주확정 탭	수주확정 상태만 필터링
L-023	기능	생산지시완료 탭	생산지시완료 상태만 필터링
L-024	기능	미수 탭	미수 상태만 필터링
L-025	경계	탭 전환 후 카운트	필터 결과 건수와 탭 배지 숫자 일치

1.4 검색

TC#	구분	테스트 항목	기대 결과
L-030	기능	로트번호 검색	로트번호 입력 시 해당 수주만 필터링
L-031	기능	발주처 검색	발주처명 입력 시 해당 수주만 필터링
L-032	기능	현장명 검색	현장명 입력 시 해당 수주만 필터링
L-033	기능	검색어 지우기	검색어 삭제 시 전체 목록 복원
L-034	경계	존재하지 않는 검색어	빈 결과 + "검색 결과 없음" 메시지

1.5 뷰 모드

TC#	구분	테스트 항목	기대 결과
L-040	기능	테이블 뷰	테이블 형태로 목록 표시
L-041	기능	카드 뷰	카드 형태로 목록 표시
L-042	기능	뷰 모드 전환	테이블↔카드 전환 시 데이터 유지

1.6 행 동작

TC#	구분	테스트 항목	기대 결과
L-050	기능	행 클릭	수주 상세 모달/페이지 열림
L-051	기능	수주 등록 버튼	클릭 시 등록 모달/페이지 열림

---

2. 등록/수정 페이지

2.1 수주 등록

TC#	구분	테스트 항목	기대 결과
D-001	기본	등록 폼 로딩	빈 폼 표시, 저장/취소 버튼
D-002	기본	필수 필드 표시	발주처, 현장명, 출고예정일 필수 표시 (*)

2.1.1 필수값 검증

TC#	구분	테스트 항목	기대 결과
D-010	검증	발주처 미선택	저장 시 필수값 에러 메시지
D-011	검증	현장명 미입력	저장 시 필수값 에러 메시지
D-012	검증	출고예정일 미선택	저장 시 필수값 에러 메시지

2.1.2 폼 입력

TC#	구분	테스트 항목	기대 결과
D-020	기능	발주처 선택	거래처 목록 콤보박스에서 선택
D-021	기능	현장명 입력	텍스트 입력 가능
D-022	기능	출고예정일 선택	날짜 선택 캘린더 동작
D-023	기능	배송방식 선택	택배/상차/직배송 드롭다운 선택
D-024	기능	비고 입력	텍스트 입력 가능

2.1.3 저장 동작

TC#	구분	테스트 항목	기대 결과
D-030	기능	정상 저장	성공 토스트 + 목록 페이지 이동
D-031	기능	저장 후 로트번호	자동 생성된 로트번호 확인
D-032	기능	취소 버튼	목록 페이지로 복귀, 데이터 미저장
D-033	비즈	⚠️ 등록 데이터 반영	목록에서 등록된 수주 확인 (토스트만 확인 불가)

2.2 수주 상세/수정

TC#	구분	테스트 항목	기대 결과
D-100	기본	상세 페이지 로딩	수주 상세 정보 표시
D-101	기본	수정/삭제 버튼	상단에 수정/삭제 버튼 표시
D-102	기능	수정 버튼 클릭	수정 모드 전환
D-103	기능	수정 저장	변경사항 저장 + 성공 토스트
D-104	비즈	⚠️ 수정 데이터 반영	목록에서 수정 내용 확인 (토스트만 확인 불가)

2.3 수주 상태 변경

TC#	구분	테스트 항목	기대 결과
D-110	비즈	수주확정 버튼	수주등록 → 수주확정 상태 변경
D-111	비즈	생산지시 버튼	수주확정 → 생산지시 상태 변경
D-112	비즈	상태 변경 조건	이전 상태 완료 후에만 다음 상태 전환 가능

2.4 수주 삭제

TC#	구분	테스트 항목	기대 결과
D-120	기능	삭제 버튼	삭제 확인 다이얼로그 표시
D-121	기능	삭제 확인	수주 삭제 + 목록 이동
D-122	기능	삭제 취소	아무 변경 없음
D-123	비즈	생산지시 후 삭제	생산지시 진행 중이면 삭제 불가
D-124	비즈	⚠️ 삭제 데이터 반영	목록에서 삭제된 수주 없음 확인

---

3. API 응답 검증

TC#	구분	테스트 항목	기대 결과
A-001	API	GET /sales/order 응답	페이지네이션 포함 목록 반환
A-002	API	POST /sales/order 응답	로트번호 자동 생성, success: true
A-003	API	PUT /sales/order/{id} 응답	수정 성공 응답
A-004	API	DELETE /sales/order/{id} 응답	삭제 성공 응답

---

TC 요약

카테고리	건수
목록 페이지	25건
등록/수정 페이지	30건
API 응답 검증	4건
합계	59건