@yolo-croket-dev/amqp-access 0.7.401 → 0.7.403

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.7.403 — 관리자 개인 즐겨찾기
+
+- `AmqpManageUserService.getManagePageFavorites`, `updateManagePageFavorites`와 DTO를 공개합니다.
+- RPC: `manage-user.get.page-favorites`, `manage-user.update.page-favorites`. 기존 저트래픽 관리자 설정 RPC를 사용합니다.
+- 목록은 내부 pathname·표시 이름만 보존하며 최대 100개·경로 중복 금지·중첩 DTO·revision을 검증합니다.
+- `entity-v2@0.3.65`에 의존합니다. 기존 공개 API의 입력·응답은 변경하지 않습니다.
+
 ## 0.7.373
 
 - 기존 `SignInGuestUserPayload.phoneNumber`와 `SignInGuestUserResult`의 `access_token`, `refresh_token`, `userId` 계약을 복원한다. 이를 상속하는 비회원 가입 계약도 복원한다.
@@ -15,3 +22,5 @@
 본섭의 기존 로그인 검증 오류 복구는 Gateway의 패키지 업데이트로 진행한다. Gateway가 직접 사용하는 core와 이 패키지의 core 타입이 충돌하는 경우 버전을 함께 맞춰 검증해야 한다.
 
 전화번호만 받는 기존 계약은 전화번호 소유를 검증하지 않는다. OTP 전환, 기존 토큰 차단과 한시적 호환 기간의 종료는 소비 서버에서 별도로 구현해야 한다. 이 패키지 발행은 서버 배포나 인증 우회 문제 전체의 해결을 의미하지 않는다.
+
+- 먼저 발행된 0.7.402의 Buyma 정산 입력 계약을 보존합니다.

package/manage-service/dto/manage-user/command/index.d.ts

@@ -1 +1,3 @@
+/** @author jun @description 관리자 변경 DTO 공개 진입점 */
 export * from './update-p-infos-for-admin-excel-columns.dto';
+export * from './update-manage-page-favorites.dto';

package/manage-service/dto/manage-user/command/index.js

@@ -14,4 +14,6 @@ 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 });
+/** @author jun @description 관리자 변경 DTO 공개 진입점 */
 __exportStar(require("./update-p-infos-for-admin-excel-columns.dto"), exports);
+__exportStar(require("./update-manage-page-favorites.dto"), exports);

package/manage-service/dto/manage-user/command/update-manage-page-favorites.dto.d.ts

@@ -0,0 +1,9 @@
+import { ManagePageFavoriteEntity } from '@yolo-croket-dev/entity-v2/manage-user';
+export declare class ManagePageFavoritePayload implements ManagePageFavoriteEntity {
+    path: string;
+    title: string;
+}
+export declare class UpdateManagePageFavoritesPayload {
+    favorites: ManagePageFavoritePayload[];
+    revision: number;
+}

package/manage-service/dto/manage-user/command/update-manage-page-favorites.dto.js

@@ -0,0 +1,51 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateManagePageFavoritesPayload = exports.ManagePageFavoritePayload = void 0;
+/**
+ * @author jun
+ * @description 관리자 즐겨찾기 저장 입력과 내부 페이지 경로 검증
+ * @process 최대 100개, 중복 경로 금지, 중첩 DTO 검증과 기존 버전을 확인한다.
+ */
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+class ManagePageFavoritePayload {
+}
+exports.ManagePageFavoritePayload = ManagePageFavoritePayload;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(1, 300),
+    (0, class_validator_1.Matches)(/^\/(?!\/)[A-Za-z0-9/_-]*$/),
+    __metadata("design:type", String)
+], ManagePageFavoritePayload.prototype, "path", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(1, 120),
+    (0, class_validator_1.Matches)(/\S/),
+    __metadata("design:type", String)
+], ManagePageFavoritePayload.prototype, "title", void 0);
+class UpdateManagePageFavoritesPayload {
+}
+exports.UpdateManagePageFavoritesPayload = UpdateManagePageFavoritesPayload;
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(100),
+    (0, class_validator_1.ArrayUnique)((favorite) => favorite === null || favorite === void 0 ? void 0 : favorite.path),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => ManagePageFavoritePayload),
+    __metadata("design:type", Array)
+], UpdateManagePageFavoritesPayload.prototype, "favorites", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(Number.MAX_SAFE_INTEGER - 1),
+    __metadata("design:type", Number)
+], UpdateManagePageFavoritesPayload.prototype, "revision", void 0);

package/manage-service/dto/manage-user/query/get-manage-page-favorites.dto.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @author jun
+ * @description 로그인한 관리자의 즐겨찾기 목록과 동시 수정 버전
+ * @process 목록 순서와 마지막 저장 버전을 함께 반환한다.
+ */
+import { ManagePageFavoriteEntity } from '@yolo-croket-dev/entity-v2/manage-user';
+export declare class GetManagePageFavoritesResult {
+    favorites: ManagePageFavoriteEntity[];
+    revision: number;
+}

package/manage-service/dto/manage-user/query/get-manage-page-favorites.dto.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GetManagePageFavoritesResult = void 0;
+class GetManagePageFavoritesResult {
+}
+exports.GetManagePageFavoritesResult = GetManagePageFavoritesResult;

package/manage-service/dto/manage-user/query/index.d.ts

@@ -1,3 +1,5 @@
+/** @author jun @description 관리자 조회 DTO 공개 진입점 */
 export * from './get-manage-user-info-by-id.dto';
+export * from './get-manage-page-favorites.dto';
 export * from './get-manage-user-infos-by-ids.dto';
 export * from './get-p-infos-for-admin-excel-columns.dto';

package/manage-service/dto/manage-user/query/index.js

@@ -14,6 +14,8 @@ 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 });
+/** @author jun @description 관리자 조회 DTO 공개 진입점 */
 __exportStar(require("./get-manage-user-info-by-id.dto"), exports);
+__exportStar(require("./get-manage-page-favorites.dto"), exports);
 __exportStar(require("./get-manage-user-infos-by-ids.dto"), exports);
 __exportStar(require("./get-p-infos-for-admin-excel-columns.dto"), exports);

package/manage-service/services/amqp.manage-user.service.d.ts

@@ -1,10 +1,14 @@
 import { ClientProxy } from '@nestjs/microservices';
 import { AbstractParam } from '@yolo-croket-dev/core';
-import { GetManageUserInfoByIdPayload, GetManageUserInfoByIdResult, GetManageUserInfosByIdsPayload, GetManageUserInfosByIdsResult, GetPInfosForAdminExcelColumnsResult, UpdatePInfosForAdminExcelColumnsPayload } from '../dto/manage-user';
+import { GetManageUserInfoByIdPayload, GetManageUserInfoByIdResult, GetManageUserInfosByIdsPayload, GetManageUserInfosByIdsResult, GetPInfosForAdminExcelColumnsResult, UpdatePInfosForAdminExcelColumnsPayload, GetManagePageFavoritesResult, UpdateManagePageFavoritesPayload } from '../dto/manage-user';
 export declare class AmqpManageUserService {
     private readonly client;
     private readonly amqpManager;
     constructor(client: ClientProxy);
+    /** 로그인 관리자 자신의 즐겨찾기를 조회한다. @param param 인증·추적 정보 @returns 목록과 버전 */
+    getManagePageFavorites(param: AbstractParam): Promise<GetManagePageFavoritesResult>;
+    /** 기존 버전과 일치할 때 목록을 저장한다. @param payload 목록과 버전 @param param 인증·추적 정보 @returns 저장 결과 */
+    updateManagePageFavorites(payload: UpdateManagePageFavoritesPayload, param: AbstractParam): Promise<GetManagePageFavoritesResult>;
     getManageUserInfoById(payload: GetManageUserInfoByIdPayload, param: AbstractParam): Promise<GetManageUserInfoByIdResult>;
     getManageUserInfosByIds(payload: GetManageUserInfosByIdsPayload, param: AbstractParam): Promise<GetManageUserInfosByIdsResult>;
     getPInfosForAdminExcelColumns(param: AbstractParam): Promise<GetPInfosForAdminExcelColumnsResult>;

package/manage-service/services/amqp.manage-user.service.js

@@ -13,6 +13,7 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AmqpManageUserService = void 0;
+/** @author jun @description 관리자 조회·변경 및 개인 즐겨찾기 RPC 클라이언트 */
 const common_1 = require("@nestjs/common");
 const microservices_1 = require("@nestjs/microservices");
 const functions_1 = require("@yolo-croket-dev/core/functions");
@@ -21,6 +22,14 @@ let AmqpManageUserService = class AmqpManageUserService {
         this.client = client;
         this.amqpManager = new functions_1.AmqpManagement(this.client);
     }
+    /** 로그인 관리자 자신의 즐겨찾기를 조회한다. @param param 인증·추적 정보 @returns 목록과 버전 */
+    async getManagePageFavorites(param) {
+        return this.amqpManager.call('관리자 개인 즐겨찾기 조회', 'manage-user.get.page-favorites', undefined, param, { isErrorThrowing: true });
+    }
+    /** 기존 버전과 일치할 때 목록을 저장한다. @param payload 목록과 버전 @param param 인증·추적 정보 @returns 저장 결과 */
+    async updateManagePageFavorites(payload, param) {
+        return this.amqpManager.call('관리자 개인 즐겨찾기 저장', 'manage-user.update.page-favorites', payload, param, { isErrorThrowing: true });
+    }
     async getManageUserInfoById(payload, param) {
         return this.amqpManager.call('유저 정보 조회', 'manage-user.get.manage-user-info-by-id', payload, param, { isErrorThrowing: true });
     }

package/order-server/dto/buyma-order/command/buyma-order.dto.d.ts

@@ -3,6 +3,28 @@ export declare class BuymaMoneyPayload {
     amount: number;
     currency: string;
 }
+/** @description 정산 기록은 손실·차감 금액도 보존한다. 일반 결제 금액의 음수 제한은 유지한다. */
+export declare class BuymaSettlementMoneyPayload {
+    amount: number;
+    currency: string;
+}
+/** @description 지정한 정산 항목만 수정한다. 공란 null은 미확인으로 저장한다. */
+export declare class BuymaSettlementPayload {
+    buymaFee?: BuymaSettlementMoneyPayload | null;
+    sellerSettlementJPY?: BuymaSettlementMoneyPayload | null;
+    productMargin?: BuymaSettlementMoneyPayload | null;
+    shippingFee?: BuymaSettlementMoneyPayload | null;
+    outboundShippingJPY?: BuymaSettlementMoneyPayload | null;
+    shippingMargin?: BuymaSettlementMoneyPayload | null;
+    totalMargin?: BuymaSettlementMoneyPayload | null;
+    appliedExchangeRate?: string | null;
+    exchangeRateUnit?: string | null;
+    feeRateText?: string | null;
+    productMarginRate?: string | null;
+    shippingMarginRate?: string | null;
+    totalMarginRate?: string | null;
+    memo?: string | null;
+}
 export declare class BuymaRecipientPayload {
     name?: string | null;
     phone?: string | null;
@@ -43,6 +65,7 @@ export declare class BuymaInternationalShipmentPayload {
     shippingCost?: BuymaMoneyPayload | null;
 }
 export declare class BuymaManualFieldsPayload {
+    settlement?: BuymaSettlementPayload;
     buyerName?: string | null;
     recipient?: BuymaRecipientPayload;
     productMetadata?: BuymaProductMetadataPayload;

package/order-server/dto/buyma-order/command/buyma-order.dto.js

@@ -9,7 +9,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ReceiveBuymaWebhookPayload = exports.RecordBuymaRefundPayload = exports.ChangeBuymaOrderStatusPayload = exports.ConnectBuymaProcurementPayload = exports.ConfirmBuymaPaymentPayload = exports.UpdateBuymaOrderPayload = exports.BuymaOrderCommandPayload = exports.BuymaManualFieldsPayload = exports.BuymaInternationalShipmentPayload = exports.BuymaProcurementDetailsPayload = exports.BuymaLocalShipmentPayload = exports.BuymaProductMetadataPayload = exports.BuymaRecipientPayload = exports.BuymaMoneyPayload = void 0;
+exports.ReceiveBuymaWebhookPayload = exports.RecordBuymaRefundPayload = exports.ChangeBuymaOrderStatusPayload = exports.ConnectBuymaProcurementPayload = exports.ConfirmBuymaPaymentPayload = exports.UpdateBuymaOrderPayload = exports.BuymaOrderCommandPayload = exports.BuymaManualFieldsPayload = exports.BuymaInternationalShipmentPayload = exports.BuymaProcurementDetailsPayload = exports.BuymaLocalShipmentPayload = exports.BuymaProductMetadataPayload = exports.BuymaRecipientPayload = exports.BuymaSettlementPayload = exports.BuymaSettlementMoneyPayload = exports.BuymaMoneyPayload = void 0;
 /** @author jun @description Buyma 변경 계약. @process 허용 필드·수정 버전·담당자와 선택 입력을 정의한다. */
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
@@ -31,6 +31,112 @@ __decorate([
     (0, class_validator_1.Matches)(/^[A-Z]{3}$/),
     __metadata("design:type", String)
 ], BuymaMoneyPayload.prototype, "currency", void 0);
+/** @description 정산 기록은 손실·차감 금액도 보존한다. 일반 결제 금액의 음수 제한은 유지한다. */
+class BuymaSettlementMoneyPayload {
+}
+exports.BuymaSettlementMoneyPayload = BuymaSettlementMoneyPayload;
+__decorate([
+    (0, class_validator_1.IsNumber)({
+        allowNaN: false,
+        allowInfinity: false,
+    }),
+    (0, class_validator_1.Min)(-Number.MAX_SAFE_INTEGER),
+    (0, class_validator_1.Max)(Number.MAX_SAFE_INTEGER),
+    __metadata("design:type", Number)
+], BuymaSettlementMoneyPayload.prototype, "amount", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(/^[A-Z]{3}$/),
+    __metadata("design:type", String)
+], BuymaSettlementMoneyPayload.prototype, "currency", void 0);
+/** @description 지정한 정산 항목만 수정한다. 공란 null은 미확인으로 저장한다. */
+class BuymaSettlementPayload {
+}
+exports.BuymaSettlementPayload = BuymaSettlementPayload;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => BuymaSettlementMoneyPayload),
+    __metadata("design:type", Object)
+], BuymaSettlementPayload.prototype, "buymaFee", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => BuymaSettlementMoneyPayload),
+    __metadata("design:type", Object)
+], BuymaSettlementPayload.prototype, "sellerSettlementJPY", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => BuymaSettlementMoneyPayload),
+    __metadata("design:type", Object)
+], BuymaSettlementPayload.prototype, "productMargin", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => BuymaSettlementMoneyPayload),
+    __metadata("design:type", Object)
+], BuymaSettlementPayload.prototype, "shippingFee", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => BuymaSettlementMoneyPayload),
+    __metadata("design:type", Object)
+], BuymaSettlementPayload.prototype, "outboundShippingJPY", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => BuymaSettlementMoneyPayload),
+    __metadata("design:type", Object)
+], BuymaSettlementPayload.prototype, "shippingMargin", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => BuymaSettlementMoneyPayload),
+    __metadata("design:type", Object)
+], BuymaSettlementPayload.prototype, "totalMargin", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(100),
+    __metadata("design:type", Object)
+], BuymaSettlementPayload.prototype, "appliedExchangeRate", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(100),
+    __metadata("design:type", Object)
+], BuymaSettlementPayload.prototype, "exchangeRateUnit", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(100),
+    __metadata("design:type", Object)
+], BuymaSettlementPayload.prototype, "feeRateText", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(100),
+    __metadata("design:type", Object)
+], BuymaSettlementPayload.prototype, "productMarginRate", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(100),
+    __metadata("design:type", Object)
+], BuymaSettlementPayload.prototype, "shippingMarginRate", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(100),
+    __metadata("design:type", Object)
+], BuymaSettlementPayload.prototype, "totalMarginRate", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(10000),
+    __metadata("design:type", Object)
+], BuymaSettlementPayload.prototype, "memo", void 0);
 class BuymaRecipientPayload {
 }
 exports.BuymaRecipientPayload = BuymaRecipientPayload;
@@ -222,6 +328,12 @@ __decorate([
 class BuymaManualFieldsPayload {
 }
 exports.BuymaManualFieldsPayload = BuymaManualFieldsPayload;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => BuymaSettlementPayload),
+    __metadata("design:type", BuymaSettlementPayload)
+], BuymaManualFieldsPayload.prototype, "settlement", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yolo-croket-dev/amqp-access",
-  "version": "0.7.401",
+  "version": "0.7.403",
   "main": "index.js",
   "author": "Yolo Co., Ltd.",
   "description": "크로켓 amqp-access npm",
@@ -24,7 +24,7 @@
     "@yolo-croket-dev/domain": "0.2.50",
     "@yolo-croket-dev/dto-v2": "0.2.37",
     "@yolo-croket-dev/entity": "0.2.110",
-    "@yolo-croket-dev/entity-v2": "0.3.63",
+    "@yolo-croket-dev/entity-v2": "0.3.65",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.13.2",
     "dotenv": "^16.3.1"