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

approval-box.json

@@ -0,0 +1,440 @@
+{
+  "scenarioId": "approval-box",
+  "name": "결재함 E2E 테스트",
+  "screenshotPolicy": {
+    "onErrorOnly": true,
+    "captureOn": ["error", "fail", "timeout", "404", "500", "blocked"]
+  },
+  "description": "결재함 페이지의 전체 기능을 검증합니다 (탭 전환, 검색, 필터, 승인/반려, 모달)",
+  "baseUrl": "https://dev.codebridge-x.com",
+
+  "menuNavigationEnhanced": {
+    "strategy": "scroll-and-search",
+    "description": "사이드바를 스크롤하며 메뉴를 찾고 클릭하여 404를 방지",
+    "level1": "결재관리",
+    "level2": "결재함",
+    "alternativeLevel2Names": ["결재함", "결재 함", "승인함", "Approval Box", "inbox"],
+    "fallbackUrls": [
+      "/ko/approval/inbox",
+      "/ko/approval/box",
+      "/ko/approvals/inbox",
+      "/ko/approval-management/inbox",
+      "/approval/inbox"
+    ],
+    "scrollConfig": {
+      "sidebarSelector": "nav, aside, [role='navigation'], .sidebar, #sidebar",
+      "menuItemSelector": "a, button, [role='menuitem'], [role='treeitem']",
+      "scrollStep": 200,
+      "maxScrollAttempts": 10,
+      "scrollDelay": 300
+    }
+  },
+
+  "steps": [
+    {
+      "id": 0,
+      "name": "사이드바 메뉴 탐색 준비",
+      "description": "사이드바를 최상단으로 스크롤하고 메뉴 구조 파악",
+      "actions": [
+        { "type": "scroll", "target": "sidebar", "direction": "top", "description": "사이드바 최상단으로 스크롤" },
+        { "type": "wait", "duration": 500 },
+        { "type": "screenshot", "name": "sidebar_initial_state" }
+      ],
+      "verification": [
+        "사이드바가 화면에 보이는지 확인",
+        "메뉴 항목들이 렌더링되었는지 확인"
+      ]
+    },
+    {
+      "id": 1,
+      "name": "1차 메뉴 찾기: 결재관리 (스크롤 포함)",
+      "description": "사이드바를 스크롤하며 '결재관리' 메뉴를 찾아 클릭",
+      "actions": [
+        {
+          "type": "scrollAndFind",
+          "target": "결재관리",
+          "alternativeTexts": ["결재관리", "결재 관리", "Approval", "전자결재"],
+          "scrollContainer": "sidebar",
+          "maxAttempts": 10,
+          "description": "스크롤하며 결재관리 메뉴 찾기"
+        },
+        { "type": "wait", "duration": 300 },
+        { "type": "click", "target": "결재관리", "description": "결재관리 메뉴 클릭" },
+        { "type": "wait", "duration": 500, "description": "서브메뉴 펼쳐지기 대기" },
+        { "type": "screenshot", "name": "approval_menu_expanded" }
+      ],
+      "verification": [
+        "결재관리 메뉴가 클릭되었는지 확인",
+        "서브메뉴가 펼쳐졌는지 확인",
+        "하위 메뉴 항목들이 보이는지 확인"
+      ],
+      "fallback": {
+        "if": "메뉴를 찾을 수 없음",
+        "then": "사이드바 전체를 스크롤하며 재탐색"
+      }
+    },
+    {
+      "id": 2,
+      "name": "2차 메뉴 찾기: 결재함 (스크롤 포함)",
+      "description": "서브메뉴에서 '결재함'을 찾아 클릭",
+      "actions": [
+        {
+          "type": "scrollAndFind",
+          "target": "결재함",
+          "alternativeTexts": ["결재함", "결재 함", "Inbox", "승인함"],
+          "scrollContainer": "submenu",
+          "maxAttempts": 5,
+          "description": "서브메뉴에서 결재함 찾기"
+        },
+        { "type": "wait", "duration": 200 },
+        { "type": "click", "target": "결재함", "description": "결재함 메뉴 클릭" },
+        { "type": "wait", "target": "페이지 로드 완료", "timeout": 10000 },
+        { "type": "screenshot", "name": "approval_box_page" }
+      ],
+      "verification": [
+        "결재함 메뉴 클릭 성공",
+        "페이지 이동 또는 컨텐츠 로드"
+      ]
+    },
+    {
+      "id": 3,
+      "name": "404 에러 감지 및 대체 경로 시도",
+      "description": "페이지 로드 후 404 에러 여부 확인, 404시 대체 경로 탐색",
+      "actions": [
+        { "type": "wait", "duration": 1000 },
+        { "type": "checkFor404", "indicators": [
+          "페이지를 찾을 수 없습니다",
+          "404",
+          "Not Found",
+          "존재하지 않거나"
+        ]},
+        { "type": "screenshot", "name": "page_load_result" }
+      ],
+      "verification": [
+        "현재 페이지가 404인지 확인"
+      ],
+      "onError404": {
+        "description": "404 에러 발생 시 대체 URL 시도",
+        "actions": [
+          { "type": "log", "message": "404 감지 - 대체 경로 탐색 시작" },
+          {
+            "type": "tryAlternativeUrls",
+            "urls": [
+              "/ko/approval/inbox",
+              "/ko/approvals/inbox",
+              "/ko/approval-box"
+            ],
+            "stopOnSuccess": true
+          },
+          {
+            "type": "ifStillFailed",
+            "action": "navigateViaMenuClick",
+            "description": "URL 직접 접근 실패 시 메뉴 클릭으로 재시도"
+          }
+        ]
+      }
+    },
+    {
+      "id": 4,
+      "name": "페이지 정상 로드 확인",
+      "description": "결재함 페이지가 정상적으로 로드되었는지 확인",
+      "actions": [
+        { "type": "verify", "target": "pageTitle", "contains": ["결재함", "결재", "Approval"] },
+        { "type": "verify", "target": "pageContent", "notContains": ["404", "찾을 수 없습니다", "Not Found"] }
+      ],
+      "verification": [
+        "페이지 제목 '결재함' 또는 관련 텍스트 표시",
+        "404 에러 메시지 미표시",
+        "콘텐츠가 정상 렌더링됨"
+      ],
+      "successCriteria": {
+        "urlPattern": "/approval",
+        "requiredElements": ["결재", "문서", "승인"]
+      }
+    },
+    {
+      "id": 5,
+      "name": "통계 카드 확인",
+      "action": "현황 카드의 데이터 수집",
+      "verification": [
+        "전체결재 건수 기록",
+        "미결재 건수 기록",
+        "결재완료 건수 기록",
+        "결재반려 건수 기록"
+      ]
+    },
+    {
+      "id": 6,
+      "name": "탭 구조 확인",
+      "action": "4개 탭 존재 여부 확인",
+      "verification": [
+        "'전체결재' 탭 존재 확인",
+        "'미결재' 탭 존재 확인",
+        "'결재완료' 탭 존재 확인",
+        "'결재반려' 탭 존재 확인"
+      ]
+    },
+    {
+      "id": 7,
+      "name": "테이블 데이터 확인",
+      "action": "테이블에 데이터가 표시되는지 확인",
+      "verification": [
+        "테이블 헤더 컬럼 확인",
+        "데이터 행 존재 여부 확인",
+        "페이지네이션 표시 확인"
+      ]
+    },
+    {
+      "id": 8,
+      "name": "⚠️ 필수 검증: 결재 문서 상세 보기",
+      "description": "테이블에서 결재 문서 클릭하여 상세 모달/페이지 확인",
+      "critical": true,
+      "actions": [
+        { "type": "click", "target": "미결재 탭", "description": "미결재 탭으로 이동" },
+        { "type": "wait", "duration": 500 },
+        { "type": "click", "target": "첫 번째 결재 문서 행", "description": "결재 문서 클릭" },
+        { "type": "wait", "target": "상세 모달 또는 페이지" }
+      ],
+      "expect": {
+        "detailView": true,
+        "fields": ["문서 제목", "기안자", "기안일", "결재 상태"],
+        "buttons": ["승인", "반려", "PDF", "인쇄"]
+      },
+      "note": "결재 문서가 없으면 데이터 생성 또는 SKIP"
+    },
+    {
+      "id": "8-pdf-1",
+      "name": "⚠️ 필수 검증: PDF 다운로드 전 모달 스크린샷",
+      "critical": true,
+      "description": "PDF 생성 전 모달 상태를 스크린샷으로 캡처하여 CSS 문제 감지용 기준 이미지 확보",
+      "prerequisite": "step-8의 문서 상세 모달이 열려있는 상태에서 실행",
+      "actions": [
+        {
+          "type": "screenshot",
+          "name": "pdf-preview-before-download-approval-box",
+          "fullPage": false,
+          "selector": "[role='dialog'], .modal, [data-state='open']",
+          "savePath": "tests/e2e/results/hotfix/screenshots/",
+          "description": "PDF 생성 대상 모달 전체 캡처"
+        }
+      ],
+      "verify": {
+        "screenshotCaptured": true,
+        "purpose": "PDF CSS 문제 감지를 위한 기준 이미지"
+      }
+    },
+    {
+      "id": "8-pdf-2",
+      "name": "⚠️ 필수 검증: PDF 다운로드 실행 및 파일 보관",
+      "critical": true,
+      "description": "PDF 다운로드 후 파일을 지정 폴더에 보관하여 수동 검증 가능하게 함",
+      "actions": [
+        {
+          "type": "verify",
+          "target": "PDF 버튼 존재",
+          "selector": "button:has-text('PDF'), [aria-label*='PDF']",
+          "description": "PDF 다운로드 버튼 존재 확인"
+        },
+        {
+          "type": "expectResponse",
+          "id": "pdf-download-response-approval-box",
+          "urlPattern": "/api/v1/approvals/*/pdf",
+          "description": "PDF 다운로드 API 응답 대기 설정"
+        },
+        {
+          "type": "click",
+          "target": "PDF 버튼",
+          "selector": "button:has-text('PDF')",
+          "description": "PDF 다운로드 버튼 클릭"
+        },
+        {
+          "type": "wait",
+          "duration": 3000,
+          "description": "PDF 생성 및 다운로드 대기"
+        },
+        {
+          "type": "assertResponse",
+          "id": "pdf-download-response-approval-box",
+          "checks": {
+            "status": 200,
+            "contentType": "application/pdf"
+          }
+        },
+        {
+          "type": "saveDownloadedFile",
+          "targetPath": "tests/e2e/results/hotfix/pdf-samples/",
+          "fileNamePattern": "approval-box-{timestamp}.pdf",
+          "description": "다운로드된 PDF 파일을 지정 폴더에 보관"
+        }
+      ],
+      "verify": {
+        "apiSuccess": true,
+        "fileDownloaded": true,
+        "fileSaved": "tests/e2e/results/hotfix/pdf-samples/"
+      }
+    },
+    {
+      "id": "8-pdf-3",
+      "name": "⚠️ PDF 파일 유효성 검증",
+      "critical": true,
+      "description": "다운로드된 PDF 파일의 기본 유효성 검사",
+      "actions": [
+        {
+          "type": "verifyDownloadedFile",
+          "checks": {
+            "fileExists": true,
+            "fileSize": "> 1024",
+            "pdfSignature": "%PDF-",
+            "description": "PDF 파일 헤더 검증"
+          }
+        }
+      ],
+      "verify": {
+        "pdfValid": true,
+        "minFileSize": "1KB 이상"
+      }
+    },
+    {
+      "id": "8-pdf-4",
+      "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-approval-box-*.png",
+        "pdfFile": "tests/e2e/results/hotfix/pdf-samples/approval-box-*.pdf"
+      },
+      "reportFlag": {
+        "requiresManualReview": true,
+        "message": "⚠️ PDF 스타일 수동 확인 필요 - 위 체크리스트 항목을 PDF 파일에서 직접 확인하세요"
+      }
+    },
+    {
+      "id": 9,
+      "name": "⚠️ 필수 검증 #4: 결재 승인 실제 수행",
+      "description": "미결재 문서에 대해 실제 승인 처리 수행",
+      "critical": true,
+      "actions": [
+        { "type": "verify", "target": "승인 버튼 존재" },
+        { "type": "click", "target": "승인 버튼", "description": "결재 승인 클릭" },
+        { "type": "wait", "target": "확인 다이얼로그" },
+        { "type": "click", "target": "확인", "description": "승인 확인" }
+      ],
+      "expect": {
+        "urlMaintained": true,
+        "noErrorPage": true,
+        "apiCall": "POST /api/v1/approvals/{id}/approve",
+        "toast": "승인되었습니다",
+        "statusChange": "미결재 → 결재완료"
+      },
+      "note": "⚠️ 버튼 존재만 확인하면 불완전! 실제 승인까지 검증 필수!"
+    },
+    {
+      "id": "9-1",
+      "name": "결재 승인 결과 확인",
+      "description": "승인 후 결재완료 탭에서 해당 문서 확인",
+      "actions": [
+        { "type": "click", "target": "결재완료 탭" },
+        { "type": "wait", "duration": 500 }
+      ],
+      "verify": {
+        "documentMoved": "승인한 문서가 결재완료 탭에 표시",
+        "statusUpdated": "결재 상태가 '완료'로 변경"
+      }
+    },
+    {
+      "id": 10,
+      "name": "⚠️ 필수 검증 #4: 결재 반려 실제 수행",
+      "description": "미결재 문서에 대해 실제 반려 처리 수행",
+      "critical": true,
+      "actions": [
+        { "type": "click", "target": "미결재 탭", "description": "미결재 탭으로 이동" },
+        { "type": "wait", "duration": 500 },
+        { "type": "click", "target": "결재 문서 행", "description": "결재 문서 선택" },
+        { "type": "wait", "target": "상세 보기" },
+        { "type": "click", "target": "반려 버튼", "description": "결재 반려 클릭" },
+        { "type": "wait", "target": "반려 사유 입력 모달" },
+        { "type": "type", "target": "반려 사유", "value": "E2E 테스트 반려 사유" },
+        { "type": "click", "target": "확인", "description": "반려 확인" }
+      ],
+      "expect": {
+        "urlMaintained": true,
+        "noErrorPage": true,
+        "apiCall": "POST /api/v1/approvals/{id}/reject",
+        "toast": "반려되었습니다",
+        "statusChange": "미결재 → 결재반려"
+      },
+      "note": "⚠️ 반려 버튼 존재만 확인하면 불완전! 실제 반려까지 검증 필수!"
+    },
+    {
+      "id": "10-1",
+      "name": "결재 반려 결과 확인",
+      "description": "반려 후 결재반려 탭에서 해당 문서 확인",
+      "actions": [
+        { "type": "click", "target": "결재반려 탭" },
+        { "type": "wait", "duration": 500 }
+      ],
+      "verify": {
+        "documentMoved": "반려한 문서가 결재반려 탭에 표시",
+        "statusUpdated": "결재 상태가 '반려'로 변경",
+        "rejectReason": "반려 사유가 표시"
+      }
+    },
+    {
+      "id": 11,
+      "name": "검색 기능 테스트",
+      "description": "검색 필터로 결재 문서 검색",
+      "actions": [
+        { "type": "click", "target": "전체결재 탭" },
+        { "type": "type", "target": "검색 입력창", "value": "테스트" },
+        { "type": "click", "target": "검색 버튼" }
+      ],
+      "verify": {
+        "searchApplied": true,
+        "filteredResults": "검색어에 맞는 결과 표시"
+      }
+    }
+  ],
+
+  "mandatoryVerifications": {
+    "description": "E2E_TEST_CONFIG.md 기준 필수 검증 항목",
+    "items": [
+      {
+        "id": 4,
+        "name": "결재 승인/반려 완료",
+        "trigger": "결재 문서 상세의 승인/반려 버튼",
+        "verification": "실제 승인/반려 동작 + API 호출 + 결과 확인",
+        "failCondition": "버튼 존재만 확인, 클릭하지 않음",
+        "steps": ["9", "10"]
+      }
+    ]
+  },
+
+  "expectedAPIs": [
+    "GET /api/v1/approvals/inbox - 결재함 목록 조회",
+    "GET /api/v1/approvals/inbox/summary - 결재함 통계",
+    "GET /api/v1/approvals/{id} - 결재 문서 상세 조회",
+    "POST /api/v1/approvals/{id}/approve - 결재 승인",
+    "POST /api/v1/approvals/{id}/reject - 결재 반려"
+  ],
+
+  "notes": [
+    "⚠️ 404 방지: 반드시 메뉴 클릭으로 페이지 진입 (직접 URL 접근 금지)",
+    "⚠️ 스크롤 필수: 사이드바가 길 경우 메뉴가 화면 밖에 있을 수 있음",
+    "⚠️ 대체 경로: 메뉴명이 변경되었을 수 있으므로 다양한 이름으로 탐색",
+    "메뉴 계층: 결재관리 > 결재함",
+    "탭 전환 시 URL 변경 없이 데이터만 필터링됨"
+  ]
+}