sam-hotfix/testcase/TC_SALARY_MANAGEMENT.md

TC - 급여관리 (Salary Management)

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

---

⚠️ 테스트 환경 안내

항목	내용
환경 유형	개발/테스트 환경 (Development Environment)
운영 환경 여부	❌ 아니오 - 운영 환경이 아닙니다
데이터 특성	테스트용 시드 데이터 및 개발 중 생성된 샘플 데이터
테스트 정책	조회 및 상태 변경 테스트 가능

테스트 실행 지침

1. 조회 테스트: 목록, 검색, 필터, 정렬 기능 테스트 수행

2. 상태 변경 테스트: 지급완료/지급예정 상태 변경 테스트 시 기존 데이터 상태를 원복

3. 급여 수정 테스트: 급여 수정 시 테스트 데이터만 대상으로 하며, 원본 데이터 보존

---

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	기본	페이지 접근	/hr/salary-management 정상 로딩, 테이블 표시
L-002	기본	대시보드 카드 표시	"총 실지급액", "총 기본급", "총 수당", "초과근무", "상여", "총 공제" 6개 카드
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	경계	날짜 필터 후 카운트	필터링된 데이터 건수 표시

1.4 검색

TC#	구분	테스트 항목	기대 결과
L-030	기능	이름 검색	이름 입력 시 해당 직원만 필터링
L-031	기능	부서 검색	부서명 입력 시 해당 부서만 필터링
L-032	기능	검색어 지우기	검색어 삭제 시 전체 목록 복원
L-033	경계	존재하지 않는 검색어	빈 결과 + "검색 결과 없음" 메시지
L-034	UI	검색 플레이스홀더	"이름, 부서 검색..." 표시

1.5 정렬

TC#	구분	테스트 항목	기대 결과
L-040	기능	정렬 드롭다운 열기	정렬 옵션 목록 표시
L-041	기능	직급순 정렬	직급 기준 정렬
L-042	기능	이름순 정렬	이름 기준 정렬
L-043	기능	부서순 정렬	부서 기준 정렬
L-044	기능	지급일순 정렬	지급일 기준 정렬
L-045	기능	지급액순 정렬	실지급액 기준 정렬

1.6 체크박스 선택

TC#	구분	테스트 항목	기대 결과
L-050	기능	개별 체크박스 선택	해당 행 선택, 지급완료/지급예정 버튼 표시
L-051	기능	전체 선택	모든 행 체크박스 선택
L-052	기능	전체 해제	모든 행 체크박스 해제

---

2. 상태 변경 기능

2.1 지급완료 처리

TC#	구분	테스트 항목	기대 결과
D-001	기능	지급완료 버튼 클릭	선택된 항목 상태 변경
D-002	비즈	지급완료 처리 성공	성공 토스트 + 상태 뱃지 변경
D-003	경계	미선택 시 지급완료	버튼 비활성화 또는 경고 메시지

2.2 지급예정 처리

TC#	구분	테스트 항목	기대 결과
D-010	기능	지급예정 버튼 클릭	선택된 항목 상태 변경
D-011	비즈	지급예정 처리 성공	성공 토스트 + 상태 뱃지 변경

---

3. 급여 상세 다이얼로그

3.1 모달 열기

TC#	구분	테스트 항목	기대 결과
D-020	기능	수정 버튼 클릭	급여 상세 다이얼로그 열림
D-021	기본	모달 필드 표시	기본급, 수당, 초과근무, 상여, 공제, 실지급액 표시

3.2 급여 수정

TC#	구분	테스트 항목	기대 결과
D-030	기능	기본급 수정	금액 입력 가능
D-031	기능	수당 수정	금액 입력 가능
D-032	기능	초과근무 수정	금액 입력 가능
D-033	기능	상여 수정	금액 입력 가능
D-034	기능	공제 수정	금액 입력 가능
D-035	계산	실지급액 자동 계산	기본급 + 수당 + 초과근무 + 상여 - 공제

3.3 저장/닫기

TC#	구분	테스트 항목	기대 결과
D-040	기능	저장 버튼 클릭	수정 내용 저장 + 성공 토스트
D-041	비즈	⚠️ 저장 데이터 반영	목록에서 수정된 금액 확인
D-042	기능	취소/ESC 클릭	모달 닫힘, 변경사항 미저장

---

4. 엑셀 다운로드

TC#	구분	테스트 항목	기대 결과
E-001	기능	엑셀 다운로드 버튼	버튼 존재 확인
E-002	기능	다운로드 실행	Network API 호출 + 실제 파일 다운로드
E-003	검증	⚠️ 파일 검증	.xlsx 또는 .xls 파일 다운로드 완료

---

5. API 응답 검증

TC#	구분	테스트 항목	기대 결과
A-001	API	GET /api/v1/salaries 응답	페이지네이션 포함 목록 반환
A-002	API	PUT /api/v1/salaries/bulk-status 응답	상태 변경 성공 응답
A-003	API	PUT /api/v1/salaries/{id} 응답	급여 수정 성공 응답
A-004	API	GET /api/export/salaries 응답	엑셀 파일 다운로드

---

TC 요약

카테고리	건수
목록 페이지	34건
상태 변경	6건
급여 상세 다이얼로그	12건
엑셀 다운로드	3건
API 응답 검증	4건
합계	59건