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

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,46 @@
+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 검수 오류 요약 */
+export interface NaverPolicyAiReviewErrorSummary {
+    /** @description 오류를 분류하기 위한 코드 */
+    code: string;
+    /** @description 운영자 또는 개발자가 확인할 오류 메시지 */
+    message: string;
+    /** @description 오류가 발생한 시각 */
+    occurredAt: Date;
+}

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,4 @@
+export * from './common.entity';
+export * from './enum';
+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,20 @@
+"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-log.entity"), exports);
+__exportStar(require("./naver-policy-ai-review-result.entity"), exports);

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

@@ -0,0 +1,71 @@
+import { Types } from 'mongoose';
+import { NaverPolicyAiReviewCandidate, NaverPolicyAiReviewCandidateResult, NaverPolicyAiReviewErrorSummary } 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[];
+}
+/**
+ * @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,61 @@
+import { Types } from 'mongoose';
+import { NaverPolicyAiReviewCandidate, NaverPolicyAiReviewCandidateResult, NaverPolicyAiReviewErrorSummary } 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 최종 판정에 연결된 사유 코드 목록 */
+    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.5",
+  "version": "0.2.141-jun.7",
   "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

@@ -39,6 +39,10 @@ export declare enum StoreItemNaverFeedGuardErrorTypeEnum {
     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"
 }

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

@@ -44,6 +44,10 @@ var StoreItemNaverFeedGuardErrorTypeEnum;
     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 = {}));