Files
sam-docs/sam/docs/rules/billing-policy.md

254 lines
9.0 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만원
- **구독료**: 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