# Partner UI: V1 vs V2 비교 분석

> 작성일: 2026-03-24
> V1: https://partner.cryptoments.cc/ (운영)
> V2: http://localhost:5173/partner/ (개발)

---

## 1. 전체 구조 비교

### V1 네비게이션 (Flat Sidebar — 11개 메뉴)

| # | 메뉴 | URL 패턴 | 설명 |
|---|------|---------|------|
| 1 | 계정 관리 | `/me?tabActive=me` | 파트너 정보 + Axim 설정 (2탭) |
| 2 | 정책 관리 | `/setting?tabActive=*` | 환율/출금/콜백URL/텔레그램 (4탭) |
| 3 | 모지갑 관리 | `/mother-wallet` | 네트워크별 카드 (ETH/BSC/POLYGON/TRON) |
| 4 | 사용자 지갑 관리 | `/user?page=1` | 사용자ID 검색 + 입금 지갑 생성 |
| 5 | 입출금 내역 관리 | `/history?page=1` | 입출금 통합 테이블 + 총 입금/출금 요약 |
| 6 | 출금 승인 관리 | `/withdrawal?page=1` | 수동 출금 승인 처리 |
| 7 | 콜백 이력 관리 | `/callback?page=1` | Webhook 콜백 이력 + 재시도 |
| 8 | 입금 예약 관리 | `/deposit-reservation?page=1` | KRW 환율 기반 입금 예약 |
| 9 | 결제 링크 관리 | `/link?page=1` | 결제 위젯 링크 생성/관리 |
| 10 | 액심 연결 관리 | `/axim-link?page=1` | Axim Pay 사용자 연결 상태 |
| 11 | 액심 결제 내역 | `/axim-history?page=1` | Axim Pay 결제 이력 |

### V2 네비게이션 (Grouped Sidebar — 8개 그룹)

| # | 그룹/메뉴 | URL 패턴 | 설명 |
|---|----------|---------|------|
| 1 | 대시보드 | `/partner/dashboard` | 요약 통계 (V1에 없음) |
| 2 | 입금 관리 | `/partner/deposits` | 입금 전용 테이블 |
| 3 | 출금 관리 > 출금 내역 | `/partner/withdrawals` | 출금 전용 테이블 |
| 4 | 출금 관리 > 출금 요청 | `/partner/withdrawals/new` | 출금 요청 폼 |
| 5 | 잔액 조회 | `/partner/balances` | 네트워크/토큰별 잔액 |
| 6 | 원장 조회 | `/partner/ledger` | Ledger 엔트리 |
| 7 | 정산 > 쉐어 출금 | `/partner/settlement/withdraw` | 정산 출금 |
| 8 | Webhook | `/partner/webhook` | Webhook 이벤트 조회 |
| 9 | 프로필 | `/partner/profile` | 계정 정보 + 보안 설정 |

---

## 2. 화면별 매핑 & 차이점

### 2.1 계정 관리 → 프로필

| 항목 | V1 | V2 |
|------|----|----|
| 기본 정보 | 파트너사 이름, 이메일, 비밀번호 변경, API Key/Secret | 프로필 페이지 (구현 완료) |
| Axim 설정 | Api Key/Secret 입력 + ON/OFF | ❌ **미구현** |
| 2FA 설정 | ❌ 없음 | ✅ TOTP 2FA 지원 (V2 신규) |

### 2.2 정책 관리 → (분산)

| 항목 | V1 | V2 |
|------|----|----|
| 환율 정책 | 상위 시스템 승계 / 환율 고정 선택 + 고정값 입력 | ❌ **미구현** — 프로필 또는 별도 설정 화면 필요 |
| 출금 정책 | 자동 출금 / 수동(조건부) 출금 + 승인 임계값 | ❌ **미구현** |
| 콜백 URL | 입금 콜백 URL / 출금 콜백 URL | ❌ **미구현** — Webhook 설정에 통합 가능 |
| 텔레그램 챗봇 | 봇 핸들 + ON/OFF | ❌ **미구현** |

### 2.3 모지갑 관리 → 잔액 조회

| 항목 | V1 | V2 |
|------|----|----|
| UI 형태 | 네트워크별 컬러 카드 (ETH/BSC/POLYGON/TRON) | 테이블 형식 (네트워크+토큰별 잔액) |
| 주소 표시 | 마스터 지갑 주소 + 복사 버튼 | 잔액 데이터 위주 |
| 네트워크 활성화 | "ETH 활성화" 버튼 | ❌ 없음 (관리자 영역으로 이관) |

### 2.4 사용자 지갑 관리 → (없음)

| 항목 | V1 | V2 |
|------|----|----|
| 사용자 지갑 목록 | 사용자ID 검색 + 테이블 | ❌ **미구현** — API는 존재 |
| 입금 지갑 생성 | "입금 지갑 생성" 버튼 | ❌ **미구현** |

### 2.5 입출금 내역 관리 → 입금 관리 + 출금 관리

| 항목 | V1 | V2 |
|------|----|----|
| 구조 | 입출금 통합 1개 테이블 | ✅ 입금/출금 **분리** (더 나은 구조) |
| 요약 | 총 입금 / 총 출금 금액 상단 표시 | 대시보드에서 통계 제공 |
| 검색 | 사용자ID, 지갑주소 통합 검색 | 각 화면별 필터 |
| 사용자 출금 | "사용자 출금" 버튼 (테이블 상단) | "출금 요청" 별도 페이지 ✅ |

### 2.6 출금 승인 관리 → 출금 관리

| 항목 | V1 | V2 |
|------|----|----|
| 승인 대기 목록 | 검색 + 테이블 + 상태 변경 | 출금 내역 테이블에서 상태별 필터 |
| 승인/거절 액션 | 행별 상태관리 버튼 | 출금 상세에서 처리 (추정) |

### 2.7 콜백 이력 관리 → Webhook

| 항목 | V1 | V2 |
|------|----|----|
| 명칭 | "콜백 이력" (입금/출금 콜백) | "Webhook" (이벤트 기반) |
| 테이블 컬럼 | No, 타입, URL, 시도횟수, 생성/수정일시, 상태 | Webhook 이벤트 목록 |
| 재시도 | "재시도" 버튼 (실패 건) | ⚠️ 재시도 기능 확인 필요 |
| 구조적 차이 | 단순 HTTP 콜백 이력 | V2는 webhook_events 테이블 기반 이벤트 시스템 |

### 2.8 입금 예약 관리 → (없음)

| 항목 | V1 | V2 |
|------|----|----|
| 기능 | KRW 환율 기반 입금 예약 (DepositSession) | ❌ **미구현** — partner-api에 deposit-session 관련 Controller 필요 |
| 테이블 | 사용자ID, 네트워크, 환율, 예약/실제 금액(KRW/토큰), txHash, 상태, 일시 | — |
| 실데이터 | BSC/TRON USDT/USDC 거래 내역 확인됨 | — |

### 2.9 결제 링크 관리 → (없음)

| 항목 | V1 | V2 |
|------|----|----|
| 기능 | 결제 위젯 링크 생성, 상태 관리 | ❌ **미구현** — PaymentLink Controller 미구현 |
| 테이블 | No, 사용자ID, 결제링크, 수량, 환율, KRW금액, 상태, 만료/생성일시 | — |
| 상태 | 대기/활성화/완료 | — |
| 액션 | "결제 링크 생성", "선택 삭제", 상태 필터 | — |
| 실데이터 | 37건 운영 데이터 확인 | — |

### 2.10 액심 연결 관리 → (없음)

| 항목 | V1 | V2 |
|------|----|----|
| 기능 | Axim Pay 사용자 연결 상태 조회 | ❌ **미구현** — AximService 연동 필요 |
| 검색 | 사용자ID 검색 | — |

### 2.11 액심 결제 내역 → (없음)

| 항목 | V1 | V2 |
|------|----|----|
| 기능 | Axim Pay 결제 이력 + "액심 결제 요청" | ❌ **미구현** — AximService 연동 필요 |

---

## 3. V2 신규 기능 (V1에 없음)

| 기능 | V2 화면 | 설명 |
|------|---------|------|
| **대시보드** | `/partner/dashboard` | 통계 요약, 차트 — V1은 홈이 바로 계정관리 |
| **원장 조회** | `/partner/ledger` | Ledger 엔트리 기반 회계 투명성 |
| **정산 (쉐어 출금)** | `/partner/settlement/withdraw` | 수익 정산 출금 기능 |
| **2FA (TOTP)** | 프로필 내 | Google Authenticator 기반 2단계 인증 |
| **입금/출금 분리** | deposits / withdrawals | V1의 통합 테이블 → 분리 (UX 개선) |

---

## 4. V2 미구현 항목 (V1 기능 중 누락)

### P0 — 핵심 비즈니스 기능

| # | V1 기능 | 필요한 구현 | 비고 |
|---|--------|-----------|------|
| 1 | **입금 예약 관리** | DepositSession Controller + UI 화면 | V1에서 실거래 데이터 있음 — 핵심 기능 |
| 2 | **결제 링크 관리** | PaymentLink Controller + UI 화면 | V1에 37건 운영 데이터 — 활발히 사용 중 |
| 3 | **사용자 지갑 관리** | 지갑 목록 UI + 입금 지갑 생성 UI | API는 partner-api에 존재 |

### P1 — 설정/정책

| # | V1 기능 | 필요한 구현 | 비고 |
|---|--------|-----------|------|
| 4 | **정책 관리 (4탭)** | 환율정책/출금정책/콜백URL/텔레그램 설정 화면 | 프로필 하위 또는 별도 "설정" 메뉴 |
| 5 | **콜백 URL 설정** | Webhook URL 관리 UI | V2 Webhook 화면에 통합 가능 |
| 6 | **콜백 재시도** | Webhook 이벤트 재발송 버튼 | V1에서 실패 건 재시도 지원 |

### P2 — Axim Pay 연동

| # | V1 기능 | 필요한 구현 | 비고 |
|---|--------|-----------|------|
| 7 | **Axim 설정** | Api Key/Secret 입력 + 활성화 토글 | 프로필 하위 탭 |
| 8 | **액심 연결 관리** | Axim 사용자 연결 상태 조회 | AximService 연동 |
| 9 | **액심 결제 내역** | Axim 결제 이력 + 결제 요청 | AximService 연동 |

---

## 5. V2 UI/UX 개선점

| 항목 | V1 | V2 | 평가 |
|------|----|----|------|
| **네비게이션** | Flat 11개 버튼 | 그룹화된 계층 메뉴 | ✅ V2 우수 |
| **디자인** | 기본 Bootstrap 스타일 | 모던 UI (Tailwind/shadcn) | ✅ V2 우수 |
| **대시보드** | 없음 (홈=계정관리) | 통계 대시보드 | ✅ V2 신규 |
| **입출금 분리** | 통합 1테이블 | 입금/출금 별도 화면 | ✅ V2 우수 |
| **원장/정산** | 없음 | 원장 조회 + 쉐어 출금 | ✅ V2 신규 |
| **2FA** | 없음 | TOTP 지원 | ✅ V2 신규 |
| **반응형** | 제한적 | 반응형 지원 | ✅ V2 우수 |

---

## 6. 권장 우선순위

**즉시 (V2 런칭 전 필수)**:
1. 입금 예약 관리 — V1 핵심 운영 기능
2. 결제 링크 관리 — V1에서 활발히 사용 중
3. 사용자 지갑 관리 — 지갑 생성/조회는 기본 기능

**단기 (런칭 직후)**:
4. 정책 관리 (환율/출금/콜백URL/텔레그램) — 설정 화면으로 통합
5. Webhook 재시도 기능

**중기 (Axim Pay 연동 시)**:
6. Axim 설정 + 연결 관리 + 결제 내역 — Axim Pay 비즈니스 결정 후