SamProject/sam-docs
6
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: [sales] '가입비' 용어를 '개발비'로 전면 변경

Browse Source 
- 가입비 → 개발비로 용어 통일
- 원가/적용가 구분 명확화 (development_fee=원가, registration_fee=적용가)
- 상품관리정보, 수당지급, 영업파트너가이드북 등 10개 문서 수정
This commit is contained in:
김보곤
2026-03-13 21:25:43 +09:00
parent 9447e60896
commit 5738f7442c
10 changed files with 63 additions and 62 deletions
Download Patch File Download Diff File Expand all files Collapse all files

45
dev/guides/상품관리정보.md
View File

@@ -42,7 +42,7 @@ SAM 상품관리 시스템은 본사(HQ)에서 SAM 솔루션 상품을 관리하
| `name` | varchar | 상품명 |
| `description` | text | 상품 설명 |
| `development_fee` | decimal(15,2) | **개발비** (원가) |
| `registration_fee` | decimal(15,2) | **가입비** (고객 청구 금액) |
| `registration_fee` | decimal(15,2) | **개발비 (적용가)** (고객 청구 금액) |
| `subscription_fee` | decimal(15,2) | **월 구독료** |
| `partner_commission_rate` | decimal(5,2) | **영업파트너 수당율** (%) |
| `manager_commission_rate` | decimal(5,2) | **매니저 수당율** (%) |
@@ -61,7 +61,7 @@ SAM 상품관리 시스템은 본사(HQ)에서 SAM 솔루션 상품을 관리하
| `management_id` | bigint | FK → sales_tenant_managements |
| `category_id` | bigint | FK → sales_product_categories |
| `product_id` | bigint | FK → sales_products |
| `registration_fee` | decimal(15,2) | 실제 청구 가입비 (커스텀 가능) |
| `registration_fee` | decimal(15,2) | 개발비 적용가 (커스텀 가능) |
| `subscription_fee` | decimal(15,2) | 실제 청구 구독료 (커스텀 가능) |
| `discount_rate` | decimal(5,2) | 할인율 |
| `notes` | text | 비고 |
@@ -82,7 +82,7 @@ SAM 상품관리 시스템은 본사(HQ)에서 SAM 솔루션 상품을 관리하
│ ├── 원가 개념, 내부 관리용 │
│ └── 예: ₩80,000,000 │
│ │
│ 가입비 (Registration Fee) │
│ 개발비 (Registration Fee) │
│ ├── 고객에게 청구하는 금액 │
│ ├── 일반적으로 개발비의 25% │
│ └── 예: ₩20,000,000 (80,000,000 × 25%) │
@@ -92,8 +92,8 @@ SAM 상품관리 시스템은 본사(HQ)에서 SAM 솔루션 상품을 관리하
│ └── 예: ₩500,000/월 │
│ │
│ 수당 (Commission) │
│ ├── 영업파트너 수당: 가입비 × 20% │
│ ├── 매니저 수당: 가입비 × 5% │
│ ├── 영업파트너 수당: 개발비 × 20% │
│ ├── 매니저 수당: 개발비 × 5% │
│ └── 총 수당율: 25% │
│ │
└─────────────────────────────────────────────────────────────────┘
@@ -102,13 +102,13 @@ SAM 상품관리 시스템은 본사(HQ)에서 SAM 솔루션 상품을 관리하
### 3.2 가격 계산 공식
```php
// 가입비 = 개발비 × 25% (기본값)
// 개발비 적용가 = 개발비 원가 × 25% (기본값)
$registration_fee = $development_fee * 0.25;
// 영업파트너 수당 = 가입비 × 20%
// 영업파트너 수당 = 개발비 × 20%
$partner_commission = $registration_fee * 0.20;
// 매니저 수당 = 가입비 × 5%
// 매니저 수당 = 개발비 × 5%
$manager_commission = $registration_fee * 0.05;
// 총 수당
@@ -121,7 +121,7 @@ $total_commission = $partner_commission + $manager_commission;
┌──────────────────────────────────────────┐
│ SAM 기본 솔루션 │
│ │
│ 가입비: ₩80,000,000 → ₩20,000,000 │
│ 개발비: ₩80,000,000 → ₩20,000,000 │
│ (취소선) (할인가) │
│ │
│ 월 구독료: ₩500,000 │
@@ -136,7 +136,7 @@ $total_commission = $partner_commission + $manager_commission;
### 4.1 제조 업체 (manufacturer)
| 상품명 | 개발비 | 가입비 | 월 구독료 | 파트너 수당 | 매니저 수당 | 필수 |
| 상품명 | 개발비 (원가) | 개발비 (적용가) | 월 구독료 | 파트너 수당 | 매니저 수당 | 필수 |
|--------|--------|--------|-----------|-------------|-------------|------|
| SAM 기본 솔루션 | ₩80,000,000 | ₩20,000,000 | ₩500,000 | 20% | 5% | O |
| ERP 연동 모듈 | ₩40,000,000 | ₩10,000,000 | ₩200,000 | 20% | 5% | - |
@@ -146,7 +146,7 @@ $total_commission = $partner_commission + $manager_commission;
### 4.2 공사 업체 (contractor)
| 상품명 | 개발비 | 가입비 | 월 구독료 | 파트너 수당 | 매니저 수당 | 필수 |
| 상품명 | 개발비 (원가) | 개발비 (적용가) | 월 구독료 | 파트너 수당 | 매니저 수당 | 필수 |
|--------|--------|--------|-----------|-------------|-------------|------|
| SAM 공사관리 | ₩60,000,000 | ₩15,000,000 | ₩400,000 | 20% | 5% | O |
| 현장관리 모듈 | ₩24,000,000 | ₩6,000,000 | ₩150,000 | 20% | 5% | - |
@@ -241,7 +241,7 @@ class SalesContractProduct extends Model
'discount_rate', 'notes', 'created_by',
];
// 테넌트별 총 가입비
// 테넌트별 총 개발비
public static function getTotalRegistrationFee(int $tenantId): float
{
return self::where('tenant_id', $tenantId)->sum('registration_fee') ?? 0;
@@ -326,7 +326,7 @@ class SalesContractProduct extends Model
**파일 위치**: `resources/views/sales/dashboard/partials/tenant-list.blade.php`
각 테넌트 행에 계약 금액 정보가 표시됩니다:
- 총 가입비: `SalesContractProduct::getTotalRegistrationFee($tenantId)`
- 총 개발비: `SalesContractProduct::getTotalRegistrationFee($tenantId)`
- 총 구독료: `SalesContractProduct::getTotalSubscriptionFee($tenantId)`
---
@@ -343,14 +343,14 @@ class SalesContractProduct extends Model
- `true`: 영업 담당자가 가격 조정 가능
- UI에서 "재량권" 뱃지로 표시
### 8.3 개발비 vs 가입비
### 8.3 개발비 원가 vs 개발비 적용가
| 구분 | 개발비 (development_fee) | 가입비 (registration_fee) |
| 구분 | 개발비 원가 (development_fee) | 개발비 적용가 (registration_fee) |
|------|-------------------------|--------------------------|
| 용도 | 내부 원가 관리 | 고객 청구 금액 |
| 표시 | 취소선으로 표시 | 실제 금액으로 표시 |
| 비율 | 100% (기준) | 25% (기본) |
| 수당 계산 | 기준 금액 | - |
| 수당 계산 | - | 기준 금액 |
---
@@ -361,7 +361,7 @@ class SalesContractProduct extends Model
```
상품: SAM 기본 솔루션
개발비: ₩80,000,000
가입비: ₩20,000,000
개발비: ₩20,000,000
영업파트너 수당 = ₩20,000,000 × 20% = ₩4,000,000
매니저 수당 = ₩20,000,000 × 5% = ₩1,000,000
@@ -371,11 +371,11 @@ class SalesContractProduct extends Model
### 9.2 복수 상품 계약
```
상품1: SAM 기본 솔루션 (가입비 ₩20,000,000)
상품2: ERP 연동 모듈 (가입비 ₩10,000,000)
상품3: 품질관리 모듈 (가입비 ₩5,000,000)
상품1: SAM 기본 솔루션 (개발비 ₩20,000,000)
상품2: ERP 연동 모듈 (개발비 ₩10,000,000)
상품3: 품질관리 모듈 (개발비 ₩5,000,000)
총 가입비 = ₩35,000,000
총 개발비 = ₩35,000,000
영업파트너 수당 = ₩35,000,000 × 20% = ₩7,000,000
매니저 수당 = ₩35,000,000 × 5% = ₩1,750,000
@@ -440,4 +440,5 @@ POST /api/sales/contracts/{id}/apply-discount
| 날짜 | 변경 내용 | 작성자 |
|------|----------|--------|
| 2026-01-29 | 최초 문서 작성 | Claude |
| 2026-01-29 | 가입비/개발비 분리, 수당율 분리 (파트너/매니저) | Claude |
| 2026-01-29 | 개발비 원가/적용가 분리, 수당율 분리 (파트너/매니저) | Claude |
| 2026-03-13 | '가입비' 용어 폐지 → '개발비(적용가)'로 통일 | Claude |

22
dev/guides/수당지급.md
View File

@@ -15,9 +15,9 @@
| 수당 유형 | 수당률/금액 | 대상 | 기준 |
|-----------|-------------|------|------|
| **판매자 수당** | 20% | 가망고객 등록자 | 가입비의 50% 기준 |
| **매니저 수당** | 5% | 지정된 매니저 | 가입비의 50% 기준 |
| **협업지원금** | 메뉴당 2,000원 | 2단계 상위 파트너 | 가입비 완납 시 |
| **판매자 수당** | 20% | 가망고객 등록자 | 개발비의 50% 기준 |
| **매니저 수당** | 5% | 지정된 매니저 | 개발비의 50% 기준 |
| **협업지원금** | 메뉴당 2,000원 | 2단계 상위 파트너 | 개발비 완납 시 |
---
@@ -26,7 +26,7 @@
### 2.1 기본 공식
```
기준 금액 = 총 가입비 ÷ 2 (50%)
기준 금액 = 총 개발비 ÷ 2 (50%)
판매자 수당 = 기준 금액 × 20%
매니저 수당 = 기준 금액 × 5%
@@ -35,7 +35,7 @@
### 2.2 계산 예시
```
총 가입비: 10,000,000원
총 개발비: 10,000,000원
기준 금액: 5,000,000원 (50%)
판매자 수당: 5,000,000 × 20% = 1,000,000원
@@ -82,7 +82,7 @@
| 항목 | 내용 |
|------|------|
| **산출 공식** | 테넌트 메뉴 개수 × 2,000원 |
| **지급 시점** | 가입비 완납 시 |
| **지급 시점** | 개발비 완납 시 |
| **지급 대상** | 계약자의 parent의 parent (2단계 상위) |
### 3.4 계산 예시
@@ -91,7 +91,7 @@
[상황]
- 손자 파트너가 테넌트 A와 계약 체결
- 테넌트 A에 메뉴 50개 생성
- 가입비 1,000만원 완납
- 개발비 1,000만원 완납
[수당/지원금 지급]
손자 파트너 (판매자): 500만원 × 20% = 100만원
@@ -103,7 +103,7 @@
1. 계약자(손자)의 parent_id가 존재해야 함 (아버지 파트너)
2. 아버지 파트너의 parent_id가 존재해야 함 (할아버지 파트너)
3. 가입비가 **완납**되어야 함
3. 개발비가 **완납**되어야 함
4. 테넌트에 메뉴가 생성되어 있어야 함
> **주의**: 1단계 상위(아버지)는 협업지원금 대상이 아님.
@@ -166,7 +166,7 @@ CREATE TABLE sales_commissions (
payment_date DATE NOT NULL,
-- 수당 계산
base_amount DECIMAL(15,2) NOT NULL, -- 기준 금액 (가입비의 50%)
base_amount DECIMAL(15,2) NOT NULL, -- 기준 금액 (개발비의 50%)
partner_rate DECIMAL(5,2) DEFAULT 20.00, -- 판매자 수당률
manager_rate DECIMAL(5,2) DEFAULT 5.00, -- 매니저 수당률
partner_commission DECIMAL(15,2) NOT NULL, -- 판매자 수당액
@@ -203,7 +203,7 @@ CREATE TABLE sales_commission_details (
commission_id BIGINT UNSIGNED NOT NULL,
contract_product_id BIGINT UNSIGNED NOT NULL,
registration_fee DECIMAL(15,2) NOT NULL, -- 상품 가입비
registration_fee DECIMAL(15,2) NOT NULL, -- 개발비 (적용가)
base_amount DECIMAL(15,2) NOT NULL, -- 기준 금액
partner_rate DECIMAL(5,2) NOT NULL, -- 상품별 판매자 수당률
manager_rate DECIMAL(5,2) NOT NULL, -- 상품별 매니저 수당률
@@ -275,7 +275,7 @@ $summary = $this->commissionService->getManagerCommissionSummary($managerUserId)
| 항목 | 설명 |
|------|------|
| 총 가입비 | 나와 관련된 계약의 총 입금액 |
| 총 개발비 | 나와 관련된 계약의 총 입금액 |
| 총 수당 | 판매자 수당 + 매니저 수당 합계 |
| 지급 완료 비율 | (지급완료 수당 / 총 수당) × 100 |
| 전체 건수 | 관련 계약 건수 |

16
dev/guides/영업파트너가이드북.md
View File

@@ -49,7 +49,7 @@
| 항목 | 설명 |
| ----------- | ---------------------------------- |
| 관리 테넌트 | 본인이 담당하는 업체 수 |
| 총 가입비 | 계약된 가입비 합계 |
| 총 개발비 | 계약된 개발비 합계 |
| 확정 수당 | 받을 수당 총액 (클릭 시 상세 보기) |
| 승인 대기 | 가입/지급 승인 대기 건수 |
@@ -57,7 +57,7 @@
- 본인이 담당하는 테넌트(업체) 목록
- 각 업체의 영업/매니저 진행률 확인
- 계약 금액(가입비, 월 구독료) 확인
- 계약 금액(개발비, 월 구독료) 확인
#### [유치 파트너 현황] 탭
@@ -139,7 +139,7 @@
| 5. 협상 및 조율 | Negotiation | 가격/조건 협상, 의사결정권자 설득 |
| 6. 계약 체결 | Closing | 계약서 날인/교부, 세금계산서 발행, 후속 지원 일정 |
> **Tip:** 가입비 입금이 완료되어야 매니저에게 프로젝트가 이관됩니다.
> **Tip:** 개발비 입금이 완료되어야 매니저에게 프로젝트가 이관됩니다.
#### 매니저 시나리오 (매니저 담당)
@@ -238,7 +238,7 @@
- 개발 진행 상태 (8단계 프로그레스 바)
- 영업/매니저 진행률
- 고객 정보 (업체명, 사업자번호, 대표자, 연락처, 주소)
- 계약 상품 목록 (가입비, 월 구독료)
- 계약 상품 목록 (개발비, 월 구독료)
- 메모 (반려 사유 등)
---
@@ -255,13 +255,13 @@
### 수당 계산 기준
- **기준 금액**: 가입비의 50%
- **기준 금액**: 개발비의 50%
- **판매자 수당**: 기준금액 × 20%
- **관리자 수당**: 기준금액 × 5%
### 수당 지급 일정
1. 테넌트 가입비 입금 완료
1. 테넌트 개발비 입금 완료
2. 본사 승인 처리
3. **익월 10일** 지급 예정
@@ -352,7 +352,7 @@
영업 수당 지급도 본사 승인이 필요합니다.
**1. 수당 발생**
- 테넌트 계약 완료 및 가입비 입금
- 테넌트 계약 완료 및 개발비 입금
- 수당이 자동 계산되어 지급 대기 상태
**2. 지급 승인 (관리자)**
@@ -401,7 +401,7 @@
### Q. 수당은 언제 지급되나요?
> 가입비 입금 완료 후 본사 승인을 거쳐 **익월 10일**에 지급됩니다.
> 개발비 입금 완료 후 본사 승인을 거쳐 **익월 10일**에 지급됩니다.
### Q. 유치한 파트너가 비활동 상태입니다

12
dev/guides/영업파트너구조.md
View File

@@ -102,14 +102,14 @@
| 수당 유형 | 수당률/금액 | 지급 대상 | 설명 |
|-----------|-------------|-----------|------|
| **판매자 수당** | 20% | 가망고객 등록자 | 가입비의 50% × 20% |
| **매니저 수당** | 5% | 지정된 매니저 | 가입비의 50% × 5% |
| **협업지원금** | 메뉴당 2,000원 | 2단계 상위 파트너 | 가입비 완납 시 지급 |
| **판매자 수당** | 20% | 가망고객 등록자 | 개발비의 50% × 20% |
| **매니저 수당** | 5% | 지정된 매니저 | 개발비의 50% × 5% |
| **협업지원금** | 메뉴당 2,000원 | 2단계 상위 파트너 | 개발비 완납 시 지급 |
### 4.2 수당 계산 원칙
```
기준 금액 = 총 가입비의 50%
기준 금액 = 총 개발비의 50%
1. 판매자 수당: 기준 금액 × 20% (가망고객 등록자)
2. 매니저 수당: 기준 금액 × 5% (매니저로 지정된 파트너)
@@ -118,8 +118,8 @@
### 4.3 수당 흐름 예시
```
고객 계약 (가입비 1,000만원)
└─ 기준 금액: 500만원 (가입비의 50%)
고객 계약 (개발비 1,000만원)
└─ 기준 금액: 500만원 (개발비의 50%)
김철수 (가망고객 등록자, 판매자)
→ 판매자 수당: 500만원 × 20% = 100만원