feat:전체 AI 서비스에 토큰 사용량 기록 추가

- AiTokenHelper 공통 헬퍼 생성 (Gemini/Claude 응답 파서)
- BizCertOcrService (Claude) 토큰 기록 추가
- BusinessCardOcrService (Gemini) 토큰 기록 추가
- MeetingLogService (Claude) 토큰 기록 추가

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

app/Helpers/AiTokenHelper.php

@@ -0,0 +1,92 @@
+<?php
+
+namespace App\Helpers;
+
+use App\Models\System\AiTokenUsage;
+use Illuminate\Support\Facades\Log;
+use Illuminate\Support\Str;
+
+class AiTokenHelper
+{
+    /**
+     * Gemini API 응답에서 토큰 사용량 저장
+     */
+    public static function saveGeminiUsage(array $apiResult, string $model, string $menuName): void
+    {
+        try {
+            $usage = $apiResult['usageMetadata'] ?? null;
+            if (! $usage) {
+                return;
+            }
+
+            $promptTokens = $usage['promptTokenCount'] ?? 0;
+            $completionTokens = $usage['candidatesTokenCount'] ?? 0;
+            $totalTokens = $usage['totalTokenCount'] ?? 0;
+
+            // Gemini 2.0 Flash 기준 단가
+            $inputPrice = 0.10 / 1_000_000;
+            $outputPrice = 0.40 / 1_000_000;
+
+            self::save($model, $menuName, $promptTokens, $completionTokens, $totalTokens, $inputPrice, $outputPrice);
+        } catch (\Exception $e) {
+            Log::warning('AI token usage save failed (Gemini)', ['error' => $e->getMessage()]);
+        }
+    }
+
+    /**
+     * Claude API 응답에서 토큰 사용량 저장
+     */
+    public static function saveClaudeUsage(array $apiResult, string $model, string $menuName): void
+    {
+        try {
+            $usage = $apiResult['usage'] ?? null;
+            if (! $usage) {
+                return;
+            }
+
+            $promptTokens = $usage['input_tokens'] ?? 0;
+            $completionTokens = $usage['output_tokens'] ?? 0;
+            $totalTokens = $promptTokens + $completionTokens;
+
+            // Claude 3 Haiku 기준 단가
+            $inputPrice = 0.25 / 1_000_000;
+            $outputPrice = 1.25 / 1_000_000;
+
+            self::save($model, $menuName, $promptTokens, $completionTokens, $totalTokens, $inputPrice, $outputPrice);
+        } catch (\Exception $e) {
+            Log::warning('AI token usage save failed (Claude)', ['error' => $e->getMessage()]);
+        }
+    }
+
+    /**
+     * 공통 저장 로직
+     */
+    private static function save(
+        string $model,
+        string $menuName,
+        int $promptTokens,
+        int $completionTokens,
+        int $totalTokens,
+        float $inputPricePerToken,
+        float $outputPricePerToken,
+    ): void {
+        $costUsd = ($promptTokens * $inputPricePerToken) + ($completionTokens * $outputPricePerToken);
+        $exchangeRate = (float) config('services.gemini.exchange_rate', 1400);
+        $costKrw = $costUsd * $exchangeRate;
+
+        $tenantId = session('selected_tenant_id', 1);
+
+        AiTokenUsage::create([
+            'tenant_id' => $tenantId,
+            'model' => $model,
+            'menu_name' => $menuName,
+            'prompt_tokens' => $promptTokens,
+            'completion_tokens' => $completionTokens,
+            'total_tokens' => $totalTokens,
+            'cost_usd' => $costUsd,
+            'cost_krw' => $costKrw,
+            'request_id' => Str::uuid()->toString(),
+            'created_by' => auth()->id(),
+        ]);
+    }
+}

app/Services/BizCertOcrService.php

@@ -2,6 +2,7 @@
 
 namespace App\Services;
 
+use App\Helpers\AiTokenHelper;
 use App\Models\BizCert;
 use Illuminate\Support\Facades\Http;
 use Illuminate\Support\Facades\Log;
@@ -88,6 +89,10 @@ public function processWithClaude(string $imageBase64, ?string $rawText = null):
             }
 
             $apiResponse = $response->json();
+
+            // 토큰 사용량 저장
+            AiTokenHelper::saveClaudeUsage($apiResponse, 'claude-3-haiku-20240307', '사업자등록증OCR');
+
             $claudeText = $apiResponse['content'][0]['text'] ?? '';
 
             if (empty($claudeText)) {

app/Services/BusinessCardOcrService.php

@@ -2,6 +2,7 @@
 
 namespace App\Services;
 
+use App\Helpers\AiTokenHelper;
 use App\Models\System\AiConfig;
 use Illuminate\Http\Client\ConnectionException;
 use Illuminate\Support\Facades\Http;
@@ -130,6 +131,10 @@ private function callGeminiApi(string $url, string $base64Image, array $headers,
             }
 
             $result = $response->json();
+
+            // 토큰 사용량 저장
+            AiTokenHelper::saveGeminiUsage($result, $result['modelVersion'] ?? 'gemini', '명함OCR');
+
             $text = $result['candidates'][0]['content']['parts'][0]['text'] ?? '';
 
             // JSON 파싱

app/Services/MeetingLogService.php

@@ -2,6 +2,7 @@
 
 namespace App\Services;
 
+use App\Helpers\AiTokenHelper;
 use App\Models\MeetingLog;
 use Illuminate\Pagination\LengthAwarePaginator;
 use Illuminate\Support\Facades\Auth;
@@ -171,6 +172,9 @@ private function generateSummary(string $transcript, string $summaryType = 'meet
             if ($response->successful()) {
                 $data = $response->json();
 
+                // 토큰 사용량 저장
+                AiTokenHelper::saveClaudeUsage($data, 'claude-3-haiku-20240307', '회의록AI요약');
+
                 return $data['content'][0]['text'] ?? null;
             }