Files
sam-hotfix/testcase/TC_DASHBOARD.md
김보곤 4765cd5484 test: E2E 테스트 결과 정리 및 TC 문서 업데이트
- 이전 테스트 결과 파일 정리 (Fail-*, OK-* 삭제)
- testcase 11개 문서 업데이트
- 시나리오 품질 현황 문서 수정

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-06 14:14:18 +09:00

16 KiB

TC - 대시보드 (Dashboard)

페이지: https://dev.codebridge-x.com/dashboard 작성일: 2026-01-29 대상: QC Playwright AI 테스트용


⚠️ 테스트 환경 안내

항목 내용
환경 유형 개발/테스트 환경 (Development Environment)
운영 환경 여부 아니오 - 운영 환경이 아닙니다
데이터 특성 테스트용 시드 데이터 및 개발 중 생성된 샘플 데이터
테스트 정책 조회 중심 테스트, 위젯 설정 변경 가능

테스트 실행 지침

  1. 조회 테스트: 대시보드는 주로 데이터 조회 및 시각화 기능을 테스트합니다.

  2. 위젯 설정 테스트: 위젯 배치, 크기 조절, 설정 변경 등을 테스트합니다.

  3. 성능 확인: 대시보드 로딩 시간 및 차트 렌더링 성능을 확인합니다.


0. 사이드바 메뉴 탐색 (공통 전제 조건)

0.1 메뉴 펼치기

TC# 구분 테스트 항목 기대 결과
NAV-001 전제 사이드바 최상단 스크롤 사이드바가 최상단으로 스크롤
NAV-002 전제 "모두 펼치기" 버튼 클릭 사이드바의 모든 메뉴가 펼쳐짐
NAV-003 전제 메뉴 펼침 대기 2초 대기 후 모든 메뉴 펼침 완료
NAV-004 기능 대시보드 메뉴 찾기 스크롤 없이 대시보드 메뉴 클릭 가능
NAV-005 기능 대시보드 클릭 대시보드 메뉴 클릭
NAV-006 기능 페이지 로드 확인 404 없이 정상 페이지 로드

💡 참고: "모두 펼치기" 버튼으로 전체 메뉴를 펼친 후 메뉴를 탐색하면 1차 메뉴를 누르지 못해 찾지 못하는 문제를 방지할 수 있습니다.


1. 페이지 로딩

1.1 기본 로딩

TC# 구분 테스트 항목 기대 결과
L-001 기본 페이지 접근 /dashboard 정상 로딩
L-002 기본 로딩 인디케이터 데이터 로딩 중 스피너/스켈레톤 표시
L-003 기본 기본 레이아웃 그리드 형태 위젯 레이아웃 표시
L-004 기본 사용자별 설정 저장된 대시보드 설정 로드
L-005 기본 첫 로그인 기본값 기본 위젯 구성으로 표시
L-006 성능 로딩 시간 3초 이내 메인 컨텐츠 표시

1.2 헤더 영역

TC# 구분 테스트 항목 기대 결과
L-010 UI 페이지 타이틀 "대시보드" 타이틀 표시
L-011 기능 기간 선택 오늘/이번주/이번달/지난달/직접입력
L-012 기능 기간 변경 적용 기간 변경 시 위젯 데이터 갱신
L-013 기능 새로고침 버튼 클릭 시 전체 데이터 새로고침
L-014 기능 마지막 갱신 시간 마지막 데이터 갱신 시간 표시
L-015 기능 위젯 설정 버튼 위젯 편집 모드 진입

2. KPI 카드 위젯

2.1 매출 KPI

TC# 구분 테스트 항목 기대 결과
K-001 기본 매출액 카드 선택 기간 총 매출액 표시
K-002 UI 금액 포맷 천단위 콤마 + "원" 표시
K-003 UI 전기 대비 전월/전주 대비 증감률 표시
K-004 UI 증가 표시 증가 시 초록색 화살표 ↑
K-005 UI 감소 표시 감소 시 빨간색 화살표 ↓
K-006 기능 카드 클릭 상세 매출 페이지로 이동

2.2 주문 KPI

TC# 구분 테스트 항목 기대 결과
K-010 기본 주문건수 카드 선택 기간 총 주문 건수
K-011 UI 건수 포맷 숫자 + "건" 표시
K-012 UI 전기 대비 전월/전주 대비 증감 표시
K-013 기능 카드 클릭 주문 목록 페이지로 이동

2.3 고객/거래처 KPI

TC# 구분 테스트 항목 기대 결과
K-020 기본 신규 고객 카드 신규 등록 고객/거래처 수
K-021 기본 활성 고객 카드 최근 거래 있는 고객 수
K-022 기능 카드 클릭 고객/거래처 목록으로 이동

2.4 재고/품목 KPI

TC# 구분 테스트 항목 기대 결과
K-030 기본 품목 수 카드 등록된 총 품목 수
K-031 기본 재고 부족 카드 안전재고 미만 품목 수
K-032 UI 경고 표시 재고 부족 시 빨간색 강조
K-033 기능 카드 클릭 재고 현황 페이지로 이동

2.5 미수금/미지급금 KPI

TC# 구분 테스트 항목 기대 결과
K-040 기본 미수금 총액 카드 미수금 총액 표시
K-041 기본 미지급금 총액 카드 미지급금 총액 표시
K-042 UI 금액 색상 금액 높을수록 빨간색 강조
K-043 기능 카드 클릭 미수금/미지급금 상세로 이동

3. 차트 위젯

3.1 매출 추이 차트

TC# 구분 테스트 항목 기대 결과
C-001 기본 차트 표시 기간별 매출 추이 라인/바 차트
C-002 UI X축 기간 (일/주/월) 표시
C-003 UI Y축 금액 표시 (자동 스케일)
C-004 기능 호버 툴팁 데이터 포인트 호버 시 상세 정보
C-005 기능 차트 유형 전환 라인/바/영역 차트 전환
C-006 기능 데이터 범위 월간/분기/연간 선택
C-007 기능 전년 비교 전년 동기 데이터 오버레이
C-008 성능 렌더링 시간 1초 이내 차트 표시

3.2 주문 현황 차트

TC# 구분 테스트 항목 기대 결과
C-010 기본 차트 표시 주문 상태별 파이/도넛 차트
C-011 UI 범례 상태별 색상 범례 표시
C-012 UI 비율 표시 각 상태별 비율(%) 표시
C-013 기능 호버 툴팁 상태 호버 시 건수/금액 표시
C-014 기능 범례 클릭 클릭 시 해당 상태 데이터 토글

3.3 카테고리별 매출 차트

TC# 구분 테스트 항목 기대 결과
C-020 기본 차트 표시 카테고리별 매출 막대/파이 차트
C-021 UI 색상 구분 카테고리별 다른 색상
C-022 기능 정렬 매출 높은순/낮은순 정렬
C-023 기능 Top N 상위 N개만 표시 옵션

3.4 거래처별 매출 차트

TC# 구분 테스트 항목 기대 결과
C-030 기본 차트 표시 거래처별 매출 막대 차트
C-031 기능 Top 10 상위 10개 거래처 표시
C-032 기능 거래처 클릭 거래처 상세 페이지로 이동

3.5 일별/시간별 패턴 차트

TC# 구분 테스트 항목 기대 결과
C-040 기본 차트 표시 요일/시간별 주문 패턴 히트맵
C-041 UI 색상 강도 주문 많을수록 진한 색상
C-042 기능 호버 상세 셀 호버 시 구체적 수치

4. 목록 위젯

4.1 최근 주문 목록

TC# 구분 테스트 항목 기대 결과
W-001 기본 목록 표시 최근 5~10건 주문 표시
W-002 UI 주문 정보 주문번호, 거래처, 금액, 상태
W-003 UI 상태 뱃지 상태별 색상 뱃지
W-004 기능 행 클릭 주문 상세 페이지로 이동
W-005 기능 더보기 "더보기" 클릭 시 주문 목록으로 이동
W-006 기능 자동 갱신 새 주문 시 실시간 반영 (설정에 따라)

4.2 처리 필요 항목

TC# 구분 테스트 항목 기대 결과
W-010 기본 목록 표시 승인 대기, 미처리 항목 목록
W-011 UI 항목 유형 결재, 주문, 발주 등 유형 표시
W-012 UI 긴급 표시 긴급 항목 빨간색 강조
W-013 기능 항목 클릭 해당 상세 페이지로 이동
W-014 기능 빠른 처리 간단한 항목 즉시 처리 버튼

4.3 재고 부족 알림

TC# 구분 테스트 항목 기대 결과
W-020 기본 목록 표시 안전재고 미만 품목 목록
W-021 UI 품목 정보 품목명, 현재고, 안전재고
W-022 UI 부족량 표시 부족 수량 빨간색 표시
W-023 기능 품목 클릭 품목 상세 또는 발주 페이지
W-024 기능 발주 바로가기 "발주하기" 버튼

4.4 최근 활동 로그

TC# 구분 테스트 항목 기대 결과
W-030 기본 목록 표시 최근 시스템 활동 로그
W-031 UI 활동 정보 시간, 사용자, 활동 내용
W-032 UI 활동 아이콘 활동 유형별 아이콘
W-033 기능 타임라인 형태 시간순 타임라인 표시

5. 위젯 커스터마이징

5.1 편집 모드

TC# 구분 테스트 항목 기대 결과
E-001 기능 편집 모드 진입 설정 버튼 클릭 시 편집 모드
E-002 UI 편집 모드 표시 위젯 테두리, 이동/크기 핸들 표시
E-003 기능 위젯 드래그 위젯 위치 드래그앤드롭 이동
E-004 기능 위젯 크기 조절 모서리 드래그로 크기 조절
E-005 기능 위젯 삭제 X 버튼 클릭 시 위젯 제거
E-006 기능 위젯 추가 "위젯 추가" 버튼으로 새 위젯
E-007 기능 저장 변경사항 저장
E-008 기능 취소 변경사항 취소 + 원복
E-009 기능 기본값 복원 기본 레이아웃으로 초기화

5.2 위젯 설정

TC# 구분 테스트 항목 기대 결과
E-010 기능 위젯 설정 모달 위젯 기어 아이콘 클릭
E-011 기능 차트 유형 변경 라인/바/파이 등 유형 선택
E-012 기능 데이터 범위 설정 표시할 기간/개수 설정
E-013 기능 색상 테마 차트 색상 테마 선택
E-014 기능 자동 갱신 자동 갱신 간격 설정

5.3 위젯 라이브러리

TC# 구분 테스트 항목 기대 결과
E-020 기능 위젯 목록 사용 가능한 위젯 목록 표시
E-021 UI 위젯 미리보기 위젯 썸네일/설명 표시
E-022 기능 위젯 검색 위젯명으로 검색
E-023 기능 카테고리 필터 KPI/차트/목록/알림 카테고리
E-024 기능 위젯 추가 클릭 또는 드래그로 추가

6. 알림 및 실시간 업데이트

6.1 실시간 알림

TC# 구분 테스트 항목 기대 결과
N-001 기능 새 주문 알림 새 주문 발생 시 토스트 알림
N-002 기능 결재 요청 알림 결재 요청 시 알림
N-003 기능 재고 경고 알림 안전재고 미만 시 알림
N-004 기능 알림 센터 알림 목록 확인 패널
N-005 기능 알림 읽음 처리 알림 클릭 시 읽음 표시
N-006 기능 알림 설정 알림 종류별 ON/OFF 설정

6.2 자동 데이터 갱신

TC# 구분 테스트 항목 기대 결과
N-010 기능 자동 갱신 설정된 간격으로 데이터 갱신
N-011 UI 갱신 중 표시 갱신 중 인디케이터 표시
N-012 기능 갱신 간격 설정 1분/5분/10분/수동 선택
N-013 비즈 백그라운드 갱신 탭 비활성 시 갱신 정책

7. 다중 대시보드

TC# 구분 테스트 항목 기대 결과
D-001 기능 대시보드 생성 새 대시보드 생성
D-002 기능 대시보드 이름 대시보드 이름 설정
D-003 기능 대시보드 전환 탭/드롭다운으로 대시보드 전환
D-004 기능 대시보드 복사 기존 대시보드 복사
D-005 기능 대시보드 삭제 대시보드 삭제 (기본 대시보드 제외)
D-006 기능 기본 대시보드 설정 로그인 시 기본 표시 대시보드

8. 모바일 반응형

TC# 구분 테스트 항목 기대 결과
M-001 UI 모바일 레이아웃 위젯 세로 배치 (1열)
M-002 UI KPI 카드 가로 스크롤 또는 2열 그리드
M-003 UI 차트 반응형 차트 크기 자동 조절
M-004 UI 목록 축소 목록 항목 수 축소
M-005 기능 터치 스크롤 매끄러운 스크롤
M-006 기능 풀 투 리프레시 당겨서 새로고침
M-007 UI 위젯 편집 모바일 모바일 위젯 편집 제한적 지원

9. 성능 테스트

TC# 구분 테스트 항목 기대 결과
P-001 성능 초기 로딩 시간 3초 이내 메인 컨텐츠 표시
P-002 성능 차트 렌더링 1초 이내 차트 표시
P-003 성능 기간 변경 반응 2초 이내 데이터 갱신
P-004 성능 위젯 드래그 끊김 없는 드래그 애니메이션
P-005 성능 메모리 사용량 장시간 사용 시 메모리 누수 없음
P-006 성능 대량 데이터 대량 데이터에서도 정상 동작

10. API 응답 검증

TC# 구분 테스트 항목 기대 결과
API-001 API GET /dashboard/kpi 응답 KPI 데이터 반환
API-002 API GET /dashboard/charts 응답 차트 데이터 반환
API-003 API GET /dashboard/lists 응답 목록 데이터 반환
API-004 API GET /dashboard/settings 응답 사용자 대시보드 설정
API-005 API PUT /dashboard/settings 응답 설정 저장 결과
API-006 API 병렬 요청 여러 위젯 데이터 동시 요청
API-007 API 멀티테넌트 격리 다른 tenant 데이터 접근 불가

11. 데이터 정합성

TC# 구분 테스트 항목 기대 결과
I-001 비즈 KPI 수치 일치 대시보드 수치 = 상세 페이지 합계
I-002 비즈 차트 데이터 일치 차트 합계 = KPI 수치
I-003 비즈 기간 계산 정확성 선택 기간 데이터 정확 집계
I-004 비즈 실시간 반영 신규 데이터 즉시 반영
I-005 비즈 권한별 데이터 권한에 따른 데이터 범위

TC 요약

카테고리 건수
페이지 로딩 15건
KPI 카드 위젯 18건
차트 위젯 24건
목록 위젯 15건
위젯 커스터마이징 24건
알림 및 실시간 업데이트 10건
다중 대시보드 6건
모바일 반응형 7건
성능 테스트 6건
API 응답 검증 7건
데이터 정합성 5건
합계 137건

참고: 구분 체계

  • 기본: 페이지 로딩, 기본 표시
  • 기능: 사용자 인터랙션, 설정 변경
  • UI: 색상, 레이아웃, 애니메이션 등 시각 요소
  • 성능: 로딩 시간, 렌더링 성능
  • 비즈: 비즈니스 로직 (데이터 집계, 권한 등)
  • API: API 레벨 검증