@pisell/pisellos 1.0.59 → 1.0.61

package/dist/modules/Date/index.d.ts

@@ -17,6 +17,23 @@ export declare class DateModule extends BaseModule implements Module, DateModule
     getDateList(): ITime[];
     setDateList(dateList: ITime[]): void;
     fetchResourceDates(params: IGetAvailableTimeListParams): Promise<any>;
+    /**
+     * 将时间向上取整到下一个10分钟整数
+     *
+     * @param time dayjs 时间对象
+     * @returns 向上取整后的时间字符串 (YYYY-MM-DD HH:mm 格式)
+     */
+    private roundUpToNext10Minutes;
+    /**
+     * 校正资源时间段数据
+     *
+     * 如果时间段的 start_at 早于资源的 start_time，将其同步为 start_time 的下一个10分钟整数
+     * 如果修正后 end_at 也早于修正后的 start_time，则删除该时间段
+     *
+     * @param resourcesData 资源数据数组
+     * @returns 校正后的资源数据数组
+     */
+    private correctResourceTimeSlots;
     getResourceAvailableTimeList(params: IGetAvailableTimeListParams): Promise<ITime[]>;
     clearDateRange(): void;
     storeChange(): void;

package/dist/modules/Date/index.js

@@ -1,4 +1,6 @@
 function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
 function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
 function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
@@ -21,6 +23,7 @@ function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.g
 function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import dayjs from 'dayjs';
 import { BaseModule } from "../BaseModule";
 import { disableAllDates, generateMonthDates, handleAvailableDateByResource, handleAvailableDatesByRules } from "./utils";
 import cloneDeep from 'lodash-es/cloneDeep';
@@ -204,22 +207,107 @@ export var DateModule = /*#__PURE__*/function (_BaseModule) {
               });
             case 6:
               res = _context3.sent;
+              // 校正资源时间段数据
+              if (res !== null && res !== void 0 && res.data && Array.isArray(res.data)) {
+                res.data = this.correctResourceTimeSlots(res.data);
+              }
               return _context3.abrupt("return", res);
-            case 10:
-              _context3.prev = 10;
+            case 11:
+              _context3.prev = 11;
               _context3.t0 = _context3["catch"](3);
               console.error(_context3.t0);
-            case 13:
+            case 14:
             case "end":
               return _context3.stop();
           }
-        }, _callee3, this, [[3, 10]]);
+        }, _callee3, this, [[3, 11]]);
       }));
       function fetchResourceDates(_x4) {
         return _fetchResourceDates.apply(this, arguments);
       }
       return fetchResourceDates;
     }()
+    /**
+     * 将时间向上取整到下一个10分钟整数
+     * 
+     * @param time dayjs 时间对象
+     * @returns 向上取整后的时间字符串 (YYYY-MM-DD HH:mm 格式)
+     */
+  }, {
+    key: "roundUpToNext10Minutes",
+    value: function roundUpToNext10Minutes(time) {
+      var minutes = time.minute();
+      var remainder = minutes % 10;
+      if (remainder === 0) {
+        // 如果已经是10分钟的整数，保持不变
+        return time.format('YYYY-MM-DD HH:mm');
+      } else {
+        // 向上取整到下一个10分钟
+        var minutesToAdd = 10 - remainder;
+        var roundedTime = time.add(minutesToAdd, 'minute');
+        return roundedTime.format('YYYY-MM-DD HH:mm');
+      }
+    }
+
+    /**
+     * 校正资源时间段数据
+     * 
+     * 如果时间段的 start_at 早于资源的 start_time，将其同步为 start_time 的下一个10分钟整数
+     * 如果修正后 end_at 也早于修正后的 start_time，则删除该时间段
+     * 
+     * @param resourcesData 资源数据数组
+     * @returns 校正后的资源数据数组
+     */
+  }, {
+    key: "correctResourceTimeSlots",
+    value: function correctResourceTimeSlots(resourcesData) {
+      var _this2 = this;
+      return resourcesData.map(function (resource) {
+        // 检查资源是否有 times 数组和 start_time
+        if (!resource.times || !Array.isArray(resource.times) || !resource.start_time) {
+          return resource;
+        }
+        var resourceStartTime = dayjs(resource.start_time);
+
+        // 过滤和修正时间段
+        var correctedTimes = resource.times.map(function (timeSlot) {
+          if (!timeSlot.start_at || !timeSlot.end_at) {
+            return timeSlot;
+          }
+          var startAt = dayjs(timeSlot.start_at);
+          var endAt = dayjs(timeSlot.end_at);
+
+          // 如果 start_at 早于资源的 start_time，需要修正
+          if (startAt.isBefore(resourceStartTime)) {
+            // 将 start_time 向上取整到下一个10分钟整数
+            var roundedStartTime = _this2.roundUpToNext10Minutes(resourceStartTime);
+            var roundedStartTimeDayjs = dayjs(roundedStartTime);
+            console.log("[DateModule] \u4FEE\u6B63\u65F6\u95F4\u6BB5\u5F00\u59CB\u65F6\u95F4: ".concat(timeSlot.start_at, " -> ").concat(roundedStartTime, " (\u8D44\u6E90ID: ").concat(resource.id, ", \u539F\u59CBstart_time: ").concat(resource.start_time, ")"));
+
+            // 将 start_at 修正为向上取整后的时间
+            var correctedTimeSlot = _objectSpread(_objectSpread({}, timeSlot), {}, {
+              start_at: roundedStartTime
+            });
+
+            // 检查修正后的 end_at 是否也早于修正后的 start_time
+            if (endAt.isBefore(roundedStartTimeDayjs)) {
+              console.log("[DateModule] \u65F6\u95F4\u6BB5\u65E0\u6548\uFF0C\u5C06\u88AB\u5220\u9664: ".concat(timeSlot.start_at, " - ").concat(timeSlot.end_at, " (\u8D44\u6E90ID: ").concat(resource.id, ", \u4FEE\u6B63\u540Estart_time: ").concat(roundedStartTime, ")"));
+              return null; // 标记为删除
+            }
+            return correctedTimeSlot;
+          }
+
+          // 不需要修正的时间段直接返回
+          return timeSlot;
+        }).filter(function (timeSlot) {
+          return timeSlot !== null;
+        }); // 过滤掉被删除的时间段
+
+        return _objectSpread(_objectSpread({}, resource), {}, {
+          times: correctedTimes
+        });
+      });
+    }
   }, {
     key: "getResourceAvailableTimeList",
     value: function () {

package/dist/modules/Order/index.d.ts

@@ -7,8 +7,21 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     protected defaultVersion: string;
     private store;
     private request;
+    private logger;
     constructor(name?: string, version?: string);
     initialize(core: PisellCore, options: ModuleOptions): Promise<void>;
+    /**
+     * 记录信息日志
+     */
+    private logInfo;
+    /**
+     * 记录警告日志
+     */
+    private logWarning;
+    /**
+     * 记录错误日志
+     */
+    private logError;
     createOrder(params: CommitOrderParams['query']): {
         type: "virtual" | "appointment_booking";
         platform: string;

package/dist/modules/Order/index.js

@@ -30,6 +30,8 @@ import dayjs from 'dayjs';
 export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   _inherits(OrderModule, _BaseModule);
   var _super = _createSuper(OrderModule);
+  // LoggerManager 实例
+
   function OrderModule(name, version) {
     var _this;
     _classCallCheck(this, OrderModule);
@@ -38,19 +40,31 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     _defineProperty(_assertThisInitialized(_this), "defaultVersion", '1.0.0');
     _defineProperty(_assertThisInitialized(_this), "store", void 0);
     _defineProperty(_assertThisInitialized(_this), "request", void 0);
+    _defineProperty(_assertThisInitialized(_this), "logger", void 0);
     return _this;
   }
   _createClass(OrderModule, [{
     key: "initialize",
     value: function () {
       var _initialize = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(core, options) {
+        var appPlugin, app;
         return _regeneratorRuntime().wrap(function _callee$(_context) {
           while (1) switch (_context.prev = _context.next) {
             case 0:
               this.core = core;
               this.store = options.store;
               this.request = this.core.getPlugin('request');
-            case 3:
+              appPlugin = this.core.getPlugin('app');
+              if (appPlugin) {
+                _context.next = 6;
+                break;
+              }
+              throw new Error('Order 模块需要 app 插件支持');
+            case 6:
+              app = appPlugin.getApp();
+              this.logger = app.logger;
+              this.logInfo('OrderModule initialized successfully');
+            case 9:
             case "end":
               return _context.stop();
           }
@@ -61,6 +75,50 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
       }
       return initialize;
     }()
+    /**
+     * 记录信息日志
+     */
+  }, {
+    key: "logInfo",
+    value: function logInfo(title, metadata) {
+      if (this.logger) {
+        this.logger.addLog({
+          type: 'info',
+          title: "[OrderModule] ".concat(title),
+          metadata: metadata || {}
+        });
+      }
+    }
+
+    /**
+     * 记录警告日志
+     */
+  }, {
+    key: "logWarning",
+    value: function logWarning(title, metadata) {
+      if (this.logger) {
+        this.logger.addLog({
+          type: 'warning',
+          title: "[OrderModule] ".concat(title),
+          metadata: metadata || {}
+        });
+      }
+    }
+
+    /**
+     * 记录错误日志
+     */
+  }, {
+    key: "logError",
+    value: function logError(title, metadata) {
+      if (this.logger) {
+        this.logger.addLog({
+          type: 'error',
+          title: "[OrderModule] ".concat(title),
+          metadata: metadata || {}
+        });
+      }
+    }
   }, {
     key: "createOrder",
     value: function createOrder(params) {
@@ -120,6 +178,11 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
   }, {
     key: "checkBeforeSubmitOrder",
     value: function checkBeforeSubmitOrder(params) {
+      var _params$cartItems;
+      this.logInfo('checkBeforeSubmitOrder called', {
+        cartItemsCount: ((_params$cartItems = params.cartItems) === null || _params$cartItems === void 0 ? void 0 : _params$cartItems.length) || 0,
+        type: params.type
+      });
       var cartItems = params.cartItems,
         type = params.type;
       if (type === 'holder') {
@@ -137,15 +200,31 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     key: "submitOrder",
     value: function () {
       var _submitOrder = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2(order) {
+        var _order$query$cartItem, _params$bookings, _params$relation_prod;
         var url, query, fetchUrl, params;
         return _regeneratorRuntime().wrap(function _callee2$(_context2) {
           while (1) switch (_context2.prev = _context2.next) {
             case 0:
+              this.logInfo('submitOrder called', {
+                url: order.url,
+                orderType: order.query.type,
+                platform: order.query.platform,
+                cartItemsCount: ((_order$query$cartItem = order.query.cartItems) === null || _order$query$cartItem === void 0 ? void 0 : _order$query$cartItem.length) || 0
+              });
               url = order.url, query = order.query;
               fetchUrl = url || '/order/appointment';
               params = this.createOrder(query);
+              this.logInfo('Calling backend order API', {
+                url: fetchUrl,
+                orderType: params.type,
+                platform: params.platform,
+                isDeposit: params.is_deposit,
+                bookingsCount: ((_params$bookings = params.bookings) === null || _params$bookings === void 0 ? void 0 : _params$bookings.length) || 0,
+                relationProductsCount: ((_params$relation_prod = params.relation_products) === null || _params$relation_prod === void 0 ? void 0 : _params$relation_prod.length) || 0,
+                scheduleDate: params.schedule_date
+              });
               return _context2.abrupt("return", this.request.post(fetchUrl, params));
-            case 4:
+            case 6:
             case "end":
               return _context2.stop();
           }
@@ -170,21 +249,39 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
     key: "createOrderByCheckout",
     value: (function () {
       var _createOrderByCheckout = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee3(params) {
-        var _params$bookings, _params$relation_prod, _params$payments;
-        var _orderData$payments, _orderData$bookings, _orderData$relation_p, _orderData$payments2, _orderData$payments3, _response$data, orderData, response;
+        var _params$bookings2, _params$relation_prod2, _params$payments, _params$payments2, _params$bookings3, _params$relation_prod3, _params$payments3;
+        var _orderData$payments, _orderData$bookings, _orderData$relation_p, _orderData$payments2, _orderData$payments3, _orderData$bookings2, _orderData$relation_p2, _orderData$payments4, _orderData$payments5, _response$data, orderData, response;
         return _regeneratorRuntime().wrap(function _callee3$(_context3) {
           while (1) switch (_context3.prev = _context3.next) {
             case 0:
+              this.logInfo('createOrderByCheckout called', {
+                type: params.type,
+                platform: params.platform,
+                is_deposit: params.is_deposit,
+                customer_id: params.customer_id,
+                bookingsCount: ((_params$bookings2 = params.bookings) === null || _params$bookings2 === void 0 ? void 0 : _params$bookings2.length) || 0,
+                relationProductsCount: ((_params$relation_prod2 = params.relation_products) === null || _params$relation_prod2 === void 0 ? void 0 : _params$relation_prod2.length) || 0,
+                paymentsCount: ((_params$payments = params.payments) === null || _params$payments === void 0 ? void 0 : _params$payments.length) || 0,
+                depositAmount: params.deposit_amount,
+                productTaxFee: params.product_tax_fee,
+                note: params.note,
+                scheduleDate: params.schedule_date,
+                hasOrderId: !!params.order_id,
+                orderIdIncluded: params.order_id,
+                paymentMethods: ((_params$payments2 = params.payments) === null || _params$payments2 === void 0 ? void 0 : _params$payments2.map(function (p) {
+                  return p.code;
+                })) || []
+              });
               console.log('[Order] createOrderByCheckout 开始创建订单:', {
                 type: params.type,
                 platform: params.platform,
                 is_deposit: params.is_deposit,
                 customer_id: params.customer_id,
-                bookingsCount: ((_params$bookings = params.bookings) === null || _params$bookings === void 0 ? void 0 : _params$bookings.length) || 0,
-                relationProductsCount: ((_params$relation_prod = params.relation_products) === null || _params$relation_prod === void 0 ? void 0 : _params$relation_prod.length) || 0,
-                paymentsCount: ((_params$payments = params.payments) === null || _params$payments === void 0 ? void 0 : _params$payments.length) || 0
+                bookingsCount: ((_params$bookings3 = params.bookings) === null || _params$bookings3 === void 0 ? void 0 : _params$bookings3.length) || 0,
+                relationProductsCount: ((_params$relation_prod3 = params.relation_products) === null || _params$relation_prod3 === void 0 ? void 0 : _params$relation_prod3.length) || 0,
+                paymentsCount: ((_params$payments3 = params.payments) === null || _params$payments3 === void 0 ? void 0 : _params$payments3.length) || 0
               });
-              _context3.prev = 1;
+              _context3.prev = 2;
               // 构建订单数据，设置默认值并允许 params 覆盖
               orderData = _objectSpread({
                 sales_channel: 'my_pisel',
@@ -225,26 +322,53 @@ export var OrderModule = /*#__PURE__*/function (_BaseModule) {
                 })) || []
               });
 
+              // 记录接口调用详情
+              this.logInfo('Calling backend checkout API', {
+                url: '/order/checkout',
+                orderType: orderData.type,
+                platform: orderData.platform,
+                isDeposit: orderData.is_deposit,
+                customerId: orderData.customer_id,
+                depositAmount: orderData.deposit_amount,
+                bookingsCount: ((_orderData$bookings2 = orderData.bookings) === null || _orderData$bookings2 === void 0 ? void 0 : _orderData$bookings2.length) || 0,
+                relationProductsCount: ((_orderData$relation_p2 = orderData.relation_products) === null || _orderData$relation_p2 === void 0 ? void 0 : _orderData$relation_p2.length) || 0,
+                paymentsCount: ((_orderData$payments4 = orderData.payments) === null || _orderData$payments4 === void 0 ? void 0 : _orderData$payments4.length) || 0,
+                paymentMethods: ((_orderData$payments5 = orderData.payments) === null || _orderData$payments5 === void 0 ? void 0 : _orderData$payments5.map(function (p) {
+                  return {
+                    code: p.code,
+                    amount: p.amount,
+                    type: p.type,
+                    hasVoucherId: !!p.voucher_id,
+                    orderPaymentType: p.order_payment_type
+                  };
+                })) || [],
+                productTaxFee: orderData.product_tax_fee,
+                note: orderData.note,
+                scheduleDate: orderData.schedule_date,
+                hasOrderId: !!orderData.order_id,
+                smallTicketDataFlag: orderData.small_ticket_data_flag
+              });
+
               // 调用后端接口
-              _context3.next = 9;
+              _context3.next = 11;
               return this.request.post('/order/checkout', orderData);
-            case 9:
+            case 11:
               response = _context3.sent;
               console.log('[Order] 订单创建成功，后端响应:', {
                 success: !!response,
                 hasOrderId: !!(response !== null && response !== void 0 && (_response$data = response.data) !== null && _response$data !== void 0 && _response$data.order_id || response !== null && response !== void 0 && response.order_id)
               });
               return _context3.abrupt("return", response);
-            case 14:
-              _context3.prev = 14;
-              _context3.t0 = _context3["catch"](1);
+            case 16:
+              _context3.prev = 16;
+              _context3.t0 = _context3["catch"](2);
               console.error('[Order] createOrderByCheckout 创建订单失败:', _context3.t0);
               throw _context3.t0;
-            case 18:
+            case 20:
             case "end":
               return _context3.stop();
           }
-        }, _callee3, this, [[1, 14]]);
+        }, _callee3, this, [[2, 16]]);
       }));
       function createOrderByCheckout(_x4) {
         return _createOrderByCheckout.apply(this, arguments);

package/dist/modules/Payment/index.js

@@ -1030,7 +1030,7 @@ export var PaymentModule = /*#__PURE__*/function (_BaseModule) {
     key: "addPaymentItemAsync",
     value: (function () {
       var _addPaymentItemAsync = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee13(orderUuid, paymentItem) {
-        var _newPaymentItem$metad, order, paymentUuid, newPaymentItem;
+        var _newPaymentItem$metad, _newPaymentItem$metad2, _newPaymentItem$metad3, order, paymentUuid, newPaymentItem;
         return _regeneratorRuntime().wrap(function _callee13$(_context13) {
           while (1) switch (_context13.prev = _context13.next) {
             case 0:
@@ -1066,9 +1066,10 @@ export var PaymentModule = /*#__PURE__*/function (_BaseModule) {
                 // 新支付项默认为活跃状态
                 order_payment_type: paymentItem.order_payment_type || 'normal',
                 // 默认为正常支付
-                metadata: {
+                metadata: _objectSpread(_objectSpread({}, paymentItem.metadata), {}, {
+                  // 保留传入的所有 metadata 字段
                   unique_payment_number: paymentUuid // 设置唯一支付号为支付项的 uuid
-                }
+                })
               };
               order.payment.push(newPaymentItem);
               this.recalculateOrderAmount(order);
@@ -1085,7 +1086,14 @@ export var PaymentModule = /*#__PURE__*/function (_BaseModule) {
                 orderUuid: orderUuid,
                 paymentUuid: newPaymentItem.uuid,
                 uniquePaymentNumber: (_newPaymentItem$metad = newPaymentItem.metadata) === null || _newPaymentItem$metad === void 0 ? void 0 : _newPaymentItem$metad.unique_payment_number,
-                newExpectAmount: order.expect_amount
+                newExpectAmount: order.expect_amount,
+                paymentAmount: newPaymentItem.amount,
+                paymentCode: newPaymentItem.code,
+                orderPaymentType: newPaymentItem.order_payment_type,
+                metadataFields: Object.keys(newPaymentItem.metadata || {}),
+                // 现金支付找零信息
+                actualPaidAmount: (_newPaymentItem$metad2 = newPaymentItem.metadata) === null || _newPaymentItem$metad2 === void 0 ? void 0 : _newPaymentItem$metad2.actual_paid_amount,
+                changeGivenAmount: (_newPaymentItem$metad3 = newPaymentItem.metadata) === null || _newPaymentItem$metad3 === void 0 ? void 0 : _newPaymentItem$metad3.change_given_amount
               });
               _context13.next = 23;
               break;

package/dist/modules/Payment/types.d.ts

@@ -111,6 +111,10 @@ export interface PaymentItem {
         unique_payment_number?: string;
         /** rouding规则 */
         rounding_rule?: any;
+        /** 实付金额（现金支付时的实际给出金额） */
+        actual_paid_amount?: number;
+        /** 找零金额（现金支付时的找零金额） */
+        change_given_amount?: number;
     };
     /** rouding金额 */
     rounding_amount?: string;
@@ -230,6 +234,10 @@ export interface PaymentItemInput {
         unique_payment_number?: string;
         /** rounding规则 */
         rounding_rule?: any;
+        /** 实付金额（现金支付时的实际给出金额） */
+        actual_paid_amount?: number;
+        /** 找零金额（现金支付时的找零金额） */
+        change_given_amount?: number;
     };
 }
 /**

package/dist/modules/Payment/walletpass.js

@@ -116,23 +116,22 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
           while (1) switch (_context.prev = _context.next) {
             case 0:
               startTime = Date.now();
-              if (!(Number((businessData === null || businessData === void 0 || (_businessData$amountI = businessData.amountInfo) === null || _businessData$amountI === void 0 ? void 0 : _businessData$amountI.totalAmount) || 0) <= 0 || Number((businessData === null || businessData === void 0 || (_businessData$amountI2 = businessData.amountInfo) === null || _businessData$amountI2 === void 0 ? void 0 : _businessData$amountI2.subTotal) || 0) <= 0)) {
-                _context.next = 3;
+              walletParams = this.generateWalletParams(businessData);
+              if (!(Number((businessData === null || businessData === void 0 || (_businessData$amountI = businessData.amountInfo) === null || _businessData$amountI === void 0 ? void 0 : _businessData$amountI.totalAmount) || 0) < 0 || Number((businessData === null || businessData === void 0 || (_businessData$amountI2 = businessData.amountInfo) === null || _businessData$amountI2 === void 0 ? void 0 : _businessData$amountI2.subTotal) || 0) < 0)) {
+                _context.next = 4;
                 break;
               }
               return _context.abrupt("return", {
                 walletRecommendList: [],
                 userIdentificationCodes: []
               });
-            case 3:
+            case 4:
               // 发送初始化开始事件
               this.emitEvent(WalletPassHooks.OnWalletInitializationStarted, {
                 businessData: businessData,
                 startTime: startTime
               });
-              _context.prev = 4;
-              // 生成钱包API参数
-              walletParams = this.generateWalletParams(businessData); // 调用标准的初始化流程
+              _context.prev = 5;
               _context.next = 8;
               return this.initializeWalletDataAsync(walletParams);
             case 8:
@@ -150,7 +149,7 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
               return _context.abrupt("return", result);
             case 16:
               _context.prev = 16;
-              _context.t0 = _context["catch"](4);
+              _context.t0 = _context["catch"](5);
               _endTime = Date.now();
               _duration = _endTime - startTime; // 发送初始化失败事件
               this.emitEvent(WalletPassHooks.OnWalletInitializationFailed, {
@@ -166,7 +165,7 @@ export var WalletPassPaymentImpl = /*#__PURE__*/function () {
             case "end":
               return _context.stop();
           }
-        }, _callee, this, [[4, 16]]);
+        }, _callee, this, [[5, 16]]);
       }));
       function initializeWalletDataFromBusinessAsync(_x) {
         return _initializeWalletDataFromBusinessAsync.apply(this, arguments);

package/dist/solution/Checkout/index.d.ts

@@ -18,10 +18,23 @@ export declare class CheckoutImpl extends BaseModule implements Module, Checkout
     private request;
     private store;
     private otherParams;
+    private logger;
     order: OrderModule;
     payment: PaymentModule;
     constructor(name?: string, version?: string);
     initialize(core: PisellCore, options: ModuleOptions): Promise<void>;
+    /**
+     * 记录信息日志
+     */
+    private logInfo;
+    /**
+     * 记录警告日志
+     */
+    private logWarning;
+    /**
+     * 记录错误日志
+     */
+    private logError;
     /**
      * 初始化子模块
      */
@@ -366,10 +379,31 @@ export declare class CheckoutImpl extends BaseModule implements Module, Checkout
      * 验证结账参数
      */
     private validateCheckoutParams;
+    /**
+     * 处理现金支付项的找零逻辑
+     *
+     * @param paymentItem 原始支付项
+     * @returns 处理后的支付项（包含找零信息）
+     */
+    private processCashPaymentItem;
+    /**
+     * 判断是否为现金支付
+     *
+     * @param paymentCode 支付代码
+     * @param paymentType 支付类型
+     * @returns 是否为现金支付
+     */
+    private isCashPayment;
     /**
      * 预加载支付方式（在初始化时调用）
      */
     private preloadPaymentMethods;
+    /**
+     * 清理过期的已同步订单数据
+     *
+     * 删除本地 IndexDB 中超过指定天数且已同步到后端的订单数据
+     */
+    private cleanupExpiredOrdersAsync;
     /**
      * 计算已支付金额（从 Payment 模块获取最新数据）
      */