docs:협업지원금 구조 문서화

- 매뉴제작 협업수당 → 협업지원금으로 명칭 변경
- 협업지원금 산출 기준: 메뉴당 2,000원
- 지급 대상: 계약자 기준 2단계 상위 파트너 (할아버지)
- 지급 시점: 가입비 완납 시
- 다단계법 준수를 위한 구조 설명 추가

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

app/Http/Controllers/Sales/SalesDashboardController.php

@@ -133,10 +133,10 @@ private function getDashboardData(Request $request): array
                 'color' => 'blue',
             ],
             [
-                'name' => '매뉴제작 협업수당',
-                'rate' => null, // 별도
-                'amount' => null, // 운영팀 산정
-                'color' => 'red',
+                'name' => '협업지원금',
+                'rate' => null, // 메뉴당 2,000원
+                'amount' => null, // 가입비 완납 시 계산
+                'color' => 'purple',
             ],
         ];
 

claudedocs/수당지급.md

@@ -13,11 +13,11 @@ ### 1.1 목적
 
 ### 1.2 수당 유형
 
-| 수당 유형 | 수당률 | 대상 | 기준 |
-|-----------|--------|------|------|
+| 수당 유형 | 수당률/금액 | 대상 | 기준 |
+|-----------|-------------|------|------|
 | **판매자 수당** | 20% | 가망고객 등록자 | 가입비의 50% 기준 |
 | **매니저 수당** | 5% | 지정된 매니저 | 가입비의 50% 기준 |
-| **매뉴제작 협업수당** | 별도 | 운영팀 산정 | 별도 정책 |
+| **협업지원금** | 메뉴당 2,000원 | 2단계 상위 파트너 | 가입비 완납 시 |
 
 ---
 
@@ -53,7 +53,65 @@ ### 2.3 입금 구분별 수당
 
 ---
 
-## 3. 수당 지급 프로세스
+## 3. 협업지원금
+
+### 3.1 도입 배경
+
+**다단계 판매법 준수**: 다단계 판매법에서는 2단계 이상의 수당 지급이 금지되어 있습니다.
+이를 준수하면서도 상위 파트너의 기여를 인정하기 위해 "수당"이 아닌 "지원금" 형태로 지급합니다.
+
+### 3.2 지급 대상
+
+계약 체결자(판매자) 기준 **2단계 상위 파트너** (할아버지 파트너)
+
+```
+할아버지 파트너 ← 협업지원금 수령
+    │
+    ↓ (유치)
+아버지 파트너
+    │
+    ↓ (유치)
+손자 파트너 ← 테넌트 계약 체결 (판매자 수당 20%)
+    │
+    ↓
+테넌트 계약
+```
+
+### 3.3 산출 기준
+
+| 항목 | 내용 |
+|------|------|
+| **산출 공식** | 테넌트 메뉴 개수 × 2,000원 |
+| **지급 시점** | 가입비 완납 시 |
+| **지급 대상** | 계약자의 parent의 parent (2단계 상위) |
+
+### 3.4 계산 예시
+
+```
+[상황]
+- 손자 파트너가 테넌트 A와 계약 체결
+- 테넌트 A에 메뉴 50개 생성
+- 가입비 1,000만원 완납
+
+[수당/지원금 지급]
+손자 파트너 (판매자):  500만원 × 20% = 100만원
+매니저 (지정된 경우):  500만원 × 5%  = 25만원
+할아버지 파트너:       50개 × 2,000원 = 10만원 (협업지원금)
+```
+
+### 3.5 지급 조건
+
+1. 계약자(손자)의 parent_id가 존재해야 함 (아버지 파트너)
+2. 아버지 파트너의 parent_id가 존재해야 함 (할아버지 파트너)
+3. 가입비가 **완납**되어야 함
+4. 테넌트에 메뉴가 생성되어 있어야 함
+
+> **주의**: 1단계 상위(아버지)는 협업지원금 대상이 아님.
+> 직접 유치한 파트너의 계약에 대해서는 별도 수당 정책 없음 (다단계법 준수).
+
+---
+
+## 4. 수당 지급 프로세스
 
 ### 3.1 상태 흐름
 

claudedocs/영업파트너구조.md

@@ -100,11 +100,11 @@ ## 4. 수당/수익 구조
 
 ### 4.1 수당 유형
 
-| 수당 유형 | 수당률 | 지급 대상 | 설명 |
-|-----------|--------|-----------|------|
+| 수당 유형 | 수당률/금액 | 지급 대상 | 설명 |
+|-----------|-------------|-----------|------|
 | **판매자 수당** | 20% | 가망고객 등록자 | 가입비의 50% × 20% |
 | **매니저 수당** | 5% | 지정된 매니저 | 가입비의 50% × 5% |
-| **매뉴제작 협업수당** | 별도 | 운영팀 산정 | 별도 정책 |
+| **협업지원금** | 메뉴당 2,000원 | 2단계 상위 파트너 | 가입비 완납 시 지급 |
 
 ### 4.2 수당 계산 원칙