/SimpleHR project
ログイン
SimpleHR project

E2E 테스트 시나리오 명세

概念編集: Cairni · 방금 · AI 生成v6

개요

26년 07월 09일 수정사항에서 docs/e2e-test-scenarios.md 파일로의 기능별 테스트 항목 문서화 작업이 진행 중(🟡 In Progress)으로 지정되었다. 사이드바 탭 단위로 테스트 흐름을 정의하며, 아래 고정 계정을 기준으로 시나리오를 작성한다. fix-task-0709

기본 전제: 기업 사용자는 모바일 중점, 기업 관리자는 PC 중점으로 테스트 환경을 구분한다. fix-task-0709 fix-task-0715 수정사항

고정 테스트 계정

역할계정
업체디비안츠
최고관리자허빈
직원김소민

진행 현황

E2E 테스트 문서화 진행 현황AI · 출처 클릭
완료7
1. 대시보드
fix-task-0709
2. 근태관리 — 출퇴근관리
fix-task-0709
2. 근태관리 — 연장근로
fix-task-0709
2. 근태관리 — 휴가지급
fix-task-0709
2. 근태관리 — 교대근로
fix-task-0709
2. 근태관리 — 근태결재
fix-task-0709
2. 근태관리 — 근태분석
fix-task-0709
진행중5
3. 직원관리
26년 07월 21일 수정사항
4. 급여관리
26년 07월 21일 수정사항
5. 정책관리
26년 07월 21일 수정사항
6. 조직관리
26년 07월 21일 수정사항
7. 설정 등 기타
26년 07월 21일 수정사항

사이드바 탭별 테스트 흐름 구조

아래 다이어그램은 테스트 대분류의 완료/잔여 분류를 시각화한다.

완료된 테스트 영역 상세

1. 대시보드

전체 시나리오 원문: E2E 테스트 시나리오 - Part 1 관리자 (대시보드, 근태, 직원관리) E2E 테스트 시나리오 - Part 1 관리자 (대시보드, 근태, 직원관리)

1-1. 지금 우리 회사 통계

#시나리오기대 결과
1허빈이 로그인하여 대시보드에 진입한다관리 범위 배지, 오늘 출근률(%), 전체 인원(N명), 7색 막대 표시
2김소민이 출근 체크 후 허빈이 대시보드 진입7색 막대의 "정상출근" 수 반영
3허빈이 7색 막대에서 "지각" 영역 클릭출퇴근관리 페이지로 이동, 지각 상태 필터 목록 표시

1-2. 초기설정 가이드

초기 설정 가이드 구조 개편 스펙 (6→8단계) 참고.

#시나리오기대 결과
1신규 기업 허빈이 처음 로그인초기설정 가이드 8단계 표시, 진행률 0%
2"회사 기본정보 등록" > "설정하기" 클릭설정 페이지 이동, 상단 안내 배지 표시
3회사 기본정보 모두 입력 후 저장안내 배지 사라지고, 해당 단계 완료 표시(체크+취소선)
4~10각 단계(회계/급여 정책, 근로 정책, 직위/직책/직무, 근무지, 부서 등록, 직원 등록, 관리자 등록) 완료각 단계 완료 표시, 진행률 갱신
118단계 모두 완료제목 "초기 설정 완료!"로 변경, 아이콘 및 완료 메시지 표시. 가이드는 사라지지 않음
12"나중에 하기" 클릭가이드 최소화, 진행률 바만 표시
13최소화된 가이드 클릭가이드 다시 펼쳐짐
14"가이드 숨기기" 클릭가이드 사라지고, 새로고침 버튼 옆에 "설정 가이드" 버튼 출현
15"설정 가이드" 버튼 클릭가이드 다시 표시

1-3. 결재 대기 큐

#시나리오기대 결과
1김소민이 연장근로 신청 후 허빈이 대시보드 진입큐에 이름/소속/근로일/근로시간/연장시간 표시
2허빈이 큐에서 "승인" 클릭승인 처리, 큐에서 사라짐
3허빈이 큐에서 "반려" 클릭반려 처리, 큐에서 사라짐
4결재 대기 건 없는 상태"결재 대기 중인 항목이 없습니다" 메시지 표시
  • 관리자 및 직원 대시보드 진입 확인
  • 주요 지표 정상 렌더링 여부
  • 7색 막대 "정상출근" 카운트 반영 검증 E2E 테스트 시나리오 - Part 3. 관리자↔사용자 연계 시나리오
  • 결재 대기 큐(연장근로·휴가 신청 등) 표시 검증 E2E 테스트 시나리오 - Part 3. 관리자↔사용자 연계 시나리오

2. 근태관리

하위 탭주요 검증 포인트관련 스펙
출퇴근관리출퇴근 체크, GPS 위치 기반 기록, 미출근·지각 상태 반영, 관리자 수정(출근시각/퇴근시각/휴게/상태/사유), 정책시간 자동인정gps-attendance-spec
연장근로연장근로 신청 및 승인 흐름, 관리자 직접 등록(소속/근로유형/대상자/근로일/근로시간/사유), 신청 내역 조회attendance-management-spec
휴가지급휴가 지급 처리, 잔액 반영, 연차 조정, 신청 승인/반려, 변동 이력, 부서별 일괄 지급, 연차촉진leave-management-spec
교대근로교대 일정 등록 및 근태 반영, 변형근로 자동 배정 및 세트 설정shift-work-management-spec
근태결재결재 목록 조회, 승인/반려 처리, 상세 내용 조회approval-management-spec
근태분석통계 데이터 정합성 확인 (종합/부서분석/개인성과/지각분석/준법리포트)attendance-management-spec

관리자↔사용자 연계 시나리오 상세 (Part 3)

Part 3 전체 시나리오는 E2E 테스트 시나리오 - Part 3. 관리자↔사용자 연계 시나리오에 정의되어 있다. 허빈(관리자)과 김소민(직원)이 교차하는 핵심 업무 흐름 8개 영역을 포함한다. E2E 테스트 시나리오 - Part 3. 관리자↔사용자 연계 시나리오

영역주요 흐름 요약관련 스펙
1. 직원 등록 → 계약서 서명 → 첫 출근직원 등록 → 계약서 DRAFT/PENDING_SIGN/PENDING_APPROVAL/ACTIVE 상태 전이, 게이트 차단/해제, GPS 첫 출근근로계약서 스펙, GPS 출퇴근 스펙
2. 출퇴근 — 근로정책 → 출퇴근 → 관리자 확인GPS 반경 내외 출근, 지각 판정(ATT_LATE), 출퇴근 요청(CheckinRequest), 휴일 출근(OT_HOLIDAY 사전 승인), 근로정책 미래 적용일 및 과거 데이터 보호GPS 출퇴근 스펙, 근무 정책 스펙, 휴일 관리 스펙
3. 연장근로 — 신청 → 결재 → 근태 반영4단계 위저드 신청, PENDING/APPROVED/REJECTED 전이, AttendanceRecord 인정시간 동기화, 52시간 초과 차단(OT_52H_EXCEEDED)근태 관리 스펙
4. 휴가 — 신청 → 결재 → 잔여일수 변동연차 신청·승인 시 LeaveBalance 차감, 반려 시 차감 없음, 취소 시 잔여일수 복원(LeaveBalanceHistory RESTORE)휴가 관리 스펙, 휴가 잔액 변동 이력 스펙
5. 급여 — 정산 → 명세서 발행 → 직원 확인PAY_DRAFT→PAY_CONFIRMED→PAY_ISSUED 상태 전이, 직원 조회·서명(AuditSignature), 이의제기(PayslipObjection)급여관리 스펙
6. 기안서/서류 — 제출 → 결재 → 결과 확인양식 선택·기안서 DRAFT→PENDING→APPROVED/REJECTED, 반려 후 재제출(version 증가), 회수(RECALLED), 보완 요청(DRAFT 복귀)결재 관리 스펙, 양식 편집기(폼 빌더) 스펙
7. 공지사항 — 등록 → 직원 확인관리자 공지 등록 → 직원 목록·상세 조회—
8. 퇴직 — 사직서 → 결재 → 퇴직 처리 → 로그인 차단직원 직접 제출 경로·관리자 직접 처리 경로·사직서 반려, EMP_RETIRED/RESIGNED 상태 전환, 세션 무효화사직서 처리 워크플로 스펙, 직원 재직 상태 변경 워크플로

잔여 테스트 대분류 (미완료)

3. 직원관리

전체 시나리오 원문(3-1~3-23): E2E 테스트 시나리오 - Part 1 관리자 (대시보드, 근태, 직원관리) E2E 테스트 시나리오 - Part 1 관리자 (대시보드, 근태, 직원관리)

  • 인사관리(3-1~3-7): 직원 목록 조회(필터: 재직상태/계약형태/부서), 직원 상세 조회·수정(근로정책 변경, 프로필 사진), 필수서류, 근로계약서 관리, 메시지/비밀번호 관리, 신규 직원 등록(단건/일괄), 근로계약서 서명 게이트(hard/soft gate) → 직원 등록 플로우, 근로계약서 스펙 참고
  • 인사발령(3-8): 부서이동/승진/승급 발령, 결재선 승인/반려 흐름 → 인사발령 결재선 스펙 참고
  • 사직처리(3-9): 퇴직 등록(Document 기반 결재), 사직서 승인, 로그인 차단 → 사직서 처리 워크플로 스펙 참고
  • 근로계약서 및 직원서류보관함(3-10~3-14): 계약서 목록/상세/수정/작성, 직원서류보관함 현황 조회/상세 관리
  • 서류결재(3-15~3-19): 결재 목록 조회(기안서/신청서/필수서류/사직), 기안서/필수서류 승인/반려, 신청서 발급/승인, 사직서 승인, 결재선 흐름(차례/비차례/결재선 없음) → 결재 관리 스펙 참고
  • 관리자 관리(3-20~3-23): 관리자 목록/등록/해제/상세/권한수정, 유형 관리(등급 생성/수정, 권한 조직 설정) → 관리자 등급 및 권한 관리 스펙 참고
  • 계약형태 변경(계약직 ↔ 정규직) 포함
  • 사직서 기안(직원 직접 제출) 및 관리자 직접 퇴직 처리 경로, 퇴직 후 로그인 차단 검증 E2E 테스트 시나리오 - Part 3. 관리자↔사용자 연계 시나리오

4. 급여관리

5. 정책관리

  • 근로정책 수정 및 적용시점 반영 검증 → 근무 정책 스펙 참고
  • 휴일 지정 후 근태 자동 반영 → 휴일 관리 스펙 참고
  • 근로정책 수정 시 적용 시점(당일 차단 → 미래 날짜 선택) 및 과거 데이터 불변 검증 포함 E2E 테스트 시나리오 - Part 3. 관리자↔사용자 연계 시나리오

6. 조직관리

7. 설정 등

07월 09일 완료 작업과의 연계

07월 15일 완료 작업과의 연계

07월 21일 완료 작업과의 연계

07월 22일 완료 작업과의 연계

26년 07월 21일 수정사항에서 E2E 테스트에 영향을 주는 주요 완료 항목은 다음과 같다. 26년 07월 21일 수정사항

완료 항목영향 테스트 영역관련 스펙
온보딩 투어형 전환 — SetupTour.tsx 신규, ?tour=true 진입·스포트라이트+툴팁·순차잠금, 관리자 등록 배너 전환, 단계 9→8설정 — 초기설정 가이드setup-guide-redesign-spec
근로정책 변경 시 인정근무시간 표시 통일 — PC·모바일 백엔드 week_worked_min/week_target_min/recognized_min 사용, 40h·52h 하드코딩 제거, 일자별 정책 버전 해소정책관리 / 근태관리payroll-work-policy-integration
로그인 실패횟수 초기화 버그 수정 (password_service.py → login_fail_count=0)인증·로그인—
관리자 등록이 배포마다 풀리는 버그 수정 — admin_granted_by 보유 시 강등 차단, 수동 등록 표식 보호. ※ 배포 후 이상재 관리자 페이지에서 재등록 필요직원관리 — 관리자 관리admin-role-management-spec

07월 21일 진행중 항목 — 테스트 대기

아래 항목은 아직 미구현 상태이거나 진행 중으로, 구현 완료 후 해당 테스트 영역에 시나리오를 추가해야 한다. 26년 07월 21일 수정사항

잔여 항목영향 테스트 영역관련 스펙
연차촉진 설정값(알림 채널/시기/기한/auto_schedule) 미적용근태관리 — 휴가지급annual-leave-promotion-spec
일정관리 반복 일정 확장(recurrence_type expand 로직) 미구현설정 등—
일정관리 알림 발송(reminder) 미구현설정 등—
근태 엑셀 시간대 분해 8컬럼 미구현 (breakdown·away_minutes 항상 0)근태관리 — 근태분석attendance-management-spec
대체휴무 소비/차감 — 방식 B(관리자 수동 부여)로 확정, 자동 적립 로직 비활성 완료근태관리 — 휴가지급leave-management-spec
페이지네이션 공용 컴포넌트 통일 — 07월 22일 전체 완료(직접구현 19곳 전부 이관)전 영역(UI)—

07월 22일 수정사항(26.07.22 수정사항 (fix-task-0722))에서 E2E 테스트에 영향을 주는 주요 완료 항목은 다음과 같다. 26.07.22 수정사항 (fix-task-0722)

완료 항목영향 테스트 영역관련 스펙
근로정책 ↔ 근로계약서 상호작용 정비 — 정책 변경 시 계약서 불일치 버그 4건 수정, 재발급 안내 badge·토스트 신설정책관리 / 직원관리 — 근로계약서work-contract-spec / work-policy-spec
대체휴무 방식 B(관리자 수동 부여) 확정 — 자동 적립 로직 비활성, COMPENSATORY 일 단위 직접 부여 방식으로 정리근태관리 — 휴가지급leave-management-spec
페이지네이션 공용 <Pagination> 통일 완료 — 직접구현 19곳 전부 이관, unit·showRange prop 추가, 소량 목록도 항상 노출(B안)전 영역(UI)—
documents 완비/미비 탭 × 페이지네이션 불일치 해결 — status 필터 추가로 total·페이지가 활성 탭과 일치직원관리 — 직원서류보관함—
관리자 등록 모달 — 무검색 시 5명 표시, "선택됨" 회색 배지화, 안내 배너 박스 제거직원관리 — 관리자 관리admin-role-management-spec
필터 초기화 전체 리셋(overtime 기간·vacation 연도 포함) + 급여대장 연도 하드코딩 → 현재연도 동적 수정급여관리 / 근태관리payroll-management-spec
관리자 페이지 헤더 미동작 아이콘(onClick 없는 장식) 13곳 제거전 영역(UI)—
단기직 근로유형(SHORT_TERM) 추가 — 휴게시간 기본 OFF, 직원 등록 시 시급 입력으로 전환(salary_system=HOURLY)정책관리 / 직원관리work-policy-spec / employee-registration-flow

07월 22일 진행중·보류 항목 — 테스트 대기

아래 항목은 진행 중이거나 보류 상태로, 구현 완료 후 해당 테스트 영역에 시나리오를 추가해야 한다. 26.07.22 수정사항 (fix-task-0722)

잔여 항목영향 테스트 영역관련 스펙
결재 '전체' 탭 통합 목록(PC 보류) — 모바일 CombinedTab 완료, PC는 '전체' 탭 임시 제거 후 추후 구현결재 — 전체 탭approval-management-spec
모바일 결재 근로유형 영문 노출 → 한글 변환 미구현모바일 / 결재mobile-app-spec
시스템관리자 본인 비밀번호 변경 미작동 (SystemUser 분기 부재, 404 실패)설정 등—
연차촉진 설정값(알림 채널/시기/기한/auto_schedule) 미적용근태관리 — 휴가지급annual-leave-promotion-spec
근태 엑셀 시간대 분해 8컬럼 미구현 (breakdown·away_minutes 항상 0)근태관리 — 근태분석attendance-management-spec
단기직 시급×실근로시간 급여 자동계산 미구현 (현 시스템 월 고정급 중심)급여관리payroll-management-spec
플랫폼 공지 소비자 측 API·화면 미구현 (발행해도 기업 관리자·직원 미노출)설정 등—

07월 15일 수정사항(fix-task-0715 수정사항)에서 E2E 테스트에 영향을 주는 주요 완료 항목은 다음과 같다. fix-task-0715 수정사항

완료 항목영향 테스트 영역관련 스펙
관리자 결재 목록 연장근로 신청 직위 '-' 표시 수정 (OvertimeRequestInfo position_name 추가)근태관리 — 근태결재approval-management-spec
근로정책 work_days OFF 요일 출근 차단 구현 (_resolve_scheduled_for_day() + 주휴일 판정)정책관리 / 출퇴근관리work-policy-spec
근로정책 적용시점 반영 + 이력 덮어쓰기 방지 (신규 EWP INSERT, effective_from/to 기반 활성 판정, 이력 모달)정책관리work-policy-spec
근로계약서 auto_renew vs renewal_method 불일치 수정 (프론트 조건 변경, prod 데이터 보정 1건)직원관리 — 근로계약서employment-contract-spec
도급직 계약 생성 시 auto_renew 기본값 False 통일직원관리 — 근로계약서employment-contract-spec
관리자 등급 변경 정상 동작 확인직원관리 — 관리자 관리admin-role-management-spec
결재선 미선택 시 자동 결재선 적용 안내 텍스트 추가직원관리 — 결재approval-management-spec
계약형태 변경(계약직 ↔ 정규직) 지원직원관리employment-contract-spec

07월 15일 미완료(잔여) 항목 — 테스트 대기

아래 항목은 아직 미구현 상태로, 구현 완료 후 해당 테스트 영역에 시나리오를 추가해야 한다. fix-task-0715 수정사항

잔여 항목영향 테스트 영역관련 스펙
교대/변형근로 수동 배정 시 최소 연속 휴식 시간(min_consecutive_rest_hours) 검증 미구현근태관리 — 교대근로shift-work-management-spec
교대근로 순환 패턴(cycle_pattern) 기반 자동 배정 미구현근태관리 — 교대근로shift-work-management-spec
일정관리 반복 일정 확장(RRULE) 미구현설정 등—
일정관리 알림 발송(reminder) 미구현설정 등—
연차촉진 threshold_days 변경 시 기존 대상자 미정리근태관리 — 휴가지급annual-leave-promotion-spec
연차촉진 설정값(알림 채널/자동 실행/촉진 시기/응답 기한) 미적용근태관리 — 휴가지급annual-leave-promotion-spec
급여기초 간이세액 비율(80/100/120%) 선택 UI 미구현급여관리payroll-management-spec
관리자 설정 별도 권한(인사·급여) 항목 제거설정 등admin-role-management-spec
회사 이미지 등록 후 깨짐 현상(서명 URL 만료 가능성) 확인 필요설정 등—

07월 09일 수정사항(fix-task-0709)에서 E2E 테스트에 영향을 주는 주요 완료 항목은 다음과 같다. 이 항목들은 해당 테스트 대분류의 시나리오에 포함되어야 한다.

완료 항목영향 테스트 영역관련 스펙
기안서·서류 신청 탭 → 서류 신청으로 통합, 양식 셀렉트 추가, form_categories 기반 다중 분류 지원설정 / 결재form-builder-spec
사직서 처리 시 Document(서류 결재) 기반으로 전환, 빈 사직서 안내 메시지 추가, 통합 테스트 4건 추가직원관리 / 결재resignation-workflow
급여-근로정책 연동 개선 (_bulk_load_work_policies())급여관리payroll-work-policy-integration
EWP 단일 소스 전환 backfill 마이그레이션 (289명 일괄 EWP 생성)정책관리 / 직원관리work-policy-spec
모바일 신청 양식 미등록 시 fallback 렌더링 및 "미등록" 표시모바일mobile-app-spec
모바일 결재 상세 영문 변수명 한글화 (출퇴근 필드 라벨, CHECK_IN→출근 등)모바일 / 결재mobile-app-spec

참고

Made with Cairni公開ウィキを見る →