## 1. 제품 개요 (Overview)
**YC-Partners**는 영카트5(YoungCart 5) 기반 독립 쇼핑몰에 외부 대행사(링크프라이스 등) 입점비나 중개 수수료 없이, **자체 회원들을 영업 사원(파트너)으로 전환**할 수 있는 설치형 CPS(Cost Per Sale) 제휴마케팅 플러그인입니다.
* **수수료 절감**: 외부 제휴 네트워크의 월 입점비 및 중개 수수료 0원
* **매출 기반 과금(CPS)**: 실제 결제 및 구매가 완료된 건에 대해서만 사전에 정한 요율(%)로 수당 지급
* **철저한 개인정보 보호**: 회원 아이디가 URL에 노출되지 않는 고유 난수 코드 발급 및 하이픈 자동 규격화

---
## 2. 주요 핵심 기능 (Key Features)
### ① 파트너 신청 및 승인 관리
- **원클릭 신청 시스템**: 일반 회원이 파트너스 대시보드에서 연락처 및 정산 계좌를 입력하여 간편 신청
- **연락처 자동 하이픈 규격화**: 입력된 번호의 하이픈 자동 포맷팅 및 회원 기본 정보(`g5_member.mb_hp`) 동시 동기화
- **관리자 검증 절차**: 관리자 승인 대기(0), 승인(1), 반려(-1) 상태 관리 지원
### ② 보안 제휴 링크 & 동적 Iframe 위젯 생성기
- **보안 파트너 코드 (`pt_code`)**: 회원 아이디(`mb_id`) 노출 없는 8자리 고유 난수 코드로 개인정보 보호
- **개별 상품 링크 복사**: 특정 상품 URL에 파트너 식별 파라미터(`?ptn=코드`) 자동 생성
- **다이나믹 Iframe 위젯**: 파트너가 원하는 상품들을 선택하여 가로형/세로형/그리드형 배너 코드를 즉시 발급받아 블로그/카페에 임베드 가능
### ③ 쿠키 기반 정밀 유입 추적 & 어뷰징 방지
- **유입 쿠키 유지기간 설정**: 관리자가 지정한 기간(예: 30일) 동안 구매가 발생해도 해당 파트너의 실적으로 인정
- **어뷰징 방지 로그**: 동일 IP, 동일 상품 중복 클릭 필터링 및 일자별 접속 로그 기록(`yc_pt_click_table`)
### ④ 주문 자동 매칭 및 수당 적립 / 취소 자동 회수
- **PC & 모바일 완벽 연동**: PC 및 모바일 웹 주문 완료 시 장바구니 품목별 수당 자동 계산 및 대기 상태 적립
- **주문 취소/반품 시 자동 회수**: 관리자가 주문 상태를 취소/반품으로 변경 시 적립 대기된 수당 자동 취소 처리
- **선택적 제휴 상품 관리**: 관리자 [상품유형관리]에서 마진율이 확보된 상품만 '제휴상품'으로 선별 지정 가능
### ⑤ 파트너 전용 대시보드
- **실시간 통계 요약**: 월별 링크 유입수, 주문 전환수, 누적 보유 수익금 실시간 확인
- **월별 실적 조회**: 연도/월별 필터를 통해 과거 실적 및 수당 발생 이력 검색
### ⑥ 정산 신청 및 세무 신고 유형 처리
- **정산 신청 기간 통제**: 관리자가 지정한 기간(예: 매월 10일~15일) 및 최소 출금액(예: 30,000원) 이상만 신청 허용
- **세무 유형 분리**:
  - **개인**: 원천징수 3.3% 자동 차감 후 실지급액 계산
  - **사업자**: 사업자등록번호 입력 및 세금계산서 발행 안내 연동
- **관리자 송금 확인 편의**: 관리자 화면에서 예금주, 은행명, 계좌번호, 연락처를 한 화면에서 확인 및 일괄 상태 업데이트

---
## 3. 관리자 화면 구성 및 사용 방법 (How to Use)
### [STEP 1] 기본 환경설정 (`관리자 > 파트너스 관리 > 기본 환경설정`)
1. **파트너스 사용 여부**: 전체 기능 활성화/비활성화
2. **기본 판매 수수료율**: 기본 적립률 설정 (예: 5.0%)
3. **유입 쿠키 유지기간**: 추천 링크 클릭 후 인정 기간 (기본 30일)
4. **최소 출금 가능 금액**: 출금 신청 최소 마일리지 기준 (기본 30,000원)
5. **정산 신청 기간 / 정산금 지급일**: 신청 가능일(예: 10일~15일) 및 지급일(예: 20일) 지정

### [STEP 2] 제휴 상품 지정 (`관리자 > 쇼핑몰관리 > 상품유형관리`)
1. 제휴 마케팅을 허용할 품목의 **'제휴상품'** 체크박스를 활성화합니다.
2. 마진이 적거나 프로모션 제외 품목은 체크를 해제하여 불필요한 수수료 지출을 방지합니다.

### [STEP 3] 파트너 회원 승인 (`관리자 > 파트너스 관리 > 파트너 회원 관리`)
1. 회원이 마이페이지를 통해 파트너를 신청하면 **'승인대기'** 상태로 접수됩니다.
2. 회원의 **이름, 닉네임, 연락처, 계좌 정보**를 검토 후 **'승인완료'**로 변경합니다.
3. 목록에서 연락처 및 정산 계좌를 즉시 일괄 수정할 수 있습니다.

### [STEP 4] 정산 신청 승인 및 지급 (`관리자 > 파트너스 관리 > 정산 신청 관리`)
1. 정산 기간에 접수된 신청 내역의 세무 유형(개인 3.3% 공제액 / 사업자) 및 계좌를 확인합니다.
2. 파트너가 정산 신청을 한 즉시 보유 수익금에서 신청금액만큼 선차감됩니다.
3. 실지급액 입금 완료 후 상태를 **'정산완료'**로 변경합니다. 이때 추가 차감은 없습니다 (상태만 변경).
4. 반려(`-1`)로 변경하면 차감됐던 신청금액이 파트너 보유 수익금으로 자동 복구됩니다. 반려 건을 다시 대기(`0`)/완료(`1`)로 되돌리면 다시 차감됩니다.
5. 신청 건을 삭제하면 대기/완료 상태였던 건은 신청금액이 자동 복구되고, 반려 상태였던 건은 변동 없습니다.

---
## 4. 설치 안내 (Installation Guide)
1. **파일 업로드**:
   - 다운로드받은 압축 파일의 압축을 해제한 후, 영카트5 루트 디렉터리에 그대로 업로드합니다.
   - `plugin/yc_partner/` 폴더
   - `extend/yc_partner.extend.php` 파일

2. **자동 DB 설치**:
   - 관리자 페이지에 접속하는 즉시 전용 테이블(5개) 및 컬럼이 자동으로 생성됩니다. (수동 SQL 실행 불필요)

3. **주문 연동 코드 확인**:
   - PC: `shop/orderformupdate.php`
   - 모바일: `mobile/shop/orderformupdate.php`
   - 위 2개 파일에 안내된 인클루드 코드 1줄 삽입 여부를 확인합니다.

4. **관리지 코드 수정**:
   - adm/shop_admin/orderformcartupdate.php:569, orderlistupdate.php:164
   - adm/shop_admin/itemtypelist.php, itemtypelistupdate.php


---
## 5. 시스템 요구 사양 (System Requirements)
* **그누보드 / 영카트 버전**: 영카트 5.4 / 5.5 / 5.6 전 버전 완벽 호환
* **PHP 버전**: PHP 7.4 ~ PHP 8.2+
* **데이터베이스**: MySQL 5.7+ / MariaDB 10.3+ (utf8, utf8mb4 지원)
* **모바일 지원**: 영카트 기본 모바일 쇼핑몰 및 반응형 테마 완벽 지원

demo id/pass : aaaa/aaaa

파트너스 페이지

https://gnu.cmake.work/plugin/yc_partner/user/dashboard.php

자세한 내용이나 관리자 데모를 확인하고 싶으신 분은 
이메일/ 쪽지로 연락 주시면 아이디 / 비번을 알려드리겠습니다