# QA Report - Redmine #3657 (dev)

- Generated: 2026-07-03T09:59:54+09:00
- Redmine: https://itsm.bix.bz/issues/3657
- QA Redmine: https://itsm.bix.bz/issues/3754
- Subject: [QA] 정산내역 엑셀 고유코드 컬럼 추가 검증
- Workflow Status: 진행 중
- Status: PASS
- Result JSON: artifacts/result-summary.json
- Roles: ADMIN
- Route Candidates: not recorded

## Scope

dev 환경 ADMIN 계정으로 정산관리 > 정산내역 화면에서 조회 조건을 적용하고 엑셀을 생성/다운로드한 뒤, 법인/법인하위/상위/상호 고유코드 컬럼 위치와 기존 컬럼 정렬, 화면 조회 대상과 엑셀 데이터 일치 여부를 검증한다.

## Checklist

1. 어드민 정산관리 > 정산내역 화면에서 조회 조건을 선택하고 엑셀 다운로드를 실행했을 때 파일이 정상 생성되는지 확인
2. 다운로드된 엑셀에서 '법인 고유코드' 컬럼이 '법인명' 바로 앞에 표시되는지 확인
3. 다운로드된 엑셀에서 '법인하위 고유코드' 컬럼이 '법인하위 상호명' 바로 앞에 표시되는지 확인
4. 다운로드된 엑셀에서 '상위 고유코드' 컬럼이 '상위 상호명' 바로 앞에 표시되는지 확인
5. 다운로드된 엑셀에서 '상호 고유코드' 컬럼이 '상호명' 바로 앞에 표시되는지 확인
6. 정산일, 구분, 선정산 여부, 은행명, 예금주명, 계좌번호, 매출금, 정산금, 상태, 비고 등 기존 컬럼 값이 밀리거나 누락되지 않았는지 확인
7. 같은 조회 조건에서 화면 목록과 엑셀 다운로드 대상 정산 건이 일치하는지 확인

## Setup Steps

1. [required] ADMIN 개발계 로그인 및 정산내역 접근 (admin/ADMIN / kind: state-verify) - ADMIN 계정으로 개발계 전산에 로그인하고 정산관리 > 정산내역 화면에 접근 가능해야 한다.
2. [required] 고유코드 확인 가능한 정산 데이터 준비 (admin/ADMIN / kind: manual-precondition) - 정산내역 조회 결과와 엑셀에 법인, 법인하위, 상위 상호, 상호명이 포함된 데이터가 있어야 하며 각 항목의 고유코드를 화면/엑셀에서 식별할 수 있어야 한다.

## Source Text

김경주님의 QA 요청입니다. 조지민 프로님 안녕하세요, 비스킷 링크 개발계 QA 요청드립니다. [1] QA 요청 배경 - https://itsm.bix.bz/issues/3657 - 정산관리 > 정산내역 엑셀 다운로드 파일에서 정산대상 식별을 쉽게 할 수 있도록 법인, 법인하위, 상위, 상호명 앞에 각각 고유코드 컬럼을 추가했습니다. [2] 사전 데이터 - 개발계에서 정산내역이 조회되는 법인/영업점/가맹점 정산 데이터 준비 - 고유코드를 확인할 수 있는 법인, 법인하위, 상위 상호, 상호 데이터가 포함된 정산 건 준비. [3] 사전 작업 - admin 계정으로 로그인 가능 여부 확인 - 어드민 > 정산관리 > 정산내역 메뉴 접근 가능 여부 확인 - 정산내역 조회 조건을 선택한 뒤 엑셀 다운로드가 가능한 상태인지 확인. [4] 권한별 테스트 - admin. [5] 검증 대상 - 어드민 정산관리 > 정산내역 화면 - 정산내역 엑셀 다운로드 파일 - 법인/법인하위/상위/상호명 및 각 고유코드 표시. [6] 체크리스트 - 어드민 정산관리 > 정산내역 화면에서 조회 조건을 선택하고 엑셀 다운로드를 실행했을 때 파일이 정상 생성되는지 확인 - 다운로드된 엑셀에서 '법인 고유코드' 컬럼이 '법인명' 바로 앞에 표시되는지 확인 - 다운로드된 엑셀에서 '법인하위 고유코드' 컬럼이 '법인하위 상호명' 바로 앞에 표시되는지 확인 - 다운로드된 엑셀에서 '상위 고유코드' 컬럼이 '상위 상호명' 바로 앞에 표시되는지 확인 - 다운로드된 엑셀에서 '상호 고유코드' 컬럼이 '상호명' 바로 앞에 표시되는지 확인 - 정산일, 구분, 선정산 여부, 은행명, 예금주명, 계좌번호, 매출금, 정산금, 상태, 비고 등 기존 컬럼 값이 밀리거나 누락되지 않았는지 확인 - 같은 조회 조건에서 화면 목록과 엑셀 다운로드 대상 정산 건이 일치하는지 확인

## Execution Summary

- Passed: 3
- Failed: 0
- Skipped: 0
- Blocked: 0
- Flaky: 0
- Duration: 33932ms


## 한눈에 보는 결과

| 확인한 항목 | 계정 | 화면 | 수행한 동작 | 결과 | 증거 자료 |
|---|---|---|---|---|---|
| 어드민 정산관리 > 정산내역 화면에서 조회 조건을 선택하고 엑셀 다운로드를 실행했을 때 파일이 정상 생성되는지 확인 | 전체 | [3657][dev] [QA] 정산내역 엑셀 고유코드 컬럼 추가 검증 | 전체 계정으로 정산내역 엑셀을 요청하고 문서보관함 생성 파일의 은행/계좌 컬럼과 기존 금액/상태/비고 컬럼을 확인 | 기대한 동작과 일치했습니다. | [스크린샷 1](artifacts/screenshots/01-정산내역-ADMIN-settlement-screen.png)<br>[스크린샷 2](artifacts/screenshots/02-정산내역-ADMIN-document-history.png)<br>[실행 기록 1](artifacts/logs/01-정산내역-ADMIN-screen-summary.txt)<br>[실행 기록 2](artifacts/logs/02-정산내역-ADMIN-document-url.md)<br>[실행 기록 3](artifacts/logs/03-정산내역-ADMIN-excel-summary.txt)<br>[파일 1](artifacts/files/01-_-_20260703095920.xlsx) |
| 어드민 정산관리 > 정산내역 화면에서 조회 조건을 선택하고 엑셀 다운로드를 실행했을 때 파일이 정상 생성되는지 확인 | 전체 | [3657][dev] [QA] 정산내역 엑셀 고유코드 컬럼 추가 검증 | 전체 계정으로 정산내역 엑셀을 요청하고 문서보관함 생성 파일의 은행/계좌 컬럼과 기존 금액/상태/비고 컬럼을 확인 | 기대한 동작과 일치했습니다. | [실행 기록 1](artifacts/logs/04-정산내역-ADMIN-document-url.md)<br>[실행 기록 2](artifacts/logs/05-정산내역-ADMIN-code-header-order.txt)<br>[파일 1](artifacts/files/02-_-_20260703095931.xlsx) |
| 어드민 정산관리 > 정산내역 화면에서 조회 조건을 선택하고 엑셀 다운로드를 실행했을 때 파일이 정상 생성되는지 확인 | 전체 | [3657][dev] [QA] 정산내역 엑셀 고유코드 컬럼 추가 검증 | 전체 계정으로 정산내역 엑셀을 요청하고 문서보관함 생성 파일의 은행/계좌 컬럼과 기존 금액/상태/비고 컬럼을 확인 | 기대한 동작과 일치했습니다. | [실행 기록 1](artifacts/logs/06-정산내역-ADMIN-document-url.md)<br>[실행 기록 2](artifacts/logs/07-정산내역-ADMIN-existing-columns-and-targets.txt)<br>[파일 1](artifacts/files/03-_-_20260703095942.xlsx) |

## 실패 또는 확인 불가 상세

- 실패 또는 확인 불가 항목이 없습니다.

## 수동 재현 필요

- 수동 재현이 필요한 항목이 없습니다.

## 스크린샷

- 전체 / [3657][dev] [QA] 정산내역 엑셀 고유코드 컬럼 추가 검증 / 어드민 정산관리 > 정산내역 화면에서 조회 조건을 선택하고 엑셀 다운로드를 실행했을 때 파일이 정상 생성되는지 확인: [스크린샷 1](artifacts/screenshots/01-정산내역-ADMIN-settlement-screen.png)
- 전체 / [3657][dev] [QA] 정산내역 엑셀 고유코드 컬럼 추가 검증 / 어드민 정산관리 > 정산내역 화면에서 조회 조건을 선택하고 엑셀 다운로드를 실행했을 때 파일이 정상 생성되는지 확인: [스크린샷 2](artifacts/screenshots/02-정산내역-ADMIN-document-history.png)

## 화면 재현 기록

- 화면 재현 기록 자료가 없습니다.
- 화면 재현 기록은 기본적으로 실패/확인불가 항목에 한해 포함합니다. PASS 항목 trace까지 필요하면 `QA_PUBLISH_TRACE=1 npm run qa:report -- --issue <id> --env <env>`로 내부 제출용 산출물을 생성합니다.

## 실행 기록

- 전체 / [3657][dev] [QA] 정산내역 엑셀 고유코드 컬럼 추가 검증 / 어드민 정산관리 > 정산내역 화면에서 조회 조건을 선택하고 엑셀 다운로드를 실행했을 때 파일이 정상 생성되는지 확인: [실행 기록 1](artifacts/logs/01-정산내역-ADMIN-screen-summary.txt)
- 전체 / [3657][dev] [QA] 정산내역 엑셀 고유코드 컬럼 추가 검증 / 어드민 정산관리 > 정산내역 화면에서 조회 조건을 선택하고 엑셀 다운로드를 실행했을 때 파일이 정상 생성되는지 확인: [실행 기록 2](artifacts/logs/02-정산내역-ADMIN-document-url.md)
- 전체 / [3657][dev] [QA] 정산내역 엑셀 고유코드 컬럼 추가 검증 / 어드민 정산관리 > 정산내역 화면에서 조회 조건을 선택하고 엑셀 다운로드를 실행했을 때 파일이 정상 생성되는지 확인: [실행 기록 3](artifacts/logs/03-정산내역-ADMIN-excel-summary.txt)
- 전체 / [3657][dev] [QA] 정산내역 엑셀 고유코드 컬럼 추가 검증 / 어드민 정산관리 > 정산내역 화면에서 조회 조건을 선택하고 엑셀 다운로드를 실행했을 때 파일이 정상 생성되는지 확인: [실행 기록 1](artifacts/logs/04-정산내역-ADMIN-document-url.md)
- 전체 / [3657][dev] [QA] 정산내역 엑셀 고유코드 컬럼 추가 검증 / 어드민 정산관리 > 정산내역 화면에서 조회 조건을 선택하고 엑셀 다운로드를 실행했을 때 파일이 정상 생성되는지 확인: [실행 기록 2](artifacts/logs/05-정산내역-ADMIN-code-header-order.txt)
- 전체 / [3657][dev] [QA] 정산내역 엑셀 고유코드 컬럼 추가 검증 / 어드민 정산관리 > 정산내역 화면에서 조회 조건을 선택하고 엑셀 다운로드를 실행했을 때 파일이 정상 생성되는지 확인: [실행 기록 1](artifacts/logs/06-정산내역-ADMIN-document-url.md)
- 전체 / [3657][dev] [QA] 정산내역 엑셀 고유코드 컬럼 추가 검증 / 어드민 정산관리 > 정산내역 화면에서 조회 조건을 선택하고 엑셀 다운로드를 실행했을 때 파일이 정상 생성되는지 확인: [실행 기록 2](artifacts/logs/07-정산내역-ADMIN-existing-columns-and-targets.txt)

## 자동화 원본 결과

| Scenario | Status | Duration | Screenshot | 화면 재현 기록 | Log | Error |
|---|---:|---:|---|---|---|---|
| 3657/dev/settlement-excel-department-codes.spec.ts / [3657][dev] [QA] 정산내역 엑셀 고유코드 컬럼 추가 검증 / 정산내역 엑셀 생성 및 화면 조회 대상 확인 | PASS | 11051ms | [스크린샷 1](artifacts/screenshots/01-정산내역-ADMIN-settlement-screen.png)<br>[스크린샷 2](artifacts/screenshots/02-정산내역-ADMIN-document-history.png) |  | [로그 1](artifacts/logs/01-정산내역-ADMIN-screen-summary.txt)<br>[로그 2](artifacts/logs/02-정산내역-ADMIN-document-url.md)<br>[로그 3](artifacts/logs/03-정산내역-ADMIN-excel-summary.txt) |  |
| 3657/dev/settlement-excel-department-codes.spec.ts / [3657][dev] [QA] 정산내역 엑셀 고유코드 컬럼 추가 검증 / 정산내역 엑셀 고유코드 컬럼 위치 확인 | PASS | 11197ms |  |  | [로그 1](artifacts/logs/04-정산내역-ADMIN-document-url.md)<br>[로그 2](artifacts/logs/05-정산내역-ADMIN-code-header-order.txt) |  |
| 3657/dev/settlement-excel-department-codes.spec.ts / [3657][dev] [QA] 정산내역 엑셀 고유코드 컬럼 추가 검증 / 정산내역 엑셀 기존 컬럼 유지 및 화면 대상 일치 확인 | PASS | 11037ms |  |  | [로그 1](artifacts/logs/06-정산내역-ADMIN-document-url.md)<br>[로그 2](artifacts/logs/07-정산내역-ADMIN-existing-columns-and-targets.txt) |  |

## Notes

- Playwright 실행 결과를 기준으로 작성되었습니다.
- 검토 후 `qa:redmine:update`로 report/evidence를 업로드하고 QA subissue 상태를 갱신합니다.
