@yolo-croket-dev/entity-v2 0.2.141-jun.1 → 0.2.141-jun.11

package/index.d.ts

@@ -59,6 +59,7 @@ export * from './cart-second-push-log';
 export * from './cart-third-push-log';
 export * from './store-item-naver-feed';
 export * from './store-item-naver-feed-guard';
+export * from './naver-policy-ai-review';
 export * from './brand.modules/naver-brand-dictionary';
 export * from './buyma-item.modules';
 export * from './campaign-store-item';

package/index.js

@@ -75,6 +75,7 @@ __exportStar(require("./cart-second-push-log"), exports);
 __exportStar(require("./cart-third-push-log"), exports);
 __exportStar(require("./store-item-naver-feed"), exports);
 __exportStar(require("./store-item-naver-feed-guard"), exports);
+__exportStar(require("./naver-policy-ai-review"), exports);
 __exportStar(require("./brand.modules/naver-brand-dictionary"), exports);
 __exportStar(require("./buyma-item.modules"), exports);
 __exportStar(require("./campaign-store-item"), exports);

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

@@ -0,0 +1,66 @@
+import { Types } from 'mongoose';
+import { NaverPolicyAiReviewDecisionEnum, NaverPolicyAiReviewTextSourceTypeEnum } from './enum';
+/** @description 네이버 정책 AI 검수 후보 문장 */
+export interface NaverPolicyAiReviewCandidate {
+    /** @description 후보 문장이 추출된 원본 텍스트 종류 */
+    sourceType: NaverPolicyAiReviewTextSourceTypeEnum;
+    /** @description 텍스트 원본을 식별하기 위한 내부 id 또는 path */
+    sourceId?: string;
+    /** @description OCR 이미지 후보일 때 원본 이미지를 식별하는 md5sum */
+    imageMd5?: string;
+    /** @description 후보를 추출한 룰 id */
+    ruleId: string;
+    /** @description 후보가 속한 정책 위험 카테고리 */
+    category: string;
+    /** @description 룰에 매칭된 핵심 단어 목록 */
+    matchedTerms: string[];
+    /** @description 후보 문장 바로 앞 문맥 */
+    beforeText?: string;
+    /** @description AI 검수 대상이 되는 핵심 후보 문장 */
+    exactText: string;
+    /** @description 후보 문장 바로 뒤 문맥 */
+    afterText?: string;
+    /** @description OCR 저신뢰도처럼 후보 해석에 참고할 품질 플래그 */
+    qualityFlags?: string[];
+}
+/** @description 네이버 정책 AI 검수 후보별 판정 결과 */
+export interface NaverPolicyAiReviewCandidateResult {
+    /** @description candidates 배열에서 해당 후보가 위치한 index */
+    candidateIndex: number;
+    /** @description 후보 단위 AI 판정 */
+    decision: NaverPolicyAiReviewDecisionEnum;
+    /** @description 판정 사유를 분류하기 위한 코드 */
+    reasonCode: string;
+    /** @description 후보 판정 confidence. 0부터 1 사이 값을 기대합니다. */
+    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 {
+    /** @description 오류를 분류하기 위한 코드 */
+    code: string;
+    /** @description 운영자 또는 개발자가 확인할 오류 메시지 */
+    message: string;
+    /** @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/common.entity.js

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

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

@@ -0,0 +1,43 @@
+/** @description 네이버 정책 AI 검수 채널 */
+export declare enum NaverPolicyAiReviewChannelEnum {
+    /** @description 네이버 SA/쇼핑 연동 정책 검수 채널 */
+    NAVER = "NAVER"
+}
+/** @description 네이버 정책 AI 검수 결과 문서의 처리 상태 */
+export declare enum NaverPolicyAiReviewStatusEnum {
+    /** @description 검수 요청은 생성됐지만 아직 AI 검수가 시작되지 않은 상태 */
+    WAITING = "waiting",
+    /** @description AI 검수 처리 중 실패가 발생해 운영 확인이 필요한 상태 */
+    FAIL = "fail",
+    /** @description AI 검수 처리가 정상 종료된 상태 */
+    SUCCESS = "success"
+}
+/** @description 네이버 정책 AI 검수 최종 판정 */
+export declare enum NaverPolicyAiReviewDecisionEnum {
+    /** @description 네이버 연동을 계속 진행해도 되는 상품 */
+    ALLOW = "ALLOW",
+    /** @description 자동 차단은 하지 않지만 운영자 확인이 필요한 상품 */
+    REVIEW = "REVIEW",
+    /** @description 네이버 패널티 위험이 높아 운영자 우선 확인과 연동 제외 검토가 필요한 상품 */
+    BLOCK = "BLOCK"
+}
+/** @description 네이버 정책 AI 검수 시도 로그의 처리 상태 */
+export declare enum NaverPolicyAiReviewLogStatusEnum {
+    /** @description AI 검수 시도가 정상 종료된 로그 */
+    SUCCESS = "SUCCESS",
+    /** @description AI 검수 시도 중 오류가 발생한 로그 */
+    FAILED = "FAILED"
+}
+/** @description 네이버 정책 AI 검수에 사용된 텍스트 출처 */
+export declare enum NaverPolicyAiReviewTextSourceTypeEnum {
+    /** @description 상품명에서 추출한 텍스트. v1에서는 예약 값입니다. */
+    PRODUCT_NAME = "PRODUCT_NAME",
+    /** @description 옵션명 또는 옵션값에서 추출한 텍스트. v1에서는 예약 값입니다. */
+    OPTION_NAME = "OPTION_NAME",
+    /** @description 상품 상세 설명 텍스트 */
+    DETAIL_TEXT = "DETAIL_TEXT",
+    /** @description 상품 HTML 상세에서 태그를 제거해 만든 텍스트 */
+    DETAIL_HTML_TEXT = "DETAIL_HTML_TEXT",
+    /** @description 상품 이미지 OCR 결과 텍스트 */
+    IMAGE_OCR = "IMAGE_OCR"
+}

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

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NaverPolicyAiReviewTextSourceTypeEnum = exports.NaverPolicyAiReviewLogStatusEnum = exports.NaverPolicyAiReviewDecisionEnum = exports.NaverPolicyAiReviewStatusEnum = exports.NaverPolicyAiReviewChannelEnum = void 0;
+/** @description 네이버 정책 AI 검수 채널 */
+var NaverPolicyAiReviewChannelEnum;
+(function (NaverPolicyAiReviewChannelEnum) {
+    /** @description 네이버 SA/쇼핑 연동 정책 검수 채널 */
+    NaverPolicyAiReviewChannelEnum["NAVER"] = "NAVER";
+})(NaverPolicyAiReviewChannelEnum = exports.NaverPolicyAiReviewChannelEnum || (exports.NaverPolicyAiReviewChannelEnum = {}));
+/** @description 네이버 정책 AI 검수 결과 문서의 처리 상태 */
+var NaverPolicyAiReviewStatusEnum;
+(function (NaverPolicyAiReviewStatusEnum) {
+    /** @description 검수 요청은 생성됐지만 아직 AI 검수가 시작되지 않은 상태 */
+    NaverPolicyAiReviewStatusEnum["WAITING"] = "waiting";
+    /** @description AI 검수 처리 중 실패가 발생해 운영 확인이 필요한 상태 */
+    NaverPolicyAiReviewStatusEnum["FAIL"] = "fail";
+    /** @description AI 검수 처리가 정상 종료된 상태 */
+    NaverPolicyAiReviewStatusEnum["SUCCESS"] = "success";
+})(NaverPolicyAiReviewStatusEnum = exports.NaverPolicyAiReviewStatusEnum || (exports.NaverPolicyAiReviewStatusEnum = {}));
+/** @description 네이버 정책 AI 검수 최종 판정 */
+var NaverPolicyAiReviewDecisionEnum;
+(function (NaverPolicyAiReviewDecisionEnum) {
+    /** @description 네이버 연동을 계속 진행해도 되는 상품 */
+    NaverPolicyAiReviewDecisionEnum["ALLOW"] = "ALLOW";
+    /** @description 자동 차단은 하지 않지만 운영자 확인이 필요한 상품 */
+    NaverPolicyAiReviewDecisionEnum["REVIEW"] = "REVIEW";
+    /** @description 네이버 패널티 위험이 높아 운영자 우선 확인과 연동 제외 검토가 필요한 상품 */
+    NaverPolicyAiReviewDecisionEnum["BLOCK"] = "BLOCK";
+})(NaverPolicyAiReviewDecisionEnum = exports.NaverPolicyAiReviewDecisionEnum || (exports.NaverPolicyAiReviewDecisionEnum = {}));
+/** @description 네이버 정책 AI 검수 시도 로그의 처리 상태 */
+var NaverPolicyAiReviewLogStatusEnum;
+(function (NaverPolicyAiReviewLogStatusEnum) {
+    /** @description AI 검수 시도가 정상 종료된 로그 */
+    NaverPolicyAiReviewLogStatusEnum["SUCCESS"] = "SUCCESS";
+    /** @description AI 검수 시도 중 오류가 발생한 로그 */
+    NaverPolicyAiReviewLogStatusEnum["FAILED"] = "FAILED";
+})(NaverPolicyAiReviewLogStatusEnum = exports.NaverPolicyAiReviewLogStatusEnum || (exports.NaverPolicyAiReviewLogStatusEnum = {}));
+/** @description 네이버 정책 AI 검수에 사용된 텍스트 출처 */
+var NaverPolicyAiReviewTextSourceTypeEnum;
+(function (NaverPolicyAiReviewTextSourceTypeEnum) {
+    /** @description 상품명에서 추출한 텍스트. v1에서는 예약 값입니다. */
+    NaverPolicyAiReviewTextSourceTypeEnum["PRODUCT_NAME"] = "PRODUCT_NAME";
+    /** @description 옵션명 또는 옵션값에서 추출한 텍스트. v1에서는 예약 값입니다. */
+    NaverPolicyAiReviewTextSourceTypeEnum["OPTION_NAME"] = "OPTION_NAME";
+    /** @description 상품 상세 설명 텍스트 */
+    NaverPolicyAiReviewTextSourceTypeEnum["DETAIL_TEXT"] = "DETAIL_TEXT";
+    /** @description 상품 HTML 상세에서 태그를 제거해 만든 텍스트 */
+    NaverPolicyAiReviewTextSourceTypeEnum["DETAIL_HTML_TEXT"] = "DETAIL_HTML_TEXT";
+    /** @description 상품 이미지 OCR 결과 텍스트 */
+    NaverPolicyAiReviewTextSourceTypeEnum["IMAGE_OCR"] = "IMAGE_OCR";
+})(NaverPolicyAiReviewTextSourceTypeEnum = exports.NaverPolicyAiReviewTextSourceTypeEnum || (exports.NaverPolicyAiReviewTextSourceTypeEnum = {}));

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

@@ -0,0 +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

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+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

@@ -0,0 +1,79 @@
+import { Types } from 'mongoose';
+import { NaverPolicyAiReviewCandidate, NaverPolicyAiReviewCandidateResult, NaverPolicyAiReviewErrorSummary, NaverPolicyAiReviewTokenUsage } from './common.entity';
+import { NaverPolicyAiReviewChannelEnum, NaverPolicyAiReviewDecisionEnum, NaverPolicyAiReviewLogStatusEnum } from './enum';
+/** @description 네이버 정책 AI 검수 로그에 저장하는 provider 요청 스냅샷 */
+export interface NaverPolicyAiReviewRequestPayload {
+    /** @description AI 검수에 전달한 후보 목록 */
+    candidates: NaverPolicyAiReviewCandidate[];
+    /** @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 네이버 정책 AI 검수 로그에 저장하는 provider 응답 스냅샷 */
+export interface NaverPolicyAiReviewResponseResult {
+    /** @description AI가 반환한 상품 단위 최종 판정 */
+    productDecision: NaverPolicyAiReviewDecisionEnum;
+    /** @description AI가 반환한 상품 단위 confidence */
+    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
+ * @description 네이버 정책 AI 검수 시도 로그 데이터
+ */
+export interface NaverPolicyAiReviewLogEntity {
+    /** @description AI 검수 시도 로그 문서 id */
+    _id: Types.ObjectId | string;
+    /** @description 이 시도가 연결된 AI 검수 결과 문서 id */
+    naverPolicyAiReviewResultId: Types.ObjectId | string;
+    /** @description 검수 대상 guard 문서 id */
+    guardId: Types.ObjectId | string;
+    /** @description 상품 기준 검수일 때 연결되는 상품 id */
+    productId?: Types.ObjectId | string;
+    /** @description 상품 판매자 id. 운영자 필터와 통계에 사용합니다. */
+    sellerId?: Types.ObjectId | string;
+    /** @description 검수 채널 */
+    channel: NaverPolicyAiReviewChannelEnum;
+    /** @description 같은 result 안에서 몇 번째 시도인지 나타내는 번호 */
+    attemptNo: number;
+    /** @description AI 검수 시도 성공 또는 실패 상태 */
+    status: NaverPolicyAiReviewLogStatusEnum;
+    /** @description AI provider에 전달한 요청 스냅샷 */
+    payload: NaverPolicyAiReviewRequestPayload;
+    /** @description AI provider가 반환한 응답 스냅샷 */
+    result?: NaverPolicyAiReviewResponseResult;
+    /** @description AI 검수 시도 실패 시 저장하는 오류 요약 */
+    error?: NaverPolicyAiReviewErrorSummary;
+    /** @description AI 검수를 실행한 worker id */
+    workerId?: string;
+    /** @description AI 검수를 실행한 host 이름 */
+    hostname?: string;
+    /** @description AI 검수 시도 시작 시각 */
+    startedAt: Date;
+    /** @description AI 검수 시도 종료 시각 */
+    finishedAt?: Date;
+    /** @description AI 검수 시도 처리 시간 */
+    processingTimeMs?: number;
+    /** @description 로그 문서 생성 시각 */
+    createdAt: Date;
+}

package/naver-policy-ai-review/naver-policy-ai-review-log.entity.js

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

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

@@ -0,0 +1,69 @@
+import { Types } from 'mongoose';
+import { NaverPolicyAiReviewCandidate, NaverPolicyAiReviewCandidateResult, NaverPolicyAiReviewErrorSummary, NaverPolicyAiReviewTokenUsage } from './common.entity';
+import { NaverPolicyAiReviewChannelEnum, NaverPolicyAiReviewDecisionEnum, NaverPolicyAiReviewStatusEnum } from './enum';
+/**
+ * @author jun
+ * @description 네이버 정책 AI 검수 결과 데이터
+ */
+export interface NaverPolicyAiReviewResultEntity {
+    /** @description 검수 결과 문서 id */
+    _id: Types.ObjectId | string;
+    /** @description 검수 대상 guard 문서 id */
+    guardId: Types.ObjectId | string;
+    /** @description 상품 기준 검수일 때 연결되는 상품 id */
+    productId?: Types.ObjectId | string;
+    /** @description 상품 판매자 id. 운영자 필터와 통계에 사용합니다. */
+    sellerId?: Types.ObjectId | string;
+    /** @description 검수 채널 */
+    channel: NaverPolicyAiReviewChannelEnum;
+    /** @description AI 검수 결과 문서의 처리 상태 */
+    status: NaverPolicyAiReviewStatusEnum;
+    /** @description AI 검수 결과의 최종 판정 */
+    decision?: NaverPolicyAiReviewDecisionEnum;
+    /** @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 AI 검수에 사용한 후보 수 */
+    candidateCount: number;
+    /** @description 운영자 리스트에서 빠르게 볼 후보 요약 */
+    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 검수에 전달한 후보 문장 스냅샷 */
+    candidates: NaverPolicyAiReviewCandidate[];
+    /** @description 후보별 AI 판정 결과 */
+    candidateResults: NaverPolicyAiReviewCandidateResult[];
+    /** @description AI 검수를 시도한 횟수 */
+    attempts: number;
+    /** @description 마지막 AI 검수 시도 로그 id */
+    lastAttemptId?: Types.ObjectId | string;
+    /** @description 마지막 실패가 발생했을 때의 오류 요약 */
+    lastError?: NaverPolicyAiReviewErrorSummary;
+    /** @description AI 검수가 완료된 시각 */
+    reviewedAt?: Date;
+    /** @description 문서 생성 시각 */
+    createdAt: Date;
+    /** @description 문서 마지막 수정 시각 */
+    updatedAt: Date;
+}

package/naver-policy-ai-review/naver-policy-ai-review-result.entity.js

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

package/package.json

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

package/store-item-naver-feed-guard/store-item-naver-feed-guard.entity.d.ts

@@ -1,4 +1,5 @@
 import { Types } from 'mongoose';
+import { NaverPolicyAiReviewDecisionEnum } from '../naver-policy-ai-review';
 /** @description 네이버 연동 상품 검수 종류 */
 export declare enum StoreItemNaverFeedGuardTypeEnum {
     /** 네이버 연동 상품 */
@@ -16,8 +17,12 @@ export declare enum StoreItemNaverFeedGuardStatusEnum {
     WAITING = "WAITING",
     /** 검수 시작 */
     STARTED = "STARTED",
+    /** 이미지 md5sum 조회 진행중 */
+    MD5SUM_CHECKING = "MD5SUM_CHECKING",
     /** OCR 체크 진행중 */
     OCR_CHECKING = "OCR_CHECKING",
+    /** OCR 체크 완료 */
+    OCR_COMPLETED = "OCR_COMPLETED",
     /** AI 체크 진행중 */
     AI_CHECKING = "AI_CHECKING",
     /** 검수 완료 */
@@ -25,6 +30,23 @@ export declare enum StoreItemNaverFeedGuardStatusEnum {
     /** 에러 발생 */
     ERROR = "ERROR"
 }
+/** @description 네이버 연동 상품 검수 오류 종류 */
+export declare enum StoreItemNaverFeedGuardErrorTypeEnum {
+    /** 이미지 md5sum 조회 실패 */
+    MD5SUM_CHECK_FAILED = "MD5SUM_CHECK_FAILED",
+    /** OCR 요청 발행 실패 */
+    OCR_REQUEST_FAILED = "OCR_REQUEST_FAILED",
+    /** OCR 처리 실패 */
+    OCR_PROCESS_FAILED = "OCR_PROCESS_FAILED",
+    /** OCR completion이 도착하지 않아 검수 진행 상태가 멈춤 */
+    OCR_CHECK_STALLED = "OCR_CHECK_STALLED",
+    /** OCR은 완료됐지만 AI 검수 요청 발행이 확인되지 않음 */
+    AI_REVIEW_REQUEST_FAILED = "AI_REVIEW_REQUEST_FAILED",
+    /** AI 검수 진행 상태가 오래 멈춤 */
+    AI_REVIEW_STALLED = "AI_REVIEW_STALLED",
+    /** AI 검수 실패 */
+    AI_REVIEW_FAILED = "AI_REVIEW_FAILED"
+}
 /** @description 네이버 연동 상품 검수 이미지 OCR 상태 */
 export declare enum StoreItemNaverFeedGuardImageOcrStatusEnum {
     /** OCR 대기 */
@@ -42,6 +64,12 @@ export interface StoreItemNaverFeedGuardImage {
     url: string;
     /** @description 이미지 md5sum */
     md5sum?: string;
+    /** @description OCR 대상 이미지가 저장된 R2 object key */
+    r2Key?: string;
+    /** @description OCR 대상 이미지가 저장된 R2 bucket */
+    r2Bucket?: string;
+    /** @description OCR 결과 아이디 */
+    ocrAttemptResultId?: Types.ObjectId | string;
     /** @description 이미지 검수 처리 오류 사유 */
     errorReason?: string;
     /** @description OCR 상태 */
@@ -118,6 +146,10 @@ export interface StoreItemNaverFeedGuardEntity {
     type: StoreItemNaverFeedGuardTypeEnum;
     /** @description 상태값 */
     status: StoreItemNaverFeedGuardStatusEnum;
+    /** @description 오류 사유 */
+    errorReason?: string;
+    /** @description 통계용 오류 종류 */
+    errorType?: StoreItemNaverFeedGuardErrorTypeEnum;
     /**
      * @description 유니크 키. 생성 규칙은 `${type}:${sourceId}`
      *
@@ -137,6 +169,24 @@ export interface StoreItemNaverFeedGuardEntity {
     storeFixedContent?: StoreItemNaverFeedGuardStoreFixedContent;
     /** @description 마지막 네이버 정책 AI 검수 결과 아이디 */
     latestNaverPolicyAiReviewResultId?: Types.ObjectId | string;
+    /** @description 최신 네이버 정책 AI 검수 최종 판정값 */
+    latestAiReviewDecision?: NaverPolicyAiReviewDecisionEnum;
+    /** @description 최신 네이버 정책 AI 검수 완료 일자 */
+    latestAiReviewedAt?: Date;
+    /** @description 관리자가 REVIEW/BLOCK 판정 건을 확인했는지 여부 */
+    isAdminChecked?: boolean;
+    /** @description 관리자 확인 일자 */
+    adminCheckedAt?: Date;
+    /** @description 확인 처리한 관리자 아이디 */
+    adminCheckedBy?: Types.ObjectId | string;
+    /** @description 관리자 확인 메모 */
+    adminCheckMemo?: string;
+    /** @description 이미지 md5sum 조회 완료 일자 */
+    md5sumCheckedAt?: Date;
+    /** @description OCR 체크 완료 일자 */
+    ocrCompletedAt?: Date;
+    /** @description AI 체크 완료 일자 */
+    aiCheckedAt?: Date;
     /** @description 마지막 업데이트 일자 */
     lastUpdated: Date;
     /** @description 등록 일자 */

package/store-item-naver-feed-guard/store-item-naver-feed-guard.entity.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.StoreItemNaverFeedGuardImageOcrStatusEnum = exports.StoreItemNaverFeedGuardStatusEnum = exports.StoreItemNaverFeedGuardTypeEnum = void 0;
+exports.StoreItemNaverFeedGuardImageOcrStatusEnum = exports.StoreItemNaverFeedGuardErrorTypeEnum = exports.StoreItemNaverFeedGuardStatusEnum = exports.StoreItemNaverFeedGuardTypeEnum = void 0;
 /** @description 네이버 연동 상품 검수 종류 */
 var StoreItemNaverFeedGuardTypeEnum;
 (function (StoreItemNaverFeedGuardTypeEnum) {
@@ -20,8 +20,12 @@ var StoreItemNaverFeedGuardStatusEnum;
     StoreItemNaverFeedGuardStatusEnum["WAITING"] = "WAITING";
     /** 검수 시작 */
     StoreItemNaverFeedGuardStatusEnum["STARTED"] = "STARTED";
+    /** 이미지 md5sum 조회 진행중 */
+    StoreItemNaverFeedGuardStatusEnum["MD5SUM_CHECKING"] = "MD5SUM_CHECKING";
     /** OCR 체크 진행중 */
     StoreItemNaverFeedGuardStatusEnum["OCR_CHECKING"] = "OCR_CHECKING";
+    /** OCR 체크 완료 */
+    StoreItemNaverFeedGuardStatusEnum["OCR_COMPLETED"] = "OCR_COMPLETED";
     /** AI 체크 진행중 */
     StoreItemNaverFeedGuardStatusEnum["AI_CHECKING"] = "AI_CHECKING";
     /** 검수 완료 */
@@ -29,6 +33,24 @@ var StoreItemNaverFeedGuardStatusEnum;
     /** 에러 발생 */
     StoreItemNaverFeedGuardStatusEnum["ERROR"] = "ERROR";
 })(StoreItemNaverFeedGuardStatusEnum = exports.StoreItemNaverFeedGuardStatusEnum || (exports.StoreItemNaverFeedGuardStatusEnum = {}));
+/** @description 네이버 연동 상품 검수 오류 종류 */
+var StoreItemNaverFeedGuardErrorTypeEnum;
+(function (StoreItemNaverFeedGuardErrorTypeEnum) {
+    /** 이미지 md5sum 조회 실패 */
+    StoreItemNaverFeedGuardErrorTypeEnum["MD5SUM_CHECK_FAILED"] = "MD5SUM_CHECK_FAILED";
+    /** OCR 요청 발행 실패 */
+    StoreItemNaverFeedGuardErrorTypeEnum["OCR_REQUEST_FAILED"] = "OCR_REQUEST_FAILED";
+    /** OCR 처리 실패 */
+    StoreItemNaverFeedGuardErrorTypeEnum["OCR_PROCESS_FAILED"] = "OCR_PROCESS_FAILED";
+    /** OCR completion이 도착하지 않아 검수 진행 상태가 멈춤 */
+    StoreItemNaverFeedGuardErrorTypeEnum["OCR_CHECK_STALLED"] = "OCR_CHECK_STALLED";
+    /** OCR은 완료됐지만 AI 검수 요청 발행이 확인되지 않음 */
+    StoreItemNaverFeedGuardErrorTypeEnum["AI_REVIEW_REQUEST_FAILED"] = "AI_REVIEW_REQUEST_FAILED";
+    /** AI 검수 진행 상태가 오래 멈춤 */
+    StoreItemNaverFeedGuardErrorTypeEnum["AI_REVIEW_STALLED"] = "AI_REVIEW_STALLED";
+    /** AI 검수 실패 */
+    StoreItemNaverFeedGuardErrorTypeEnum["AI_REVIEW_FAILED"] = "AI_REVIEW_FAILED";
+})(StoreItemNaverFeedGuardErrorTypeEnum = exports.StoreItemNaverFeedGuardErrorTypeEnum || (exports.StoreItemNaverFeedGuardErrorTypeEnum = {}));
 /** @description 네이버 연동 상품 검수 이미지 OCR 상태 */
 var StoreItemNaverFeedGuardImageOcrStatusEnum;
 (function (StoreItemNaverFeedGuardImageOcrStatusEnum) {