sam-scenarios/salary-management.json

{
  "id": "salary-management",
  "name": "급여관리 테스트",
  "screenshotPolicy": {
    "onErrorOnly": true,
    "captureOn": ["error", "fail", "timeout", "404", "500", "blocked"]
  },
  "description": "급여 현황 조회, 상태 변경, 엑셀 다운로드 기능을 테스트하는 E2E 테스트",
  "baseUrl": "https://dev.codebridge-x.com",
  "url": "/hr/salary-management",
  "menuNavigation": {
    "level1": "인사관리",
    "level2": "급여관리",
    "expectedUrl": "/hr/salary-management"
  },
  "menuNavigationEnhanced": {
    "strategy": "scroll-and-search",
    "sidebar": {
      "scrollContainer": ".sidebar-scroll",
      "scrollStep": 200,
      "maxScrollAttempts": 5,
      "waitAfterScroll": 300
    },
    "level1": {
      "text": "인사관리",
      "expandable": true,
      "waitAfterClick": 500
    },
    "level2": {
      "text": "급여관리",
      "waitAfterClick": 300
    },
    "fallbackUrl": "/hr/salary-management",
    "expectedUrl": "/hr/salary-management"
  },
  "timeout": 90000,
  "tags": ["hr", "salary", "payroll", "management"],

  "login": {
    "url": "https://dev.codebridge-x.com/login",
    "credentials": {
      "id": "TestUser5",
      "password": "password123!"
    },
    "successIndicator": "대시보드"
  },

  "testData": {
    "searchKeyword": "홍",
    "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 패턴 사용)",
      "actions": [
        {
          "type": "scrollAndFind",
          "container": ".sidebar-scroll",
          "target": "인사관리",
          "scrollStep": 200,
          "maxAttempts": 5
        },
        { "type": "click", "target": "인사관리" },
        { "type": "wait", "duration": 500 },
        {
          "type": "scrollAndFind",
          "container": ".sidebar-scroll",
          "target": "급여관리",
          "scrollStep": 200,
          "maxAttempts": 5
        },
        { "type": "click", "target": "급여관리" }
      ],
      "expect": {
        "url": "/hr/salary-management",
        "visible": ["급여관리", "엑셀 다운로드"]
      },
      "fallback": {
        "type": "navigate",
        "url": "/ko/hr/salary-management"
      }
    },
    {
      "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": {
        "tableColumns": ["부서", "직책", "이름", "직급", "기본급", "수당", "초과근무", "상여", "공제", "실지급액", "일자", "상태", "작업"]
      }
    },
    {
      "id": "step-5",
      "name": "날짜 필터 확인",
      "description": "시작일/종료일 날짜 필터 필드 확인",
      "verify": {
        "dateInputs": 2,
        "dateRange": {
          "startDate": "2025-12-01",
          "endDate": "2025-12-31"
        }
      }
    },
    {
      "id": "step-5-1",
      "name": "⚠️ 필수 검증: 날짜 필터 검색",
      "critical": true,
      "description": "날짜 범위 필터를 설정하고 데이터가 필터링되는지 확인",
      "actions": [
        { "type": "capture", "variable": "initialRowCount", "selector": "table tbody tr", "extract": "count", "description": "필터 전 행 수 저장" },
        { "type": "fill", "target": "시작일", "value": "{testData.dateRange.startDate}", "description": "시작일 입력" },
        { "type": "fill", "target": "종료일", "value": "{testData.dateRange.endDate}", "description": "종료일 입력" },
        { "type": "wait", "duration": 500, "description": "필터 적용 대기" },
        { "type": "capture", "variable": "filteredRowCount", "selector": "table tbody tr", "extract": "count", "description": "필터 후 행 수 저장" }
      ],
      "verify": {
        "dateFilterApplied": true,
        "dataChanged": "initialRowCount may differ from filteredRowCount"
      },
      "note": "날짜 필터가 실제로 데이터를 필터링하는지 확인 - 단순 UI 변경만 확인하면 FAIL"
    },
    {
      "id": "step-6",
      "name": "⚠️ 필수 검증: 검색 기능 확인",
      "critical": true,
      "description": "검색어 입력 후 테이블 데이터가 필터링되는지 확인",
      "actions": [
        { "type": "capture", "variable": "beforeSearchCount", "selector": "table tbody tr", "extract": "count", "description": "검색 전 행 수 저장" },
        { "type": "fill", "target": "검색", "value": "{testData.searchKeyword}", "description": "검색어 입력" },
        { "type": "wait", "duration": 500, "description": "검색 결과 대기" },
        { "type": "capture", "variable": "afterSearchCount", "selector": "table tbody tr", "extract": "count", "description": "검색 후 행 수 저장" }
      ],
      "verify": {
        "searchApplied": true,
        "tableContains": "{testData.searchKeyword}",
        "dataFiltered": "검색 결과에 검색어가 포함된 행만 표시되어야 함"
      },
      "expect": {
        "searchPlaceholder": "이름, 부서 검색..."
      },
      "note": "⚠️ 검색어 입력 후 테이블 데이터가 변경되지 않으면 FAIL"
    },
    {
      "id": "step-6-1",
      "name": "검색 결과 데이터 검증",
      "description": "검색 결과의 각 행에 검색어가 포함되어 있는지 확인",
      "verify": {
        "allRowsContain": "{testData.searchKeyword}",
        "verifyMethod": "테이블의 모든 행이 검색어를 포함하는지 확인"
      }
    },
    {
      "id": "step-6-2",
      "name": "검색 초기화 확인",
      "description": "검색어 삭제 후 전체 목록 복원 확인",
      "actions": [
        { "type": "clear", "target": "검색", "description": "검색어 삭제" },
        { "type": "wait", "duration": 500, "description": "목록 복원 대기" }
      ],
      "verify": {
        "dataRestored": true,
        "rowCountRestored": "beforeSearchCount와 유사한 행 수로 복원"
      }
    },
    {
      "id": "step-7",
      "name": "정렬 옵션 확인",
      "description": "정렬 드롭다운 옵션 확인",
      "actions": [
        { "type": "click", "target": "정렬", "role": "combobox" }
      ],
      "verify": {
        "options": ["직급순", "이름순", "부서순", "지급일순", "지급액순"]
      }
    },
    {
      "id": "step-8",
      "name": "급여 항목 선택",
      "description": "체크박스로 급여 항목 선택",
      "actions": [
        { "type": "click", "target": "첫번째 행 체크박스" }
      ],
      "expect": {
        "visible": ["지급완료", "지급예정"],
        "buttonsEnabled": true
      }
    },
    {
      "id": "step-9",
      "name": "필수 검증 #2: 지급완료 버튼 동작 확인",
      "description": "지급완료 버튼 클릭 시 실제 상태 변경 확인",
      "actions": [
        { "type": "click", "target": "지급완료" }
      ],
      "expect": {
        "urlMaintained": true,
        "noErrorPage": true,
        "toast": "지급완료 처리되었습니다",
        "apiCall": "bulkUpdateSalaryStatus"
      }
    },
    {
      "id": "step-10",
      "name": "수정 버튼 클릭 - 상세 다이얼로그 열기",
      "description": "급여 항목의 수정 버튼 클릭하여 상세 다이얼로그 열기",
      "actions": [
        { "type": "openModal", "target": "수정", "description": "급여 상세 모달 열기" }
      ],
      "modalConfig": {
        "containerSelector": "[role='dialog'], .modal",
        "animationDelay": 300,
        "waitForSelector": "[role='dialog']"
      },
      "expect": {
        "modal": "급여 상세",
        "visible": ["기본급", "수당", "초과근무", "상여", "공제", "실지급액"]
      }
    },
    {
      "id": "step-11",
      "name": "필수 검증 #4: 상세 다이얼로그 저장",
      "description": "모달 내 급여 상세 저장 버튼 동작 확인",
      "actions": [
        { "type": "clickInModal", "target": "저장", "options": { "waitAfter": 500 } }
      ],
      "expect": {
        "urlMaintained": true,
        "noErrorPage": true,
        "modalClosed": true,
        "toast": "저장되었습니다"
      }
    },
    {
      "id": "step-12",
      "name": "상세 다이얼로그 닫기",
      "description": "다이얼로그 닫기",
      "actions": [
        { "type": "press", "key": "Escape" }
      ],
      "expect": {
        "modalClosed": true
      }
    },
    {
      "id": "step-13",
      "name": "필수 검증 #1: 엑셀 다운로드",
      "description": "엑셀 다운로드 버튼 클릭 시 실제 다운로드 발생 확인",
      "actions": [
        { "type": "click", "target": "엑셀 다운로드" }
      ],
      "verify": {
        "networkRequest": {
          "type": "download",
          "apiPattern": "/api/export|/api/download|/api/salary"
        },
        "downloadEvent": true
      },
      "note": "⚠️ Console LOG만 출력되면 FAIL - Network API 호출 필수 확인"
    }
  ],

  "assertions": [
    {
      "type": "url",
      "expected": "/hr/salary-management",
      "message": "급여관리 페이지에 머물러야 함"
    },
    {
      "type": "elementExists",
      "selector": "button:has-text('엑셀 다운로드')",
      "message": "엑셀 다운로드 버튼이 표시되어야 함"
    },
    {
      "type": "tableExists",
      "message": "급여 목록 테이블이 표시되어야 함"
    }
  ],

  "mandatoryVerifications": {
    "description": "E2E_TEST_CONFIG.md 기준 필수 검증 항목",
    "items": [
      {
        "id": 1,
        "name": "파일 다운로드",
        "trigger": "엑셀 다운로드 버튼",
        "verification": "Network API 호출 + 실제 파일 다운로드 확인",
        "failCondition": "Console LOG만 존재, API 미호출"
      },
      {
        "id": 2,
        "name": "등록/저장 버튼",
        "trigger": "지급완료, 지급예정, 저장 버튼",
        "verification": "URL 유지 + 에러 페이지 없음 + 성공 토스트",
        "failCondition": "404/500 에러 페이지 이동"
      },
      {
        "id": 3,
        "name": "검색/필터",
        "trigger": "검색창, 날짜 필터, 정렬",
        "verification": "데이터 변화 확인",
        "failCondition": "필터 적용 후 데이터 무변화"
      },
      {
        "id": 4,
        "name": "모달 등록 완료",
        "trigger": "급여 상세 다이얼로그 저장",
        "verification": "실제 저장 동작 + 결과 확인",
        "failCondition": "열기/닫기만 테스트"
      },
      {
        "id": 5,
        "name": "목업/미완성 페이지 감지",
        "trigger": "페이지 로드 시",
        "verification": "입력 필드 + 동작하는 버튼 + API 호출 확인",
        "failCondition": "버튼만 있고 입력 불가, Console LOG만 출력"
      }
    ]
  },

  "cleanup": {
    "enabled": false,
    "description": "조회/상태변경 테스트이므로 cleanup 불필요"
  },

  "notes": {
    "testScope": "급여관리 페이지 UI 요소 및 기능 검증",
    "features": {
      "dashboard": "총 실지급액/기본급/수당/초과근무/상여/공제 현황 카드",
      "dateFilter": "시작일~종료일 날짜 범위 필터",
      "search": "이름, 부서 검색",
      "sort": "직급순/이름순/부서순/지급일순/지급액순 정렬",
      "statusChange": "지급완료/지급예정 일괄 상태 변경",
      "detailDialog": "급여 상세 조회/수정 다이얼로그",
      "export": "엑셀 다운로드"
    },
    "tableColumns": {
      "부서": "소속 부서",
      "직책": "직책명",
      "이름": "직원 이름",
      "직급": "직급명",
      "기본급": "기본급 금액",
      "수당": "수당 금액",
      "초과근무": "초과근무 수당",
      "상여": "상여금",
      "공제": "공제 금액",
      "실지급액": "실제 지급 금액",
      "일자": "지급 일자",
      "상태": "지급완료/지급예정",
      "작업": "수정 버튼"
    },
    "knownIssues": [
      "엑셀 다운로드 기능이 toast.info('준비 중') 상태일 수 있음 - 목업 가능성",
      "지급항목 추가 기능이 미구현 상태"
    ],
    "prerequisites": "로그인된 사용자에게 급여 관리 권한 필요"
  }
}