sam-hotfix/testcase/TC_PAYMENT_MANAGEMENT.md

# TC - 입출금관리 (Payment Management)

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

---

## ⚠️ 테스트 환경 안내

| 항목 | 내용 |
|------|------|
| **환경 유형** | 개발/테스트 환경 (Development Environment) |
| **운영 환경 여부** | ❌ 아니오 - 운영 환경이 **아닙니다** |
| **데이터 특성** | 테스트용 시드 데이터 및 개발 중 생성된 샘플 데이터 |
| **테스트 정책** | CRUD 전체 테스트 가능 (생성, 수정, 삭제 포함) |

### 테스트 실행 지침

1. **CRUD 테스트 허용**: 이 환경은 개발/테스트 목적으로, 데이터 생성·수정·삭제를 포함한 전체 기능 테스트를 수행해야 합니다.

2. **입출금 등록 테스트**: 신규 입출금(D-080~D-095) 테스트 시 실제 데이터를 생성하여 기능 검증을 수행합니다.

3. **데이터 삭제 테스트**: 삭제 테스트는 테스트 중 생성한 데이터를 대상으로 실행합니다.

4. **테스트 데이터 정리**: 테스트 완료 후 생성된 테스트 데이터는 삭제하여 환경을 정리합니다.

---

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

### 0.1 메뉴 펼치기

| TC# | 구분 | 테스트 항목 | 기대 결과 |
|-----|------|------------|-----------|
| NAV-001 | 전제 | 사이드바 최상단 스크롤 | 사이드바가 최상단으로 스크롤 |
| NAV-002 | 전제 | "모두 펼치기" 버튼 클릭 | 사이드바의 모든 메뉴가 펼쳐짐 |
| NAV-003 | 전제 | 메뉴 펼침 대기 | 2초 대기 후 모든 메뉴 펼침 완료 |
| NAV-004 | 기능 | 1차 메뉴 찾기 | 스크롤 없이 1차 메뉴(회계관리) 클릭 가능 |
| NAV-005 | 기능 | 2차 메뉴 클릭 | 펼쳐진 서브메뉴에서 입출금관리 클릭 |
| NAV-006 | 기능 | 페이지 로드 확인 | 404 없이 정상 페이지 로드 |

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

---

## 1. 목록 페이지 (List View)

### 1.1 페이지 로딩

| TC# | 구분 | 테스트 항목 | 기대 결과 |
|-----|------|------------|-----------|
| L-001 | 기본 | 페이지 접근 | `/accounting/deposits` 정상 로딩, 테이블 표시 |
| L-002 | 기본 | 통계 카드 표시 | "총 입금", "총 출금", "잔액", "이번 달" 4개 카드 |
| L-003 | 기본 | 입출금 차트 | 월별/주별 입출금 추이 차트 표시 |
| L-004 | 기본 | 기본 정렬 | 최신순(거래일 내림차순) 정렬 |
| L-005 | 기본 | 빈 목록 | 데이터 없을 때 빈 상태 메시지 표시 |
| L-006 | 기본 | 계좌별 잔액 | 등록된 계좌별 현재 잔액 표시 |

### 1.2 테이블 컬럼

| TC# | 구분 | 테스트 항목 | 기대 결과 |
|-----|------|------------|-----------|
| L-010 | 기본 | 컬럼 구성 | 체크박스, 번호, 거래일, 구분, 거래처, 계좌, 입금, 출금, 잔액, 적요, 작업 |
| L-011 | UI | 구분 뱃지 색상 | 입금=초록, 출금=빨강, 이체=파랑 |
| L-012 | UI | 금액 포맷 | 천단위 콤마 + "원" 표시 |
| L-013 | UI | 입금 표시 | 입금액 초록색, 출금 빨간색 |
| L-014 | UI | 잔액 변동 | 각 거래 후 잔액 표시 |
| L-015 | UI | 미확인 거래 표시 | 미확인 거래 노란 뱃지 표시 |

### 1.3 검색

| TC# | 구분 | 테스트 항목 | 기대 결과 |
|-----|------|------------|-----------|
| L-020 | 기능 | 거래처명 검색 | 거래처명 입력 시 해당 거래만 필터링 |
| L-021 | 기능 | 적요 검색 | 적요 내용으로 검색 |
| L-022 | 기능 | 금액 검색 | 특정 금액으로 검색 |
| L-023 | 기능 | 계좌번호 검색 | 계좌번호로 검색 |
| L-024 | 기능 | 검색어 지우기 | 검색어 삭제 시 전체 목록 복원 |
| L-025 | 경계 | 빈 검색어 | 전체 목록 표시 |
| L-026 | 경계 | 존재하지 않는 검색어 | 빈 결과 + "검색 결과 없음" 메시지 |

### 1.4 필터

| TC# | 구분 | 테스트 항목 | 기대 결과 |
|-----|------|------------|-----------|
| L-030 | 기능 | 구분 필터 - 입금 | 입금 거래만 표시 |
| L-031 | 기능 | 구분 필터 - 출금 | 출금 거래만 표시 |
| L-032 | 기능 | 구분 필터 - 이체 | 계좌 이체만 표시 |
| L-033 | 기능 | 기간 필터 | 거래일 시작~종료 범위 내 표시 |
| L-034 | 기능 | 기간 단축 필터 | 오늘/이번 주/이번 달/지난 달/직접입력 |
| L-035 | 기능 | 계좌 필터 | 특정 계좌 거래만 표시 |
| L-036 | 기능 | 거래처 필터 | 특정 거래처 거래만 표시 |
| L-037 | 기능 | 금액 범위 필터 | 설정한 금액 범위 내 거래만 표시 |
| L-038 | 기능 | 확인 상태 필터 | 확인/미확인 거래 필터 |
| L-039 | 기능 | 필터 복합 적용 | 구분 + 기간 + 계좌 동시 적용 시 AND 조건 |
| L-040 | 기능 | 필터 해제 | 필터 해제 시 전체 목록 복원 |
| L-041 | 경계 | 필터 결과 0건 | 빈 상태 메시지 표시, 에러 없음 |

### 1.5 정렬

| TC# | 구분 | 테스트 항목 | 기대 결과 |
|-----|------|------------|-----------|
| L-050 | 기능 | 최신순 | 거래일 내림차순 |
| L-051 | 기능 | 등록순 | 거래일 오름차순 |
| L-052 | 기능 | 금액 높은순 | 거래금액 내림차순 |
| L-053 | 기능 | 금액 낮은순 | 거래금액 오름차순 |
| L-054 | 기능 | 거래처명순 | 거래처명 가나다순 |

### 1.6 페이지네이션

| TC# | 구분 | 테스트 항목 | 기대 결과 |
|-----|------|------------|-----------|
| L-060 | 기능 | 기본 페이지 크기 | 한 페이지 50건 표시 (거래 특성상 많은 건수) |
| L-061 | 기능 | 페이지 크기 변경 | 20/50/100/200건 선택 가능 |
| L-062 | 기능 | 다음 페이지 이동 | 다음 페이지로 이동 |
| L-063 | 기능 | 이전 페이지 이동 | 이전 페이지로 복귀 |
| L-064 | 경계 | 마지막 페이지 | "다음" 버튼 비활성화 |
| L-065 | 경계 | 첫 페이지 | "이전" 버튼 비활성화 |

### 1.7 행 선택 및 동작

| TC# | 구분 | 테스트 항목 | 기대 결과 |
|-----|------|------------|-----------|
| L-070 | 기능 | 행 클릭 | 상세 페이지(view 모드)로 이동 |
| L-071 | 기능 | 체크박스 개별 선택 | 해당 행 선택 상태 |
| L-072 | 기능 | 전체 선택 체크박스 | 현재 페이지 전체 선택/해제 |
| L-073 | 기능 | 호버 시 작업 버튼 | 수정/삭제/확인 버튼 표시 |
| L-074 | 기능 | 수정 버튼 클릭 | 상세 페이지(edit 모드)로 이동 |
| L-075 | 기능 | 삭제 버튼 클릭 | 삭제 확인 다이얼로그 표시 |
| L-076 | 기능 | 확인 버튼 클릭 | 거래 확인 상태로 변경 |
| L-077 | 비즈 | 마감된 거래 삭제 | 삭제 불가 에러 메시지 |
| L-078 | 비즈 | 연결된 전표 있는 거래 | 삭제 시 경고 메시지 |

### 1.8 일괄 처리

| TC# | 구분 | 테스트 항목 | 기대 결과 |
|-----|------|------------|-----------|
| L-080 | 기능 | 일괄 확인 | 다중 선택 → 일괄 확인 처리 |
| L-081 | 기능 | 일괄 삭제 | 다중 선택 → 일괄 삭제 |
| L-082 | 기능 | Excel 내보내기 | 거래 목록 Excel 다운로드 |
| L-083 | 기능 | Excel 가져오기 | Excel 파일로 거래 일괄 등록 |
| L-084 | 기능 | 은행 자동수집 | 은행 거래내역 자동 수집 (연동 시) |

### 1.9 신규 등록 버튼

| TC# | 구분 | 테스트 항목 | 기대 결과 |
|-----|------|------------|-----------|
| L-090 | 기능 | 입금 등록 버튼 | 클릭 시 입금 등록 페이지로 이동 |
| L-091 | 기능 | 출금 등록 버튼 | 클릭 시 출금 등록 페이지로 이동 |
| L-092 | 기능 | 이체 등록 버튼 | 클릭 시 이체 등록 페이지로 이동 |

---

## 2. 입금 등록 페이지

### 2.1 입금 등록 (mode=new)

| TC# | 구분 | 테스트 항목 | 기대 결과 |
|-----|------|------------|-----------|
| D-001 | 기본 | 페이지 로딩 | 빈 폼 표시, 저장/취소 버튼 |
| D-002 | 기본 | 기본값 확인 | 거래일=오늘, 구분=입금 |
| D-003 | 기본 | 계좌 선택 기본값 | 기본 계좌 자동 선택 |

#### 2.1.1 필수값 검증

| TC# | 구분 | 테스트 항목 | 기대 결과 |
|-----|------|------------|-----------|
| D-010 | 검증 | 거래일 미입력 | 저장 시 필수값 에러 메시지 |
| D-011 | 검증 | 계좌 미선택 | 저장 시 필수값 에러 메시지 |
| D-012 | 검증 | 금액 미입력 | 저장 시 필수값 에러 메시지 |
| D-013 | 검증 | 금액 0원 입력 | 에러 메시지 |

#### 2.1.2 기본 정보 입력

| TC# | 구분 | 테스트 항목 | 기대 결과 |
|-----|------|------------|-----------|
| D-020 | 기능 | 거래일 선택 | 달력에서 날짜 선택 |
| D-021 | 기능 | 계좌 선택 | 등록된 계좌 목록에서 선택 |
| D-022 | 기능 | 거래처 선택 | 거래처 검색 및 선택 |
| D-023 | 기능 | 입금액 입력 | 숫자만 입력, 천단위 자동 콤마 |
| D-024 | 기능 | 적요 입력 | 거래 내용 입력 (최대 100자) |
| D-025 | 경계 | 미래 날짜 입력 | 미래 날짜 허용 또는 경고 |
| D-026 | 경계 | 음수 금액 | 에러 메시지 또는 입력 제한 |

#### 2.1.3 입금 유형

| TC# | 구분 | 테스트 항목 | 기대 결과 |
|-----|------|------------|-----------|
| D-030 | 기능 | 매출입금 선택 | 매출 관련 입금 유형 |
| D-031 | 기능 | 미수금 입금 선택 | 미수금 회수 입금 유형 |
| D-032 | 기능 | 기타입금 선택 | 기타 입금 유형 |
| D-033 | 기능 | 주문 연결 | 특정 주문과 입금 연결 |
| D-034 | 기능 | 미수금 연결 | 미수금 채권과 입금 연결 |

#### 2.1.4 추가 정보

| TC# | 구분 | 테스트 항목 | 기대 결과 |
|-----|------|------------|-----------|
| D-040 | 기능 | 비고 입력 | 추가 메모 (최대 500자) |
| D-041 | 기능 | 영수증 첨부 | 영수증 이미지/PDF 첨부 |
| D-042 | 기능 | 전표 자동 생성 | 회계 전표 자동 생성 옵션 |

#### 2.1.5 저장 동작

| TC# | 구분 | 테스트 항목 | 기대 결과 |
|-----|------|------------|-----------|
| D-050 | 기능 | 정상 저장 | 성공 메시지 + 목록 페이지로 이동 |
| D-051 | 기능 | 저장 후 계속 등록 | 저장 후 새 입금 등록 화면 |
| D-052 | 기능 | 취소 버튼 | 목록 페이지로 복귀 |
| D-053 | 비즈 | 계좌 잔액 갱신 | 입금 후 계좌 잔액 증가 확인 |
| D-054 | 비즈 | 미수금 차감 | 미수금 연결 시 미수금 잔액 차감 |

---

## 3. 출금 등록 페이지

### 3.1 출금 등록 (mode=new)

| TC# | 구분 | 테스트 항목 | 기대 결과 |
|-----|------|------------|-----------|
| E-001 | 기본 | 페이지 로딩 | 빈 폼 표시, 저장/취소 버튼 |
| E-002 | 기본 | 기본값 확인 | 거래일=오늘, 구분=출금 |

#### 3.1.1 필수값 검증

| TC# | 구분 | 테스트 항목 | 기대 결과 |
|-----|------|------------|-----------|
| E-010 | 검증 | 거래일 미입력 | 저장 시 필수값 에러 메시지 |
| E-011 | 검증 | 계좌 미선택 | 저장 시 필수값 에러 메시지 |
| E-012 | 검증 | 금액 미입력 | 저장 시 필수값 에러 메시지 |
| E-013 | 비즈 | 잔액 초과 출금 | 잔액 부족 에러 메시지 |

#### 3.1.2 기본 정보 입력

| TC# | 구분 | 테스트 항목 | 기대 결과 |
|-----|------|------------|-----------|
| E-020 | 기능 | 거래일 선택 | 달력에서 날짜 선택 |
| E-021 | 기능 | 계좌 선택 | 등록된 계좌 목록에서 선택, 잔액 표시 |
| E-022 | 기능 | 거래처 선택 | 거래처 검색 및 선택 |
| E-023 | 기능 | 출금액 입력 | 숫자만 입력, 천단위 자동 콤마 |
| E-024 | 기능 | 적요 입력 | 거래 내용 입력 |
| E-025 | 비즈 | 잔액 표시 | 출금 가능 잔액 실시간 표시 |

#### 3.1.3 출금 유형

| TC# | 구분 | 테스트 항목 | 기대 결과 |
|-----|------|------------|-----------|
| E-030 | 기능 | 매입대금 선택 | 매입 관련 출금 유형 |
| E-031 | 기능 | 경비 선택 | 경비 지출 유형 |
| E-032 | 기능 | 급여 선택 | 급여 지급 유형 |
| E-033 | 기능 | 세금 선택 | 세금 납부 유형 |
| E-034 | 기능 | 기타출금 선택 | 기타 출금 유형 |
| E-035 | 기능 | 발주 연결 | 특정 발주와 출금 연결 |
| E-036 | 기능 | 미지급금 연결 | 미지급금 채무와 출금 연결 |

#### 3.1.4 저장 동작

| TC# | 구분 | 테스트 항목 | 기대 결과 |
|-----|------|------------|-----------|
| E-050 | 기능 | 정상 저장 | 성공 메시지 + 목록 페이지로 이동 |
| E-051 | 비즈 | 계좌 잔액 갱신 | 출금 후 계좌 잔액 감소 확인 |
| E-052 | 비즈 | 미지급금 차감 | 미지급금 연결 시 미지급금 잔액 차감 |

---

## 4. 계좌 이체 등록

| TC# | 구분 | 테스트 항목 | 기대 결과 |
|-----|------|------------|-----------|
| T-001 | 기본 | 페이지 로딩 | 출금계좌, 입금계좌, 금액 폼 |
| T-002 | 기능 | 출금계좌 선택 | 출금할 계좌 선택 + 잔액 표시 |
| T-003 | 기능 | 입금계좌 선택 | 입금받을 계좌 선택 |
| T-004 | 기능 | 이체금액 입력 | 이체할 금액 입력 |
| T-005 | 비즈 | 동일 계좌 이체 | 같은 계좌로 이체 불가 |
| T-006 | 비즈 | 잔액 초과 이체 | 잔액 부족 에러 메시지 |
| T-007 | 기능 | 이체 저장 | 출금/입금 2건 거래 생성 |
| T-008 | 비즈 | 잔액 동시 갱신 | 출금계좌 감소, 입금계좌 증가 |

---

## 5. 계좌 관리

### 5.1 계좌 목록

| TC# | 구분 | 테스트 항목 | 기대 결과 |
|-----|------|------------|-----------|
| A-001 | 기능 | 계좌 목록 조회 | 등록된 계좌 목록 표시 |
| A-002 | UI | 계좌 정보 표시 | 은행명, 계좌번호, 예금주, 잔액 |
| A-003 | 기능 | 기본 계좌 표시 | 기본 계좌 표시 뱃지 |
| A-004 | 기능 | 계좌 추가 | 신규 계좌 등록 |
| A-005 | 기능 | 계좌 수정 | 계좌 정보 수정 |
| A-006 | 기능 | 계좌 비활성화 | 계좌 사용 중지 (삭제 대신) |
| A-007 | 비즈 | 거래 있는 계좌 삭제 | 삭제 불가, 비활성화만 가능 |

### 5.2 계좌 등록

| TC# | 구분 | 테스트 항목 | 기대 결과 |
|-----|------|------------|-----------|
| A-010 | 기능 | 은행 선택 | 은행 드롭다운에서 선택 |
| A-011 | 기능 | 계좌번호 입력 | 계좌번호 포맷팅 |
| A-012 | 기능 | 예금주 입력 | 예금주명 입력 |
| A-013 | 기능 | 계좌별칭 입력 | 구분용 별칭 입력 |
| A-014 | 기능 | 초기잔액 입력 | 시작 잔액 설정 |
| A-015 | 기능 | 기본계좌 설정 | 기본 계좌로 지정 |
| A-016 | 경계 | 계좌번호 중복 | 중복 에러 메시지 |

---

## 6. 조회/수정 페이지

### 6.1 조회 모드 (mode=view)

| TC# | 구분 | 테스트 항목 | 기대 결과 |
|-----|------|------------|-----------|
| V-001 | 기본 | 페이지 로딩 | 저장된 데이터 표시, 읽기전용 |
| V-002 | UI | 거래 정보 표시 | 구분, 일자, 계좌, 금액, 거래처, 적요 |
| V-003 | UI | 연결 정보 표시 | 연결된 주문/발주/채권/채무 표시 |
| V-004 | 기능 | 영수증 보기 | 첨부된 영수증 조회 |
| V-005 | 기능 | 전표 보기 | 생성된 전표 조회 링크 |

### 6.2 수정 모드 (mode=edit)

| TC# | 구분 | 테스트 항목 | 기대 결과 |
|-----|------|------------|-----------|
| V-010 | 기본 | 페이지 로딩 | 기존 데이터 편집 가능 폼 |
| V-011 | 기능 | 금액 수정 | 거래 금액 수정 |
| V-012 | 기능 | 적요 수정 | 적요 내용 수정 |
| V-013 | 기능 | 거래처 변경 | 다른 거래처로 변경 |
| V-014 | 비즈 | 마감 후 수정 | 마감된 거래 수정 불가 |
| V-015 | 비즈 | 전표 연결 후 수정 | 전표 연결 시 금액 수정 제한 |

### 6.3 삭제

| TC# | 구분 | 테스트 항목 | 기대 결과 |
|-----|------|------------|-----------|
| V-020 | 기능 | 삭제 버튼 | 삭제 확인 다이얼로그 |
| V-021 | 기능 | 삭제 확인 | 거래 삭제 + 목록으로 이동 |
| V-022 | 비즈 | 삭제 후 잔액 | 잔액 역산 처리 |
| V-023 | 비즈 | 마감 거래 삭제 | 삭제 불가 에러 |

---

## 7. 보고서

### 7.1 입출금 보고서

| TC# | 구분 | 테스트 항목 | 기대 결과 |
|-----|------|------------|-----------|
| R-001 | 기능 | 일별 보고서 | 일자별 입출금 집계 |
| R-002 | 기능 | 주별 보고서 | 주간 입출금 집계 |
| R-003 | 기능 | 월별 보고서 | 월별 입출금 집계 |
| R-004 | 기능 | 계좌별 보고서 | 계좌별 입출금 내역 |
| R-005 | 기능 | 거래처별 보고서 | 거래처별 입출금 내역 |
| R-006 | 기능 | PDF 출력 | 보고서 PDF 다운로드 |
| R-007 | 기능 | Excel 출력 | 보고서 Excel 다운로드 |

### 7.2 현금흐름표

| TC# | 구분 | 테스트 항목 | 기대 결과 |
|-----|------|------------|-----------|
| R-010 | 기능 | 현금흐름표 조회 | 영업/투자/재무활동별 현금흐름 |
| R-011 | 기능 | 기간 설정 | 조회 기간 설정 |
| R-012 | UI | 차트 표시 | 현금흐름 시각화 |

---

## 8. 모바일 반응형

| TC# | 구분 | 테스트 항목 | 기대 결과 |
|-----|------|------------|-----------|
| M-001 | UI | 목록 모바일 뷰 | 카드 형태로 거래 표시 |
| M-002 | UI | 카드 핵심 정보 | 일자, 구분, 금액, 잔액 표시 |
| M-003 | UI | 빠른 등록 | 모바일에서 간편 입출금 등록 |
| M-004 | UI | 계좌 잔액 | 모바일에서 계좌 잔액 확인 |
| M-005 | UI | 영수증 촬영 | 카메라로 영수증 첨부 |

---

## 9. API 응답 검증

| TC# | 구분 | 테스트 항목 | 기대 결과 |
|-----|------|------------|-----------|
| API-001 | API | GET /payments 응답 | `{ success: true, data: { data: [...], total } }` |
| API-002 | API | GET /payments/{id} 응답 | 거래 상세 정보 |
| API-003 | API | POST /payments 응답 | 신규 거래 ID 반환 |
| API-004 | API | GET /accounts 응답 | 계좌 목록 + 잔액 |
| API-005 | API | GET /payments/summary 응답 | 입출금 집계 데이터 |
| API-006 | API | 멀티테넌트 격리 | 다른 tenant 데이터 접근 불가 |

---

## 10. 데이터 정합성

| TC# | 구분 | 테스트 항목 | 기대 결과 |
|-----|------|------------|-----------|
| I-001 | 비즈 | 잔액 계산 | 초기잔액 + 입금합계 - 출금합계 = 현재잔액 |
| I-002 | 비즈 | 거래별 잔액 | 각 거래 후 잔액 = 이전잔액 ± 거래금액 |
| I-003 | 비즈 | 이체 정합성 | 출금액 = 입금액 (이체 시) |
| I-004 | 비즈 | 채권 연동 | 입금 → 미수금 차감 동기화 |
| I-005 | 비즈 | 채무 연동 | 출금 → 미지급금 차감 동기화 |
| I-006 | 비즈 | 삭제 역산 | 삭제 시 잔액 역산 정확성 |

---

## TC 요약

| 카테고리 | 건수 |
|----------|------|
| 목록 페이지 | 54건 |
| 입금 등록 | 22건 |
| 출금 등록 | 18건 |
| 계좌 이체 | 8건 |
| 계좌 관리 | 13건 |
| 조회/수정 페이지 | 12건 |
| 보고서 | 9건 |
| 모바일 반응형 | 5건 |
| API 응답 검증 | 6건 |
| 데이터 정합성 | 6건 |
| **합계** | **153건** |

---

## 참고: 구분 체계

- **기본**: 페이지 로딩, 기본 표시
- **기능**: 사용자 인터랙션, CRUD 동작
- **UI**: 색상, 레이아웃, 뱃지 등 시각 요소
- **검증**: 입력값 유효성 검사
- **경계**: 경계값, 예외 케이스
- **비즈**: 비즈니스 로직 (잔액 계산, 채권/채무 연동 등)
- **API**: API 레벨 검증