{
  "issueId": "3936",
  "environment": "dev",
  "source": "Redmine #3936 + user-provided QA checklist 2026-08-03",
  "scenario": "settlement-segment-column",
  "sourceText": "송인준님의 QA 요청입니다. 비스킷 링크 개발계 정산관리 > 정산내역에서 ADMIN, TA, CO, BO 권한으로 영업라인 검색 필터 선택 가능 여부, 구간 컬럼 추가 여부, 구간 검색 필터 동작, 엑셀 다운로드 시 구간 컬럼 추가 여부를 확인한다.",
  "scope": "개발계 비스킷 링크 정산관리 > 정산내역 화면에서 ADMIN/TA/CO/BO별 영업라인(정산대상) 선택 필터와 구간 신고/비신고 필터를 조작하고, 목록 구간 컬럼 및 정산내역 엑셀 구간 헤더를 검증한다.",
  "roles": [
    "ADMIN",
    "TA",
    "CO",
    "BO"
  ],
  "subjectAccounts": [
    {
      "role": "ADMIN",
      "label": "ADMIN 개발계 계정",
      "envRole": "ADMIN"
    },
    {
      "role": "TA",
      "label": "TA 개발계 계정",
      "envRole": "TA"
    },
    {
      "role": "CO",
      "label": "CO 개발계 계정",
      "envRole": "CO"
    },
    {
      "role": "BO",
      "label": "BO 개발계 계정",
      "envRole": "BO"
    }
  ],
  "checklist": [
    "ADMIN, TA, CO, BO 권한으로 정산내역 화면에 진입하고 영업라인 검색 필터(화면의 정산대상 선택 컨트롤)를 선택할 수 있는지 확인",
    "정산내역 목록에 구간 컬럼이 추가되어 구간 값이 표시되는지 확인",
    "구간 검색 필터가 신고/비신고 선택과 재조회에 반영되는지 확인",
    "각 권한으로 정산내역 엑셀을 다운로드했을 때 구간 컬럼이 포함되는지 확인"
  ],
  "setupSteps": [
    {
      "name": "권한별 개발계 로그인 및 정산내역 접근",
      "kind": "state-verify",
      "role": "ADMIN",
      "targetRoles": [
        "ADMIN",
        "TA",
        "CO",
        "BO"
      ],
      "application": "admin",
      "description": "ADMIN, TA, CO, BO 계정으로 개발계 비스킷 링크에 로그인하고 정산관리 > 정산내역 화면에 접근할 수 있어야 한다.",
      "required": true,
      "mutation": "none",
      "navigation": {
        "name": "정산내역",
        "path": "/settlement-history/settlement-details"
      }
    },
    {
      "name": "영업라인 및 신고/비신고 정산 데이터 확인",
      "kind": "manual-precondition",
      "role": "ADMIN",
      "targetRoles": [
        "ADMIN",
        "TA",
        "CO",
        "BO"
      ],
      "application": "admin",
      "description": "각 권한 범위에서 정산내역 조회가 가능하고, 영업라인 선택 후보 및 신고/비신고 구간 값이 확인 가능한 정산 데이터가 준비되어 있어야 한다.",
      "required": true,
      "mutation": "none"
    }
  ],
  "pages": [
    {
      "name": "정산내역",
      "application": "admin",
      "path": "/settlement-history/settlement-details",
      "tenantParam": "tenantId",
      "roles": [
        "ADMIN",
        "TA",
        "CO",
        "BO"
      ],
      "searchButtonSelector": "button:has-text('검색'), button:has-text('조회'), [data-testid='search-button']",
      "recordsSelector": "table tbody tr, [role='row']",
      "excelDocumentPath": "/document",
      "excelDocumentFileNameIncludes": "정산내역",
      "excelDocumentDownloadSelector": "a:has-text(\"다운로드\"), button:has-text(\"다운로드\"), [role='button']:has-text(\"다운로드\")",
      "excelResponseUrlPattern": "\\.xlsx(\\?|$)|cloudflarestorage.*excel",
      "excelDocumentReadyTimeoutMs": 90000,
      "excelExpectedColumnHeaders": [
        "구간"
      ],
      "dataRequestUrlPattern": "settlement",
      "filters": [
        {
          "name": "구간",
          "label": "구간",
          "type": "combobox",
          "value": "신고",
          "queryParamCandidates": [
            "isReport",
            "segment",
            "settlementSegment"
          ]
        },
        {
          "name": "영업라인",
          "label": "정산대상",
          "type": "combobox",
          "value": "선택"
        }
      ]
    }
  ]
}