# SAM 과금정책 통합 문서

> **작성일**: 2026-02-21
> **상태**: 설계 확정

---

## 1. 개요

### 1.1 목적

SAM 프로젝트의 과금정책을 **본사 지출**과 **고객 안내** 두 관점으로 통합 정리한다.

### 1.2 적용범위

- 외부 서비스 이용 비용 (바로빌, Google, Anthropic)
- 고객 계약 요금표 (가입비, 구독료, 추가 옵션)
- 내부 정산 (영업 수당, 마진 구조)

### 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 포함) | 코드브릿지엑스 지원 → 본사 부담 (무료) |
| 홈택스 매출 | 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. 고객 안내용 과금정책 (Company → Customer)

고객 계약서에 명시되는 서비스 요금이다.

### 3.1 기본 서비스 요금

#### 제조업 기본 패키지

- **포함**: 품목관리 → 견적 → 수주 → 생산 → 출하 (ERP 인사/회계 무료 포함)
- **가입비**: 2,000만원
- **구독료**: 50만원/월

#### 개별 모듈

| 모듈명 | 가입비 | 구독료 (월) |
|--------|-------:|----------:|
| QR코드 관리 | 1,020만원 | 5만원 |
| 사진/출하 관리 | 1,920만원 | 10만원 |
| 검사/토큰 적용 | 1,020만원 | 5만원 |
| 이카운트 연동 | 1,920만원 | 10만원 |

#### 통합 패키지

| 패키지명 | 가입비 | 구독료 (월) |
|---------|-------:|----------:|
| 공사관리 패키지 | 4,000만원 | 20만원 |
| 공정/정부지원사업 | 8,000만원 | 40만원 |

### 3.2 추가 옵션 요금

| 옵션명 | 가입비 추가 | 구독료 추가 (월) |
|--------|----------:|---------------:|
| 생산공정 1개 추가 | 500만원 | 10만원 |
| 품질관리 (인정검사) | 2,000만원 | 50만원 |
| 사진 등록 | - | 10만원 |
| 챗봇/녹음/업무일지 | - | 각 20만원 |
| 연구소 연구노트 | - | 5만원 |
| 장비점검, 사무소 정비 | - | 5만원 |

> **참고**: 품질관리(인정검사)에는 '장비점검, 사무소 정비' 기능이 기본 포함된다.

### 3.3 사용량 기반 추가 과금

수당 제외 항목이며, 기본 제공 한도 초과 시 실비 과금한다.

| 항목 | 기본 제공 | 추가 과금 기준 |
|------|----------|--------------|
| 파일 저장 공간 | 100GB | 100GB당 **10만원/월** |
| AI 토큰 | 월 100만 토큰 | 1,000토큰 단위 실비 과금 |

#### AI 토큰 사용량 체감 (100만 토큰 기준)

| 활용 시나리오 | 예상 처리량 |
|-------------|-----------|
| 음성 회의 요약 | 약 520분 (8.6시간) |
| 문서 자료 정리 (A4) | 약 300~400매 |
| 이메일/노트 분류 | 약 1,500~2,000건 |

- 미사용 잔여 토큰은 이월되지 않는다 (매월 1일 갱신)
- 기본 제공량 80%, 100% 소진 시 자동 알림 발송

### 3.4 바로빌 부가 서비스 요금

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

| 서비스 | 과금 방식 | 기본 제공 | 추가 과금 | 부담 주체 |
|--------|---------|---------|---------|----------|
| 계좌조회 | 월정액 10,000원 | 1계좌 | 추가 1계좌당 10,000원 | 고객 |
| 카드내역 | 월정액 10,000원 | 5장 | 추가 1장당 5,000원 | 고객 |
| 홈택스 매입/매출 | 월 33,000원 × 2 | - | - | 본사 (무료) |
| 세금계산서 발행 | 건별 | 100건 | 추가 50건당 5,000원 | 고객 |

> **과금 계산 예시**:
> - 법인카드 8장 등록 → (8-5) × 5,000 = 15,000원 추가
> - 세금계산서 151건 → ceil((151-100)/50) × 5,000 = 10,000원 추가

---

## 4. 내부 정산 정책

### 4.1 영업 수당 체계

수당은 **가입비에 대해서만** 지급한다. 구독료는 수당 대상이 아니다.

| 구분 | 지급 비율 | 대상 |
|------|--------:|------|
| 판매자 수당 | 가입비의 **20%** | 직접 영업 및 계약 성사 담당자 |
| 관리자 수당 | 가입비의 **5%** | 판매자의 직속 상위 관리자 |
| 협업 수당 | 별도 산정 | 메뉴 제작 및 기술 지원 협업자 |

#### 수당 산정 예시 (기본 패키지 2,000만원)

| 항목 | 금액 |
|------|-----:|
| 판매자 수당 (20%) | 400만원 |
| 관리자 수당 (5%) | 100만원 |
| 회사 운영비 (~75%) | 1,500만원 |

- **지급 시점**: 가입비 입금 완료 확인 후 익월 정산일
- **회사 마진**: 가입비의 약 70~75% (인프라 유지, 마케팅 등)

### 4.2 가격 책정 배경

- 내부 총 개발비 산정: **약 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` 또는 `api` 정산 컨트롤러/서비스 | 영업수수료, 구독료, 컨설팅비 정산 |

### 5.4 DB 테이블 참조

| 테이블 | 설명 |
|--------|------|
| `barobill_subscriptions` | 바로빌 월정액 구독 현황 |
| `barobill_billing_records` | 바로빌 월별 과금 내역 |
| `barobill_pricing_policies` | 바로빌 과금 정책 (무료 제공량, 추가 단가) |
| `ai_pricing_configs` | AI 제공자별 단가 설정 |
| `ai_token_usages` | AI 토큰 사용량 기록 |
| `ai_voice_recordings` | AI 음성 녹음 (STT 비용 발생) |
| `sales_commissions` | 영업수수료 정산 |

---

## 6. 관련 문서

- [단가 정책 (품목)](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 토큰 고객 안내 가이드

---

**최종 업데이트**: 2026-02-21