추천 시스템 관리

1. 개요 탭

개요 통계

단계	작업	세부 사항
1	추천 관리 접속	메인 메뉴에서 Referrals로 이동한 다음 Manage로 이동합니다.
2	개요 탭 확인	Overview가 기본으로 선택되어 있습니다.
3	대기 중인 청구 검토	카드에 심사 대기 중인 커미션 청구 수가 표시됩니다 (예: "0").
4	총 지급 커미션 검토	카드에 추천인에게 지급된 누적 금액이 표시됩니다 (예: "$0").
5	총 활성 추천인 검토	카드에 현재 추천 커미션을 받고 있는 사용자 수가 표시됩니다.
6	대기 중인 청구 검토 작업	Review Pending Claims를 클릭하여 Manual review queue 탭을 엽니다.

등급 관리

단계	작업	세부 사항
1	등급 관리 열기	개요 탭에서 Tier management 섹션으로 스크롤합니다.
2	등급 테이블 확인	테이블 열: Name, Commission Distribution Rate (예: "L1: 7%, L2: 2%, L3: 1%"), 행별 Edit 버튼.
3	등급 검색	Search for tier를 사용하여 이름으로 등급을 필터링합니다.
5	등급 생성	+ Create new tier를 클릭하여 생성 대화 상자를 엽니다.

새 등급 생성

단계	작업	세부 사항
1	대화 상자 열기	Create new tier 대화 상자가 나타납니다.
2	등급 이름	Tier name에 고유한 이름을 입력합니다.
3	커미션 배분율 (%)	스핀 버튼으로 Level 1 (Direct), Level 2, Level 3을 설정합니다 (기본값 예: 5, 3, 2).
4	저장 또는 취소	Save로 생성; Cancel로 저장하지 않고 닫기.

등급 생성 필드

필드	설명	기본값 (예시)
Tier name	등급의 고유 이름 (예: "KOL", "Default", "Premium").	(비어 있음)
Level 1 (Direct)	직접 추천에 대한 커미션 %.	5
Level 2	두 번째 레벨 추천에 대한 커미션 %.	3
Level 3	세 번째 레벨 추천에 대한 커미션 %.	2

등급 편집 대화 상자

단계	작업	세부 사항
1	대화 상자 열기	등급 행에서 Edit를 클릭하면 Edit tier 대화 상자가 열립니다.
2	이름	Name은 읽기 전용(비활성화); 여기서 등급 이름을 변경할 수 없습니다.
3	커미션 배분율 (%)	스핀 버튼으로 Level 1 (Direct), Level 2, Level 3을 편집합니다.
4	추천인 수	대화 상자에 "Referrer in this tier: N" (예: 68)이 표시됩니다.
5	저장 또는 취소	Save로 적용; Cancel로 저장하지 않고 닫기.

등급 편집

단계	작업	세부 사항
1	등급 찾기	등급 관리 테이블에서 등급을 찾습니다.
2	편집	해당 행에서 Edit를 클릭합니다.
3	설정 변경	레벨 1, 2, 3 비율을 업데이트합니다 (편집 시 이름은 읽기 전용).
4	저장 또는 취소	Save로 적용; Cancel로 취소.

예시 등급

등급 이름	레벨 1	레벨 2	레벨 3	설명
KOL	30%	10%	10%	주요 오피니언 리더 / 인플루언서용.
Default	5%	3%	2% (또는 구성에 따라)	일반 사용자를 위한 표준 등급.

2. 사용자 네트워크 탭

사용자 네트워크 조회

단계	작업	세부 사항
1	탭 열기	User network 탭을 선택합니다.
2	테이블 확인	테이블에 추천 정보가 있는 사용자 목록이 표시됩니다 (아래 열 목록 참조).
3	검색	Search...를 사용하여 사용자 이름으로 필터링합니다 (실시간).
4	날짜별 필터	Select date range를 사용하여 가입 날짜별로 필터링합니다.
5	만료일별 필터 (표시된 경우)	사용 가능한 경우 Filter by Expires Date를 사용합니다.
6	상태 필터	첫 번째 드롭다운: All, Active, Suspended 등.
7	정렬	두 번째 드롭다운: 예: Joined At 또는 기타 기준.

사용자 네트워크 테이블 열

열	설명
Users	추천 시스템의 사용자 이름 (일부 행에서 비어 있을 수 있음).
Parent	이 사용자를 초대한 추천인의 사용자 이름 (없으면 비어 있음).
Tier	커미션 등급 (예: Default, KOL).
Earnings	총 커미션 수익 (예: "token 0").
Joined At	사용자가 가입한 시점 (예: "Feb 11 2026, 10:13").
Status	예: Active, Suspended.
Is Root Referral	이 사용자가 루트 추천인인지 여부 (예: "No").
Actions	More actions (예: Edit).

사용자 편집

단계	작업	세부 사항
1	사용자 찾기	사용자 네트워크 테이블에서 사용자를 찾습니다.
2	추가 작업	Actions 열에서 More actions 를 클릭합니다.
3	편집	메뉴에서 Edit를 선택합니다.
4	Update referral 대화 상자	대화 상자에 아바타, 사용자 이름, Is Root Referral 스위치, 등급 및 커미션 배분이 표시됩니다.
5	Is Root Referral 설정 (선택 사항)	Is Root Referral을 켜거나 끕니다.
6	등급 변경	Tier 드롭다운을 사용하여 다른 등급을 할당합니다.
7	정지 (선택 사항)	Suspend를 사용하여 추천 권한을 비활성화합니다.
8	저장 또는 닫기	Save로 적용; Cancel 또는 Close로 종료.

Update referral 대화 상자 (사용자 편집)

Update referral 대화 상자에 표시되는 내용:

1. 아바타 / 사용자 이름: 읽기 전용 (예: "GI", "GiBSon").
2. Is Root Referral: 토글(스위치); 루트 추천인 상태를 설정하거나 해제하는 데 사용합니다.
3. Tier: 다른 커미션 등급을 할당하기 위한 드롭다운.
4. 커미션 배분율: 레벨 1, 레벨 2, 레벨 3 % (읽기 전용, 선택된 등급에서 가져옴).
5. Suspend: 사용자의 추천 권한을 정지하는 버튼.
6. Cancel: 변경 사항을 취소하고 닫기.
7. Save: 변경 사항 적용.
8. Close: 저장하지 않고 닫기 (변경되지 않은 경우 Cancel과 동일).

사용자 편집 대화 상자 필드

필드	설명	편집 가능
사용자 아바타	사용자의 짧은 라벨/아바타 (예: "GI").	아니오
사용자 이름	전체 사용자 이름.	아니오
Is Root Referral	사용자를 루트 추천인으로 표시하거나 해제하는 스위치.	예
Tier	커미션 등급 드롭다운.	예
커미션 배분율	레벨 1, 2, 3 % (선택된 등급에서 가져옴).	아니오 (등급에 따라 업데이트)

3. 수동 검토 대기열 탭

대기열 조회

단계	작업	세부 사항
1	탭 열기	Manual review queue를 선택합니다 (또는 개요에서 Review Pending Claims를 클릭합니다).
2	테이블 확인	수동 승인이 필요한 청구를 표시하는 테이블입니다 (예: 자동 승인 한도 이상).
3	검색	Search...로 사용자 이름으로 필터링합니다.
4	필터	Filter by Expires Date 및 Select date range로 날짜별 필터링.
5	상태 필터	첫 번째 드롭다운: All, Pending, Approved, Rejected 등.
6	정렬	두 번째 드롭다운: 예: Created At 또는 기타 기준.

수동 검토 대기열 테이블 열

열	설명
Users	청구를 제출한 사용자의 사용자 이름.
Amount	요청 금액 (통화/토큰 포함).
Created At	청구가 생성된 시점.
Status	Pending, Approved, Rejected 등.
Actions	승인, 거부 또는 세부 정보 보기.

청구 검토

단계	작업	세부 사항
1	청구 찾기	수동 검토 대기열 테이블에서 청구를 찾습니다.
2	세부 정보 확인	사용자 이름, 금액 및 생성 날짜를 확인합니다.
3	자격 확인	사용자와 청구가 지급 규칙을 충족하는지 확인합니다.
4	결정	Approve를 클릭하여 처리하거나 Reject를 클릭하여 거부합니다.
5	거부 사유	거부하는 경우 명확한 사유를 제공합니다.

4. 이력 탭

커미션 이력 조회

단계	작업	세부 사항
1	탭 열기	History를 선택합니다.
2	테이블 확인	처리된 커미션 지급(지급/거부)을 표시하는 테이블입니다.
3	검색	Search...로 사용자 이름으로 필터링합니다.
4	날짜 필터	Select date range 및 (표시된 경우) Filter by Expires Date로 생성 날짜별 필터링.
5	상태 필터	첫 번째 드롭다운: All, Paid, Rejected 등.
6	정렬	두 번째 드롭다운: 예: Created At.

이력 테이블 열

열	설명
Users	커미션을 수령하거나 거부된 사용자의 사용자 이름.
Amount	지급 또는 요청된 금액 (통화/토큰 포함).
Created At	지급/청구가 생성된 시점.
Status	Paid, Rejected 등.
Rejected Reason	청구가 거부된 경우의 사유.
트랜잭션 해시	블록체인 세부 정보로의 짧은 링크 (예: "79b7e").
Logs	트랜잭션/로그 세부 정보를 여는 버튼.
Actions	기록에 대한 추가 작업.

트랜잭션 검증

단계	작업	세부 사항
1	기록 찾기	이력 테이블에서 지급된 커미션을 찾습니다.
2	트랜잭션 해시	트랜잭션 해시 링크를 클릭하여 블록체인 탐색기를 엽니다.
3	로그	See logs를 클릭하여 처리 세부 정보를 봅니다.

5. 초대 코드 탭

목적

초대 코드 관리: 소유자, 코드, 태그, 상태 및 만료일을 확인합니다. 코드를 내보내거나 일괄 생성합니다.

초대 코드 조회

단계	작업	세부 사항
1	탭 열기	Invite codes를 선택합니다.
2	테이블 확인	Owner, Code, Tag, Status, Created At, Expired At이 포함된 초대 코드 목록이 표시됩니다.
3	내보내기	Export All로 모든 초대 코드를 내보냅니다 (예: CSV로).
4	일괄 생성	Batch Generate로 일괄 생성 초대 코드 대화 상자를 엽니다.
5	검색	Search...로 필터링합니다 (예: 소유자 또는 코드로).
6	날짜 필터	Select date range로 생성/만료별 필터링.
7	상태 / 정렬	첫 번째 드롭다운: All 또는 상태별; 두 번째: 예: Created At.

일괄 생성 초대 코드

단계	작업	세부 사항
1	대화 상자 열기	초대 코드 탭에서 Batch Generate를 클릭합니다.
2	대화 상자 제목	Batch Generate Invite Codes — "BD 계정을 위한 여러 추천 초대 코드를 생성합니다. 코드는 CSV로 내보내집니다."
3	Owner Account (User ID)*	텍스트박스: 코드를 귀속시킬 BD 계정 사용자 ID.
4	Quantity*	스핀 버튼: 생성할 코드 수 (기본 100, 최대 500).
5	Cohort Tag*	텍스트박스: 코호트를 식별하기 위한 태그 (예: VIETNAM_KOL_FEB).
6	Expiry (Days)*	스핀 버튼: 코드 만료까지의 일수 (기본 7, 최대 30).
7	작업	Generate & Export CSV로 생성 및 다운로드; Cancel 또는 Close로 종료.

초대 코드 테이블 열

열	설명
Owner	코드를 소유한 사용자: 아바타 + 사용자 프로필 링크 (예: MKTtest2 → /admin/users/{userId}).
Code	초대 코드 (예: "XM-QA6FJS"); Copy code 버튼으로 클립보드에 복사.
Tag	코호트/태그 라벨 (예: "KOL_1").
Status	Active 또는 Used.
Created At	코드가 생성된 시점 (예: "Feb 06 2026, 10:09").
Expired At	만료 날짜/시간.

6. 설정 탭

커미션 설정

단계	작업	세부 사항
1	탭 열기	Settings를 선택합니다.
2	커미션 설정	Platform Fee Share for Referrals (%) (예: 10%) — 추천 풀에 자금을 공급하는 플랫폼 거래/상환 수수료의 분배율.
3	커미션 배분 모델	Level 1 (Direct), Level 2, Level 3 비율 (예: 7%, 2%, 1%). Edit를 클릭하여 변경.
4	지급 규칙	Minimum Withdrawal Amount (예: 플랫폼 토큰/$ 기준 1) 및 Auto-Approval Limit (예: 50) — 이 금액 미만의 출금은 자동 승인; 이상은 관리자 검토 필요. Edit를 클릭하여 변경.
5	추천 시스템	추천 시스템을 활성화/비활성화하는 토글 (잠금될 수 있음).
6	Force Invite Code	토글: 활성화 시 사용자가 등록하려면 초대 코드를 사용해야 합니다. (잠금될 수 있음.)

커미션 배분 모델 편집

단계	작업	세부 사항
1	섹션 찾기	설정에서 Commission Distribution Model을 찾습니다 (설명: 3개 레벨에 걸쳐 보상이 분배되는 방식).
2	편집	Edit를 클릭하면 섹션이 인라인 편집으로 전환됩니다 (모달 없음).
3	레벨 설정	Level 1 (Direct), Level 2, Level 3이 % 스핀 버튼으로 나타납니다 (예: 7%, 2%, 1%). 필요에 따라 업데이트합니다 (예: 합계가 요구 사항에 맞는지 확인).
4	저장	Save changes를 클릭하여 적용합니다. (Cancel 없음 — 다시 편집하여 되돌립니다.)

지급 규칙 편집

단계	작업	세부 사항
1	섹션 찾기	설정에서 Payout Rules를 찾습니다.
2	편집	Edit를 클릭하면 섹션이 인라인 편집으로 전환됩니다 (모달 없음).
3	Minimum Withdrawal Amount ($)	토큰/$ 스핀 버튼 (예: 1). 설명: 사용자는 지급을 요청하기 전에 최소 이 금액을 적립해야 합니다.
4	Auto-Approval Limit ($)	스핀 버튼 (예: 50). 설명: 이 금액 미만의 출금은 즉시 승인; 이상은 관리자 검토 필요.
5	저장	Save changes를 클릭하여 적용합니다.

설정 참조

설정	예시 / 참고	설명
Platform Fee Share for Referrals (%)	10%	추천 풀로 가는 플랫폼 수수료의 분배율.
Level 1 (Direct)	7%	직접 추천에 대한 기본 분배율.
Level 2	2%	두 번째 레벨 추천.
Level 3	1%	세 번째 레벨 추천.
Minimum Withdrawal Amount	1 (토큰/$)	사용자가 지급을 요청하기 전에 필요한 최소 수익.
Auto-Approval Limit	50 (토큰/$)	이 금액 미만은 자동 승인; 이상은 수동 검토.
Referral System	활성화 (토글)	추천 시스템의 마스터 스위치. 일부 환경에서는 비활성화(잠금)될 수 있습니다.
Force Invite Code	On/Off (토글)	켜면 등록 시 초대 코드가 필요합니다. 일부 환경에서는 비활성화(잠금)될 수 있습니다.

7. 검색 및 필터

검색

탭	검색 목적	동작
사용자 네트워크	사용자 이름으로	입력 시 실시간 필터.
수동 검토 대기열	사용자 이름으로	실시간 필터.
이력	사용자 이름으로	실시간 필터.
초대 코드	소유자/코드 등으로	실시간 필터.
개요 (등급 관리)	등급 이름으로	실시간 필터.

날짜 및 기타 필터

1. Select date range: 사용자 네트워크, 수동 검토 대기열, 이력 및 초대 코드에서 날짜별 필터링에 사용됩니다 (예: 가입 날짜, 생성 날짜, 만료일).
2. Filter by Expires Date: 사용자 네트워크(및 선택적으로 다른 곳)에서 사용 가능한 경우.
3. 상태 드롭다운: 각 탭의 첫 번째 드롭다운 (All, Active, Suspended, Pending, Paid, Rejected 등).
4. 정렬 드롭다운: 두 번째 드롭다운 (Joined At, Created At, Amount, Earnings 등).