@yolo-croket-dev/entity-v2 0.3.65 → 0.3.67

package/CHANGELOG.md

@@ -1,10 +1,16 @@
 # 변경 기록
 
+## 0.3.66 — 네이버 MID 매핑
+
+- 피드에 optional `nvMidUpdatedAt`을 추가합니다.
+- 파일 처리 상태와 시도 entity, 네 업무 필드의 후보 로그 entity를 공개합니다.
+- 소비 순서: entity-v2 → amqp-access → store-item-server → gateway.
+
 ## 0.3.65 — 관리자 개인 즐겨찾기
 
 - `ManagePageFavoriteEntity`의 `path`, `title`을 공개합니다.
 - `ManageUserEntity`에 optional `pageFavorites`, `pageFavoritesRevision`을 추가합니다. 기존 문서는 migration 없이 빈 목록·0 버전으로 읽습니다.
 - 소비 순서: entity-v2 → amqp-access → user-service → gateway → admin-front.
-- 새 컬렉션·인덱스는 추가하지 않습니다. beta 발행 전에는 로컬 tarball로 검증합니다.
+- 새 컬렉션·인덱스는 추가하지 않습니다. 발행 전에는 로컬 tarball로 검증했습니다.
 
 - 정식 0.3.64에 공개된 Buyma 정산 entity 계약을 보존합니다.

package/package.json

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

package/store-item/store-item.entity.d.ts

@@ -602,6 +602,8 @@ export interface StoreItemShippingLeadTimeStatsInfo {
  * @description 상품
  */
 export interface StoreItemEntity {
+    /** Excel 등록을 실제 생성한 실행 ID. 보완 초안이 이미 생성된 상품을 중복 등록하거나 덮어쓰지 못하게 합니다. */
+    bulkRegistrationExecutionId?: string;
     /**
      * 아이디
      * - 검증: true

package/store-item-naver-feed/index.d.ts

@@ -1 +1,3 @@
 export * from './store-item-naver-feed.entity';
+export * from './store-item-naver-feed-mapping-log.entity';
+export * from './store-item-naver-feed-import-log.entity';

package/store-item-naver-feed/index.js

@@ -15,3 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./store-item-naver-feed.entity"), exports);
+__exportStar(require("./store-item-naver-feed-mapping-log.entity"), exports);
+__exportStar(require("./store-item-naver-feed-import-log.entity"), exports);

package/store-item-naver-feed/store-item-naver-feed-import-log.entity.d.ts

@@ -0,0 +1,31 @@
+import { Types } from 'mongoose';
+/**
+ * @author jun
+ * @description 네이버 MID 파일의 처리 시도 상태. 기존 피드 syncStatus와 별도로 관리한다.
+ * @process 시도 시작은 PROCESSING, 반영 완료는 SUCCESS, 처리 실패는 FAILED로 기록한다.
+ */
+export declare enum StoreItemNaverFeedImportStatusEnum {
+    PROCESSING = "PROCESSING",
+    SUCCESS = "SUCCESS",
+    FAILED = "FAILED"
+}
+/**
+ * @author jun
+ * @description 네이버 MID 파일 한 개의 처리 시도 및 집계 결과
+ * @process 같은 sourceFileId의 재시도는 새로운 _id로 기록하고 성공한 파일은 재반영하지 않는다.
+ */
+export interface StoreItemNaverFeedImportLogEntity {
+    _id: Types.ObjectId | string;
+    /** @description 버전과 part를 구분하는 안정적인 파일 식별자. 실제 구성은 기존 업로더와 맞춘다. */
+    sourceFileId: string;
+    status: StoreItemNaverFeedImportStatusEnum;
+    startedAt: Date;
+    completedAt?: Date;
+    totalCount: number;
+    matchedCount: number;
+    unmatchedCount: number;
+    invalidCount: number;
+    /** @description 증분 처리에서는 파일에 없는 상품을 누락으로 판단하지 않으며 0을 기록한다. */
+    staleCount: number;
+    errorMessage?: string;
+}

package/store-item-naver-feed/store-item-naver-feed-import-log.entity.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StoreItemNaverFeedImportStatusEnum = void 0;
+/**
+ * @author jun
+ * @description 네이버 MID 파일의 처리 시도 상태. 기존 피드 syncStatus와 별도로 관리한다.
+ * @process 시도 시작은 PROCESSING, 반영 완료는 SUCCESS, 처리 실패는 FAILED로 기록한다.
+ */
+var StoreItemNaverFeedImportStatusEnum;
+(function (StoreItemNaverFeedImportStatusEnum) {
+    StoreItemNaverFeedImportStatusEnum["PROCESSING"] = "PROCESSING";
+    StoreItemNaverFeedImportStatusEnum["SUCCESS"] = "SUCCESS";
+    StoreItemNaverFeedImportStatusEnum["FAILED"] = "FAILED";
+})(StoreItemNaverFeedImportStatusEnum || (exports.StoreItemNaverFeedImportStatusEnum = StoreItemNaverFeedImportStatusEnum = {}));

package/store-item-naver-feed/store-item-naver-feed-mapping-log.entity.d.ts

@@ -0,0 +1,15 @@
+import { Types } from 'mongoose';
+/**
+ * @author jun
+ * @description 파일 처리 시도에서 확인한 상품별 MID 후보. 현재값은 storeitemnaverfeeds에서 조회한다.
+ * @process 동일 상품의 서로 다른 후보를 보존하고 importLogId로 처리 결과를 연결한다.
+ */
+export interface StoreItemNaverFeedMappingLogEntity {
+    _id: Types.ObjectId | string;
+    itemId: Types.ObjectId | string;
+    /** @description MID가 비어 있는 상품은 null로 기록한다. */
+    nvMid: string | null;
+    /** @description 후보 기록 시각이며 현재 MID의 성공 갱신일과 구분한다. */
+    updatedAt: Date;
+    importLogId: Types.ObjectId | string;
+}

package/store-item-naver-feed/store-item-naver-feed-mapping-log.entity.js

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

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

@@ -38,6 +38,8 @@ export interface StoreItemNaverFeedEntity {
     itemId: Types.ObjectId | string;
     /** @description 네이버 쇼핑 mid */
     nvMid?: string;
+    /** @description 파일 매핑으로 nvMid를 마지막으로 정상 반영한 시각. 기존 데이터는 날짜를 추정하지 않는다. */
+    nvMidUpdatedAt?: Date;
     /** @description 노출 여부 */
     isShow: boolean;
     /** @description 커스텀 상품명 */