Files
sam-docs/sam/docs/rules/billing-policy.md
김보곤 01eee88e40 docs: [과금정책] 단체가입 수수료율 추가 및 부가세 별도 명시
- 개인가입(20%/5%/3%) vs 단체가입(30%/0%/3%) 수당 체계 추가
- 유치자 협업지원금(3%) 정책 추가
- 모든 개발비/구독료에 VAT 별도 명시
2026-02-21 19:24:19 +09:00

264 lines
9.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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만원 (VAT 별도)
- **구독료**: 50만원/월 (VAT 별도)
#### 개별 모듈
| 모듈명 | 개발비 (VAT 별도) | 구독료/월 (VAT 별도) |
|--------|------------------:|-----------------:|
| QR코드 관리 | 1,020만원 | 5만원 |
| 사진/출하 관리 | 1,920만원 | 10만원 |
| 검사/토큰 적용 | 1,020만원 | 5만원 |
| 이카운트 연동 | 1,920만원 | 10만원 |
#### 통합 패키지
| 패키지명 | 개발비 (VAT 별도) | 구독료/월 (VAT 별도) |
|---------|------------------:|-----------------:|
| 공사관리 패키지 | 4,000만원 | 20만원 |
| 공정/정부지원사업 | 8,000만원 | 40만원 |
### 3.2 추가 옵션 요금
| 옵션명 | 개발비 추가 (VAT 별도) | 구독료 추가/월 (VAT 별도) |
|--------|---------------------:|----------------------:|
| 생산공정 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 영업 수당 체계
수당은 **개발비에 대해서만** 지급한다. 구독료는 수당 대상이 아니다.
기준금액은 개발비의 50%이며, 2단계(1차/2차) 분할 지급한다.
#### 가입 유형별 수당률
| 가입 유형 | 파트너/단체 수당 | 매니저 수당 | 협업지원금(유치자) | **본사 총 지급률** |
|-----------|:--------------:|:----------:|:-----------------:|:----------------:|
| **개인 가입** | 20% | 5% | 3% | **28%** |
| **단체 가입** | 30% | 0% | 3% | **33%** |
- **협업지원금**: 유치자(parent)가 자신이 유치한 하위 파트너의 매출에서 3%를 수령하는 내부 제도
- 1단계까지만 적용 (유치자 → 하위 파트너, 그 이상 상위로는 올라가지 않음)
- 단체 가입 시 매니저 수당은 0%
#### 수당 산정 예시 (기준금액 100만원)
| 가입 유형 | 파트너/단체 | 매니저 | 협업지원금 | 본사 총 지급 |
|-----------|----------:|-------:|----------:|------------:|
| 개인 (유치자 있음) | 200,000원 | 50,000원 | 30,000원 | **280,000원 (28%)** |
| 개인 (유치자 없음) | 200,000원 | 50,000원 | 0원 | 250,000원 (25%) |
| 단체 | 300,000원 | 0원 | 30,000원 | **330,000원 (33%)** |
- **지급 시점**: 개발비 입금 완료 확인 후 익월 정산일
- **회사 마진**: 개발비의 약 67~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 토큰 고객 안내 가이드
---
> **공통 안내**: 본 문서에 명시된 모든 개발비 및 구독료는 **부가가치세(VAT) 별도** 금액이다.
---
**최종 업데이트**: 2026-02-21