Files

김보곤 02a892f8b8 docs: [과금정책] 3분할 문서 완성 및 브랜딩 정리

- billing-policy.md 3분할: customer-pricing.md, partner-commission.md, billing-policy.md
- 3개 프레젠테이션 HTML 슬라이드 및 PPTX 생성 (총 20장)
- customer-pricing: 고객용 요금 안내 (7장, 블루 테마)
- partner-commission: 영업파트너 수당 체계 (6장, 그린 테마)
- billing-policy: 내부 대외비 과금정책 (7장, 레드 테마)
- 전체 슬라이드 BI 로고 삽입 및 주일/경동 → (주)코드브릿지엑스 전환
- esign-storyboard.pptx 내 브랜딩 텍스트 수정
- INDEX.md 업데이트

2026-02-21 21:13:46 +09:00

6.9 KiB

Raw Blame History

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

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

문서 분리 안내

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

문서	대상	내용
고객 요금 안내	고객	서비스 가격표, 과금 기준
영업파트너 수당 체계	영업파트너	수당률, 정산 프로세스
본 문서 (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 포함)	코드브릿지엑스 지원 → 본사 부담 (무료)
홈택스 매출	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. 고객 안내용 과금정책

고객 요금 상세는 고객 요금 안내 문서를 참조한다.

4. 내부 정산 정책

4.1 영업 수당 체계

수당률 및 정산 프로세스는 영업파트너 수당 체계 문서를 참조한다.

4.2 마진 구조

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

4.3 가격 책정 배경

내부 총 개발비 산정: 약 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. 관련 문서

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

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

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

6.9 KiB Raw Blame History