sam-docs/rules/billing-policy.md

# SAM 과금정책 — 내부용 (CONFIDENTIAL)

> **작성일**: 2026-02-21
> **상태**: 설계 확정
> **열람 범위**: 내부 개발팀/관리층 전용 — 대외 공유 금지

---

## 문서 분리 안내

과금정책이 대상 독자별 3개 문서로 분리되었다.

| 문서 | 대상 | 내용 |
|------|------|------|
| [고객 요금 안내](customer-pricing.md) | 고객 | 서비스 가격표, 과금 기준 |
| [영업파트너 수당 체계](partner-commission.md) | 영업파트너 | 수당률, 정산 프로세스 |
| **본 문서** (billing-policy.md) | 내부 개발팀/관리층 | 본사 원가, 마진율, 코드 참조 |

---

## 1. 개요

### 1.1 목적

SAM 프로젝트의 과금정책 중 **본사 지출 원가**, **마진 구조**, **코드 참조**를 정리한다.
고객 공개용 요금과 영업파트너 수당 체계는 별도 문서로 분리되었다.

### 1.2 적용범위

- 외부 서비스 이용 비용 (바로빌, Google, Anthropic)
- 마진 구조 및 가격 책정 배경
- 코드 참조 (모델, 서비스, DB 테이블)

### 1.3 용어 정의

| 용어 | 설명 |
|------|------|
| **개발비** | 서비스 도입 시 1회 납부하는 초기 비용 |
| **구독료** | 서비스 유지를 위한 월 정기 비용 |
| **토큰** | AI가 언어를 처리하는 최소 단위 (한글 ~1.5자 = 1토큰) |
| **MRR** | Monthly Recurring Revenue (월간 반복 매출) |

---

## 2. 본사 지출 과금정책 (Company → Service Provider)

본사가 외부 서비스 제공자에게 납입하는 비용이다.

### 2.1 바로빌 API 비용

#### 월정액 서비스

| 서비스 | 월정액 | 비고 |
|--------|--------|------|
| 계좌조회 | 10,000원 | 고객 부담 |
| 카드내역 | 10,000원 | 고객 부담 |
| 홈택스 매입/매출 | 33,000원 (VAT 포함) | 코드브릿지엑스 지원 → 본사 부담 (무료) |

> **참고**: 계좌조회/카드내역 월정액은 고객에게 전가한다. 홈택스는 본사가 흡수한다.

#### 건별 과금

| 서비스 | 단가 | 비고 |
|--------|------|------|
| 전자세금계산서 발행 | 100원/건 | 원가 기준 |

### 2.2 AI/클라우드 서비스 비용

#### 토큰 기반 과금 (LLM)

| 제공자 | 모델 | 입력 단가 (USD/1M) | 출력 단가 (USD/1M) | 입력 (KRW/1M) | 출력 (KRW/1M) |
|--------|------|------------------:|------------------:|--------------:|--------------:|
| Google | Gemini 2.0 Flash | $0.10 | $0.40 | 140원 | 560원 |
| Anthropic | Claude 3 Haiku | $0.25 | $1.25 | 350원 | 1,750원 |

#### 시간/작업 기반 과금

| 서비스 | 단가 (USD) | 단위 | KRW 환산 |
|--------|----------:|------|----------:|
| Google STT | $0.009 | 15초당 | 12.6원/15초 (약 50원/분) |
| Google GCS | $0.005 | 1,000건당 | 7원/1,000건 |
| Google FCM | 무료 | - | - |

#### 환율 기준

- 기본 환율: **1,400원/USD**
- `ai_pricing_configs` 테이블에서 동적 관리
- 캐시 TTL: 1시간

### 2.3 본사 지출 월간 예상 (테넌트 1개 기준)

| 항목 | 최소 | 최대 | 비고 |
|------|-----:|-----:|------|
| 바로빌 홈택스 | 0원 | 0원 | 코드브릿지엑스 지원 |
| 세금계산서 원가 | ~5,000원 | ~10,000원 | 50~100건 기준 |
| AI 토큰 (Gemini) | ~100원 | ~5,000원 | 사용량 비례 |
| GCS/STT | ~50원 | ~2,000원 | 사용량 비례 |

---

## 3. 고객 안내용 과금정책

> 고객 요금 상세는 **[고객 요금 안내](customer-pricing.md)** 문서를 참조한다.

---

## 4. 내부 정산 정책

### 4.1 영업 수당 체계

> 수당률 및 정산 프로세스는 **[영업파트너 수당 체계](partner-commission.md)** 문서를 참조한다.

### 4.2 마진 구조

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

### 4.3 프로모션 할인이 마진에 미치는 영향

프로모션 할인 적용 시 **수당은 할인 후 개발비 기준**으로 계산하므로, 본사 순수익 비율(%)은 변하지 않으나 절대 금액은 줄어든다.

```
예시: 제조업 기본 패키지, 개인 가입 (유치자 있음)

                정가 (2,000만원)    10% 할인 (1,800만원)    전액 면제 (0원)
파트너 (20%)    400만원              360만원                 0원
매니저 (5%)     100만원              90만원                  0원
유치자 (3%)     60만원               54만원                  0원
본사 순수익     1,440만원            1,296만원               0원
```

> **참고**: 모든 수당은 개발비를 기준으로 계산하므로, 개발비 전액 면제 시 수당도 전액 0원이 된다. 본사 수익은 구독료에서만 발생한다.

### 4.4 가격 책정 배경

- 내부 총 개발비 산정: **약 7,600만원**
- 구성: 개발비 2,000만원 + 장기 구독(약 7년) 및 금융 비용(4.6%)
- 중소기업 초기 투자 부담 분산 구조

---

## 5. 코드 참조 (개발자용)

### 5.1 바로빌 과금

| 파일 | 내용 |
|------|------|
| `mng/app/Models/Barobill/BarobillSubscription.php` | `DEFAULT_MONTHLY_FEES` 월정액 상수 |
| `mng/app/Models/Barobill/BarobillBillingRecord.php` | `USAGE_UNIT_PRICES` 건별 단가 상수 |
| `mng/app/Models/Barobill/BarobillPricingPolicy.php` | 과금 정책 모델 + `calculateBilling()` |
| `mng/app/Services/Barobill/BarobillBillingService.php` | 월정액/건별 과금 처리 서비스 |
| `mng/app/Services/Barobill/BarobillUsageService.php` | 사용량 집계 및 과금 계산 |
| `mng/database/seeders/BarobillPricingPolicySeeder.php` | 과금 정책 시더 (5개 정책) |

### 5.2 AI 가격/토큰

| 파일 | 내용 |
|------|------|
| `api/app/Models/Tenants/AiPricingConfig.php` | AI 단가 모델 + `getActivePricing()` |
| `api/app/Models/Tenants/AiTokenUsage.php` | 토큰 사용량 기록 모델 |
| `api/app/Services/AiReportService.php` | 토큰 비용 계산 로직 (`saveTokenUsage()`) |
| `api/database/migrations/2026_02_09_*_ai_pricing_configs.php` | AI 단가 테이블 + 시드 데이터 |
| `api/database/migrations/2026_02_07_*_ai_token_usages.php` | 토큰 사용량 테이블 |

### 5.3 가격 시뮬레이터

| 파일 | 내용 |
|------|------|
| `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 정산 관련

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

### 5.5 DB 테이블 참조

| 테이블 | 설명 |
|--------|------|
| `barobill_subscriptions` | 바로빌 월정액 구독 현황 |
| `barobill_billing_records` | 바로빌 월별 과금 내역 |
| `barobill_pricing_policies` | 바로빌 과금 정책 (무료 제공량, 추가 단가) |
| `ai_pricing_configs` | AI 제공자별 단가 설정 |
| `ai_token_usages` | AI 토큰 사용량 기록 |
| `ai_voice_recordings` | AI 음성 녹음 (STT 비용 발생) |
| `sales_commissions` | 영업수수료 정산 |
| `sales_commission_details` | 상품별 수당 내역 |
| `sales_products` | 상품 정의 (개발비, 구독료, 수당률) |
| `sales_product_categories` | 상품 카테고리 (최저가 포함) |
| `sales_contract_products` | 계약 상품 (실 적용가, 할인 기록) |

---

## 6. 관련 문서

- [고객 요금 안내](customer-pricing.md) - 서비스 가격표 (고객 공개용)
- [영업파트너 수당 체계](partner-commission.md) - 수당률 및 정산 (파트너용)
- [단가 정책 (품목)](pricing-policy.md) - 품목 단가/원가 계산
- [영업수수료정산](../features/settlement/sales-commissions.md)
- [구독료정산](../features/settlement/subscriptions.md)
- [컨설팅비용정산](../features/settlement/consulting-fees.md)
- [고객사정산](../features/settlement/customer-settlements.md)
- `sales/price/수당지급체계.md` - 수당 지급 체계 상세
- `sales/policy/SAM_영업정책문서.md` - 영업 정책 상세
- `sales/price/ref/토큰정책.md` - AI 토큰 고객 안내 가이드

---

> **공통 안내**: 본 문서에 명시된 모든 개발비 및 구독료는 **부가가치세(VAT) 별도** 금액이다.

---

**최종 업데이트**: 2026-03-14