@yolo-croket-dev/entity-v2 0.2.141-jun.7 → 0.2.141-jun.9

package/naver-policy-ai-review/common.entity.d.ts

@@ -1,3 +1,4 @@
+import { Types } from 'mongoose';
 import { NaverPolicyAiReviewDecisionEnum, NaverPolicyAiReviewTextSourceTypeEnum } from './enum';
 /** @description 네이버 정책 AI 검수 후보 문장 */
 export interface NaverPolicyAiReviewCandidate {
@@ -34,6 +35,14 @@ export interface NaverPolicyAiReviewCandidateResult {
     confidence: number;
     /** @description 사람이 이해할 수 있는 후보 판정 사유 */
     reason: string;
+    /** @description 후보 판정 출처. AI 직접 호출 또는 후보 cache 재사용 여부를 나타냅니다. */
+    reviewSource?: 'AI' | 'CACHE';
+    /** @description candidate cache를 사용한 후보인지 여부 */
+    cacheHit?: boolean;
+    /** @description 재사용한 candidate cache 문서 id */
+    cacheId?: Types.ObjectId | string;
+    /** @description 후보 cache를 조회할 때 사용한 key */
+    cacheKey?: string;
 }
 /** @description 네이버 정책 AI 검수 오류 요약 */
 export interface NaverPolicyAiReviewErrorSummary {
@@ -44,3 +53,14 @@ export interface NaverPolicyAiReviewErrorSummary {
     /** @description 오류가 발생한 시각 */
     occurredAt: Date;
 }
+/** @description AI provider가 반환한 토큰 사용량 */
+export interface NaverPolicyAiReviewTokenUsage {
+    /** @description provider 요청 입력 토큰 수 */
+    promptTokenCount?: number;
+    /** @description provider 응답 출력 토큰 수 */
+    candidatesTokenCount?: number;
+    /** @description 입력과 출력을 합산한 전체 토큰 수 */
+    totalTokenCount?: number;
+    /** @description Gemini thinking 계열 모델에서 반환될 수 있는 사고 토큰 수 */
+    thoughtsTokenCount?: number;
+}

package/naver-policy-ai-review/index.d.ts

@@ -1,4 +1,5 @@
 export * from './common.entity';
 export * from './enum';
+export * from './naver-policy-ai-review-candidate-cache.entity';
 export * from './naver-policy-ai-review-log.entity';
 export * from './naver-policy-ai-review-result.entity';

package/naver-policy-ai-review/index.js

@@ -16,5 +16,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./common.entity"), exports);
 __exportStar(require("./enum"), exports);
+__exportStar(require("./naver-policy-ai-review-candidate-cache.entity"), exports);
 __exportStar(require("./naver-policy-ai-review-log.entity"), exports);
 __exportStar(require("./naver-policy-ai-review-result.entity"), exports);

package/naver-policy-ai-review/naver-policy-ai-review-candidate-cache.entity.d.ts

@@ -0,0 +1,74 @@
+import { Types } from 'mongoose';
+import { NaverPolicyAiReviewDecisionEnum, NaverPolicyAiReviewTextSourceTypeEnum } from './enum';
+/**
+ * @author jun
+ * @description 네이버 정책 AI 검수 후보 단위 cache 데이터
+ */
+export interface NaverPolicyAiReviewCandidateCacheEntity {
+    /** @description cache 문서 id */
+    _id: Types.ObjectId | string;
+    /** @description 후보 cache를 유일하게 식별하는 hash key */
+    cacheKey: string;
+    /** @description cache 대상 후보의 텍스트 출처. v1은 IMAGE_OCR만 사용합니다. */
+    sourceType: NaverPolicyAiReviewTextSourceTypeEnum;
+    /** @description IMAGE_OCR 후보일 때 원본 이미지 md5sum */
+    imageMd5: string;
+    /** @description OCR 원문 또는 정규화 텍스트의 hash */
+    ocrTextHash: string;
+    /** @description OCR engine 이름 */
+    ocrEngine?: string;
+    /** @description OCR engine 버전 */
+    ocrEngineVersion?: string;
+    /** @description OCR 전처리 버전 */
+    preprocessVersion?: string;
+    /** @description 네이버 정책 정의 버전 */
+    policyVersion: string;
+    /** @description 후보 추출 룰셋 버전 */
+    ruleSetVersion: string;
+    /** @description 후보 추출기 구현 버전 */
+    candidateExtractorVersion: string;
+    /** @description AI 프롬프트 버전 */
+    promptVersion: string;
+    /** @description AI provider 이름 */
+    modelProvider: string;
+    /** @description 호출한 AI 모델명 */
+    modelName: string;
+    /** @description provider가 제공하는 모델 세부 버전 */
+    modelVersion?: string;
+    /** @description 후보를 추출한 룰 id */
+    ruleId: string;
+    /** @description 후보가 속한 정책 위험 카테고리 */
+    category: string;
+    /** @description exactText, beforeText, afterText, category를 정규화해 만든 hash */
+    candidateContextHash: string;
+    /** @description AI 검수 대상이 되는 핵심 후보 문장 */
+    exactText: string;
+    /** @description 후보 문장 바로 앞 문맥 */
+    beforeText?: string;
+    /** @description 후보 문장 바로 뒤 문맥 */
+    afterText?: string;
+    /** @description 룰에 매칭된 핵심 단어 목록 */
+    matchedTerms: string[];
+    /** @description OCR 저신뢰도처럼 후보 해석에 참고할 품질 플래그 */
+    qualityFlags?: string[];
+    /** @description 후보 단위 AI 판정 */
+    decision: NaverPolicyAiReviewDecisionEnum;
+    /** @description 후보 판정 confidence */
+    confidence: number;
+    /** @description 판정 사유를 분류하기 위한 코드 */
+    reasonCode: string;
+    /** @description 사람이 이해할 수 있는 후보 판정 사유 */
+    reason: string;
+    /** @description 이 cache row를 최초 생성한 AI 검수 결과 id */
+    sourceReviewResultId?: Types.ObjectId | string;
+    /** @description 이 cache row를 최초 생성한 AI 검수 로그 id */
+    sourceReviewLogId?: Types.ObjectId | string;
+    /** @description cache hit 누적 횟수 */
+    hitCount: number;
+    /** @description 마지막 cache hit 시각 */
+    lastHitAt?: Date;
+    /** @description 문서 생성 시각 */
+    createdAt: Date;
+    /** @description 문서 마지막 수정 시각 */
+    updatedAt: Date;
+}

package/naver-policy-ai-review/naver-policy-ai-review-candidate-cache.entity.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/naver-policy-ai-review/naver-policy-ai-review-log.entity.d.ts

@@ -1,5 +1,5 @@
 import { Types } from 'mongoose';
-import { NaverPolicyAiReviewCandidate, NaverPolicyAiReviewCandidateResult, NaverPolicyAiReviewErrorSummary } from './common.entity';
+import { NaverPolicyAiReviewCandidate, NaverPolicyAiReviewCandidateResult, NaverPolicyAiReviewErrorSummary, NaverPolicyAiReviewTokenUsage } from './common.entity';
 import { NaverPolicyAiReviewChannelEnum, NaverPolicyAiReviewDecisionEnum, NaverPolicyAiReviewLogStatusEnum } from './enum';
 /** @description 네이버 정책 AI 검수 로그에 저장하는 provider 요청 스냅샷 */
 export interface NaverPolicyAiReviewRequestPayload {
@@ -28,6 +28,14 @@ export interface NaverPolicyAiReviewResponseResult {
     productConfidence: number;
     /** @description AI가 반환한 후보별 판정 결과 */
     candidateResults: NaverPolicyAiReviewCandidateResult[];
+    /** @description AI provider가 반환한 토큰 사용량 */
+    tokenUsage?: NaverPolicyAiReviewTokenUsage;
+    /** @description 후보 cache를 재사용한 후보 수 */
+    cacheHitCount?: number;
+    /** @description 후보 cache를 재사용하지 못한 후보 수 */
+    cacheMissCount?: number;
+    /** @description 실제 AI provider에 요청한 후보 수 */
+    aiRequestedCandidateCount?: number;
 }
 /**
  * @author jun

package/naver-policy-ai-review/naver-policy-ai-review-result.entity.d.ts

@@ -1,5 +1,5 @@
 import { Types } from 'mongoose';
-import { NaverPolicyAiReviewCandidate, NaverPolicyAiReviewCandidateResult, NaverPolicyAiReviewErrorSummary } from './common.entity';
+import { NaverPolicyAiReviewCandidate, NaverPolicyAiReviewCandidateResult, NaverPolicyAiReviewErrorSummary, NaverPolicyAiReviewTokenUsage } from './common.entity';
 import { NaverPolicyAiReviewChannelEnum, NaverPolicyAiReviewDecisionEnum, NaverPolicyAiReviewStatusEnum } from './enum';
 /**
  * @author jun
@@ -40,6 +40,14 @@ export interface NaverPolicyAiReviewResultEntity {
     candidateSummary?: string;
     /** @description AI가 상품 단위로 반환한 confidence */
     aiConfidence?: number;
+    /** @description AI provider가 반환한 토큰 사용량. 요금/사용량 집계에 사용합니다. */
+    tokenUsage?: NaverPolicyAiReviewTokenUsage;
+    /** @description 후보 cache를 재사용한 후보 수 */
+    cacheHitCount?: number;
+    /** @description 후보 cache를 재사용하지 못한 후보 수 */
+    cacheMissCount?: number;
+    /** @description 실제 AI provider에 요청한 후보 수 */
+    aiRequestedCandidateCount?: number;
     /** @description 최종 판정에 연결된 사유 코드 목록 */
     reasonCodes: string[];
     /** @description AI 검수에 전달한 후보 문장 스냅샷 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yolo-croket-dev/entity-v2",
-  "version": "0.2.141-jun.7",
+  "version": "0.2.141-jun.9",
   "main": "index.js",
   "author": "Yolo Co., Ltd.",
   "description": "크로켓 nest 용 entity-v3",