sam-hotfix/testcase/TC_DASHBOARD.md

# 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 레벨 검증