docs: [sales] 가격 시뮬레이터 내용을 가격정책 문서에 반영

- customer-pricing: 프로모션/할인 정책 섹션 추가 (개발비 할인, 구독료 할인, 무료 체험, 1년차 총 비용 공식) - partner-commission: 분할 지급 구조, 수당 지급 시점, 매니저 수당 산정, 프로모션 할인과 수당 관계 추가 - billing-policy: 마진 구조 상세화, 프로모션 마진 영향 분석, 시뮬레이터/정산 코드 참조 추가
2026-03-14 17:49:17 +09:00
parent f452ec94db
commit 9139c81776
3 changed files with 173 additions and 15 deletions
--- a/rules/billing-policy.md
+++ b/rules/billing-policy.md
@@ -113,10 +113,28 @@ SAM 프로젝트의 과금정책 중 **본사 지출 원가**, **마진 구조**
 ### 4.2 마진 구조

 - **회사 마진**: 개발비의 약 **67~75%** (가입 유형에 따라 변동)
-  - 개인 가입: 개발비의 약 72~75% (수당 25~28% 차감 후)
-  - 단체 가입: 개발비의 약 67% (수당 33% 차감 후)
+  - 개인 가입 (유치자 있음): 개발비의 약 **72%** (수당 28% 차감 후)
+  - 개인 가입 (유치자 없음): 개발비의 약 **75%** (수당 25% 차감 후)
+  - 단체 가입 (유치자 있음): 개발비의 약 **67%** (수당 33% 차감 후)
+  - 단체 가입 (유치자 없음): 개발비의 약 **70%** (수당 30% 차감 후)

-### 4.3 가격 책정 배경
+### 4.3 프로모션 할인이 마진에 미치는 영향
+
+프로모션 할인 적용 시 **수당은 할인 후 개발비 기준**으로 계산하므로, 본사 순수익 비율(%)은 변하지 않으나 절대 금액은 줄어든다.
+
+```
+예시: 제조업 기본 패키지, 개인 가입 (유치자 있음)
+
+                정가 (2,000만원)    10% 할인 (1,800만원)    전액 면제 (0원)
+파트너 (20%)    400만원              360만원                 0원
+매니저          50만원 (구독료)      50만원                  50만원
+유치자 (3%)     60만원               54만원                  0원
+본사 순수익     1,490만원            1,336만원               -50만원 ⚠️
+```
+
+> **주의**: 개발비 전액 면제 시 본사는 구독료에서만 수익이 발생한다. 매니저 수당은 구독료 기반으로 지급되므로 개발비 면제 시에도 발생한다.
+
+### 4.4 가격 책정 배경

 - 내부 총 개발비 산정: **약 7,600만원**
 - 구성: 개발비 2,000만원 + 장기 구독(약 7년) 및 금융 비용(4.6%)
@@ -147,13 +165,24 @@ SAM 프로젝트의 과금정책 중 **본사 지출 원가**, **마진 구조**
 | `api/database/migrations/2026_02_09_*_ai_pricing_configs.php` | AI 단가 테이블 + 시드 데이터 |
 | `api/database/migrations/2026_02_07_*_ai_token_usages.php` | 토큰 사용량 테이블 |

-### 5.3 정산 관련
+### 5.3 가격 시뮬레이터

 | 파일 | 내용 |
 |------|------|
-| `mng` 또는 `api` 정산 컨트롤러/서비스 | 영업수수료, 구독료, 컨설팅비 정산 |
+| `mng/app/Http/Controllers/Sales/PriceSimulatorController.php` | 시뮬레이터 화면 로드 (카테고리/상품 데이터) |
+| `mng/resources/views/sales/price-simulator/index.blade.php` | Alpine.js 기반 실시간 계산 UI |
+| `mng/app/Models/Sales/SalesProduct.php` | 상품 정의 (개발비, 구독료, 수당률, 최저가) |
+| `mng/app/Models/Sales/SalesProductCategory.php` | 카테고리 정의 + 최저가 설정 |

-### 5.4 DB 테이블 참조
+### 5.4 정산 관련
+
+| 파일 | 내용 |
+|------|------|
+| `mng/app/Services/SalesCommissionService.php` | 입금 시 수당 자동 생성 및 정산 로직 |
+| `mng/app/Models/Sales/SalesCommission.php` | 수당 정산 모델 (상태 관리, 상수 정의) |
+| `mng/app/Models/Sales/SalesContractProduct.php` | 계약 상품별 실 적용가/할인 기록 |
+
+### 5.5 DB 테이블 참조

 | 테이블 | 설명 |
 |--------|------|
@@ -164,6 +193,10 @@ SAM 프로젝트의 과금정책 중 **본사 지출 원가**, **마진 구조**
 | `ai_token_usages` | AI 토큰 사용량 기록 |
 | `ai_voice_recordings` | AI 음성 녹음 (STT 비용 발생) |
 | `sales_commissions` | 영업수수료 정산 |
+| `sales_commission_details` | 상품별 수당 내역 |
+| `sales_products` | 상품 정의 (개발비, 구독료, 수당률) |
+| `sales_product_categories` | 상품 카테고리 (최저가 포함) |
+| `sales_contract_products` | 계약 상품 (실 적용가, 할인 기록) |

 ---

@@ -186,4 +219,4 @@ SAM 프로젝트의 과금정책 중 **본사 지출 원가**, **마진 구조**

 ---

-**최종 업데이트**: 2026-02-21
+**최종 업데이트**: 2026-03-14
--- a/rules/customer-pricing.md
+++ b/rules/customer-pricing.md
@@ -92,7 +92,63 @@ SAM 서비스 도입 시 고객에게 안내하는 요금 체계를 정리한다

 ---

-## 5. 사용량 기반 추가 과금
+## 5. 프로모션/할인 정책
+
+가격 시뮬레이터에서 4가지 할인을 조합하여 고객 맞춤 제안을 구성한다. 모든 할인은 최저가 하한선을 초과할 수 없다.
+
+### 5.1 개발비 할인
+
+| 방식 | 설명 | 예시 |
+|------|------|------|
+| **% 할인** | 개발비 합계에서 N% 차감 | 2,000만원 × 10% = 200만원 할인 → 1,800만원 |
+| **정액 할인** | 개발비 합계에서 N원 차감 | 2,000만원 - 300만원 = 1,700만원 |
+| **전액 면제** | 개발비를 0원으로 설정 | 최저 개발비가 0일 때만 적용 가능 |
+
+> **제약**: 어떤 방식이든 상품별 최저 개발비 합계 이하로는 할인 불가
+
+### 5.2 구독료 할인
+
+구독료 합계에서 0~50% 범위 내 할인을 적용한다.
+
+```
+최종 구독료 = max(최저 구독료 합계, 구독료 합계 × (100% - 할인%))
+```
+
+### 5.3 무료 체험 기간
+
+서비스 도입 초기에 구독료를 면제하는 기간을 설정한다.
+
+| 선택지 | 유료 개월수 (1년 기준) |
+|--------|-------------------:|
+| 없음 | 12개월 |
+| 1개월 | 11개월 |
+| 2개월 | 10개월 |
+| 3개월 | 9개월 |
+| 6개월 | 6개월 |
+
+### 5.4 1년차 총 비용 계산
+
+```
+1년차 총 비용 = 최종 개발비 + (최종 월 구독료 × 유료 개월수)
+```
+
+**예시**: 제조업 기본 패키지, 개발비 10% 할인, 무료 체험 3개월
+
+| 항목 | 금액 |
+|------|-----:|
+| 개발비 (정가) | 2,000만원 |
+| 개발비 할인 (10%) | -200만원 |
+| **최종 개발비** | **1,800만원** |
+| 월 구독료 | 50만원 |
+| 유료 개월수 | 9개월 |
+| 연 구독료 | 450만원 |
+| **1년차 총 비용** | **2,250만원** (VAT 별도) |
+
+> **참고**: 개발비-구독료 연동이 적용된 경우, 개발비 할인에 따라 구독료도 자동 조정된다. 연동 미적용 시 구독료는 정가 기준으로 별도 계산한다.
+
+---
+
+## 6. 사용량 기반 추가 과금

 기본 제공 한도 초과 시 실비 과금한다.

@@ -114,7 +170,7 @@ SAM 서비스 도입 시 고객에게 안내하는 요금 체계를 정리한다

 ---

-## 6. 바로빌 부가 서비스 요금
+## 7. 바로빌 부가 서비스 요금

 고객이 선택적으로 이용하는 바로빌 연동 서비스이다.

@@ -131,7 +187,7 @@ SAM 서비스 도입 시 고객에게 안내하는 요금 체계를 정리한다

 ---

-## 7. 관련 문서
+## 8. 관련 문서

 - [내부 과금정책](billing-policy.md) - 본사 지출 원가 및 코드 참조 (내부용)
 - [영업파트너 수당 체계](partner-commission.md) - 수당률 및 정산 프로세스 (파트너용)
--- a/rules/partner-commission.md
+++ b/rules/partner-commission.md
@@ -69,12 +69,47 @@
 ┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
 │  1. 계약 및 입금  │ →  │  2. 수당 확정     │ →  │  3. 지급          │
 │                 │    │                 │    │                 │
-│ 개발비 전액      │    │ 매월 정산일에     │    │ 파트너 등록      │
-│ 완납 확인        │    │ 건별 수당 확정    │    │ 계좌로 지급      │
+│ 개발비 1차/2차   │    │ 매월 정산일에     │    │ 파트너 등록      │
+│ 분할 입금        │    │ 건별 수당 확정    │    │ 계좌로 지급      │
 └─────────────────┘    └─────────────────┘    └─────────────────┘
 ```

- **지급 시점**: 개발비 입금 완료 확인 후 익월 정산일
+### 4.1 분할 지급 구조
+
+개발비 수당은 1차/2차 납입에 맞춰 **50%씩 분할 지급**한다.
+
+```
+개발비 2,000만원, 개인 가입, 파트너 수당률 20%
+
+총 파트너 수당 = 2,000만원 × 20% = 400만원
+
+1차 납입(계약금) 시: 400만원 × 50% = 200만원
+2차 납입(잔금) 시:  400만원 × 50% = 200만원
+```
+
+### 4.2 수당 지급 시점
+
+| 수당 유형 | 지급 시점 |
+|----------|----------|
+| 1차 파트너 수당 | 1차 납입(계약금) 완료 **익월 10일** |
+| 2차 파트너 수당 | 2차 납입(잔금) 완료 **익월 10일** |
+| 매니저 수당 | 첫 구독료 입금 **익월 10일** |
+| 협업지원금(유치자) | 파트너 수당과 동일 시점 |
+
+### 4.3 매니저 수당 산정
+
+매니저 수당은 **첫 구독료 입금 시 1회** 지급한다.
+
+- 개인 가입: 구독료 1개월분 (예: 50만원/월 → 매니저 수당 50만원)
+- 단체 가입: 매니저 수당 없음 (0%)
+
+### 4.4 수당 정산 상태 흐름
+
+```
+pending (대기) → approved (승인) → paid (지급완료)
+    │                                     ↑
+    └── cancelled (취소)            paid 상태는 취소 불가
+```

 ---

@@ -108,9 +143,43 @@

 > **참고**: 구독료는 수당 계산에 영향을 주지 않으므로, 연동 조정이 수당에 직접적 영향은 없다. 다만 개발비를 낮추면 수당도 줄어든다.

-### 6.3 가격 시뮬레이터
+### 6.3 프로모션 할인과 수당

-영업파트너는 가격 시뮬레이터를 통해 할인 조합별 수당을 미리 확인할 수 있다. 시뮬레이터에서 최저가 이하로는 슬라이더가 움직이지 않으며, 프로모션 할인도 최저가까지만 적용된다.
+수당은 **할인 적용 후 최종 개발비**를 기준으로 계산한다. 프로모션(개발비 할인, 전액 면제 등)을 적용하면 수당도 비례하여 줄어든다.
+
+```
+수당 기준액 = 최종 개발비 (프로모션 할인 적용 후)
+파트너 수당 = 수당 기준액 × 수당률
+```
+
+**예시**: 개발비 2,000만원, 10% 할인 적용, 개인 가입
+
+| 항목 | 정가 기준 | 10% 할인 기준 |
+|------|--------:|----------:|
+| 개발비 | 2,000만원 | 1,800만원 |
+| 파트너 수당 (20%) | 400만원 | 360만원 |
+| 매니저 수당 | 50만원 | 50만원 (구독료 기준) |
+| 협업지원금 (3%) | 60만원 | 54만원 |
+
+> **참고**: 개발비가 전액 면제(0원)되면 파트너 수당과 협업지원금도 0원이 된다. 매니저 수당은 구독료 기반이므로 영향 없다.
+
+> **참고**: 구독료 할인, 무료 체험 기간은 수당 계산에 영향을 주지 않는다 (수당은 개발비 기준).
+
+### 6.4 가격 시뮬레이터
+
+영업파트너는 가격 시뮬레이터(MNG)를 통해 할인 조합별 수당을 미리 확인할 수 있다.
+
+**시뮬레이터 기능:**
+- 카테고리별 상품 선택 (필수 상품 자동 포함)
+- 재량권 상품은 슬라이더로 개발비 조정 가능
+- 프로모션 할인 4종 조합 (개발비 할인, 전액 면제, 구독료 할인, 무료 체험)
+- 가입 유형(개인/단체) 전환 시 수당률 자동 반영
+- 개발비-구독료 연동 ON/OFF 선택
+- 1년차 총 비용 및 본사/파트너 수당 실시간 표시
+
+**제약:**
+- 최저 개발비/구독료 이하로는 슬라이더 및 할인이 적용되지 않는다
+- 시뮬레이터 결과는 참고용이며, 실제 계약 금액은 별도 협의에 따른다

 ---