@yolo-croket-dev/entity-v2 0.3.53 → 0.3.54-beta.1

package/index.d.ts

@@ -85,3 +85,4 @@ export * from './store-item-pending-settle';
 export * from './store-pending-settle';
 export * from './admin-settlement-limit';
 export * from './settle-adjustment-plan';
+export * from './notification-campaign';

package/index.js

@@ -99,3 +99,4 @@ __exportStar(require("./store-item-pending-settle"), exports);
 __exportStar(require("./store-pending-settle"), exports);
 __exportStar(require("./admin-settlement-limit"), exports);
 __exportStar(require("./settle-adjustment-plan"), exports);
+__exportStar(require("./notification-campaign"), exports);

package/notification-campaign/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * @author jun
+ * @description 캠페인별 수신자 불변 메시지와 발송 상태
+ * @process 등록 → 원자적 선점 → 푸시 → 결과 저장
+ */
+export interface NotificationCampaignMessage {
+    userId: string;
+    itemId: string;
+    couponCode: string;
+    pushTitle: string;
+    pushBody: string;
+    pushAppLink: string;
+    pushWebLink: string;
+    pushImage: string;
+}
+export type NotificationCampaignStatus = 'ready' | 'sending' | 'accepted' | 'failed' | 'unknown' | 'skipped';
+export interface NotificationCampaignRecipientEntity {
+    _id: string;
+    campaignId: string;
+    snapshotHash: string;
+    messageHash: string;
+    message: NotificationCampaignMessage;
+    startsAt: string;
+    endsAt: string;
+    status: NotificationCampaignStatus;
+    reason: string;
+    providerRequestId?: string;
+    createdAt: Date;
+    updatedAt: Date;
+}

package/notification-campaign/index.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.3.53",
+  "version": "0.3.54-beta.1",
   "main": "index.js",
   "author": "Yolo Co., Ltd.",
   "description": "크로켓 nest 용 entity-v3",
@@ -23,4 +23,4 @@
   },
   "license": "UNLICENSED",
   "dependencies": {}
-}
+}

package/purchased-info/purchased-info.entity.d.ts

@@ -191,12 +191,20 @@ export interface AdditionalPaymentRequestInfo {
     additionalPaymentCalculationGuide: string;
     requestedManagerId: Types.ObjectId | string;
     requestedDate: Date;
+    /** 신규 추가금 요청의 3일 자동 환불 대상 기준 시각. 과거 데이터 호환을 위해 optional이다. */
+    additionalPaymentDueDate?: Date;
+    /** 3일 만료 크론이 Parent 환불을 선점한 시각이다. */
+    additionalPaymentExpiredDate?: Date;
+    /** 추가금 결제가 시작되지 않아 만료된 경우에만 기록한다. */
+    additionalPaymentExpiredReason?: 'NO_ADDITIONAL_PAYMENT';
     /** 현재 유효한 추가금 결제 시도의 PTL. Original 환불 시 이 시도만 무효화한다. */
     activeAdditionalPaymentPayTryLogId?: Types.ObjectId | string;
     /** 여러 init 중 현재 Original을 선점한 결제 시도 토큰. 이전 결제창 callback을 무효화한다. */
     activeAdditionalPaymentAttemptId?: Types.ObjectId | string;
     /** 현재 Additional 결제 시도 토큰을 선점한 시각. 운영 추적 및 장애 복구에 사용한다. */
     activeAdditionalPaymentInitDate?: Date;
+    /** PG 승인/입금 수락과 만료 환불이 동시에 진행되지 않도록 하는 짧은 lease다. */
+    paymentAcceptanceProcessingDate?: Date;
     /** Original 환불로 활성 Additional PTL을 무효화한 시각. */
     activeAdditionalPaymentInvalidatedDate?: Date;
     /**

package/AGENTS.md

@@ -1,50 +0,0 @@
-# ENTITY-V2 KNOWLEDGE BASE
-
-## OVERVIEW
-
-Mongo 영속 모델과 서비스 contract가 공유하는 최신 entity interface 중심 패키지다. 신규 entity의 우선 위치지만 legacy `entity`와 양방향 호환 import가 남아 있어 일괄 분리하지 않는다.
-
-## STRUCTURE
-
-```text
-entity-v2/
-├── index.ts                  # 약 80개 domain public export
-├── <domain>/index.ts
-├── <domain>/*.entity.ts
-└── <domain>.modules/         # 세부 bounded context
-```
-
-대형 호환 surface는 `store-item/store-item.entity.ts`, `purchased-info/purchased-info.entity.ts`; 수정 전 `@deprecated` 필드와 legacy import를 먼저 확인한다.
-
-## WHERE TO LOOK
-
-| 작업 | 위치 | 확인 |
-|---|---|---|
-| 신규 Mongo entity | `<domain>/*.entity.ts` | 실제 schema field/type/nullability |
-| Public export | `<domain>/index.ts`, root `index.ts` | named/type export 호환성 |
-| Legacy 결합 | `packages/entity`, v2의 legacy imports | 양방향 dependency 확대 여부 |
-| 대형 commerce 모델 | `store-item`, `purchased-info`, `refund`, `cart` | deprecated 대체 필드 |
-
-## CONVENTIONS
-
-- 실제 DB 문서를 표현하는 서비스의 Mongoose `@Schema` class는 이 패키지의 대응 interface를 `implements`해야 한다.
-- `_id`, `ObjectId|string`, optional, `null`, array element type을 실제 저장 shape와 정확히 맞춘다.
-- 신규 domain은 local `index.ts`와 root barrel을 함께 갱신하되 기존 namespace/named export를 깨지 않는다.
-- 기존 v2→legacy import는 호환성 경계로 취급한다. 신규 reverse dependency는 소비 영향 근거 없이 추가하지 않는다.
-- 제거 예정 필드는 `@deprecated`와 대체 필드 설명을 유지한다.
-
-## ANTI-PATTERNS
-
-- DTO/response 전용 임시 shape를 영속 entity로 추가하지 않는다.
-- Deprecated 필드를 신규 feature의 정식 모델로 사용하지 않는다.
-- Legacy field를 소비자와 migration 확인 없이 삭제하거나 type을 축소하지 않는다.
-- `dist`, `.d.ts`, 생성 JS를 source 대신 수정하지 않는다.
-
-## VERIFY
-
-```bash
-yarn workspace @yolo-croket-dev/entity-v2 build
-yarn workspace @yolo-croket-dev/entity-v2 lint
-```
-
-Entity 변경은 `entity`, `dto-v2`, AMQP contract와 실제 Mongoose schema 소비 서비스까지 의존 순서대로 검증한다.