sam-hotfix/testcase/TC_ATTENDANCE_MANAGEMENT.md

TC - 근태관리 (Attendance Management)

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

---

⚠️ 테스트 환경 안내

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

테스트 실행 지침

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

2. 데이터 생성 테스트: 근태 등록(D-020D-026), 사유 등록(R-030R-035) 테스트 시 실제 데이터를 생성하여 기능 검증을 수행합니다.

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/attendance-management 정상 로딩, 테이블 표시
L-002	기본	대시보드 카드 표시	"미출근", "정시 출근", "지각", "휴가" 4개 카드
L-003	기본	빈 목록	데이터 없을 때 빈 상태 메시지 표시
L-004	기본	GPS 위치 정보 모킹	Geolocation API 모킹 성공

1.2 테이블 컬럼

TC#	구분	테스트 항목	기대 결과
L-010	기본	컬럼 구성	번호, 부서, 직책, 이름, 직급, 기준일, 출근, 퇴근, 휴게, 연장근무, 사유
L-011	UI	시간 포맷	HH:MM 형식 표시
L-012	UI	사유 표시	출장/휴가/외근/연장근무 텍스트 표시

1.3 기간 필터 (빠른 선택)

TC#	구분	테스트 항목	기대 결과
L-020	기능	당해년도 버튼	해당 년도 데이터 필터링
L-021	기능	전전월 버튼	전전월 데이터 필터링
L-022	기능	전월 버튼	전월 데이터 필터링
L-023	기능	당월 버튼	당월 데이터 필터링
L-024	기능	어제 버튼	어제 데이터 필터링
L-025	기능	오늘 버튼	오늘 데이터 필터링
L-026	UI	활성 버튼 표시	선택된 버튼 강조 표시

1.4 날짜 입력 필터

TC#	구분	테스트 항목	기대 결과
L-030	기능	시작일 입력	날짜 선택 가능
L-031	기능	종료일 입력	날짜 선택 가능
L-032	기능	날짜 필터 적용	선택한 기간 내 데이터만 필터링

1.5 상태 탭 필터

TC#	구분	테스트 항목	기대 결과
L-040	기능	전체 탭	모든 근태 데이터 표시
L-041	기능	미출근 탭	미출근 상태만 필터링
L-042	기능	정시 출근 탭	정시 출근 상태만 필터링
L-043	기능	지각 탭	지각 상태만 필터링
L-044	기능	결근 탭	결근 상태만 필터링
L-045	기능	휴가 탭	휴가 상태만 필터링
L-046	기능	출장 탭	출장 상태만 필터링
L-047	기능	외근 탭	외근 상태만 필터링
L-048	기능	연장근무 탭	연장근무 상태만 필터링

1.6 검색

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

---

2. 근태 등록 모달

2.1 모달 열기

TC#	구분	테스트 항목	기대 결과
D-001	기능	근태 등록 버튼 클릭	"근태 정보" 모달 열림
D-002	기본	모달 제목	"근태 정보" 표시

2.2 모달 필드

TC#	구분	테스트 항목	기대 결과
D-010	기본	대상 필드	콤보박스, 사원 목록 표시
D-011	기본	기준일 필드	날짜 선택, 기본값 오늘
D-012	기본	출근 시간 필드	시간 선택, 기본값 9:00
D-013	기본	퇴근 시간 필드	시간 선택, 기본값 18:00
D-014	기본	야간 연장 시간 필드	시간 선택, 기본값 0:00
D-015	기본	주말 연장 시간 필드	시간 선택, 기본값 0:00

2.3 근태 등록 실행

TC#	구분	테스트 항목	기대 결과
D-020	기능	대상 선택	사원 선택 가능
D-021	기능	출근 시간 변경	시간 입력/선택 가능
D-022	기능	퇴근 시간 변경	시간 입력/선택 가능
D-023	기능	저장 버튼 클릭	근태 등록 처리
D-024	비즈	⚠️ 등록 성공	성공 토스트 + 모달 닫힘
D-025	비즈	⚠️ 데이터 반영	목록에서 등록된 근태 확인
D-026	API	POST /api/v1/attendances	근태 등록 API 호출

2.4 취소/닫기

TC#	구분	테스트 항목	기대 결과
D-030	기능	취소 버튼 클릭	모달 닫힘, 데이터 미저장
D-031	기능	ESC 키	모달 닫힘

---

3. 사유 등록 모달

3.1 모달 열기

TC#	구분	테스트 항목	기대 결과
R-001	기능	사유 등록 버튼 클릭	"사유 정보" 모달 열림
R-002	기본	모달 제목	"사유 정보" 표시

3.2 모달 필드

TC#	구분	테스트 항목	기대 결과
R-010	기본	대상 필드	콤보박스, 사원 목록 표시
R-011	기본	기준일 필드	날짜 선택
R-012	기본	유형 필드	드롭다운, 사유 유형 목록

3.3 사유 유형 옵션

TC#	구분	테스트 항목	기대 결과
R-020	기능	유형 드롭다운 열기	옵션 목록 표시
R-021	기능	출장신청서 선택	출장신청서 선택 가능
R-022	기능	휴가신청서 선택	휴가신청서 선택 가능
R-023	기능	외근신청서 선택	외근신청서 선택 가능
R-024	기능	연장근무신청서 선택	연장근무신청서 선택 가능

3.4 사유 등록 실행

TC#	구분	테스트 항목	기대 결과
R-030	기능	대상 선택	사원 선택 가능
R-031	기능	유형 선택	사유 유형 선택 가능
R-032	기능	등록 버튼 클릭	사유 등록 처리
R-033	비즈	⚠️ 등록 성공	성공 토스트 + 모달 닫힘
R-034	비즈	⚠️ 데이터 반영	목록 사유 컬럼에 등록된 사유 표시
R-035	API	POST /api/v1/attendance-reasons	사유 등록 API 호출

---

4. 엑셀 다운로드

TC#	구분	테스트 항목	기대 결과
E-001	기능	엑셀 다운로드 버튼 존재	버튼 표시 확인
E-002	기능	다운로드 실행	Network API 호출 + 실제 파일 다운로드
E-003	API	GET /api/v1/attendances/export	엑셀 다운로드 API 호출

---

5. API 응답 검증

TC#	구분	테스트 항목	기대 결과
A-001	API	GET /api/v1/attendances 응답	페이지네이션 포함 목록 반환
A-002	API	POST /api/v1/attendances 응답	근태 등록 성공 응답
A-003	API	POST /api/v1/attendance-reasons 응답	사유 등록 성공 응답
A-004	API	GET /api/v1/attendances/export 응답	엑셀 파일 다운로드

---

TC 요약

카테고리	건수
목록 페이지	38건
근태 등록 모달	18건
사유 등록 모달	18건
엑셀 다운로드	3건
API 응답 검증	4건
합계	81건