# Cryptoments v2 — Partner Console UI 가이드 > **버전**: v1.0 > **작성일**: 2026-02-25 > **상위 문서**: CRYPTOMENTS_ADMIN_CONSOLE_IA.md > **기술 스택**: Vue 3 + Element Plus (또는 Ant Design Vue) > **목적**: Partner Console 전체 화면의 레이아웃, 컴포넌트, 인터랙션, 데이터 바인딩 정의 > **대상 사용자**: PARENT_PARTNER, SUB_PARTNER, PARTNER --- ## 공통 레이아웃 ``` ┌──────────────────────────────────────────────────────────────────┐ │ HEADER │ │ [Logo] Cryptoments Partner [🔴 CS 3] [🔔 알림 5] [👤 파트너명 ▾] │ ├────────────┬─────────────────────────────────────────────────────┤ │ SIDEBAR │ CONTENT AREA │ │ │ │ │ 1.대시보드 │ ┌─ Breadcrumb ──────────────────────────────┐ │ │ 2.정책 관리 │ │ 입금 관리 > 입금 상세 │ │ │ 3.알림 설정 │ └──────────────────────────────────────────┘ │ │ 4.모지갑 │ │ │ 5.입금 │ [ 실제 컨텐츠 영역 ] │ │ 6.출금 │ │ │ 7.사용자지갑 │ │ │ 8.CS 센터 ★│ │ │ 9.결제 링크 │ │ │ 10.Axim │ │ │ 11.하위파트너│ ← Parent Partner만 표시 │ │ 12.가스비 │ │ │ 13.통계 │ │ │ 14.설정 │ │ │ │ │ ├────────────┴─────────────────────────────────────────────────────┤ │ FOOTER: © 2026 Cryptoments v2.0.0 │ └──────────────────────────────────────────────────────────────────┘ ``` **공통 UI 패턴** (Super Admin Console과 동일): - **테이블 목록 화면**: 필터 바 → 데이터 테이블 (정렬, 페이징) → 상세 링크 - **상세 화면**: 요약 카드 → 탭 구성 → 하단 이력/로그 - **모달**: 등록/수정/확인 액션은 모달 다이얼로그 사용 - **상태 배지**: GREEN=정상, RED=실패, ORANGE=주의, GRAY=비활성 - **공통 필터**: 기간 선택(DateRangePicker), 네트워크 선택(체인 드롭다운), 상태 필터(태그 그룹) - **검색**: 실시간 debounce 검색 (300ms) - **API 호출**: 모든 목록 API는 cursor 기반 페이징 **파트너 콘솔 설계 원칙**: - 인프라 내부 상세(FEE 지갑, Approve, Relayer, 논스)는 노출하지 않음 - 내부 상태를 비즈니스 관점으로 추상화 (예: approve_status → "준비 중/사용 가능") - CS 대응 도구를 전면 배치하여 파트너 자체 해결률 극대화 --- ## 1. 대시보드 (Dashboard) ### 1.1 오늘의 거래 요약 ``` ┌─────────────────────────────────────────────────────────────────┐ │ 오늘의 거래 요약 │ ├──────────┬──────────┬──────────┬──────────┬──────────┬──────────┤ │ 입금 건수 │ 입금 금액 │ 출금 건수 │ 출금 금액 │ MASTER │ CS 알림 │ │ 42건 │ $12,350 │ 15건 │ $5,200 │ $28,400 │ 🔴 3건 │ │ +8% ↑ │ +15% ↑ │ -2% ↓ │ +3% ↑ │ │ │ └──────────┴──────────┴──────────┴──────────┴──────────┴──────────┘ ``` | 컴포넌트 | 타입 | 데이터 소스 | |---------|------|-----------| | 입금 건수/금액 | StatCard | `GET /api/partner/deposits?date=today` 집계 | | 출금 건수/금액 | StatCard | `GET /api/partner/withdrawals?date=today` 집계 | | MASTER 잔액 합계 | StatCard | `GET /api/partner/wallets/master` 체인별 합산 | | CS 알림 배지 | StatCard (경고) | 미식별 입금 + 세션 만료 입금 합산 건수 | ### 1.2 최근 트랜잭션 (입금 + 출금 통합 타임라인) ``` ┌──────────────────────────────────────────────────────────────┐ │ 최근 트랜잭션 [전체 보기 →] │ ├──────────────────────────────────────────────────────────────┤ │ 14:32 ▼ 입금 user_789 100.50 USDT BSC ● CONFIRMED │ │ 14:28 ▲ 출금 user_123 50.00 USDC ETH ● BROADCASTING │ │ 14:15 ▼ 입금 user_456 20.0317 USDT TRON ● SETTLED │ │ 14:02 ▲ 출금 user_001 200.00 USDT BSC ● APPROVED │ │ 13:58 ▼ 입금 user_321 75.00 USDC ETH ● COLLECTING │ │ ... │ └──────────────────────────────────────────────────────────────┘ ``` | 컬럼 | 설명 | |------|------| | 시각 | 최종 상태 변경 시각 | | 방향 | ▼ 입금 (파란색) / ▲ 출금 (초록색) | | 사용자 | partner_user_id | | 금액/통화 | 금액 + 토큰 | | 체인 | 네트워크 | | 상태 | 상태 배지 | - **데이터 소스**: deposits + withdrawals UNION, ORDER BY updated_at DESC LIMIT 10 - **자동 갱신**: 30초 polling 또는 WebSocket ### 1.3 MASTER 지갑 잔액 현황 ``` ┌──────────────────────────────────────────────────────────────┐ │ MASTER 지갑 잔액 │ ├───────────┬──────────┬──────────┬──────────┬─────────────────┤ │ 체인 │ Available│ Locked │ Total │ 최근 집금 │ ├───────────┼──────────┼──────────┼──────────┼─────────────────┤ │ Ethereum │ $5,200 │ $200 │ $5,400 │ 1시간 전 │ │ BSC │ $18,000 │ $800 │ $18,800 │ 30분 전 │ │ TRON │ $3,800 │ $0 │ $3,800 │ 2시간 전 │ ├───────────┼──────────┼──────────┼──────────┼─────────────────┤ │ 합계 │ $27,000 │ $1,000 │ $28,000 │ │ └───────────┴──────────┴──────────┴──────────┴─────────────────┘ ``` - **데이터 소스**: `GET /api/partner/wallets/master` - **비활성화된 체인**: 행 자체를 숨김 (파트너가 활성화한 체인만 표시) ### 1.4 입금 방식별 현황 ``` ┌──────────────────────────────────────────┐ │ 입금 방식별 (오늘) │ │ │ │ HD 전용 지갑 ████████████ 72% 30건 │ │ 외부 지갑 매핑 ████ 18% 8건 │ │ 소수점 매칭 ██ 10% 4건 │ │ │ │ 총 42건 / $12,350 │ └──────────────────────────────────────────┘ ``` - **데이터 소스**: `GET /api/partner/deposits?date=today` → deposit_method 별 GROUP BY - 비활성화된 방식은 "OFF" 라벨과 함께 회색 표시 ### 1.5 CS 알림 배지 ``` ┌──────────────────────────────────────────┐ │ ⚠ CS 처리 필요 │ ├──────────────────────────────────────────┤ │ 🔴 미식별 입금 2건 [조회 →] │ │ 🟠 세션 만료 입금 1건 [조회 →] │ │ 🟡 금액 불일치 0건 │ │ 🔵 승인 대기 출금 3건 [조회 →] │ └──────────────────────────────────────────┘ ``` | 항목 | 데이터 소스 | 이동 | |------|-----------|------| | 미식별 입금 | `GET /api/partner/cs/unidentified-deposits?status=PENDING` count | → 8.3 미식별 입금 | | 세션 만료 입금 | `GET /api/partner/cs/expired-sessions?status=UNRECOVERED` count | → 8.4 세션 만료 복구 | | 금액 불일치 | `GET /api/partner/cs/amount-mismatches?status=UNRESOLVED` count | → 8.5 금액 불일치 | | 승인 대기 출금 | `GET /api/partner/withdrawals?status=PENDING_APPROVAL` count | → 6.4 출금 승인 | ### 1.6 하위 파트너 현황 (Parent Partner만) ``` ┌──────────────────────────────────────────────────────────────┐ │ 하위 파트너 현황 [전체 보기 →] │ ├────────────┬────────┬──────────┬──────────┬──────────────────┤ │ 파트너명 │ 상태 │ 오늘 입금 │ 오늘 출금 │ MASTER 잔액 │ ├────────────┼────────┼──────────┼──────────┼──────────────────┤ │ Sub-A │ ●ACTIVE│ $3,200 │ $1,000 │ $8,500 │ │ Sub-B │ ●ACTIVE│ $1,800 │ $500 │ $4,200 │ │ Sub-C │ ○INACT │ — │ — │ $0 │ └────────────┴────────┴──────────┴──────────┴──────────────────┘ ``` - **조건부 표시**: `role === 'PARENT_PARTNER'` 일 때만 렌더링 - **데이터 소스**: `GET /api/partner/sub-partners/summary` --- ## 2. 정책 관리 (Policy Management) ### 2.1 환율 정책 ``` ┌──────────────────────────────────────────────────────────────┐ │ 환율 정책 [수정] │ ├──────────────────────────────────────────────────────────────┤ │ │ │ 현재 모드: ◉ INHERIT (시스템 환율 사용) │ │ ○ FIXED (고정 환율) │ │ │ │ ┌─ 현재 적용 환율 ─────────────────────────────────────┐ │ │ │ BTC/KRW ₩142,500,000 (빗썸, 14:30 갱신) │ │ │ │ ETH/KRW ₩4,850,000 (빗썸, 14:30 갱신) │ │ │ │ USDT/KRW ₩1,380 (빗썸, 14:30 갱신) │ │ │ │ USDC/KRW ₩1,379 (빗썸, 14:30 갱신) │ │ │ └──────────────────────────────────────────────────────┘ │ │ │ │ FIXED 모드 시: │ │ ┌─ 고정 환율 입력 ─────────────────────────────────────┐ │ │ │ USDT/KRW: [________] 원 │ │ │ │ USDC/KRW: [________] 원 │ │ │ └──────────────────────────────────────────────────────┘ │ │ │ └──────────────────────────────────────────────────────────────┘ ``` - **데이터 소스**: `GET /api/partner/policy/exchange-rate` - **수정 API**: `PUT /api/partner/policy/exchange-rate` - INHERIT 선택 시 고정 환율 입력 영역 disabled - 현재 시세는 `GET /api/v2/prices` 참조 ### 2.2 입금 방식 설정 ``` ┌──────────────────────────────────────────────────────────────┐ │ 입금 방식 설정 [저장] │ ├──────────────────────────────────────────────────────────────┤ │ │ │ ┌─────────────────────────────────────────────────────┐ │ │ │ HD 전용 지갑 [ON ■□ OFF] │ │ │ │ 사용자별 전용 입금 주소 자동 발급 │ │ │ └─────────────────────────────────────────────────────┘ │ │ │ │ ┌─────────────────────────────────────────────────────┐ │ │ │ 외부 지갑 매핑 [ON □■ OFF] │ │ │ │ 사용자의 FROM 주소로 입금자 식별 │ │ │ └─────────────────────────────────────────────────────┘ │ │ │ │ ┌─────────────────────────────────────────────────────┐ │ │ │ 소수점 매칭 [ON □■ OFF] │ │ │ │ 공유 풀 주소 + 소수점 키로 식별 │ │ │ │ │ │ │ │ 소수점 자릿수: [4 ▾] (최대 동시 세션: 9,999) │ │ │ │ 세션 만료 시간: [30 ] 분 │ │ │ └─────────────────────────────────────────────────────┘ │ │ │ │ ⚠ 최소 1개 입금 방식은 활성화되어야 합니다 │ └──────────────────────────────────────────────────────────────┘ ``` - **데이터 소스**: `GET /api/partner/policy/deposit-methods` - **저장 API**: `PUT /api/partner/policy/deposit-methods` - 소수점 매칭 OFF 시 하위 설정(자릿수, 만료 시간) disabled - 유효성 검사: 최소 1개 방식 활성화 필수 ### 2.3 출금 정책 설정 ``` ┌──────────────────────────────────────────────────────────────┐ │ 출금 정책 설정 [저장] │ ├──────────────────────────────────────────────────────────────┤ │ │ │ 전체 자동 승인: [ON □■ OFF] │ │ ├─ ON이면 모든 출금 즉시 승인 (아래 임계값 무시) │ │ │ │ 자동 승인 임계값: [$ 1,000 ] USD 이하 자동 승인 │ │ 일일 출금 한도: [$ 50,000 ] USD │ │ 1건 출금 한도: [$ 10,000 ] USD │ │ 연속 출금 대기: [ 0 ] 분 (0=제한 없음) │ │ │ │ 화이트리스트 전용: [ON □■ OFF] │ │ ├─ ON이면 등록된 주소로만 출금 가능 │ │ └─ [화이트리스트 관리 →] 링크 │ │ │ │ ⓘ 자동 승인 전체 ON 시에도 일일/1건 한도는 적용됩니다 │ └──────────────────────────────────────────────────────────────┘ ``` - **데이터 소스**: `GET /api/partner/withdrawal-policy` - **저장 API**: `PUT /api/partner/withdrawal-policy` - 전체 자동 승인 ON → 임계값 입력 disabled + 안내 메시지 표시 ### 2.4 콜백 URL 설정 ``` ┌──────────────────────────────────────────────────────────────┐ │ 콜백 URL 설정 [저장] │ ├──────────────────────────────────────────────────────────────┤ │ │ │ 입금 콜백 URL: [https://partner.com/callback/deposit ] │ │ 출금 콜백 URL: [https://partner.com/callback/withdrawal] │ │ │ │ Secret Key: sk_live_xxxx...xxxx [복사] [재발급] │ │ 서명 방식: HMAC-SHA256 │ │ │ │ [테스트 발송] → 입금 샘플 / 출금 샘플 선택 │ │ │ │ ┌─ 최근 콜백 이력 ──────────────────────────────────┐ │ │ │ 14:30 입금 콜백 → 200 OK (28ms) │ │ │ │ 14:15 출금 콜백 → 200 OK (42ms) │ │ │ │ 13:50 입금 콜백 → 500 ERR (timeout) ⚠ [재전송] │ │ │ └──────────────────────────────────────────────────┘ │ └──────────────────────────────────────────────────────────────┘ ``` - **데이터 소스**: `GET /api/partner/callback-settings` - **테스트 발송**: `POST /api/partner/callback-settings/test` - Secret Key 재발급 시 확인 모달 표시 ("기존 키로 검증 중인 콜백이 실패할 수 있습니다") ### 2.5 API Key / Secret 관리 ``` ┌──────────────────────────────────────────────────────────────┐ │ API 인증 키 관리 │ ├──────────────────────────────────────────────────────────────┤ │ │ │ Cryptoments API Key: ck_live_xxxx...xxxx [복사] │ │ Cryptoments API Secret: cs_live_xxxx •••••• [표시] [복사]│ │ 생성일: 2026-01-15 [키 재발급] │ │ │ │ ⚠ API Secret은 재발급 시에만 전체 확인 가능합니다 │ │ ⚠ 재발급 후 기존 키는 즉시 무효화됩니다 │ └──────────────────────────────────────────────────────────────┘ ``` - **데이터 소스**: `GET /api/partner/api-keys` - **재발급**: `POST /api/partner/api-keys/regenerate` → 확인 모달 필수 - Secret 표시는 마스킹 기본, [표시] 클릭 시 5초간 노출 후 자동 마스킹 --- ## 3. 알림 설정 (Notification Settings) ### 3.1 Telegram 채널 설정 ``` ┌──────────────────────────────────────────────────────────────┐ │ Telegram 알림 설정 │ ├──────────────────────────────────────────────────────────────┤ │ │ │ 연동 상태: ● 연결됨 │ │ 봇 이름: @CryptomentsBot │ │ 채팅방 ID: -100xxxxxxxxxx │ │ │ │ [연동 해제] [테스트 메시지 발송] │ │ │ │ ─── 미연결 시 ─── │ │ 1. @CryptomentsBot 을 채팅방에 초대하세요 │ │ 2. 채팅방에서 /start 명령어를 입력하세요 │ │ 3. 아래에 받은 인증 코드를 입력하세요 │ │ │ │ 인증 코드: [____________] [인증] │ │ │ └──────────────────────────────────────────────────────────────┘ ``` - **데이터 소스**: `GET /api/partner/notification-channels/telegram` - **연동**: `POST /api/partner/notification-channels/telegram/verify` - **테스트**: `POST /api/partner/notification-channels/telegram/test` ### 3.2 Webhook 채널 설정 ``` ┌──────────────────────────────────────────────────────────────┐ │ Webhook 알림 설정 │ ├──────────────────────────────────────────────────────────────┤ │ │ │ Webhook URL: [https://partner.com/webhook/notify ] │ │ Secret Key: wk_xxxx...xxxx [복사] │ │ 서명 방식: HMAC-SHA256 │ │ │ │ [저장] [테스트 발송] │ │ │ │ ┌─ 최근 발송 이력 (10건) ─────────────────────────────┐ │ │ │ 시각 │ 이벤트 │ 상태 │ 응답시간 │ │ │ │ 14:30 │ DEPOSIT_CONFIRMED│ 200 OK │ 32ms │ │ │ │ 14:15 │ WITHDRAWAL_SENT │ 200 OK │ 28ms │ │ │ │ 13:50 │ DEPOSIT_SETTLED │ 500 ERR│ timeout [재전송]│ │ │ └─────────────────────────────────────────────────────┘ │ └──────────────────────────────────────────────────────────────┘ ``` ### 3.3 이벤트별 구독 설정 ``` ┌──────────────────────────────────────────────────────────────┐ │ 이벤트 알림 구독 [저장] │ ├──────────────────────────────────────────────────────────────┤ │ │ │ 이벤트 │ Telegram │ Webhook │ │ │ ─────────────────────────┼──────────┼─────────┤ │ │ 입금 감지 (DETECTED) │ [✓] │ [✓] │ │ │ 입금 확정 (CONFIRMED) │ [✓] │ [✓] │ │ │ 입금 정산 (SETTLED) │ [✓] │ [✓] │ │ │ 출금 승인대기 │ [✓] │ [ ] │ │ │ 출금 완료 (CONFIRMED) │ [✓] │ [✓] │ │ │ 출금 실패 (FAILED) │ [✓] │ [✓] │ │ │ 미식별 입금 │ [✓] │ [ ] │ │ │ 집금 완료 │ [ ] │ [✓] │ │ │ 잔액 부족 경고 │ [✓] │ [ ] │ │ │ 세션 만료 │ [✓] │ [ ] │ │ │ │ │ [전체 선택] [전체 해제] │ └──────────────────────────────────────────────────────────────┘ ``` - **데이터 소스**: `GET /api/partner/notification-subscriptions` - **저장 API**: `PUT /api/partner/notification-subscriptions` - 채널이 미설정이면 해당 열 체크박스 disabled + "채널을 먼저 설정하세요" 툴팁 --- ## 4. 모지갑 관리 (Master Wallet) ### 4.1 체인 활성화/비활성화 ``` ┌──────────────────────────────────────────────────────────────┐ │ 체인 관리 │ ├──────────────────────────────────────────────────────────────┤ │ │ │ ┌──────────┬────────┬──────────┬──────────┬──────────────┐ │ │ │ 체인 │ 상태 │ MASTER │ 토큰 │ 액션 │ │ │ ├──────────┼────────┼──────────┼──────────┼──────────────┤ │ │ │ Ethereum │ ●활성 │ 0xABC... │ USDT,USDC│ [비활성화] │ │ │ │ BSC │ ●활성 │ 0xDEF... │ USDT,USDC│ [비활성화] │ │ │ │ TRON │ ○비활성│ — │ — │ [활성화] │ │ │ │ Polygon │ ○비활성│ — │ — │ [활성화] │ │ │ └──────────┴────────┴──────────┴──────────┴──────────────┘ │ │ │ │ ⚠ 활성화 후 MASTER 지갑 생성에 1~5분 소요됩니다 │ │ ⚠ 비활성화 시 해당 체인의 입금/출금이 중단됩니다 │ └──────────────────────────────────────────────────────────────┘ ``` - **데이터 소스**: `GET /api/partner/wallets/chains` - **활성화**: `POST /api/partner/wallets/chains/{chainId}/activate` → 확인 모달 - **비활성화**: `POST /api/partner/wallets/chains/{chainId}/deactivate` → 확인 모달 (잔액 존재 시 경고) - 비활성화 시: "해당 체인에 잔액 $X가 있습니다. 비활성화 전 출금을 권장합니다." ### 4.2 모지갑 상세 ``` ┌──────────────────────────────────────────────────────────────┐ │ MASTER 지갑 — Ethereum │ ├──────────────────────────────────────────────────────────────┤ │ │ │ 주소: 0xABC123...DEF456 [복사] [Etherscan →] │ │ │ │ ┌────────────┬────────────┬────────────┐ │ │ │ Available │ Locked │ Total │ │ │ │ $5,200.00 │ $200.00 │ $5,400.00 │ │ │ └────────────┴────────────┴────────────┘ │ │ │ │ ┌─ 토큰 내역 ───────────────────────────────────────┐ │ │ │ 토큰 │ Available │ Locked │ Total │ │ │ │ USDT │ 3,200.00 │ 200.00 │ 3,400.00 │ │ │ │ USDC │ 2,000.00 │ 0.00 │ 2,000.00 │ │ │ └──────────────────────────────────────────────────┘ │ │ │ │ [탭: 최근 입금 | 최근 출금 | 최근 집금] │ │ ┌──────────────────────────────────────────────────┐ │ │ │ 14:30 입금 user_789 100.50 USDT SETTLED │ │ │ │ 14:15 집금 HOT→MASTER 75.00 USDT COMPLETED │ │ │ │ 13:50 출금 user_123 50.00 USDC CONFIRMED │ │ │ └──────────────────────────────────────────────────┘ │ │ │ │ [외부 출금 →] │ └──────────────────────────────────────────────────────────────┘ ``` - **데이터 소스**: `GET /api/partner/wallets/master/{chainId}` - 지갑 상태 표시 (내부 approve 상태 숨김, "정상 운영 중" 또는 "준비 중"만) - 블록 익스플로러 링크: 체인별 자동 생성 (Etherscan, BscScan, Tronscan) ### 4.3 외부 출금 (모지갑 → 외부 주소) ``` ┌──────────────────────────────────────────────────────────────┐ │ 외부 출금 요청 │ ├──────────────────────────────────────────────────────────────┤ │ │ │ 출금 체인: [Ethereum ▾] │ │ 출금 통화: [USDT ▾] │ │ 출금 금액: [$________] 잔액: $5,200.00 │ │ │ │ 수신 주소: [화이트리스트 모드 시 ▾ 드롭다운] │ │ [일반 모드 시 직접 입력] │ │ │ │ ┌─ 승인 규칙 미리보기 ──────────────────────────────┐ │ │ │ 현재 금액 기준: ✅ 자동 승인 예정 (임계값 $1,000 이하) │ │ │ │ 또는: ⚠ 수동 승인 필요 (임계값 $1,000 초과) │ │ │ └──────────────────────────────────────────────────┘ │ │ │ │ [출금 요청] │ │ │ │ ⚠ 출금 후 취소는 BROADCASTING 전까지만 가능합니다 │ └──────────────────────────────────────────────────────────────┘ ``` - **출금 API**: `POST /api/partner/withdrawals` - 화이트리스트 전용 모드 ON → 주소 필드가 드롭다운으로 전환 - 금액 입력 시 실시간 승인 규칙 미리보기 (자동/수동) - 잔액 부족 시 버튼 disabled + "잔액 부족" 메시지 --- ## 5. 입금 관리 (Deposit Management) ### 5.1 입금 내역 조회 ``` ┌──────────────────────────────────────────────────────────────┐ │ 입금 관리 │ ├──────────────────────────────────────────────────────────────┤ │ 필터: │ │ [기간: 오늘 ▾] [입금 방식: 전체 ▾] [상태: 전체 ▾] │ │ [체인: 전체 ▾] [검색: TX Hash / 사용자 ID ...] [검색] │ ├──────────────────────────────────────────────────────────────┤ │ 요약: 총 156건 │ $42,350 │ 정상 95.5% │ ├──────────────────────────────────────────────────────────────┤ │ ID │사용자 │금액 │통화 │체인 │방식│상태 │일시 │ │ DEP-1234│user_789 │100.50 │USDT│BSC │HD │●SETTLED │14:30│ │ DEP-1233│user_456 │ 20.0317 │USDT│TRON│DM │●CONFIRMED│14:15│ │ DEP-1232│user_123 │ 75.00 │USDC│ETH │EW │●COLLECTING│14:02│ │ DEP-1231│user_001 │500.00 │USDT│BSC │HD │●NOTIFIED│13:50│ │ ... │ ├──────────────────────────────────────────────────────────────┤ │ [< 이전] [1] [2] [3] [다음 >] 20건 | 50건 | 100건 │ └──────────────────────────────────────────────────────────────┘ ``` - **방식 약어**: HD=HD 전용 지갑, EW=외부 지갑 매핑, DM=소수점 매칭(Decimal Match) - **데이터 소스**: `GET /api/partner/deposits` - **행 클릭**: → 5.2 입금 상세 ### 5.2 입금 상세 / 상태 이력 ``` ┌──────────────────────────────────────────────────────────────┐ │ 입금 상세 — DEP-1234 [뒤로] │ ├──────────────────────────────────────────────────────────────┤ │ │ │ ┌─ 기본 정보 ────────────────────────────────────────┐ │ │ │ 사용자 ID: user_789 │ │ │ │ 금액: 100.50 USDT │ │ │ │ 체인: BSC (BNB Smart Chain) │ │ │ │ 입금 방식: HD 전용 지갑 │ │ │ │ TX Hash: 0x1234abcd... [복사] [BscScan →] │ │ │ │ FROM: 0xSender... │ │ │ │ TO: 0xHot789... (HOT 지갑) │ │ │ │ 상태: ● SETTLED │ │ │ └──────────────────────────────────────────────────────┘ │ │ │ │ ┌─ 상태 이력 (타임라인) ──────────────────────────────┐ │ │ │ 14:30 ● SETTLED 집금 완료 │ │ │ │ 14:25 ● COLLECTING HOT→MASTER 전송 중 │ │ │ │ 14:20 ● NOTIFIED 파트너 콜백 발송 │ │ │ │ 14:18 ● CONFIRMED 12/12 컨펌 완료 │ │ │ │ 14:12 ● CONFIRMING 블록 컨펌 대기 (6/12) │ │ │ │ 14:10 ● DETECTED Webhook 수신 │ │ │ └──────────────────────────────────────────────────────┘ │ │ │ │ ┌─ 집금 정보 ────────────────────────────────────────┐ │ │ │ 집금 TX: 0xColl... [복사] [BscScan →] │ │ │ │ 상태: ● COMPLETED │ │ │ │ HOT → MASTER 전송 완료 │ │ │ └──────────────────────────────────────────────────────┘ │ │ │ │ ┌─ CS 메모 ──────────────────────────────── [메모 추가] ┐ │ │ │ (메모 없음) │ │ │ └────────────────────────────────────────────────────────┘ │ └──────────────────────────────────────────────────────────────┘ ``` - **데이터 소스**: `GET /api/partner/deposits/{id}` - **CS 메모 추가**: `POST /api/partner/cs/notes` (type=DEPOSIT, ref_id=deposit_id) - 집금 상태는 추상화: PENDING→"대기 중", QUEUED/PROCESSING→"처리 중", COMPLETED→"완료", FAILED→"실패" ### 5.3 풀 주소 관리 (소수점 매칭) ``` ┌──────────────────────────────────────────────────────────────┐ │ 풀 주소 관리 [풀 주소 생성] │ ├──────────────────────────────────────────────────────────────┤ │ 현재: 8개 / 최대 20개 │ ├──────────────────────────────────────────────────────────────┤ │ 주소 │체인 │통화 │상태 │활성 세션│누적 입금 │액션 │ │ TPool01... │TRON│USDT│● 사용 가능 │ 3 │$12,500 │[비활성]│ │ TPool02... │TRON│USDT│● 사용 가능 │ 1 │$8,200 │[비활성]│ │ 0xPool01...│BSC │USDT│● 사용 가능 │ 5 │$25,300 │[비활성]│ │ 0xPool02...│ETH │USDC│◐ 초기화 중 │ 0 │$0 │ │ │ TPool03... │TRON│USDT│○ 비활성 │ 0 │$3,100 │[활성화]│ └──────────────────────────────────────────────────────────────┘ ``` **풀 주소 상태 추상화** (IA 섹션 5 참조): | 파트너 표시 상태 | 배지 | 내부 조건 | |----------------|------|----------| | 사용 가능 | ● GREEN | approve=APPROVED, monitor=TRUE, active=TRUE | | 초기화 중 | ◐ ORANGE | approve IN (PENDING,APPROVING) 또는 monitor=FALSE | | 비활성 | ○ GRAY | active=FALSE | | 오류 | ● RED | approve=FAILED → "Super Admin에 문의하세요" | **풀 주소 생성 모달**: ``` ┌─────────────────────────────┐ │ 풀 주소 생성 │ ├─────────────────────────────┤ │ 체인: [BSC ▾] │ │ 통화: [USDT ▾] │ │ │ │ ⓘ 생성 후 초기화에 │ │ 1~5분 소요됩니다 │ │ │ │ [취소] [생성] │ └─────────────────────────────┘ ``` - **데이터 소스**: `GET /api/partner/pool-addresses` - **생성 API**: `POST /api/partner/pool-addresses` ### 5.4 입금 세션 현황 (소수점 매칭) ``` ┌──────────────────────────────────────────────────────────────┐ │ 입금 세션 현황 │ ├──────────────────────────────────────────────────────────────┤ │ 필터: [상태: 전체 ▾] [풀 주소: 전체 ▾] │ ├──────────────────────────────────────────────────────────────┤ │ [탭: 활성 세션 (8) | 완료 (245) | 만료 (12)] │ ├──────────────────────────────────────────────────────────────┤ │ 세션 ID │사용자 │요청 금액 │소수점 키│풀 주소 │남은 시간│상태 │ │ S-501 │user_789 │20.0317 USDT│0317 │TPool01│18:25 │●ACTIVE│ │ S-500 │user_456 │50.1284 USDT│1284 │TPool01│22:10 │●ACTIVE│ │ S-499 │user_123 │30.0592 USDC│0592 │0xPool │05:33 │⚠ACTIVE│ │ ... │ ├──────────────────────────────────────────────────────────────┤ │ ⚠ 남은 시간 5분 이하: 주황색 강조 │ │ 만료 세션 중 입금 발생 건 → [CS 센터 →] 링크 │ └──────────────────────────────────────────────────────────────┘ ``` - **데이터 소스**: `GET /api/partner/deposit-sessions` - 남은 시간 < 5분 → 주황색 배경 + ⚠ 아이콘 - 만료 탭에서 "입금 발생" 건은 빨간 배지 + CS 센터 8.4 링크 ### 5.5 집금 현황 ``` ┌──────────────────────────────────────────────────────────────┐ │ 집금 현황 │ ├──────────────────────────────────────────────────────────────┤ │ 필터: [상태: 전체 ▾] [체인: 전체 ▾] [기간: 오늘 ▾] │ ├──────────────────────────────────────────────────────────────┤ │ ID │금액 │통화 │체인 │상태 │소요 시간│일시 │ │ COL-301 │100.50 │USDT│BSC │● 완료 │5분 │14:30 │ │ COL-300 │ 75.00 │USDC│ETH │◐ 처리 중│— │14:25 │ │ COL-299 │500.00 │USDT│BSC │● 완료 │3분 │14:15 │ │ COL-298 │ 20.0317 │USDT│TRON│● 실패 │— │14:02 ⚠ │ └──────────────────────────────────────────────────────────────┘ ``` **집금 상태 추상화**: | 파트너 표시 | 배지 | 내부 상태 | |-----------|------|----------| | 대기 중 | ○ GRAY | PENDING_THRESHOLD, QUEUED | | 처리 중 | ◐ BLUE | PROCESSING, TX_SENT | | 완료 | ● GREEN | COMPLETED | | 실패 | ● RED | FAILED → "시스템이 자동 재시도합니다" | - **데이터 소스**: `GET /api/partner/collections` - 실패 건은 안내 메시지만 표시 (재시도는 Super Admin 영역) --- ## 6. 출금 관리 (Withdrawal Management) ### 6.1 출금 내역 조회 ``` ┌──────────────────────────────────────────────────────────────┐ │ 출금 관리 │ ├──────────────────────────────────────────────────────────────┤ │ 필터: │ │ [기간: 오늘 ▾] [상태: 전체 ▾] [소스: 전체 ▾] │ │ [체인: 전체 ▾] [검색: TX Hash / 사용자 ID ...] [검색] │ ├──────────────────────────────────────────────────────────────┤ │ 요약: 총 48건 │ $18,900 │ 승인대기 3건 │ 실패 1건 │ ├──────────────────────────────────────────────────────────────┤ │ ID │사용자 │금액 │통화 │체인 │소스 │상태 │일시 │ │ WD-501 │user_789 │200.00 │USDT│BSC │API │● CONFIRMED │14:30│ │ WD-500 │user_456 │ 50.00 │USDC│ETH │CONSOLE│◐ BROADCASTING│14:15│ │ WD-499 │user_123 │5,000.00 │USDT│BSC │API │⚠ PEND_APPR │14:02│ │ WD-498 │user_001 │100.00 │USDT│TRON│CONSOLE│● FAILED │13:50│ │ ... │ ├──────────────────────────────────────────────────────────────┤ │ [< 이전] [1] [2] [다음 >] 20건 | 50건 | 100건 │ └──────────────────────────────────────────────────────────────┘ ``` - **소스**: API(파트너 Public API에서 요청) / CONSOLE(콘솔에서 직접 요청) - **데이터 소스**: `GET /api/partner/withdrawals` - **상태 색상**: CONFIRMED=GREEN, BROADCASTING/PROCESSING=BLUE, PENDING_APPROVAL/BALANCE_PENDING=ORANGE, FAILED/REJECTED=RED, CANCELLED=GRAY ### 6.2 출금 상세 / 상태 이력 ``` ┌──────────────────────────────────────────────────────────────┐ │ 출금 상세 — WD-501 [뒤로] │ ├──────────────────────────────────────────────────────────────┤ │ │ │ ┌─ 기본 정보 ────────────────────────────────────────┐ │ │ │ 사용자 ID: user_789 │ │ │ │ 금액: 200.00 USDT │ │ │ │ 체인: BSC │ │ │ │ 수신 주소: 0xRecv... [복사] [BscScan →] │ │ │ │ TX Hash: 0xWithd... [복사] [BscScan →] │ │ │ │ 요청 소스: API │ │ │ │ 상태: ● CONFIRMED │ │ │ └──────────────────────────────────────────────────────┘ │ │ │ │ ┌─ 상태 이력 (타임라인) ──────────────────────────────┐ │ │ │ 14:30 ● CONFIRMED TX 컨펌 완료 │ │ │ │ 14:28 ◐ BROADCASTING TX 브로드캐스트 │ │ │ │ 14:26 ◐ PROCESSING 출금 처리 중 │ │ │ │ 14:25 ● APPROVED 자동 승인 (≤$1,000) │ │ │ │ 14:25 ○ REQUESTED 출금 요청 접수 │ │ │ └──────────────────────────────────────────────────────┘ │ │ │ │ ┌─ 승인 정보 ────────────────────────────────────────┐ │ │ │ 승인 방식: 자동 승인 (임계값 $1,000 이하) │ │ │ │ 승인 시각: 2026-02-25 14:25:03 │ │ │ └──────────────────────────────────────────────────────┘ │ │ │ │ ┌─ CS 메모 ──────────────────────────────── [메모 추가] ┐ │ │ │ (메모 없음) │ │ │ └────────────────────────────────────────────────────────┘ │ │ │ │ [출금 취소] ← REQUESTED/PENDING_APPROVAL/APPROVED 상태에서만│ └──────────────────────────────────────────────────────────────┘ ``` - **데이터 소스**: `GET /api/partner/withdrawals/{id}` - **취소 API**: `PATCH /api/partner/withdrawals/{id}/cancel` - 취소 가능 상태: REQUESTED, PENDING_APPROVAL, APPROVED, BALANCE_PENDING - BROADCASTING 이후는 취소 불가 → 버튼 숨김 ### 6.3 출금 요청 (콘솔 직접 출금) → 4.3 외부 출금과 동일한 화면. 모지갑 관리에서도, 출금 관리에서도 접근 가능. ### 6.4 출금 승인 관리 ``` ┌──────────────────────────────────────────────────────────────┐ │ 출금 승인 관리 │ ├──────────────────────────────────────────────────────────────┤ │ 승인 대기: 3건 │ 총 $7,500 │ ├──────────────────────────────────────────────────────────────┤ │ □ │ ID │사용자 │금액 │통화│체인│수신 주소 │요청일 │ │ □ │WD-499 │user_123 │5,000.00 │USDT│BSC│0xRecv... │14:02 │ │ □ │WD-497 │user_456 │1,500.00 │USDC│ETH│0xRecv... │13:45 │ │ □ │WD-495 │user_789 │1,000.00 │USDT│TRON│TRecv... │13:30 │ ├──────────────────────────────────────────────────────────────┤ │ 선택: 0건 [일괄 승인] [일괄 거부] │ └──────────────────────────────────────────────────────────────┘ ``` **승인 확인 모달**: ``` ┌─────────────────────────────────┐ │ 출금 승인 확인 │ ├─────────────────────────────────┤ │ 3건의 출금을 승인합니다: │ │ │ │ WD-499: 5,000.00 USDT → 0xR... │ │ WD-497: 1,500.00 USDC → 0xR... │ │ WD-495: 1,000.00 USDT → TR... │ │ │ │ 총 출금: $7,500.00 │ │ │ │ [취소] [승인 확인] │ └─────────────────────────────────┘ ``` - **승인 API**: `PATCH /api/partner/withdrawals/{id}/approve` - **거부 API**: `PATCH /api/partner/withdrawals/{id}/reject` (사유 입력 필수) - 일괄 처리: 체크박스 선택 → 일괄 승인/거부 ### 6.5 출금 주소 화이트리스트 ``` ┌──────────────────────────────────────────────────────────────┐ │ 출금 주소 화이트리스트 [주소 추가] │ ├──────────────────────────────────────────────────────────────┤ │ 체인 필터: [전체 ▾] │ ├──────────────────────────────────────────────────────────────┤ │ 주소 │라벨 │체인 │등록일 │액션 │ │ 0xABC123... │본사 지갑 │Ethereum │2026-01-15│[수정][삭제]│ │ 0xDEF456... │파트너B │BSC │2026-02-01│[수정][삭제]│ │ TWallet78... │정산 계좌 │TRON │2026-02-10│[수정][삭제]│ └──────────────────────────────────────────────────────────────┘ ``` **주소 추가 모달**: ``` ┌─────────────────────────────────┐ │ 화이트리스트 주소 추가 │ ├─────────────────────────────────┤ │ 체인: [Ethereum ▾] │ │ 주소: [0x... ] │ │ 라벨: [본사 지갑 ] │ │ │ │ ⚠ 주소 형식이 올바른지 │ │ 확인 후 추가해 주세요 │ │ │ │ [취소] [추가] │ └─────────────────────────────────┘ ``` - **데이터 소스**: `GET /api/partner/whitelist` - **추가**: `POST /api/partner/whitelist` - **삭제**: `DELETE /api/partner/whitelist/{id}` → 확인 모달 필수 - 주소 형식 유효성 검사: 체인별 주소 패턴 (0x... / T...) ### 6.6 출금 취소 출금 상세 화면(6.2)에서 [출금 취소] 버튼으로 실행. 취소 확인 모달: ``` ┌─────────────────────────────────┐ │ 출금 취소 확인 │ ├─────────────────────────────────┤ │ WD-499: 5,000.00 USDT │ │ 수신: 0xRecv123... │ │ │ │ 취소 사유: [____________] │ │ │ │ ⚠ 취소 후 되돌릴 수 없습니다 │ │ │ │ [닫기] [취소 확인] │ └─────────────────────────────────┘ ``` - **API**: `PATCH /api/partner/withdrawals/{id}/cancel` - 취소 가능 상태만 버튼 활성화 --- ## 7. 사용자 지갑 관리 (User Wallets) ### 7.1 사용자 지갑 목록/검색 ``` ┌──────────────────────────────────────────────────────────────┐ │ 사용자 지갑 관리 [지갑 생성 ★] │ ├──────────────────────────────────────────────────────────────┤ │ 검색: [사용자 ID / 주소 ...] [검색] │ │ 필터: [체인: 전체 ▾] [상태: 전체 ▾] │ ├──────────────────────────────────────────────────────────────┤ │ 사용자 ID │체인 │주소 │잔액 │상태 │생성일 │ │ user_789 │ETH │0xHot789... │$120.50 │●ACTIVE│01-15│ │ user_789 │BSC │0xHot789b... │$0.00 │●ACTIVE│01-15│ │ user_789 │TRON │THot789t... │$10.00 │●ACTIVE│01-20│ │ user_456 │BSC │0xHot456... │$500.00 │●ACTIVE│02-01│ │ user_123 │ETH │0xHot123... │$0.00 │○INACT │01-10│ │ ... │ ├──────────────────────────────────────────────────────────────┤ │ 총 1,250개 지갑 │ 활성 1,180개 │ 비활성 70개 │ └──────────────────────────────────────────────────────────────┘ ``` - **데이터 소스**: `GET /api/partner/user-wallets` - Approve 상태 숨김 (인프라 내부) - 행 클릭 → 7.3 사용자 지갑 상세 ### 7.2 사용자 지갑 생성 ``` ┌──────────────────────────────────────────────────────────────┐ │ 사용자 지갑 생성 │ ├──────────────────────────────────────────────────────────────┤ │ │ │ 사용자 ID: [________________] (파트너 측 사용자 식별자) │ │ 체인: [BSC ▾] (활성 체인만 선택 가능) │ │ 통화: [USDT ▾] │ │ │ │ [생성] │ │ │ │ ─── 생성 결과 ─── │ │ ┌────────────────────────────────────────────────────┐ │ │ │ ✅ 지갑이 생성되었습니다 │ │ │ │ │ │ │ │ 사용자: user_new_001 │ │ │ │ 체인: BSC │ │ │ │ 주소: 0xNewAddr123...456 [복사] [BscScan →] │ │ │ │ │ │ │ │ ⓘ 지갑 초기화에 1~5분 소요됩니다. │ │ │ │ 초기화 완료 후 입금이 가능합니다. │ │ │ └────────────────────────────────────────────────────┘ │ │ │ │ ⓘ 이미 존재하는 사용자+체인+통화 → 기존 주소 반환 │ └──────────────────────────────────────────────────────────────┘ ``` - **API**: `POST /api/partner/wallets/deposit-address` - 동일한 `POST /api/v2/wallets/deposit-address` 로직 - 기존 지갑 존재 시 → "이미 생성된 주소입니다" + 기존 주소 표시 ### 7.3 사용자 지갑 상세 ``` ┌──────────────────────────────────────────────────────────────┐ │ 사용자 지갑 상세 — user_789 [뒤로] │ ├──────────────────────────────────────────────────────────────┤ │ │ │ ┌─ 체인별 주소 ──────────────────────────────────────┐ │ │ │ ETH: 0xHot789... [복사] 잔액 $120.50 ●ACTIVE │ │ │ │ BSC: 0xHot789b... [복사] 잔액 $0.00 ●ACTIVE │ │ │ │ TRON: THot789t... [복사] 잔액 $10.00 ●ACTIVE │ │ │ └──────────────────────────────────────────────────────┘ │ │ │ │ [탭: 입금 이력 | 집금 이력 | 출금 이력] │ │ ┌──────────────────────────────────────────────────┐ │ │ │ 14:30 입금 100.50 USDT BSC ● SETTLED │ │ │ │ 13:20 입금 50.00 USDC ETH ● SETTLED │ │ │ │ 12:00 입금 20.0317 USDT TRON ● SETTLED │ │ │ │ ... │ │ │ └──────────────────────────────────────────────────┘ │ │ │ │ 입금 합계: $3,200 (15건) │ 집금 합계: $3,080 (12건) │ └──────────────────────────────────────────────────────────────┘ ``` - **데이터 소스**: `GET /api/partner/user-wallets/{userId}` - Approve 상태 미노출 (내부 인프라) - 잔액은 available만 표시 (locked는 "처리 중 금액"으로 추상화) --- ## 8. CS 센터 (Customer Support) ★ ### 8.1 TX Hash 통합 검색 ``` ┌──────────────────────────────────────────────────────────────┐ │ CS 센터 — TX Hash 검색 │ ├──────────────────────────────────────────────────────────────┤ │ │ │ 🔍 [0x1234abcd... ] [검색] │ │ │ │ ┌─ 검색 결과 ────────────────────────────────────────┐ │ │ │ │ │ │ │ ■ 입금 건 발견 │ │ │ │ ┌────────────────────────────────────────────┐ │ │ │ │ │ DEP-1234 │ 100.50 USDT │ BSC │ ● SETTLED │ │ │ │ │ │ 사용자: user_789 │ 14:30 [→] │ │ │ │ │ └────────────────────────────────────────────┘ │ │ │ │ │ │ │ │ ■ 집금 건 발견 │ │ │ │ ┌────────────────────────────────────────────┐ │ │ │ │ │ COL-301 │ 100.50 USDT │ BSC │ ● COMPLETED │ │ │ │ │ │ HOT → MASTER │ 14:35 [→] │ │ │ │ │ └────────────────────────────────────────────┘ │ │ │ │ │ │ │ │ ※ 검색 대상: deposits, withdrawals, │ │ │ │ collection_queue, webhook_events │ │ │ └────────────────────────────────────────────────────┘ │ │ │ │ 검색 결과 없음 시: "해당 TX Hash의 거래를 찾을 수 없습니다. │ │ 미식별 입금으로 등록되었을 수 있습니다. [미식별 입금 확인 →]" │ └──────────────────────────────────────────────────────────────┘ ``` - **API**: `GET /api/partner/cs/search/tx-hash/{hash}` - [→] 클릭 → 해당 건 상세 화면으로 이동 - 결과 없음 시 미식별 입금 화면 링크 제공 ### 8.2 주소 기반 검색 ``` ┌──────────────────────────────────────────────────────────────┐ │ CS 센터 — 주소 검색 │ ├──────────────────────────────────────────────────────────────┤ │ │ │ 🔍 [0xAddress... ] [검색] │ │ │ │ ┌─ 주소 정보 ────────────────────────────────────────┐ │ │ │ 유형: HOT 지갑 │ │ │ │ 소유자: user_789 │ │ │ │ 체인: BSC │ │ │ │ 잔액: $120.50 USDT │ │ │ │ 상태: ● ACTIVE │ │ │ └────────────────────────────────────────────────────┘ │ │ │ │ ┌─ 관련 거래 ────────────────────────────────────────┐ │ │ │ [탭: 입금 (15건) | 출금 (3건) | 집금 (12건)] │ │ │ │ │ │ │ │ 14:30 ▼ 입금 100.50 USDT ● SETTLED [→] │ │ │ │ 14:15 ▲ 출금 50.00 USDC ● CONFIRMED [→] │ │ │ │ 14:10 ◐ 집금 100.50 USDT ● COMPLETED [→] │ │ │ │ ... │ │ │ └────────────────────────────────────────────────────┘ │ │ │ │ 주소가 우리 시스템에 없는 경우: │ │ "시스템에 등록되지 않은 주소입니다." │ └──────────────────────────────────────────────────────────────┘ ``` - **API**: `GET /api/partner/cs/search/address/{addr}` ### 8.3 미식별 입금 관리 ``` ┌──────────────────────────────────────────────────────────────┐ │ CS 센터 — 미식별 입금 │ ├──────────────────────────────────────────────────────────────┤ │ 필터: [상태: 전체 ▾] [체인: 전체 ▾] [기간: 최근 30일 ▾] │ ├──────────────────────────────────────────────────────────────┤ │ TX Hash │FROM 주소 │TO 주소 │금액 │입금일│상태 │액션│ │ 0xAbc... │0xSender... │0xHot... │100 USDT│02-24│●PENDING│[매칭요청]│ │ 0xDef... │0xUnkn... │0xPool... │ 50 USDT│02-23│◐CS_REQ │[상태확인]│ │ 0xGhi... │0xSender2.. │0xHot2... │200 USDC│02-22│●MATCHED│ │ │ 0xJkl... │0xSender3.. │0xPool2.. │ 75 USDT│02-20│●REFUND │ │ └──────────────────────────────────────────────────────────────┘ ``` **상태 배지**: | 상태 | 배지 | 설명 | |------|------|------| | PENDING | ● ORANGE | 미처리 — 매칭 요청 가능 | | CS_REQUESTED | ◐ BLUE | 파트너가 매칭 요청함 — Super Admin 검토 중 | | MATCHED | ● GREEN | 매칭 완료 → deposits에 반영됨 | | REFUNDED | ● GREEN | 환불 처리 완료 | **매칭 요청 모달**: ``` ┌──────────────────────────────────────┐ │ CS 매칭 요청 │ ├──────────────────────────────────────┤ │ TX Hash: 0xAbc123... │ │ 금액: 100 USDT │ │ FROM: 0xSender... │ │ │ │ 대상 사용자 ID: [user_789 ] │ │ 사유: │ │ [거래소에서 출금하여 FROM 주소가 ] │ │ [다릅니다. 사용자 확인 완료. ] │ │ │ │ 증빙 첨부: [파일 선택] (선택사항) │ │ │ │ [취소] [매칭 요청 제출] │ └──────────────────────────────────────┘ ``` - **목록 API**: `GET /api/partner/cs/unidentified-deposits` - **매칭 요청**: `POST /api/partner/cs/unidentified-deposits/{id}/match-request` ### 8.4 세션 만료 입금 복구 ``` ┌──────────────────────────────────────────────────────────────┐ │ CS 센터 — 세션 만료 입금 복구 │ ├──────────────────────────────────────────────────────────────┤ │ │ │ ┌─ 만료 세션 목록 ───────────────────────────────────┐ │ │ │ 세션 ID │ 사용자 │ 요청 금액 │ 소수점 키 │ 만료 시각 │ │ │ │ S-123 │ user_A │ 20.0317 USDT │ 0317 │ 14:30 │ │ │ │ S-120 │ user_B │ 50.1284 USDT │ 1284 │ 13:45 │ │ │ └──────────────────────────────────────────────────────┘ │ │ │ │ 세션 S-123 선택 시: │ │ ┌─ 매칭 가능한 입금 ─────────────────────────────────┐ │ │ │ TX Hash │ 금액 │ TO 주소 │ 입금 시각 │ │ │ │ 0xAbc... │ 20.0317 USDT │ TPool01... │ 14:35 ✓ │ │ │ │ 0xDef... │ 20.0500 USDT │ TPool01... │ 14:40 │ │ │ └──────────────────────────────────────────────────────┘ │ │ │ │ ✓ = 금액 일치 │ │ │ │ [수동 매칭: S-123 ↔ 0xAbc...] [환불 요청] │ │ │ │ ⓘ 수동 매칭: 세션과 입금을 연결하여 정상 입금으로 처리 │ │ ⓘ 환불 요청: Super Admin에게 환불 에스컬레이션 │ └──────────────────────────────────────────────────────────────┘ ``` - **만료 세션**: `GET /api/partner/cs/expired-sessions` - **수동 매칭**: `POST /api/partner/cs/expired-sessions/{id}/recover` - **환불 요청**: 매칭 요청 모달과 유사 (사유: "세션 만료 후 입금, 환불 요청") - 금액 일치 건은 ✓ 표시로 매칭 추천 ### 8.5 금액 불일치 입금 ``` ┌──────────────────────────────────────────────────────────────┐ │ CS 센터 — 금액 불일치 │ ├──────────────────────────────────────────────────────────────┤ │ │ │ ┌───────────────────────────────────────────────────────┐ │ │ │ 세션 ID │요청 금액 │실제 입금 │차액 │유형 │ │ │ │ S-130 │20.0317 USDT│15.0317 USDT│-5.00 │부족 입금│ │ │ │ S-128 │50.1284 USDT│55.1284 USDT│+5.00 │초과 입금│ │ │ └───────────────────────────────────────────────────────┘ │ │ │ │ 부족 입금 (S-130): │ │ ┌─ 대응 옵션 ───────────────────────────────────────┐ │ │ │ [추가 입금 세션 생성] 차액 $5.00에 대한 새 세션 생성 │ │ │ │ [환불 요청] 전액 환불을 Super Admin에 요청 │ │ │ └──────────────────────────────────────────────────────┘ │ │ │ │ 초과 입금 (S-128): │ │ ┌─ 처리 상태 ───────────────────────────────────────┐ │ │ │ ✅ 요청 금액 기준 정상 처리됨 │ │ │ │ 차액 $5.00은 잔액에 반영 │ │ │ └──────────────────────────────────────────────────────┘ │ │ │ └──────────────────────────────────────────────────────────────┘ ``` - **API**: `GET /api/partner/cs/amount-mismatches` - 부족 입금: 추가 세션 생성 또는 환불 요청 선택 - 초과 입금: 자동 처리 확인 + 차액 안내 ### 8.6 CS 메모 관리 ``` ┌──────────────────────────────────────────────────────────────┐ │ CS 메모 │ ├──────────────────────────────────────────────────────────────┤ │ 검색: [입금/출금 ID 또는 사용자 ID ...] [검색] │ ├──────────────────────────────────────────────────────────────┤ │ 대상 │ 메모 내용 │ 작성자 │ 일시 │ │ DEP-1234 │ 사용자 문의: 거래소 출금 확인... │ admin_A│ 14:30│ │ WD-498 │ TX 실패 원인: 가스 부족... │ admin_B│ 13:50│ │ user_789 │ VIP 고객, 우선 처리 요청 │ admin_A│ 13:20│ │ ... │ └──────────────────────────────────────────────────────────────┘ ``` - **조회 API**: `GET /api/partner/cs/notes/{type}/{id}` - **추가 API**: `POST /api/partner/cs/notes` - 입금 상세(5.2), 출금 상세(6.2) 화면에서도 인라인으로 메모 추가/조회 가능 ### 8.7 사용자 문의 검색 ``` ┌──────────────────────────────────────────────────────────────┐ │ CS 센터 — 사용자 검색 │ ├──────────────────────────────────────────────────────────────┤ │ │ │ 🔍 사용자 ID: [user_789 ] [검색] │ │ │ │ ┌─ 사용자 요약 ──────────────────────────────────────┐ │ │ │ 사용자 ID: user_789 │ │ │ │ 총 입금: $3,200 (15건) │ │ │ │ 총 출금: $500 (3건) │ │ │ │ 마지막 활동: 2026-02-25 14:30 │ │ │ └────────────────────────────────────────────────────┘ │ │ │ │ [탭: 지갑 | 입금 이력 | 출금 이력 | 소수점 세션 | 외부 지갑] │ │ │ │ ── 지갑 탭 ── │ │ ETH: 0xHot789... 잔액 $120.50 ● ACTIVE │ │ BSC: 0xHot789b... 잔액 $0.00 ● ACTIVE │ │ TRON: THot789t... 잔액 $10.00 ● ACTIVE │ │ │ │ ── 입금 이력 탭 ── │ │ 14:30 100.50 USDT BSC HD ● SETTLED │ │ 13:20 50.00 USDC ETH EW ● SETTLED │ │ ... │ │ │ │ ── 소수점 세션 탭 ── │ │ 활성: 1건 (20.0317 USDT, 남은 12분) │ │ 완료: 4건 │ │ ... │ │ │ │ ── 외부 지갑 탭 (Axim 연결) ── │ │ BSC: 0xUser... ● CONNECTED │ └──────────────────────────────────────────────────────────────┘ ``` - **API**: `GET /api/partner/cs/search/user/{userId}` - 모든 관련 정보를 한 화면에서 통합 조회 - 각 섹션 [→] 클릭으로 상세 화면 이동 가능 --- ## 9. 결제 링크 (Payment Links) ### 9.1 결제 링크 목록 ``` ┌──────────────────────────────────────────────────────────────┐ │ 결제 링크 [결제 링크 생성] │ ├──────────────────────────────────────────────────────────────┤ │ 필터: [상태: 전체 ▾] [기간: 최근 30일 ▾] │ ├──────────────────────────────────────────────────────────────┤ │ ID │제목 │금액 │통화 │상태 │생성일│만료일 │액션│ │ PL-301 │상품A 결제 │100.00 │USDT│● ACTIVE│02-24│03-24 │[복사]│ │ PL-300 │구독 결제 │ 50.00 │USDC│● ACTIVE│02-20│03-20 │[복사]│ │ PL-299 │테스트 │ 10.00 │USDT│● PAID │02-18│02-28 │ │ │ PL-298 │이벤트 │200.00 │USDT│○EXPIRED│02-01│02-15 │ │ └──────────────────────────────────────────────────────────────┘ ``` ### 9.2 결제 링크 생성 ``` ┌──────────────────────────────────────────────────────────────┐ │ 결제 링크 생성 │ ├──────────────────────────────────────────────────────────────┤ │ │ │ 제목: [상품A 결제 ] │ │ 설명: [상품A 구매 대금 ] (선택) │ │ 금액: [100.00 ] │ │ 통화: [USDT ▾] │ │ 허용 체인: [✓ ETH] [✓ BSC] [✓ TRON] │ │ 만료일: [2026-03-25] │ │ │ │ 고급 옵션: │ │ └─ 콜백 URL: [https://...] (결제 완료 시 리다이렉트) │ │ └─ 메타데이터: [order_id=12345] (key=value) │ │ │ │ [생성] │ │ │ │ ─── 생성 결과 ─── │ │ 결제 링크: https://pay.cryptoments.cc/pl/abc123 [복사] │ │ QR 코드: [QR 이미지] [다운로드] │ └──────────────────────────────────────────────────────────────┘ ``` - **생성 API**: `POST /api/partner/payment-links` - QR 코드 자동 생성 (프론트엔드 라이브러리) ### 9.3 결제 링크 상세 ``` ┌──────────────────────────────────────────────────────────────┐ │ 결제 링크 상세 — PL-301 [뒤로] │ ├──────────────────────────────────────────────────────────────┤ │ │ │ 제목: 상품A 결제 │ │ 금액: 100.00 USDT │ │ 상태: ● ACTIVE │ │ 링크: https://pay.cryptoments.cc/pl/abc123 [복사] │ │ QR: [QR 이미지] │ │ 생성일: 2026-02-24 │ 만료일: 2026-03-24 │ │ │ │ ┌─ 입금 예약 현황 ───────────────────────────────────┐ │ │ │ (입금 대기 중 — 아직 결제 없음) │ │ │ │ 또는: │ │ │ │ ✅ 2026-02-25 14:30 100.00 USDT BSC DEP-1234 │ │ │ └────────────────────────────────────────────────────┘ │ │ │ │ [비활성화] [링크 복사] │ └──────────────────────────────────────────────────────────────┘ ``` - **데이터 소스**: `GET /api/partner/payment-links/{id}` --- ## 10. Axim Pay 연동 ### 10.1 Axim Pay 설정 ``` ┌──────────────────────────────────────────────────────────────┐ │ Axim Pay 설정 │ ├──────────────────────────────────────────────────────────────┤ │ │ │ 연동 상태: ● 연결됨 │ │ │ │ Axim API Key: ak_xxxx...xxxx [복사] │ │ Axim API Secret: as_xxxx •••••• [표시] [복사] │ │ 생성일: 2026-01-20 [키 재발급] │ │ │ │ ⚠ Axim API Secret은 재발급 시에만 전체 확인 가능 │ │ │ │ ─── 미연결 시 ─── │ │ Axim Pay를 연동하려면 Axim 계정이 필요합니다. │ │ [Axim Pay 연동 시작] → 설정 마법사 │ └──────────────────────────────────────────────────────────────┘ ``` ### 10.2 Axim 결제 내역 ``` ┌──────────────────────────────────────────────────────────────┐ │ Axim 결제 내역 │ ├──────────────────────────────────────────────────────────────┤ │ 필터: [기간: 최근 30일 ▾] [상태: 전체 ▾] │ ├──────────────────────────────────────────────────────────────┤ │ ID │사용자 │금액 │통화│체인│상태 │일시 │ │ AX-201 │user_789 │100.00 │USDT│BSC│● SETTLED│02-24 │ │ AX-200 │user_456 │ 50.00 │USDC│ETH│● SETTLED│02-23 │ │ ... │ └──────────────────────────────────────────────────────────────┘ ``` ### 10.3 외부 지갑 연결 현황 ``` ┌──────────────────────────────────────────────────────────────┐ │ 외부 지갑 연결 │ ├──────────────────────────────────────────────────────────────┤ │ 사용자 ID │체인 │외부 주소 │상태 │연결일 │ │ user_789 │BSC │0xUserExt... │● CONNECTED│02-20 │ │ user_456 │ETH │0xUserExt2.. │● CONNECTED│02-18 │ │ user_123 │TRON │TUserExt... │○ DISCONN │02-15 │ └──────────────────────────────────────────────────────────────┘ ``` --- ## 11. 하위 파트너 관리 (Parent Partner만) > 이 메뉴는 `role === 'PARENT_PARTNER'` 일 때만 사이드바에 표시됩니다. ### 11.1 하위 파트너 목록 ``` ┌──────────────────────────────────────────────────────────────┐ │ 하위 파트너 관리 [하위 파트너 추가] │ ├──────────────────────────────────────────────────────────────┤ │ ID │파트너명 │상태 │입금(30일)│출금(30일)│MASTER 잔액│생성일│ │ P-201 │Sub-A │●ACTIVE│$45,200 │$12,300 │$28,400 │01-15│ │ P-202 │Sub-B │●ACTIVE│$23,100 │$8,500 │$15,200 │01-20│ │ P-203 │Sub-C │○INACT │$0 │$0 │$0 │02-01│ └──────────────────────────────────────────────────────────────┘ ``` ### 11.2 하위 파트너 추가 ``` ┌──────────────────────────────────────────────────────────────┐ │ 하위 파트너 추가 │ ├──────────────────────────────────────────────────────────────┤ │ │ │ 파트너명: [Sub Partner D ] │ │ 이메일: [sub-d@example.com ] │ │ 초기 비밀번호: [•••••••• ] │ │ │ │ 입금 방식: │ │ [✓ HD 전용 지갑] [□ 외부 지갑 매핑] [□ 소수점 매칭] │ │ │ │ 활성 체인: │ │ [✓ Ethereum] [✓ BSC] [□ TRON] [□ Polygon] │ │ │ │ ⓘ 생성 후 하위 파트너가 로그인하여 세부 설정 가능 │ │ │ │ [취소] [생성] │ └──────────────────────────────────────────────────────────────┘ ``` - **API**: `POST /api/partner/sub-partners` ### 11.3 하위 파트너 상세 / 수정 ``` ┌──────────────────────────────────────────────────────────────┐ │ 하위 파트너 상세 — Sub-A (P-201) [뒤로] │ ├──────────────────────────────────────────────────────────────┤ │ │ │ [탭: 기본 정보 | 거래 현황 | 정책 설정] │ │ │ │ ── 기본 정보 탭 ── │ │ 파트너명: Sub-A [수정] │ │ 이메일: sub-a@example.com [수정] │ │ 상태: ● ACTIVE [비활성화] │ │ 생성일: 2026-01-15 │ │ │ │ ── 거래 현황 탭 ── │ │ 오늘: 입금 $3,200 (12건) / 출금 $1,000 (4건) │ │ 이번 달: 입금 $45,200 (156건) / 출금 $12,300 (48건) │ │ MASTER 잔액: $28,400 │ │ │ │ 최근 거래 10건 테이블 ... │ │ │ │ ── 정책 설정 탭 ── │ │ (Parent가 하위 파트너의 정책을 직접 수정 가능) │ │ 출금 한도, 자동 승인 임계값, 화이트리스트 모드 등 │ │ │ │ [상태 변경: ACTIVE ↔ INACTIVE ↔ SUSPENDED] │ └──────────────────────────────────────────────────────────────┘ ``` - **데이터 소스**: `GET /api/partner/sub-partners/{id}` - **수정 API**: `PUT /api/partner/sub-partners/{id}` - **상태 변경 API**: `PATCH /api/partner/sub-partners/{id}/status` - Parent는 하위 파트너의 정책을 조회/수정할 수 있음 --- ## 12. 가스비 청구 (Gas Cost) ### 12.1 가스비 청구서 목록 ``` ┌──────────────────────────────────────────────────────────────┐ │ 가스비 청구 │ ├──────────────────────────────────────────────────────────────┤ │ 기간: [2026 ▾] │ ├──────────────────────────────────────────────────────────────┤ │ 월 │총 가스비 │Approve │집금 │출금 │가스지원│상태 │ │ 2026-02 │$125.40 │$32.50 │$48.20 │$38.70 │$6.00 │◐ 미정산│ │ 2026-01 │$198.30 │$45.80 │$72.50 │$65.00 │$15.00│● 정산 │ │ 2025-12 │$156.20 │$38.00 │$58.20 │$52.00 │$8.00 │● 정산 │ └──────────────────────────────────────────────────────────────┘ ``` ### 12.2 청구서 상세 ``` ┌──────────────────────────────────────────────────────────────┐ │ 가스비 청구서 — 2026년 2월 [뒤로] │ ├──────────────────────────────────────────────────────────────┤ │ │ │ 기간: 2026-02-01 ~ 2026-02-25 (진행 중) │ │ 총 가스비: $125.40 │ │ 상태: ◐ 미정산 │ │ │ │ ┌─ 체인별 내역 ──────────────────────────────────────┐ │ │ │ 체인 │ Approve │ 집금 │ 출금 │ 가스지원 │ 합계 │ │ │ │ Ethereum │ $18.50 │ $28.20 │ $22.30 │ $3.00 │ $72.00│ │ │ │ BSC │ $8.00 │ $12.00 │ $10.40 │ $2.00 │ $32.40│ │ │ │ TRON │ $6.00 │ $8.00 │ $6.00 │ $1.00 │ $21.00│ │ │ └──────────────────────────────────────────────────────┘ │ │ │ │ ┌─ 유형별 내역 ──────────────────────────────────────┐ │ │ │ 유형 │ TX 수 │ 평균 가스비 │ 합계 │ │ │ │ Approve │ 45 │ $0.72 │ $32.50 │ │ │ │ 집금 │ 120 │ $0.40 │ $48.20 │ │ │ │ 출금 │ 48 │ $0.81 │ $38.70 │ │ │ │ 가스 지원 │ 30 │ $0.20 │ $6.00 │ │ │ └──────────────────────────────────────────────────────┘ │ │ │ │ [상세 내역 다운로드 (CSV)] │ └──────────────────────────────────────────────────────────────┘ ``` - **데이터 소스**: `GET /api/partner/gas-costs/{invoiceId}` ### 12.3 가스비 사용 추이 ``` ┌──────────────────────────────────────────────────────────────┐ │ 가스비 사용 추이 [기간: 6개월 ▾] │ ├──────────────────────────────────────────────────────────────┤ │ │ │ $200 ┤ │ │ │ ╭─╮ │ │ $150 ┤ ╭─╮ │ │ ╭─╮ │ │ │ ╭─╮ │ │ │ │ │ │ ╭─╮ │ │ $100 ┤ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ $50 ┤ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ $0 ┼─┴─┴─┴─┴───┴─┴───┴─┴───┴─┴── │ │ Sep Oct Nov Dec Jan Feb │ │ │ │ ── Approve (파랑) ── 집금 (초록) ── 출금 (주황) │ └──────────────────────────────────────────────────────────────┘ ``` - **데이터 소스**: `GET /api/partner/gas-costs` → 월별 집계 → 차트 렌더링 - 차트: Bar Chart (유형별 스택) 또는 Line Chart (추이) --- ## 13. 통계 (Statistics) ### 13.1 기간별 거래 통계 ``` ┌──────────────────────────────────────────────────────────────┐ │ 거래 통계 │ ├──────────────────────────────────────────────────────────────┤ │ 기간: [2026-02-01] ~ [2026-02-25] [조회] │ │ 구분: [◉ 입금 ○ 출금] │ ├──────────────────────────────────────────────────────────────┤ │ │ │ ┌─ 기간 합계 ────────────────────────────────────────┐ │ │ │ 총 건수: 1,245건 │ 총 금액: $385,200 │ │ │ │ 일 평균: 49.8건 │ 일 평균: $15,408 │ │ │ └────────────────────────────────────────────────────┘ │ │ │ │ [일별 추이 차트] │ │ $30K ┤ ╭╮ │ │ │ ╭╮ ││ ╭╮ ╭╮ │ │ $20K ┤ ││ ││ ││╭╮ ││ ╭╮ │ │ │ ╭╮││ ││ ││││ ││ ││ │ │ $10K ┤ ││││ ││ ││││ ││ ││ │ │ $0 ┼─┴┴┴┴─┴┴─┴┴┴┴─┴┴─┴┴── │ │ 1 5 10 15 20 25 │ │ │ │ ┌─ 일별 데이터 테이블 ───────────────────────────────┐ │ │ │ 날짜 │ 건수 │ 금액 │ 평균 금액 │ HD │ EW │ DM │ │ │ │ 02-25 │ 42 │ $12,350 │ $294 │ 72%│18%│10%│ │ │ │ 02-24 │ 55 │ $18,200 │ $331 │ 68%│20%│12%│ │ │ │ ... │ │ │ └──────────────────────────────────────────────────┘ │ │ │ │ [CSV 다운로드] [Excel 다운로드] │ └──────────────────────────────────────────────────────────────┘ ``` ### 13.2 체인별 통계 ``` ┌──────────────────────────────────────────────────────────────┐ │ 체인별 통계 기간: [2026-02-01 ~ 02-25] │ ├──────────────────────────────────────────────────────────────┤ │ │ │ [도넛 차트: 체인별 거래 비중] │ │ │ │ BSC ████████████████ 58% $223,400 720건 │ │ Ethereum ████████ 28% $107,900 350건 │ │ TRON ████ 14% $53,900 175건 │ │ │ │ 합계: $385,200 / 1,245건 │ └──────────────────────────────────────────────────────────────┘ ``` ### 13.3 입금 방식별 통계 ``` ┌──────────────────────────────────────────────────────────────┐ │ 입금 방식별 통계 기간: [2026-02-01 ~ 02-25] │ ├──────────────────────────────────────────────────────────────┤ │ │ │ HD 전용 지갑 ████████████████ 68% 845건 $261,900 │ │ 외부 지갑 매핑 ██████ 22% 275건 $84,700 │ │ 소수점 매칭 ███ 10% 125건 $38,600 │ │ │ │ ┌─ 방식별 상세 ──────────────────────────────────────┐ │ │ │ 방식 │ 건수 │ 금액 │ 평균 │ 정산율 │ │ │ │ HD 전용 │ 845 │ $261,900│ $310│ 98.5% │ │ │ │ 외부 지갑 │ 275 │ $84,700 │ $308│ 97.2% │ │ │ │ 소수점 매칭 │ 125 │ $38,600 │ $309│ 94.8% │ │ │ └──────────────────────────────────────────────────┘ │ │ ⓘ 정산율 = SETTLED 건수 / 전체 건수 │ └──────────────────────────────────────────────────────────────┘ ``` ### 13.4 수수료 통계 ``` ┌──────────────────────────────────────────────────────────────┐ │ 수수료 통계 기간: [2026-02-01 ~ 02-25] │ ├──────────────────────────────────────────────────────────────┤ │ │ │ 총 입금 수수료: $1,926 (입금 $385,200 × 0.5%) │ │ 총 출금 수수료: $567 (출금 $113,400 × 0.5%) │ │ 합계: $2,493 │ │ │ │ [일별 수수료 추이 차트] │ │ ... │ └──────────────────────────────────────────────────────────────┘ ``` ### 13.5 리포트 다운로드 ``` ┌──────────────────────────────────────────────────────────────┐ │ 리포트 다운로드 │ ├──────────────────────────────────────────────────────────────┤ │ │ │ 기간: [2026-02-01] ~ [2026-02-25] │ │ 유형: [✓ 입금 내역] [✓ 출금 내역] [□ 집금 내역] │ │ [□ 수수료 내역] [□ 가스비 내역] │ │ 형식: ◉ CSV ○ Excel │ │ │ │ [다운로드] │ │ │ │ ┌─ 최근 다운로드 ────────────────────────────────────┐ │ │ │ 02-25 14:30 입금내역_202602.csv [재다운로드] │ │ │ │ 02-24 10:15 출금내역_202602.xlsx [재다운로드] │ │ │ └──────────────────────────────────────────────────┘ │ └──────────────────────────────────────────────────────────────┘ ``` - **API**: `POST /api/partner/reports/download` → 비동기 생성 → 다운로드 링크 반환 --- ## 14. 설정 (Settings) ### 14.1 계정 정보 관리 ``` ┌──────────────────────────────────────────────────────────────┐ │ 계정 설정 │ ├──────────────────────────────────────────────────────────────┤ │ │ │ 파트너명: Acme Corp [수정] │ │ 이메일: admin@acme.com [수정] │ │ 역할: PARENT_PARTNER │ │ 파트너 ID: P-001 │ │ 가입일: 2026-01-15 │ │ │ │ 담당자명: [홍길동 ] [저장] │ │ 담당자 연락처: [010-1234-5678 ] [저장] │ └──────────────────────────────────────────────────────────────┘ ``` ### 14.2 비밀번호 변경 ``` ┌──────────────────────────────────────────────────────────────┐ │ 비밀번호 변경 │ ├──────────────────────────────────────────────────────────────┤ │ │ │ 현재 비밀번호: [•••••••• ] │ │ 새 비밀번호: [•••••••• ] │ │ 비밀번호 확인: [•••••••• ] │ │ │ │ ⓘ 비밀번호 규칙: │ │ - 8자 이상 │ │ - 영문 대/소문자, 숫자, 특수문자 포함 │ │ │ │ [변경] │ └──────────────────────────────────────────────────────────────┘ ``` ### 14.3 API Key / Secret 확인 → 2.5 API Key / Secret 관리와 동일 화면으로 이동 (중복 방지 링크) --- ## 부록 A. 상태 배지 색상 표 | 색상 | 코드 | 적용 상태 | |------|------|----------| | GREEN (초록) | `#27ae60` | CONFIRMED, SETTLED, APPROVED, COMPLETED, ACTIVE, MATCHED, REFUNDED, 사용 가능 | | BLUE (파랑) | `#2980b9` | PROCESSING, BROADCASTING, COLLECTING, CS_REQUESTED, 처리 중 | | ORANGE (주황) | `#f39c12` | PENDING_APPROVAL, BALANCE_PENDING, PENDING, 초기화 중 | | RED (빨강) | `#e74c3c` | FAILED, REJECTED, COLLECTION_FAILED, 오류 | | GRAY (회색) | `#95a5a6` | CANCELLED, EXPIRED, INACTIVE, 비활성 | ## 부록 B. 풀 주소 상태 추상화 매핑 | 파트너 표시 | 배지 | 내부 조건 | 설명 | |-----------|------|----------|------| | **사용 가능** | ● GREEN | approve_status=APPROVED AND monitor_registered=TRUE AND is_active=TRUE | 세션 생성 가능 | | **초기화 중** | ◐ ORANGE | approve IN (PENDING, APPROVING) OR monitor=FALSE | 시스템 준비 중 | | **비활성** | ○ GRAY | is_active=FALSE | 수동 비활성화 | | **오류** | ● RED | approve_status=FAILED | Super Admin 문의 필요 | ## 부록 C. 집금 상태 추상화 매핑 | 파트너 표시 | 배지 | 내부 상태 | 설명 | |-----------|------|----------|------| | **대기 중** | ○ GRAY | PENDING_THRESHOLD, QUEUED | 집금 조건 대기/큐 대기 | | **처리 중** | ◐ BLUE | PROCESSING, TX_SENT | TX 생성/전송 중 | | **완료** | ● GREEN | COMPLETED | 집금 TX 확정 | | **실패** | ● RED | FAILED | 자동 재시도 예정 | ## 부록 D. 권한별 메뉴 표시 | 메뉴 | PARENT | SUB | PARTNER | |------|:------:|:---:|:-------:| | 1. 대시보드 | ✅ (자신+하위) | ✅ (자신) | ✅ (자신) | | 2. 정책 관리 | ✅ | ✅ | ✅ | | 3. 알림 설정 | ✅ | ✅ | ✅ | | 4. 모지갑 관리 | ✅ | ✅ | ✅ | | 5. 입금 관리 | ✅ | ✅ | ✅ | | 6. 출금 관리 | ✅ | ✅ | ✅ | | 7. 사용자 지갑 | ✅ | ✅ | ✅ | | 8. CS 센터 | ✅ | ✅ | ✅ | | 9. 결제 링크 | ✅ | ✅ | ✅ | | 10. Axim Pay | ✅ | ✅ | ✅ | | **11. 하위 파트너** | **✅** | ❌ | ❌ | | 12. 가스비 청구 | ✅ | ✅ | ✅ | | 13. 통계 | ✅ (자신+하위) | ✅ (자신) | ✅ (자신) | | 14. 설정 | ✅ | ✅ | ✅ | --- > **관련 문서**: > - [CRYPTOMENTS_ADMIN_CONSOLE_IA.md](CRYPTOMENTS_ADMIN_CONSOLE_IA.md) — 전체 IA 정의 > - [CRYPTOMENTS_ADMIN_CONSOLE_UI_GUIDE.md](CRYPTOMENTS_ADMIN_CONSOLE_UI_GUIDE.md) — Super Admin Console UI 가이드 > - [CRYPTOMENTS_V2_API_SPEC.md](CRYPTOMENTS_V2_API_SPEC.md) — API 명세 > - [CRYPTOMENTS_V2_DDL.sql](CRYPTOMENTS_V2_DDL.sql) — 데이터베이스 스키마 > - [CRYPTOMENTS_V2_COMPONENT_SPEC.md](CRYPTOMENTS_V2_COMPONENT_SPEC.md) — 컴포넌트 명세