sam-scenarios/vacation-management.json

{
  "id": "vacation-management",
  "name": "휴가관리 테스트",
  "screenshotPolicy": {
    "onErrorOnly": true,
    "captureOn": ["error", "fail", "timeout", "404", "500", "blocked"]
  },
  "description": "휴가 사용현황, 부여현황, 신청현황 탭 기능과 부여등록/휴가신청 다이얼로그를 테스트하는 E2E 테스트",
  "baseUrl": "https://dev.codebridge-x.com",
  "url": "/ko/hr/vacation-management",
  "navigation": {
    "targetUrl": "/hr/vacation-management",
    "urlPattern": "/hr/vacation-management|/ko/hr/vacation-management",
    "menuHints": ["휴가관리", "휴가 관리", "인사관리"]
  },
  "menuNavigation": {
    "level1": "인사관리",
    "level2": "휴가관리",
    "expectedUrl": "/ko/hr/vacation-management",
    "searchWithinParent": true,
    "closeOtherMenus": true
  },
  "menuNavigationEnhanced": {
    "strategy": "scroll-and-search",
    "sidebarSelector": ".sidebar-scroll, [data-sidebar], nav[class*='sidebar']",
    "scrollConfig": {
      "scrollStep": 200,
      "maxScrollAttempts": 10,
      "scrollDelay": 300
    },
    "level1": {
      "text": "인사관리",
      "selectors": [
        "button:has-text('인사관리')",
        "[data-menu='hr']",
        "a:has-text('인사관리')"
      ]
    },
    "level2": {
      "text": "휴가관리",
      "selectors": [
        "a:has-text('휴가관리')",
        "[href*='vacation-management']",
        "button:has-text('휴가관리')"
      ]
    },
    "fallbackUrl": "/ko/hr/vacation-management"
  },
  "timeout": 120000,
  "tags": ["hr", "vacation", "leave", "management"],

  "auth": {
    "username": "TestUser5",
    "password": "password123!"
  },

  "testData": {
    "searchKeyword": "홍",
    "grantData": {
      "vacationType": "annual",
      "grantDays": 3,
      "reason": "E2E 테스트 부여"
    },
    "requestData": {
      "leaveType": "annual",
      "daysRange": 2
    },
    "dateRange": {
      "startDate": "2025-12-01",
      "endDate": "2025-12-31"
    }
  },

  "steps": [
    {
      "id": "step-0",
      "name": "사이드바 메뉴 전체 펼치기",
      "description": "모두 펼치기 버튼을 클릭하여 전체 메뉴를 펼친 후 메뉴 탐색 준비",
      "actions": [
        {
          "type": "evaluate",
          "script": "document.querySelector('.sidebar-scroll')?.scrollTo({top:0,behavior:'instant'})"
        },
        { "type": "wait", "duration": 300 },
        {
          "type": "evaluate",
          "script": "Array.from(document.querySelectorAll('button')).find(b => b.innerText?.includes('모두 펼치기'))?.click()"
        },
        { "type": "wait", "duration": 2000 }
      ],
      "expect": {
        "sidebarReady": true
      }
    },
    {
      "id": "step-1",
      "name": "인사관리 메뉴 진입",
      "description": "인사관리 > 휴가관리 메뉴로 이동 (scrollAndFind 패턴 사용)",
      "navigationPattern": "scrollAndFind",
      "actions": [
        {
          "type": "scrollAndFind",
          "target": "인사관리",
          "container": ".sidebar-scroll, [data-sidebar], nav[class*='sidebar']",
          "scrollStep": 200,
          "maxAttempts": 10
        },
        { "type": "click_if_exists", "target": "인사관리" },
        { "type": "wait", "duration": 300 },
        {
          "type": "scrollAndFind",
          "target": "휴가관리",
          "container": ".sidebar-scroll, [data-sidebar], nav[class*='sidebar']",
          "scrollStep": 200,
          "maxAttempts": 10
        },
        { "type": "click_if_exists", "target": "휴가관리" }
      ],
      "fallback": {
        "type": "navigate",
        "url": "/ko/hr/vacation-management"
      },
      "expect": {
        "url": "/hr/vacation-management",
        "visible": ["휴가관리", "휴가 사용현황"]
      }
    },
    {
      "id": "step-2",
      "name": "필수 검증 #5: 목업 페이지 감지",
      "description": "페이지가 목업인지 실제 동작하는 페이지인지 감지",
      "verify": {
        "mockupDetection": {
          "inputFields": ["검색창", "날짜 필터"],
          "functionalButtons": ["부여등록", "휴가신청", "승인", "거절"],
          "apiCalls": true,
          "dataChangePossible": true
        }
      }
    },
    {
      "id": "step-3",
      "name": "통계 카드 대시보드 확인",
      "description": "휴가 승인 대기, 연차, 경조사, 연간 연차 사용률 카드 표시 확인",
      "verify": {
        "visible": ["휴가 승인 대기", "연차", "경조사", "연간 연차 사용률"],
        "statsCards": true
      }
    },
    {
      "id": "step-4",
      "name": "휴가 사용현황 탭 확인 (기본 탭)",
      "description": "휴가 사용현황 탭의 테이블 컬럼 구조 검증",
      "verify": {
        "activeTab": "휴가 사용현황",
        "tableColumns": ["번호", "부서", "직책", "이름", "직급", "입사일", "기본", "부여", "사용", "잔여"]
      }
    },
    {
      "id": "step-4-1",
      "name": "⚠️ 필수 검증: 날짜 필터 검색",
      "description": "날짜 범위 필터를 설정하고 데이터가 필터링되는지 확인",
      "actions": [
        { "type": "evaluate", "script": "document.querySelectorAll('table tbody tr').length", "description": "필터 전 행 수 확인" },
        { "type": "fill", "target": "input[type='date']:first-of-type, input[placeholder*='시작']", "value": "2025-12-01", "description": "시작일 입력" },
        { "type": "fill", "target": "input[type='date']:last-of-type, input[placeholder*='종료']", "value": "2025-12-31", "description": "종료일 입력" },
        { "type": "wait", "duration": 500, "description": "필터 적용 대기" },
        { "type": "evaluate", "script": "document.querySelectorAll('table tbody tr').length", "description": "필터 후 행 수 확인" }
      ],
      "verify": {
        "dateFilterApplied": true,
        "dataChanged": "필터 적용 후 데이터가 변경되어야 함"
      },
      "note": "날짜 필터가 실제로 데이터를 필터링하는지 확인"
    },
    {
      "id": "step-5",
      "name": "⚠️ 필수 검증: 검색 기능 확인 (사용현황)",
      "description": "검색어 입력 후 테이블 데이터가 필터링되는지 확인",
      "actions": [
        { "type": "evaluate", "script": "document.querySelectorAll('table tbody tr').length", "description": "검색 전 행 수 확인" },
        { "type": "fill", "target": "input[placeholder*='검색'], input[type='search']", "value": "홍", "description": "검색어 입력" },
        { "type": "wait", "duration": 500, "description": "검색 결과 대기" },
        { "type": "evaluate", "script": "document.querySelectorAll('table tbody tr').length", "description": "검색 후 행 수 확인" }
      ],
      "verify": {
        "searchApplied": true,
        "tableContains": "{testData.searchKeyword}",
        "dataFiltered": "검색 결과에 검색어가 포함된 행만 표시"
      },
      "expect": {
        "searchPlaceholder": "이름, 부서 검색..."
      },
      "note": "⚠️ 검색어 입력 후 테이블에 검색어가 포함된 행만 표시되어야 함"
    },
    {
      "id": "step-5-1",
      "name": "검색 결과 데이터 검증",
      "description": "검색 결과의 각 행에 검색어가 포함되어 있는지 확인",
      "verify": {
        "allRowsContain": "{testData.searchKeyword}",
        "verifyMethod": "테이블의 모든 행이 검색어를 포함하는지 확인"
      }
    },
    {
      "id": "step-5-2",
      "name": "검색 초기화 확인",
      "description": "검색어 삭제 후 전체 목록 복원 확인",
      "actions": [
        { "type": "clear", "target": "input[placeholder*='검색'], input[type='search']", "description": "검색어 삭제" },
        { "type": "wait", "duration": 500, "description": "목록 복원 대기" }
      ],
      "verify": {
        "dataRestored": true
      }
    },
    {
      "id": "step-6",
      "name": "휴가 부여현황 탭 전환",
      "description": "휴가 부여현황 탭 클릭 및 테이블 구조 확인",
      "actions": [
        { "type": "click_if_exists", "target": "휴가 부여현황" }
      ],
      "verify": {
        "activeTab": "휴가 부여현황",
        "tableColumns": ["번호", "부서", "직책", "이름", "직급", "유형", "부여일", "부여휴가일수", "사유"],
        "visible": ["부여등록"]
      }
    },
    {
      "id": "step-7",
      "name": "부여등록 다이얼로그 열기",
      "description": "부여등록 버튼 클릭하여 다이얼로그 열기",
      "actions": [
        { "type": "openModal", "target": "부여등록", "description": "휴가 부여 등록 모달 열기" }
      ],
      "modalConfig": {
        "containerSelector": "[role='dialog'], .modal",
        "animationDelay": 300,
        "waitForSelector": "[role='dialog']"
      },
      "expect": {
        "modal": "휴가 부여 등록",
        "visible": ["사원 선택", "휴가 유형", "부여일", "부여 일수", "사유"]
      }
    },
    {
      "id": "step-8",
      "name": "부여등록 다이얼로그 입력 필드 확인",
      "description": "다이얼로그 내 입력 필드들이 정상 동작하는지 확인",
      "actions": [
        { "type": "click_if_exists", "target": "사원 선택", "options": { "waitAfter": 200 } }
      ],
      "verify": {
        "comboboxOptions": true,
        "inputFields": ["사원 선택", "휴가 유형", "부여일", "부여 일수", "사유"]
      }
    },
    {
      "id": "step-9",
      "name": "필수 검증 #4: 부여등록 저장",
      "description": "모달 내 부여등록 실제 등록 수행",
      "actions": [
        { "type": "selectInModal", "target": "사원 선택", "value": "첫번째 사원", "options": { "waitAfter": 200 } },
        { "type": "selectInModal", "target": "휴가 유형", "value": "연차", "options": { "waitAfter": 200 } },
        { "type": "fillInModal", "target": "부여 일수", "value": "3", "options": { "waitAfter": 100 } },
        { "type": "fillInModal", "target": "사유", "value": "E2E 테스트 부여", "options": { "waitAfter": 100 } },
        { "type": "click_if_exists", "target": "등록", "options": { "waitAfter": 500 } }
      ],
      "expect": {
        "urlMaintained": true,
        "noErrorPage": true,
        "modalClosed": true,
        "apiCall": "createLeaveGrant"
      }
    },
    {
      "id": "step-10",
      "name": "부여등록 다이얼로그 취소 테스트",
      "description": "다이얼로그 취소 버튼 동작 확인",
      "actions": [
        { "type": "click_if_exists", "target": "부여등록" },
        { "type": "click_if_exists", "target": "취소" }
      ],
      "expect": {
        "modalClosed": true
      }
    },
    {
      "id": "step-11",
      "name": "휴가 신청현황 탭 전환",
      "description": "휴가 신청현황 탭 클릭 및 테이블 구조 확인",
      "actions": [
        { "type": "click_if_exists", "target": "휴가 신청현황" }
      ],
      "verify": {
        "activeTab": "휴가 신청현황",
        "tableColumns": ["번호", "부서", "직책", "이름", "직급", "휴가기간", "휴가일수", "상태", "신청일"],
        "visible": ["휴가신청"]
      }
    },
    {
      "id": "step-12",
      "name": "휴가신청 다이얼로그 열기",
      "description": "휴가신청 버튼 클릭하여 다이얼로그 열기",
      "actions": [
        { "type": "openModal", "target": "휴가신청", "description": "휴가 신청 모달 열기" }
      ],
      "modalConfig": {
        "containerSelector": "[role='dialog'], .modal",
        "animationDelay": 300,
        "waitForSelector": "[role='dialog']"
      },
      "expect": {
        "modal": "휴가 신청",
        "visible": ["사원 선택", "휴가 유형", "시작일", "종료일"]
      }
    },
    {
      "id": "step-13",
      "name": "휴가신청 다이얼로그 입력 필드 확인",
      "description": "다이얼로그 내 입력 필드들이 정상 동작하는지 확인 (캘린더 포함)",
      "actions": [
        { "type": "click_if_exists", "target": "사원 선택", "options": { "waitAfter": 200 } }
      ],
      "verify": {
        "comboboxOptions": true,
        "inputFields": ["사원 선택", "휴가 유형", "시작일", "종료일"]
      }
    },
    {
      "id": "step-14",
      "name": "필수 검증 #4: 휴가신청 등록",
      "description": "모달 내 휴가신청 실제 등록 수행",
      "actions": [
        { "type": "selectInModal", "target": "사원 선택", "value": "첫번째 사원", "options": { "waitAfter": 200 } },
        { "type": "selectInModal", "target": "휴가 유형", "value": "연차", "options": { "waitAfter": 200 } },
        { "type": "click_if_exists", "target": "시작일 선택", "options": { "waitAfter": 200 } },
        { "type": "click_if_exists", "target": "캘린더 날짜 선택", "options": { "waitAfter": 200 } },
        { "type": "click_if_exists", "target": "종료일 선택", "options": { "waitAfter": 200 } },
        { "type": "click_if_exists", "target": "캘린더 날짜 선택", "options": { "waitAfter": 200 } },
        { "type": "click_if_exists", "target": "신청", "options": { "waitAfter": 500 } }
      ],
      "expect": {
        "urlMaintained": true,
        "noErrorPage": true,
        "modalClosed": true,
        "apiCall": "createLeave"
      }
    },
    {
      "id": "step-15",
      "name": "휴가신청 다이얼로그 취소 테스트",
      "description": "다이얼로그 취소 버튼 동작 확인",
      "actions": [
        { "type": "click_if_exists", "target": "휴가신청" },
        { "type": "click_if_exists", "target": "취소" }
      ],
      "expect": {
        "modalClosed": true
      }
    },
    {
      "id": "step-16",
      "name": "필수 검증 #2: 휴가 승인 버튼 동작",
      "description": "신청현황에서 체크박스 선택 후 승인 버튼 동작 확인",
      "actions": [
        { "type": "click_if_exists", "target": "첫번째 행 체크박스" },
        { "type": "click_if_exists", "target": "승인" }
      ],
      "expect": {
        "modal": "휴가 승인",
        "visible": ["승인하시겠습니까"]
      }
    },
    {
      "id": "step-17",
      "name": "승인 확인 다이얼로그 동작",
      "description": "승인 확인 다이얼로그에서 승인 버튼 클릭",
      "actions": [
        { "type": "click_if_exists", "target": "승인", "context": "dialog" }
      ],
      "expect": {
        "urlMaintained": true,
        "noErrorPage": true,
        "modalClosed": true,
        "apiCall": "approveLeavesMany"
      }
    },
    {
      "id": "step-18",
      "name": "필수 검증 #2: 휴가 거절 버튼 동작",
      "description": "신청현황에서 체크박스 선택 후 거절 버튼 동작 확인",
      "actions": [
        { "type": "click_if_exists", "target": "첫번째 행 체크박스" },
        { "type": "click_if_exists", "target": "거절" }
      ],
      "expect": {
        "modal": "휴가 거절",
        "visible": ["거절하시겠습니까"]
      }
    },
    {
      "id": "step-19",
      "name": "거절 확인 다이얼로그 취소",
      "description": "거절 확인 다이얼로그에서 취소 버튼 클릭",
      "actions": [
        { "type": "click_if_exists", "target": "취소", "context": "dialog" }
      ],
      "expect": {
        "modalClosed": true
      }
    },
    {
      "id": "step-20",
      "name": "필터 및 정렬 셀렉트 동작 확인",
      "description": "필터 및 정렬 셀렉트박스가 정상 동작하는지 확인",
      "actions": [
        { "type": "click_if_exists", "target": "필터 선택 콤보박스" }
      ],
      "verify": {
        "comboboxOptions": ["전체", "대기중", "승인됨", "거절됨"]
      }
    },
    {
      "id": "step-21",
      "name": "날짜 범위 필터 확인",
      "description": "시작일/종료일 날짜 필터 필드 동작 확인",
      "verify": {
        "dateInputs": 2,
        "dateRange": {
          "startDate": "2025-12-01",
          "endDate": "2025-12-31"
        }
      }
    }
  ],

  "assertions": [
    {
      "type": "url",
      "expected": "/hr/vacation-management",
      "message": "휴가관리 페이지에 머물러야 함"
    },
    {
      "type": "tabsExist",
      "expected": ["휴가 사용현황", "휴가 부여현황", "휴가 신청현황"],
      "message": "3개의 탭이 모두 표시되어야 함"
    },
    {
      "type": "tableExists",
      "message": "휴가 목록 테이블이 표시되어야 함"
    }
  ],

  "mandatoryVerifications": {
    "description": "E2E_TEST_CONFIG.md 기준 필수 검증 항목",
    "items": [
      {
        "id": 2,
        "name": "등록/저장 버튼",
        "trigger": "부여등록, 휴가신청, 승인, 거절 버튼",
        "verification": "URL 유지 + 에러 페이지 없음 + 모달 닫힘",
        "failCondition": "404/500 에러 페이지 이동"
      },
      {
        "id": 3,
        "name": "검색/필터",
        "trigger": "검색창, 날짜 필터, 탭 전환",
        "verification": "데이터 변화 확인",
        "failCondition": "필터 적용 후 데이터 무변화"
      },
      {
        "id": 4,
        "name": "모달 등록 완료",
        "trigger": "부여등록/휴가신청 다이얼로그",
        "verification": "실제 등록 동작 + API 호출 확인",
        "failCondition": "열기/닫기만 테스트"
      },
      {
        "id": 5,
        "name": "목업/미완성 페이지 감지",
        "trigger": "페이지 로드 시",
        "verification": "입력 필드 + 동작하는 버튼 + API 호출 확인",
        "failCondition": "버튼만 있고 입력 불가, Console LOG만 출력"
      }
    ]
  },

  "cleanup": {
    "enabled": false,
    "description": "테스트 데이터는 수동 정리 필요"
  },

  "notes": {
    "testScope": "휴가관리 페이지 UI 요소 및 기능 검증",
    "features": {
      "tabs": "휴가 사용현황 / 휴가 부여현황 / 휴가 신청현황",
      "statsCards": "휴가 승인 대기 / 연차 / 경조사 / 연간 연차 사용률",
      "grantDialog": "부여등록 다이얼로그 (사원 선택, 휴가 유형, 부여일, 부여 일수, 사유)",
      "requestDialog": "휴가신청 다이얼로그 (사원 선택, 휴가 유형, 시작일, 종료일, 캘린더)",
      "approveReject": "신청현황 탭에서 승인/거절 버튼",
      "dateFilter": "시작일~종료일 날짜 범위 필터",
      "search": "이름, 부서 검색",
      "filterSort": "필터 및 정렬 셀렉트박스"
    },
    "tableColumns": {
      "usage": ["번호", "부서", "직책", "이름", "직급", "입사일", "기본", "부여", "사용", "잔여"],
      "grant": ["번호", "부서", "직책", "이름", "직급", "유형", "부여일", "부여휴가일수", "사유"],
      "request": ["번호", "부서", "직책", "이름", "직급", "휴가기간", "휴가일수", "상태", "신청일"]
    },
    "dialogs": {
      "grantDialog": {
        "title": "휴가 부여 등록",
        "fields": ["사원 선택", "휴가 유형", "부여일", "부여 일수", "사유"],
        "buttons": ["취소", "등록"]
      },
      "requestDialog": {
        "title": "휴가 신청",
        "fields": ["사원 선택", "휴가 유형", "시작일", "종료일"],
        "buttons": ["취소", "신청"],
        "note": "캘린더 컴포넌트 사용"
      },
      "approveDialog": {
        "title": "휴가 승인",
        "buttons": ["취소", "승인"]
      },
      "rejectDialog": {
        "title": "휴가 거절",
        "buttons": ["취소", "거절"]
      }
    },
    "knownIssues": [
      "엑셀 다운로드 버튼이 주석처리 되어 있음 (미구현)",
      "휴가 유형 옵션: annual(연차), sick(병가), personal(개인사유), condolence(경조사), maternity(출산휴가), reward(포상휴가)"
    ],
    "prerequisites": "로그인된 사용자에게 휴가 관리 권한 필요"
  }
}