From 24a542cb955231723daacabd0fd1f64da7697b93 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=EA=B9=80=EB=B3=B4=EA=B3=A4?= Date: Sat, 21 Feb 2026 19:03:12 +0900 Subject: [PATCH] =?UTF-8?q?docs:=20[=EA=B3=BC=EA=B8=88=EC=A0=95=EC=B1=85]?= =?UTF-8?q?=20=EA=B3=BC=EA=B8=88=EC=A0=95=EC=B1=85=20=ED=86=B5=ED=95=A9=20?= =?UTF-8?q?=EB=AC=B8=EC=84=9C=20=EC=9E=91=EC=84=B1?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 본사 지출 과금정책 (바로빌, AI/클라우드) - 고객 안내용 과금정책 (가입비, 구독료, 추가 옵션) - 내부 정산 정책 (영업 수당, 마진 구조) - INDEX.md에 과금정책 문서 등록 --- sam/docs/INDEX.md | 237 +++++++++++++++++++++++++++++ sam/docs/rules/billing-policy.md | 253 +++++++++++++++++++++++++++++++ 2 files changed, 490 insertions(+) create mode 100644 sam/docs/INDEX.md create mode 100644 sam/docs/rules/billing-policy.md diff --git a/sam/docs/INDEX.md b/sam/docs/INDEX.md new file mode 100644 index 0000000..e4eece5 --- /dev/null +++ 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/ 디렉토리 생성 \ No newline at end of file diff --git a/sam/docs/rules/billing-policy.md b/sam/docs/rules/billing-policy.md new file mode 100644 index 0000000..909a2ba --- /dev/null +++ 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