docs: [과금정책] 과금정책 통합 문서 작성

- 본사 지출 과금정책 (바로빌, AI/클라우드) - 고객 안내용 과금정책 (가입비, 구독료, 추가 옵션) - 내부 정산 정책 (영업 수당, 마진 구조) - INDEX.md에 과금정책 문서 등록
2026-02-21 19:03:12 +09:00
parent 6fb6e4fdbe
commit 24a542cb95
2 changed files with 490 additions and 0 deletions
--- a/sam/docs/INDEX.md
+++ b/sam/docs/INDEX.md
@@ -0,0 +1,237 @@
+# SAM 프로젝트 문서 인덱스
+
+> **Claude Code 작업 전 필수 확인** - 작업 유형에 맞는 문서를 먼저 읽고 시작하세요.
+
+---
+
+## 🎯 작업별 필수 문서 (반드시 먼저 확인)
+
+| 작업 유형 | 필수 문서 | 용도 |
+|----------|----------|------|
+| **TODO 확인** | `TODO.md` | 긴급/중요 이슈 및 개선사항 추적 |
+| **API 개발** | `standards/api-rules.md` | Service-First, FormRequest, i18n 규칙 |
+| **DB 변경** | `specs/database-schema.md` | 테이블 구조, 관계, 컬럼 규칙 |
+| **새 기능 구현** | `architecture/system-overview.md` | 전체 아키텍처 이해 |
+| **보안 관련** | `architecture/security-policy.md` | 인증/인가, 보안 규칙 |
+| **Git 커밋** | `standards/git-conventions.md` | 커밋 메시지, 브랜치 전략 |
+| **품질 검증** | `standards/quality-checklist.md` | 코드 품질 체크리스트 |
+| **Swagger 작성** | `guides/swagger-guide.md` | API 문서 작성 방법 |
+| **품목관리** | `rules/item-policy.md` | 품목 정책 (유형, 예약어, API 규칙) |
+| **게시판** | `specs/board-system-spec.md` | 게시판 시스템 설계 |
+| **단가관리** | `rules/pricing-policy.md` | 원가/판매가 계산, 리비전 관리 |
+| **과금정책** | `rules/billing-policy.md` | 과금정책 (본사 지출, 고객 요금, 수당) |
+| **견적관리** | `features/quotes/README.md` | 견적 시스템, BOM 계산, 10단계 로직 |
+| **MES 개발** | `projects/mes/README.md` | MES 프로젝트 개요 |
+
+---
+
+## 📁 폴더 구조
+
+```
+docs/
+├── plans/          # 🆕 개발 계획 - 임시 (작업 완료 후 정리 → 삭제)
+├── standards/      # 개발 표준 - "어떻게 코드를 작성할 것인가"
+├── architecture/   # 아키텍처 - "왜 이렇게 설계하는가"
+├── rules/          # 비즈니스 규칙 - "무엇이 유효한 데이터인가"
+├── specs/          # 기술 스펙 - "무엇을 구현할 것인가"
+├── guides/         # 구현 가이드 - "어떻게 구현할 것인가"
+├── quickstart/     # 빠른 시작 - 핵심 요약
+├── front/          # 프론트엔드 공유 문서
+├── features/       # 기능별 상세 문서
+├── projects/       # 프로젝트별 문서 (MES, Legacy)
+├── history/        # 히스토리 및 로드맵
+├── changes/        # 변경 이력
+└── data/           # 데이터 분석
+```
+
+---
+
+## 📚 폴더별 문서 목록
+
+### standards/ - 개발 표준
+> 코딩 컨벤션, 스타일 가이드, 품질 기준
+
+| 문서 | 설명 | 필수 확인 시점 |
+|------|------|--------------|
+| [api-rules.md](standards/api-rules.md) | API 개발 규칙 (Service-First, FormRequest, i18n) | API 개발 전 |
+| [git-conventions.md](standards/git-conventions.md) | Git 커밋 메시지, 브랜치 전략 | 커밋 전 |
+| [quality-checklist.md](standards/quality-checklist.md) | 코드 품질 체크리스트 | PR 전 |
+
+### architecture/ - 아키텍처 & 설계 원칙
+> 시스템 설계, 보안 정책, 아키텍처 결정
+
+| 문서 | 설명 | 필수 확인 시점 |
+|------|------|--------------|
+| [system-overview.md](architecture/system-overview.md) | 전체 시스템 아키텍처 | 새 기능 설계 전 |
+| [security-policy.md](architecture/security-policy.md) | 인증/인가, 보안 규칙 | 보안 관련 작업 전 |
+
+### rules/ - 비즈니스 규칙
+> 도메인 로직, 검증 규칙, 상태 전이
+
+| 문서 | 설명 | 필수 확인 시점 |
+|------|------|--------------|
+| [README.md](rules/README.md) | 비즈니스 규칙 개요 | 도메인 로직 구현 전 |
+| [item-policy.md](rules/item-policy.md) | 품목 정책 (유형 체계, 예약어, API 규칙) | 품목 관련 작업 전 |
+| [pricing-policy.md](rules/pricing-policy.md) | 단가 정책 (원가/판매가 계산, 리비전 관리) | 단가 관련 작업 전 |
+| [billing-policy.md](rules/billing-policy.md) | 과금정책 통합 (본사 지출 + 고객 요금 + 수당) | 과금/정산 관련 작업 전 |
+
+### specs/ - 기술 스펙
+> 구현 명세, DB 스키마, 시스템 설정
+
+| 문서 | 설명 | 필수 확인 시점 |
+|------|------|--------------|
+| [database-schema.md](specs/database-schema.md) | DB 구조 및 관계도 | DB 변경 전 |
+| [board-system-spec.md](specs/board-system-spec.md) | 게시판 시스템 설계 | 게시판 작업 전 |
+| [item-master-integration.md](specs/item-master-integration.md) | 품목관리 연동 설계 | 품목 연동 구현 시 |
+| [docker-setup.md](specs/docker-setup.md) | Docker 환경 구성 | 환경 설정 시 |
+| [remote-work-setup.md](specs/remote-work-setup.md) | 원격 개발 설정 | 원격 작업 시 |
+
+### guides/ - 구현 가이드
+> 특정 기능 구현을 위한 단계별 매뉴얼
+
+| 문서 | 설명 | 필수 확인 시점 |
+|------|------|--------------|
+| [swagger-guide.md](guides/swagger-guide.md) | Swagger API 문서 작성법 | API 문서 작성 전 |
+| [file-storage-guide.md](guides/file-storage-guide.md) | 파일 업로드/다운로드 구현 | 파일 기능 구현 전 |
+| [item-management-migration.md](guides/item-management-migration.md) | Item 시스템 전환 가이드 | 마이그레이션 작업 전 |
+| [project-launch-roadmap.md](guides/project-launch-roadmap.md) | 런칭 준비 현황 | 런칭 관련 작업 시 |
+| [production-env-sync.md](guides/production-env-sync.md) | 운영 전환 시 .env 동기화 절차 | 테스트→운영 전환 시 |
+
+### quickstart/ - 빠른 시작
+> 핵심 규칙 요약, 자주 쓰는 명령어
+
+| 문서 | 설명 | 필수 확인 시점 |
+|------|------|--------------|
+| [quick-start.md](quickstart/quick-start.md) | 프로젝트 핵심 규칙 요약 | 세션 시작 시 |
+| [dev-commands.md](quickstart/dev-commands.md) | 일상 개발 명령어 모음 | 명령어 확인 시 |
+
+### front/ - 프론트엔드 공유 문서
+> API 연동 가이드, 프론트엔드 스펙
+
+| 문서 | 설명 |
+|------|------|
+| [item-master-guide.md](front/item-master-guide.md) | 품목기준관리 페이지-섹션-필드 구조 |
+
+> 날짜별 API 요청 문서는 `history/2025-11/front-requests/`로 이동됨
+
+### data/ - 데이터 분석
+> 시스템 분석, 데이터 모델링
+
+| 문서 | 설명 |
+|------|------|
+| [analysis/item-db-analysis.md](data/analysis/item-db-analysis.md) | Item DB/API 분석 최종본 |
+
+### features/ - 기능별 문서
+
+| 문서 | 설명 |
+|------|------|
+| [barobill-kakaotalk/README.md](features/barobill-kakaotalk/README.md) | 바로빌 카카오톡 (알림톡/친구톡) 연동 |
+| [boards/README.md](features/boards/README.md) | 게시판 시스템 구현 |
+| [boards/mng-implementation.md](features/boards/mng-implementation.md) | MNG 게시판 구현 상세 |
+| [hr/hr-api-analysis.md](features/hr/hr-api-analysis.md) | HR API 분석 (근태/직원/부서) |
+| [quotes/README.md](features/quotes/README.md) | 견적 시스템 분석 (BOM 계산, 10단계 로직) |
+
+### projects/ - 프로젝트별 문서
+
+| 프로젝트 | 문서 | 설명 |
+|---------|------|------|
+| **MES** | [README.md](projects/mes/README.md) | MES 프로젝트 개요 |
+| **MES** | [MES_PROJECT_ROADMAP.md](projects/mes/MES_PROJECT_ROADMAP.md) | 개발 로드맵 |
+| **Legacy** | [draw-module.md](projects/legacy-5130/draw-module.md) | 레거시 드로우 모듈 |
+
+### history/ - 히스토리
+
+| 기간 | 문서 |
+|------|------|
+| **2025-11** | [item-master-gap-analysis.md](history/2025-11/item-master-gap-analysis.md), [item-master-spec.md](history/2025-11/item-master-spec.md), [front-requests/](history/2025-11/front-requests/), [item-master-archived/](history/2025-11/item-master-archived/) |
+| **2025-09** | [checkpoint.md](history/2025-09/checkpoint.md), [database-schema.md](history/2025-09/database-schema.md) |
+| **Roadmaps** | [december-2025.md](history/roadmaps/december-2025.md) |
+
+---
+
+## 🏗️ 서브프로젝트 문서
+
+각 서브프로젝트는 독립적인 `docs/` 디렉토리를 가집니다.
+
+| 프로젝트 | 문서 경로 | 설명 |
+|---------|----------|------|
+| **API** | [api/docs/INDEX.md](../api/docs/INDEX.md) | REST API 프로젝트 |
+| **MNG** | [mng/docs/INDEX.md](../mng/docs/INDEX.md) | Plain Laravel 관리자 (운영 주력) |
+| **React** | [react/docs/](../react/docs/) | Next.js 프론트엔드 |
+
+---
+
+## 📝 문서 작성 가이드
+
+### 새 문서 작성 시
+1. **적절한 폴더 선택**: 위 폴더 구조 참고
+2. **파일명**: 소문자 + 하이픈 (kebab-case)
+3. **크기 목표**: 10KB 이하
+4. **INDEX 업데이트**: 새 문서는 반드시 이 파일에 추가
+
+### 폴더 선택 기준
+- **"개발 계획/작업 예정"** → `plans/` (임시, 완료 후 삭제)
+- **"어떻게 코드 작성?"** → `standards/`
+- **"왜 이렇게 설계?"** → `architecture/`
+- **"무엇이 유효한 데이터?"** → `rules/`
+- **"무엇을 구현?"** → `specs/`
+- **"어떻게 구현?"** → `guides/`
+
+### plans/ 워크플로우
+1. 개발 계획 문서를 `plans/`에 작성
+2. 작업 진행
+3. 완료 후 결과물을 해당 프로젝트 docs에 정리
+4. plan 문서 삭제
+
+### plans/flow-tests/
+API Flow Tester에서 생성되는 JSON 파일 저장 경로
+- 경로: `plans/flow-tests/*.json`
+- 용도: MNG API Flow Tester 테스트 시나리오
+- 예시: `item-master-page-api-flow.json`, `client-api-flow.json`
+
+---
+
+## 🔄 문서 구조 변경 이력
+
+- **2026-01-28**: API 라우터 분리 및 버전 폴백 시스템 구현
+  - `routes/api.php` → 13개 도메인별 파일로 분리 (1,479줄 → 61줄)
+  - `ApiVersionMiddleware` 추가 (헤더/쿼리 기반 버전 선택, v2→v1 폴백)
+  - `standards/api-rules.md` 라우팅 섹션 업데이트
+  - `architecture/system-overview.md` 라우팅 구조 업데이트
+
+- **2025-12-09**: 품목 정책 통합 문서 생성
+  - `rules/item-policy.md` 생성 (4개 문서 통합)
+  - 삭제: `specs/ITEM-MASTER-INDEX.md`, `specs/item-master-field-key-validation.md`, `specs/item-master-field-integration.md`, `plans/items-api-unified-plan.md`
+  - 품목 관련 정책을 rules/ 디렉토리로 이동
+
+- **2025-12-09**: Item Master 문서 정리 및 인덱스 생성
+  - `specs/ITEM-MASTER-INDEX.md` 생성 (개발 현황/필요 항목 정리)
+  - `history/2025-11/item-master-archived/` 생성 (구버전 문서 아카이브)
+  - 중복 문서 정리 (front-requests → history 이동)
+
+- **2025-12-09**: 문서 정리 및 통합
+  - 중복 분석 문서 삭제 (v2, DB_Modeling)
+  - `SAM_Item_DB_API_Analysis_v3_FINAL.md` → `item-db-analysis.md` 리네임
+  - `ITEM_MASTER_FIELD_INTEGRATION_PLAN.md` → `item-master-field-integration.md` 리네임
+  - `HR_API_ANALYSIS.md` → `features/hr/hr-api-analysis.md` 이동
+  - 날짜 접두사 front 문서 → `history/2025-11/front-requests/` 이동
+  - api/docs에서 프로젝트 문서 분리 (swagger, api-flows만 유지)
+
+- **2025-12-09**: api/docs 문서 통합
+  - `api/docs/analysis/` → `docs/data/analysis/` 이동
+  - `api/docs/front/` → `docs/front/` 병합
+  - `api/docs/specs/` → `docs/specs/` 병합
+  - api/docs에는 API 구성/설정 문서만 유지 (swagger, api-flows)
+
+- **2025-12-09**: `plans/` 폴더 추가
+  - 개발 계획 문서용 임시 폴더
+  - 작업 완료 후 정리 → 삭제 워크플로우
+
+- **2025-12-05**: 폴더 구조 대폭 재정리
+  - `reference/` → `standards/`, `architecture/`, `quickstart/`로 분리
+  - `principles/` → `architecture/`로 통합
+  - 작업별 필수 문서 가이드 추가
+
+- **2025-11-20**: 문서 구조 대규모 재정리
+  - claudedocs → docs/ 체계화
+  - 각 서브프로젝트별 docs/ 디렉토리 생성
--- a/sam/docs/rules/billing-policy.md
+++ b/sam/docs/rules/billing-policy.md
@@ -0,0 +1,253 @@
+# 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