init: E2E 테스트 시나리오 초기화 (61개 파일)

vendor-ledger.json

@@ -0,0 +1,675 @@
+{
+  "id": "vendor-ledger",
+  "name": "거래처원장 테스트",
+  "screenshotPolicy": {
+    "onErrorOnly": true,
+    "captureOn": ["error", "fail", "timeout", "404", "500", "blocked"]
+  },
+  "description": "회계관리 > 거래처원장 메뉴의 기간 설정, 검색, 테이블, 다운로드, 상세 페이지 기능 테스트",
+  "baseUrl": "https://dev.codebridge-x.com",
+  "menuNavigation": {
+    "level1": "회계관리",
+    "level2": "거래처원장",
+    "expectedUrl": "/ko/accounting/vendor-ledger"
+  },
+  "menuNavigationEnhanced": {
+    "strategy": "scroll-and-search",
+    "level1": {
+      "text": "회계관리",
+      "alternativeNames": ["회계", "Accounting"],
+      "scrollConfig": {
+        "direction": "down",
+        "maxScrollAttempts": 5,
+        "scrollAmount": 200
+      }
+    },
+    "level2": {
+      "text": "거래처원장",
+      "alternativeNames": ["거래처 원장", "Vendor Ledger"],
+      "scrollConfig": {
+        "direction": "down",
+        "maxScrollAttempts": 3,
+        "scrollAmount": 150
+      }
+    },
+    "expectedUrl": "/ko/accounting/vendor-ledger",
+    "fallbackUrl": "/ko/accounting/vendor-ledger"
+  },
+  "auth": {
+    "username": "TestUser5",
+    "password": "password123!"
+  },
+  "steps": [
+    {
+      "id": 0,
+      "name": "사이드바 준비",
+      "description": "메뉴 탐색 전 사이드바를 최상단으로 스크롤",
+      "actions": [
+        {
+          "type": "scrollSidebarToTop",
+          "script": "document.querySelector('.sidebar-scroll, [class*=\"sidebar\"], nav')?.scrollTo({top:0,behavior:'smooth'})"
+        },
+        {
+          "type": "wait",
+          "duration": 300
+        }
+      ],
+      "expected": "사이드바 최상단으로 스크롤 완료"
+    },
+    {
+      "id": 1,
+      "name": "로그인",
+      "action": "login",
+      "target": "/ko/login",
+      "expected": "로그인 성공 후 메인 페이지 이동"
+    },
+    {
+      "id": 2,
+      "name": "2단계 메뉴 진입: 회계관리 > 거래처원장",
+      "description": "회계관리 > 거래처원장 메뉴로 이동하여 페이지 로드 확인 (scrollAndFind 패턴 사용)",
+      "actions": [
+        {
+          "type": "scrollAndFind",
+          "level": 1,
+          "target": "회계관리",
+          "alternativeSelectors": [
+            "text=회계관리",
+            "[data-menu='accounting']",
+            "a:has-text('회계관리')",
+            "span:has-text('회계관리')"
+          ],
+          "scrollConfig": {
+            "container": ".sidebar-scroll, [class*='sidebar'], nav",
+            "direction": "down",
+            "maxAttempts": 5,
+            "scrollAmount": 200
+          }
+        },
+        {
+          "type": "click",
+          "target": "회계관리"
+        },
+        {
+          "type": "wait",
+          "duration": 500
+        },
+        {
+          "type": "scrollAndFind",
+          "level": 2,
+          "target": "거래처원장",
+          "alternativeSelectors": [
+            "text=거래처원장",
+            "[data-menu='vendor-ledger']",
+            "a:has-text('거래처원장')",
+            "span:has-text('거래처원장')"
+          ],
+          "scrollConfig": {
+            "container": ".sidebar-scroll, [class*='sidebar'], nav",
+            "direction": "down",
+            "maxAttempts": 3,
+            "scrollAmount": 150
+          }
+        },
+        {
+          "type": "click",
+          "target": "거래처원장"
+        },
+        {
+          "type": "wait",
+          "target": "페이지 로드 완료"
+        }
+      ],
+      "expected": {
+        "url": "/ko/accounting/vendor-ledger",
+        "pageTitle": "거래처원장",
+        "elements": ["통계 카드", "테이블"]
+      }
+    },
+    {
+      "id": 3,
+      "name": "필수 검증 #5: 목업 페이지 감지",
+      "action": "verify_not_mockup",
+      "checks": [
+        "입력 필드 존재 (검색창, 날짜 선택)",
+        "동작하는 버튼 존재 (엑셀 다운로드)",
+        "테이블 데이터 표시",
+        "API 호출 확인"
+      ],
+      "expected": "정상 페이지 (목업 아님)"
+    },
+    {
+      "id": 4,
+      "name": "통계 카드 확인",
+      "action": "verify_elements",
+      "checks": [
+        "전기 이월 카드 표시",
+        "매출 카드 표시",
+        "수금 카드 표시",
+        "잔액 카드 표시"
+      ],
+      "expected": "4개 통계 카드 모두 표시, 금액 형식 확인"
+    },
+    {
+      "id": 5,
+      "name": "테이블 구조 확인",
+      "action": "verify_table",
+      "checks": [
+        "체크박스 컬럼",
+        "No. 컬럼",
+        "거래처명 컬럼",
+        "이월잔액 컬럼",
+        "매출 컬럼",
+        "수금 컬럼",
+        "잔액 컬럼",
+        "결제일 컬럼"
+      ],
+      "expected": "8개 컬럼 존재, 합계 행 표시"
+    },
+    {
+      "id": 6,
+      "name": "기간 설정 - 시작일 변경",
+      "action": "change_date",
+      "target": "startDate",
+      "value": "2025-01-01",
+      "expected": "시작일 변경 후 데이터 재조회"
+    },
+    {
+      "id": 7,
+      "name": "기간 설정 - 종료일 변경",
+      "action": "change_date",
+      "target": "endDate",
+      "value": "2025-12-31",
+      "expected": "종료일 변경 후 데이터 재조회"
+    },
+    {
+      "id": 8,
+      "name": "기간 설정 - 데이터 변화 확인",
+      "action": "verify_data_change",
+      "checks": [
+        "테이블 데이터 갱신",
+        "통계 카드 값 갱신",
+        "합계 행 값 갱신"
+      ],
+      "expected": "기간에 맞는 데이터로 변경됨"
+    },
+    {
+      "id": 9,
+      "name": "⚠️ 필수 검증: 검색 기능 테스트",
+      "critical": true,
+      "actions": [
+        {
+          "type": "capture",
+          "variable": "beforeSearchCount",
+          "selector": "table tbody tr",
+          "extract": "count",
+          "description": "검색 전 행 수 저장"
+        },
+        {
+          "type": "fill",
+          "target": "searchInput",
+          "value": "{testData.searchKeyword}",
+          "description": "검색어 입력"
+        },
+        {
+          "type": "wait",
+          "duration": 1000,
+          "description": "검색 결과 로딩 대기"
+        },
+        {
+          "type": "capture",
+          "variable": "afterSearchCount",
+          "selector": "table tbody tr",
+          "extract": "count",
+          "description": "검색 후 행 수 저장"
+        }
+      ],
+      "verify": {
+        "searchApplied": true,
+        "tableContains": "{testData.searchKeyword}",
+        "dataChanged": "beforeSearchCount may differ from afterSearchCount"
+      },
+      "expected": "검색어에 맞는 거래처만 필터링"
+    },
+    {
+      "id": "9-1",
+      "name": "검색 결과 데이터 검증",
+      "critical": true,
+      "description": "검색 결과의 모든 행이 검색어를 포함하는지 확인",
+      "verify": {
+        "allRowsContain": "{testData.searchKeyword}",
+        "columnToCheck": "거래처명"
+      }
+    },
+    {
+      "id": 10,
+      "name": "검색 결과 확인",
+      "action": "verify_search_result",
+      "checks": [
+        "테이블 행 수 변화",
+        "검색어 포함 거래처명 표시"
+      ],
+      "expected": "검색 결과 정상 표시"
+    },
+    {
+      "id": 11,
+      "name": "검색 초기화",
+      "actions": [
+        {
+          "type": "clear",
+          "target": "searchInput"
+        },
+        {
+          "type": "wait",
+          "duration": 500
+        },
+        {
+          "type": "capture",
+          "variable": "afterClearCount",
+          "selector": "table tbody tr",
+          "extract": "count"
+        }
+      ],
+      "verify": {
+        "dataRestored": "afterClearCount should equal beforeSearchCount"
+      },
+      "expected": "전체 데이터 다시 표시"
+    },
+    {
+      "id": 12,
+      "name": "체크박스 선택",
+      "action": "click_checkbox",
+      "target": "first_row",
+      "expected": "첫 번째 행 체크박스 선택됨"
+    },
+    {
+      "id": 13,
+      "name": "전체 선택 체크박스",
+      "action": "click_checkbox",
+      "target": "select_all",
+      "expected": "모든 행 체크박스 선택됨"
+    },
+    {
+      "id": 14,
+      "name": "전체 선택 해제",
+      "action": "click_checkbox",
+      "target": "select_all",
+      "expected": "모든 행 체크박스 해제됨"
+    },
+    {
+      "id": 15,
+      "name": "필수 검증 #1: 엑셀 다운로드",
+      "action": "click_download",
+      "target": "엑셀 다운로드",
+      "checks": [
+        "버튼 클릭",
+        "Network API 호출 확인 (/api/v1/vendor-ledger/export)",
+        "Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+        "파일 다운로드 이벤트 발생",
+        "성공 토스트 메시지 (엑셀 파일이 다운로드되었습니다)"
+      ],
+      "expected": "엑셀 파일 다운로드 완료"
+    },
+    {
+      "id": 16,
+      "name": "테이블 행 클릭 - 상세 페이지 이동",
+      "action": "click_row",
+      "target": "first_row",
+      "expected": "거래처원장 상세 페이지로 이동"
+    },
+    {
+      "id": 17,
+      "name": "상세 페이지 - URL 파라미터 확인",
+      "action": "verify_url",
+      "checks": [
+        "URL에 거래처 ID 포함",
+        "start_date 파라미터 포함",
+        "end_date 파라미터 포함"
+      ],
+      "expected": "URL 파라미터 정상 전달"
+    },
+    {
+      "id": 18,
+      "name": "상세 페이지 - 헤더 확인",
+      "action": "verify_elements",
+      "checks": [
+        "거래처원장 상세 (거래명세서별) 타이틀",
+        "목록 버튼 존재"
+      ],
+      "expected": "상세 페이지 헤더 정상 표시"
+    },
+    {
+      "id": 19,
+      "name": "상세 페이지 - 거래처 정보 카드 확인",
+      "action": "verify_vendor_info",
+      "checks": [
+        "회사명 표시",
+        "사업자등록번호 표시",
+        "대표자 표시",
+        "전화번호 표시",
+        "모바일 표시",
+        "팩스 표시",
+        "이메일 표시",
+        "주소 표시",
+        "기간 표시"
+      ],
+      "expected": "거래처 정보 모두 표시"
+    },
+    {
+      "id": 20,
+      "name": "상세 페이지 - 요약 통계 확인",
+      "action": "verify_summary",
+      "checks": [
+        "이월잔액 표시",
+        "매출 표시 (녹색)",
+        "수금 표시 (파란색)",
+        "잔액 표시"
+      ],
+      "expected": "4개 요약 통계 정상 표시"
+    },
+    {
+      "id": 21,
+      "name": "상세 페이지 - 판매/수금 내역 테이블 확인",
+      "action": "verify_transaction_table",
+      "checks": [
+        "일자 컬럼",
+        "적요 컬럼",
+        "판매 컬럼",
+        "수금 컬럼",
+        "잔액 컬럼",
+        "작업 컬럼"
+      ],
+      "expected": "판매/수금 내역 테이블 정상 표시"
+    },
+    {
+      "id": 22,
+      "name": "상세 페이지 - 기간 변경",
+      "action": "change_date_range",
+      "startDate": "2025-06-01",
+      "endDate": "2025-06-30",
+      "expected": "기간 변경 후 거래 내역 재조회"
+    },
+    {
+      "id": 23,
+      "name": "상세 페이지 - 거래 내역 데이터 변화 확인",
+      "action": "verify_transactions_update",
+      "checks": [
+        "테이블 데이터 갱신",
+        "요약 통계 값 갱신"
+      ],
+      "expected": "변경된 기간의 데이터 표시"
+    },
+    {
+      "id": 24,
+      "name": "⚠️ 필수 검증: PDF 다운로드 전 페이지 스크린샷",
+      "critical": true,
+      "description": "PDF 생성 전 페이지 상태를 스크린샷으로 캡처하여 CSS 문제 감지용 기준 이미지 확보",
+      "actions": [
+        {
+          "type": "screenshot",
+          "name": "pdf-preview-before-download",
+          "fullPage": true,
+          "savePath": "tests/e2e/results/hotfix/screenshots/",
+          "description": "PDF 생성 대상 페이지 전체 캡처"
+        },
+        {
+          "type": "screenshot",
+          "name": "pdf-content-area",
+          "selector": ".vendor-ledger-detail, .pdf-content, main",
+          "savePath": "tests/e2e/results/hotfix/screenshots/",
+          "description": "PDF 콘텐츠 영역만 캡처"
+        }
+      ],
+      "verify": {
+        "screenshotCaptured": true,
+        "purpose": "PDF CSS 문제 감지를 위한 기준 이미지"
+      }
+    },
+    {
+      "id": "24-1",
+      "name": "⚠️ 필수 검증: PDF 다운로드 실행 및 파일 보관",
+      "critical": true,
+      "description": "PDF 다운로드 후 파일을 지정 폴더에 보관하여 수동 검증 가능하게 함",
+      "actions": [
+        {
+          "type": "expectResponse",
+          "id": "pdf-download-response",
+          "urlPattern": "/api/v1/vendor-ledger/*/export-pdf",
+          "description": "PDF 다운로드 API 응답 대기 설정"
+        },
+        {
+          "type": "click",
+          "target": "PDF 다운로드",
+          "description": "PDF 다운로드 버튼 클릭"
+        },
+        {
+          "type": "wait",
+          "duration": 3000,
+          "description": "PDF 생성 및 다운로드 대기"
+        },
+        {
+          "type": "assertResponse",
+          "id": "pdf-download-response",
+          "checks": {
+            "status": 200,
+            "contentType": "application/pdf"
+          }
+        },
+        {
+          "type": "saveDownloadedFile",
+          "targetPath": "tests/e2e/results/hotfix/pdf-samples/",
+          "fileNamePattern": "vendor-ledger-{vendorId}-{timestamp}.pdf",
+          "description": "다운로드된 PDF 파일을 지정 폴더에 보관"
+        }
+      ],
+      "verify": {
+        "apiSuccess": true,
+        "fileDownloaded": true,
+        "fileSaved": "tests/e2e/results/hotfix/pdf-samples/"
+      }
+    },
+    {
+      "id": "24-2",
+      "name": "⚠️ PDF 파일 유효성 검증",
+      "critical": true,
+      "description": "다운로드된 PDF 파일의 기본 유효성 검사",
+      "actions": [
+        {
+          "type": "verifyDownloadedFile",
+          "checks": {
+            "fileExists": true,
+            "fileSize": "> 1024",
+            "pdfSignature": "%PDF-",
+            "description": "PDF 파일 헤더 검증"
+          }
+        }
+      ],
+      "verify": {
+        "pdfValid": true,
+        "minFileSize": "1KB 이상"
+      }
+    },
+    {
+      "id": "24-3",
+      "name": "📋 PDF 스타일 수동 확인 체크리스트",
+      "type": "manualVerification",
+      "critical": true,
+      "description": "개발자가 다운로드된 PDF를 열어 시각적으로 확인해야 하는 항목",
+      "manualChecklist": [
+        {
+          "id": "css-1",
+          "item": "테이블 경계선이 올바르게 표시되는가?",
+          "category": "테이블 스타일"
+        },
+        {
+          "id": "css-2",
+          "item": "한글 폰트가 깨지지 않고 정상 표시되는가?",
+          "category": "폰트"
+        },
+        {
+          "id": "css-3",
+          "item": "숫자/금액 정렬이 올바른가? (우측 정렬)",
+          "category": "정렬"
+        },
+        {
+          "id": "css-4",
+          "item": "여백(margin/padding)이 적절한가?",
+          "category": "레이아웃"
+        },
+        {
+          "id": "css-5",
+          "item": "헤더/푸터가 각 페이지에 올바르게 표시되는가?",
+          "category": "페이지 구조"
+        },
+        {
+          "id": "css-6",
+          "item": "로고/이미지가 정상 표시되는가?",
+          "category": "이미지"
+        },
+        {
+          "id": "css-7",
+          "item": "페이지 나눔(page break)이 적절한 위치에서 발생하는가?",
+          "category": "페이지 나눔"
+        },
+        {
+          "id": "css-8",
+          "item": "배경색/강조색이 올바르게 적용되었는가?",
+          "category": "색상"
+        },
+        {
+          "id": "css-9",
+          "item": "텍스트가 잘리거나 겹치지 않는가?",
+          "category": "오버플로우"
+        },
+        {
+          "id": "css-10",
+          "item": "인쇄 시 레이아웃이 유지되는가?",
+          "category": "인쇄 호환성"
+        }
+      ],
+      "outputFiles": {
+        "screenshot": "tests/e2e/results/hotfix/screenshots/pdf-preview-before-download-*.png",
+        "pdfFile": "tests/e2e/results/hotfix/pdf-samples/vendor-ledger-*.pdf"
+      },
+      "reportFlag": {
+        "requiresManualReview": true,
+        "message": "⚠️ PDF 스타일 수동 확인 필요 - 위 체크리스트 항목을 PDF 파일에서 직접 확인하세요"
+      }
+    },
+    {
+      "id": 25,
+      "name": "상세 페이지 - 작업 버튼 확인 (어음 항목)",
+      "action": "verify_action_buttons",
+      "checks": [
+        "어음 관련 항목에 수정 버튼(Pencil 아이콘) 존재",
+        "일반 항목에는 작업 버튼 없음"
+      ],
+      "expected": "hasAction=true인 항목에만 버튼 표시"
+    },
+    {
+      "id": 26,
+      "name": "상세 페이지 - 목록 버튼 클릭",
+      "action": "click_button",
+      "target": "목록",
+      "expected": "거래처원장 목록 페이지로 복귀"
+    },
+    {
+      "id": 27,
+      "name": "목록 페이지 복귀 확인",
+      "action": "verify_url",
+      "target": "/ko/accounting/vendor-ledger",
+      "expected": "목록 페이지 정상 표시"
+    },
+    {
+      "id": 28,
+      "name": "페이지네이션 동작 확인",
+      "action": "verify_pagination",
+      "checks": [
+        "현재 페이지 표시",
+        "전체 페이지 수 표시",
+        "페이지 이동 버튼 동작"
+      ],
+      "expected": "페이지네이션 정상 동작"
+    }
+  ],
+  "requiredVerifications": [
+    {
+      "id": 1,
+      "name": "파일 다운로드 (엑셀/PDF)",
+      "steps": [15, 24, "24-1", "24-2", "24-3"],
+      "criteria": "Network API 호출 + 실제 파일 다운로드 + 성공 토스트 + PDF 스타일 검증"
+    },
+    {
+      "id": "PDF-STYLE",
+      "name": "PDF 스타일/CSS 검증",
+      "steps": [24, "24-1", "24-2", "24-3"],
+      "criteria": "스크린샷 캡처 + PDF 파일 보관 + 수동 체크리스트 확인",
+      "manualReviewRequired": true,
+      "outputPaths": {
+        "screenshots": "tests/e2e/results/hotfix/screenshots/",
+        "pdfFiles": "tests/e2e/results/hotfix/pdf-samples/"
+      }
+    },
+    {
+      "id": 2,
+      "name": "등록/저장 버튼",
+      "steps": [],
+      "criteria": "해당 없음 (조회 전용 페이지)"
+    },
+    {
+      "id": 3,
+      "name": "검색/필터",
+      "steps": [6, 7, 8, 9, 10, 11],
+      "criteria": "기간 설정 및 검색 시 데이터 변화 확인"
+    },
+    {
+      "id": 4,
+      "name": "모달 등록 완료",
+      "steps": [],
+      "criteria": "해당 없음 (조회 전용 페이지)"
+    },
+    {
+      "id": 5,
+      "name": "목업 페이지 감지",
+      "steps": [3],
+      "criteria": "입력 필드, 동작 버튼, API 호출 확인"
+    }
+  ],
+  "testData": {
+    "searchKeyword": "테스트",
+    "dateRange": {
+      "start": "2025-01-01",
+      "end": "2025-12-31"
+    },
+    "detailDateRange": {
+      "start": "2025-06-01",
+      "end": "2025-06-30"
+    }
+  },
+  "expectedAPIs": [
+    {
+      "method": "GET",
+      "endpoint": "/api/v1/vendor-ledger",
+      "description": "거래처원장 목록 조회"
+    },
+    {
+      "method": "GET",
+      "endpoint": "/api/v1/vendor-ledger/summary",
+      "description": "거래처원장 요약 통계 조회"
+    },
+    {
+      "method": "GET",
+      "endpoint": "/api/v1/vendor-ledger/{id}",
+      "description": "거래처원장 상세 조회"
+    },
+    {
+      "method": "GET",
+      "endpoint": "/api/v1/vendor-ledger/export",
+      "description": "거래처원장 엑셀 다운로드"
+    },
+    {
+      "method": "GET",
+      "endpoint": "/api/v1/vendor-ledger/{id}/export-pdf",
+      "description": "거래처원장 상세 PDF 다운로드"
+    }
+  ]
+}