Files
sam-hotfix/vendor-ledger_2026-01-15_10-30-00.md
2026-01-15 21:18:34 +09:00

7.9 KiB

E2E Test Report: 거래처원장 (Vendor Ledger)

Test ID: vendor-ledger Executed: 2026-01-15 10:30:00 Duration: ~5 minutes Status: ⚠️ PARTIAL PASS (2 FAIL / 12 PASS)


Summary

Item Result
Total Steps 14
Passed 12
Failed 2
Pass Rate 85.7%

Step Results

Step Name Status Duration Notes
1 로그인 PASS - 이미 로그인 상태
2 회계관리 > 거래처원장 메뉴 진입 PASS ~2s 정상 이동
3 필수 검증 #5: 목업 페이지 감지 PASS - 정상 페이지 (목업 아님)
4 통계 카드 확인 PASS - 4개 카드 모두 표시
5 테이블 구조 확인 PASS - 8개 컬럼, 합계 행 존재
6 기간 설정 - 당해년도 PASS ~1s 종료일 2026-12-31로 변경
7 검색 기능 - "가우스" PASS ~1s 1건 필터링
8 검색 초기화 PASS ~1s 5건 복원
9 엑셀 다운로드 FAIL ~1s API 오류: 404
10 테이블 행 클릭 - 상세 페이지 이동 PASS ~2s 정상 이동 + URL 파라미터 전달
11 상세 페이지 - 거래처 정보 카드 PASS - 모든 정보 표시
12 상세 페이지 - 요약 통계 PASS - 4개 통계 표시
13 PDF 다운로드 FAIL ~1s API 오류: 404
14 목록 버튼 클릭 - 목록 복귀 PASS ~1s 정상 복귀

필수 검증 결과

필수 검증 #1: 파일 다운로드 (엑셀/PDF)

항목 예상 실제 결과
엑셀 다운로드 버튼 클릭 API 호출 + 다운로드 "API 오류: 404" 토스트 FAIL
PDF 다운로드 버튼 클릭 API 호출 + 다운로드 "API 오류: 404" 토스트 FAIL

분석:

  • /api/v1/vendor-ledger/export 엔드포인트 404 에러
  • /api/v1/vendor-ledger/{id}/export-pdf 엔드포인트 404 에러
  • 원인: 백엔드 API 미구현 또는 엔드포인트 경로 불일치

필수 검증 #3: 검색/필터

항목 예상 실제 결과
기간 설정 (당해년도) 종료일 변경 2026-12-31로 변경 PASS
검색 ("가우스") 필터링 적용 1건 표시 (가우스전자) PASS
검색 초기화 전체 표시 5건 복원 PASS

필수 검증 #5: 목업 페이지 감지

감지 항목 결과 비고
입력 필드 존재 검색창, 날짜 선택
동작하는 버튼 존재 기간 버튼, 체크박스
테이블 데이터 표시 5개 거래처 데이터
API 호출 확인 /accounting/vendor-ledger POST 성공

판정: 정상 페이지 (목업 아님)


페이지 검증 상세

목록 페이지 (/accounting/vendor-ledger)

통계 카드 (4개):

카드 상태
전기 이월 565,970,679원
매출 0원
수금 0원
잔액 565,970,679원

테이블 구조 (8개 컬럼):

컬럼 존재
체크박스
No.
거래처명
이월잔액
매출
수금
잔액
결제일

데이터 행 (5건):

No. 거래처명 이월잔액 잔액 결제일
1 가우스전자 284,445,386 284,445,386 말일
2 거래처테스트 - - 말일
3 아크더레드 430,875,859 430,875,859 말일
4 아크아크 499,284,261 499,284,261 25일
5 코브라브릿지 508,605,296 508,605,296 25일

합계 행: 이월잔액 1,723,210,802원, 잔액 1,723,210,802원

상세 페이지 (/accounting/vendor-ledger/{id})

URL 파라미터 전달: PASS

  • start_date=2026-01-01
  • end_date=2026-12-31

거래처 정보 카드:

필드 상태
회사명 가우스전자
사업자등록번호 1121212334
대표자 데우스엑스마키나
전화번호 010-1235-1234
모바일 -
팩스 -
이메일 -
주소 서울시 이세카이 오마카세
기간 2026-01-01 ~ 2026-12-31

요약 통계:

항목 상태
이월잔액 284,445,386원
매출 0원 (녹색)
수금 0원 (파란색)
잔액 284,445,386원

거래 내역 테이블: "거래 내역이 없습니다." (해당 기간 데이터 없음)


Errors (Bug Reports for Developer)

🐛 Bug #1: 엑셀 다운로드 API 404 오류

Report ID: VL-BUG-001 Priority: High Component: C:\Users\codeb\react\src\components\accounting\VendorLedger\actions.ts:362-419

Issue Summary

거래처원장 목록 페이지에서 "엑셀 다운로드" 버튼 클릭 시 API 404 오류 발생

Steps to Reproduce

  1. 거래처원장 목록 페이지 진입 (/accounting/vendor-ledger)
  2. "엑셀 다운로드" 버튼 클릭
  3. "API 오류: 404" 토스트 메시지 표시

Expected Result

  • Network API 호출: GET /api/v1/vendor-ledger/export
  • Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
  • 파일 다운로드 이벤트 발생
  • 성공 토스트: "엑셀 파일이 다운로드되었습니다."

Actual Result

  • API 호출 시 404 응답
  • 에러 토스트: "API 오류: 404"
  • 파일 다운로드 없음

Suggested Fix (Reference Only)

  • 백엔드 API 엔드포인트 /api/v1/vendor-ledger/export 구현 필요
  • 또는 프론트엔드 API URL 경로 확인 필요

영향 범위: api / react 변경 승인 정책: ⚠️ 컨펌 필요

  • SAM 정책: C:\Users\codeb\.claude\skills\sam_policy\SKILL.md
  • 문서 인덱스: C:\Users\codeb\docs\INDEX.md
  • API 규칙: C:\Users\codeb\docs\standards\api-rules.md

🐛 Bug #2: PDF 다운로드 API 404 오류

Report ID: VL-BUG-002 Priority: High Component: C:\Users\codeb\react\src\components\accounting\VendorLedger\actions.ts:421-477

Issue Summary

거래처원장 상세 페이지에서 "PDF 다운로드" 버튼 클릭 시 API 404 오류 발생

Steps to Reproduce

  1. 거래처원장 상세 페이지 진입 (/accounting/vendor-ledger/{id})
  2. "PDF 다운로드" 버튼 클릭
  3. "API 오류: 404" 토스트 메시지 표시

Expected Result

  • Network API 호출: GET /api/v1/vendor-ledger/{id}/export-pdf
  • Content-Type: application/pdf
  • 파일 다운로드 이벤트 발생
  • 성공 토스트: "PDF 파일이 다운로드되었습니다."

Actual Result

  • API 호출 시 404 응답
  • 에러 토스트: "API 오류: 404"
  • 파일 다운로드 없음

Suggested Fix (Reference Only)

  • 백엔드 API 엔드포인트 /api/v1/vendor-ledger/{id}/export-pdf 구현 필요
  • 또는 프론트엔드 API URL 경로 확인 필요

영향 범위: api / react 변경 승인 정책: ⚠️ 컨펌 필요

  • SAM 정책: C:\Users\codeb\.claude\skills\sam_policy\SKILL.md
  • 문서 인덱스: C:\Users\codeb\docs\INDEX.md
  • API 규칙: C:\Users\codeb\docs\standards\api-rules.md

Test Environment


Recommendations

  1. 높은 우선순위: 엑셀/PDF 다운로드 API 구현 필요

    • /api/v1/vendor-ledger/export
    • /api/v1/vendor-ledger/{id}/export-pdf
  2. 확인 필요: 백엔드 API 엔드포인트 경로와 프론트엔드 호출 URL 일치 여부 확인

  3. 추가 테스트 권장:

    • 거래 내역 데이터가 있는 거래처로 상세 페이지 테스트
    • 페이지네이션 동작 테스트 (데이터가 많을 때)