@pisell/pisellos 2.2.93 → 2.2.95

package/dist/server/modules/order/utils/filterBookings.js

@@ -0,0 +1,350 @@
+var _excluded = ["bookings"],
+  _excluded2 = ["bookings"],
+  _excluded3 = ["bookings"];
+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 _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
+function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
+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 _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); }
+/** 预约状态：协议 appointment_status 优先，兼容历史 status */
+function getBookingAppointmentStatus(booking) {
+  var _ref, _booking$appointment_;
+  return String((_ref = (_booking$appointment_ = booking.appointment_status) !== null && _booking$appointment_ !== void 0 ? _booking$appointment_ : booking.status) !== null && _ref !== void 0 ? _ref : '');
+}
+
+// ─────────────────────────────────────────────────────────────────
+// 时间戳 / 范围解析
+// ─────────────────────────────────────────────────────────────────
+
+function toTimestamp(value) {
+  if (value === undefined || value === null || value === '') return 0;
+  if (typeof value === 'number') return value;
+  return new Date(value).getTime();
+}
+
+/**
+ * 将 start_date / start_time（或 end_*）拼成可被 Date 稳定解析的字符串。
+ * 时间字段协议为 H:i（如 15:00）时补全为 H:i:00，避免部分环境对「无秒」非 ISO 串（空格分隔）解析不一致。
+ */
+function bookingDateTimeString(datePart, timePart) {
+  var d = (datePart !== null && datePart !== void 0 ? datePart : '').trim();
+  var t = (timePart !== null && timePart !== void 0 ? timePart : '').trim();
+  if (t && /^\d{1,2}:\d{2}$/.test(t)) {
+    t = "".concat(t, ":00");
+  }
+  return "".concat(d, " ").concat(t).trim();
+}
+function parseDateRange(range) {
+  if (!Array.isArray(range) || range.length < 2) return null;
+  var start = toTimestamp(range[0]);
+  var end = toTimestamp(range[1]);
+  if (!start && !end) return null;
+  return [start, end];
+}
+function parseNumberRange(range) {
+  if (!Array.isArray(range) || range.length < 2) return null;
+  var min = Number(range[0]);
+  var max = Number(range[1]);
+  if (isNaN(min) || isNaN(max)) return null;
+  return [min, max];
+}
+
+// ─────────────────────────────────────────────────────────────────
+// 预编译过滤上下文：将 filters 一次性解析为高效的 Set / Range，
+// 供 matchOrder、matchBooking 复用，避免重复计算
+// ─────────────────────────────────────────────────────────────────
+
+function prepareFilters(f) {
+  var _f$order_payment_stat, _f$order_status, _f$order_sales_channe, _f$payment_method, _f$appointment_status, _f$form_record_ids;
+  var hasCustomerId = f.customer_id !== undefined && f.customer_id !== null;
+  return {
+    orderPaymentStatusSet: (_f$order_payment_stat = f.order_payment_status) !== null && _f$order_payment_stat !== void 0 && _f$order_payment_stat.length ? new Set(f.order_payment_status) : null,
+    orderStatusSet: (_f$order_status = f.order_status) !== null && _f$order_status !== void 0 && _f$order_status.length ? new Set(f.order_status) : null,
+    orderSalesChannelSet: (_f$order_sales_channe = f.order_sales_channel) !== null && _f$order_sales_channe !== void 0 && _f$order_sales_channe.length ? new Set(f.order_sales_channel) : null,
+    paymentMethodSet: (_f$payment_method = f.payment_method) !== null && _f$payment_method !== void 0 && _f$payment_method.length ? new Set(f.payment_method) : null,
+    appointmentStatusSet: (_f$appointment_status = f.appointment_status) !== null && _f$appointment_status !== void 0 && _f$appointment_status.length ? new Set(f.appointment_status) : null,
+    formRecordIdSet: (_f$form_record_ids = f.form_record_ids) !== null && _f$form_record_ids !== void 0 && _f$form_record_ids.length ? new Set(f.form_record_ids) : null,
+    hasCustomerId: hasCustomerId,
+    customerIdStr: hasCustomerId ? String(f.customer_id) : '',
+    hasBusinessCode: !!f.business_code,
+    businessCode: f.business_code,
+    bookingTimeRange: parseDateRange(f.sales_time_between),
+    createdAtRange: parseDateRange(f.created_at_between),
+    updatedAtRange: parseDateRange(f.updated_at_between),
+    numberRange: parseNumberRange(f.number_between),
+    totalAmountRange: Array.isArray(f.total_amount_between) && f.total_amount_between.length === 2 ? f.total_amount_between : null,
+    keywordLower: f.keyword ? f.keyword.toLowerCase() : '',
+    afterExecutionTimeMs: function () {
+      var raw = f.after_execution_time;
+      if (raw === undefined || raw === null || raw === '') return null;
+      var ms = toTimestamp(raw);
+      return Number.isFinite(ms) ? ms : null;
+    }(),
+    enableChildBookingFilter: f.child_booking === 1
+  };
+}
+
+// ─────────────────────────────────────────────────────────────────
+// 订单级匹配：不通过则整个 order 下所有 bookings 跳过
+// ─────────────────────────────────────────────────────────────────
+
+function matchOrder(order, ctx) {
+  if (ctx.hasBusinessCode && order.business_code !== ctx.businessCode) return false;
+  if (ctx.hasCustomerId && String(order.customer_id) !== ctx.customerIdStr) return false;
+  if (ctx.orderPaymentStatusSet && !ctx.orderPaymentStatusSet.has(order.payment_status)) return false;
+  if (ctx.orderStatusSet && !ctx.orderStatusSet.has(order.status)) return false;
+  if (ctx.orderSalesChannelSet && !ctx.orderSalesChannelSet.has(order.order_sales_channel)) return false;
+  if (ctx.paymentMethodSet) {
+    var pm = order.payments;
+    if (!Array.isArray(pm) || pm.length === 0) return false;
+    var matched = false;
+    for (var k = 0; k < pm.length; k++) {
+      if (ctx.paymentMethodSet.has(pm[k].code)) {
+        matched = true;
+        break;
+      }
+    }
+    if (!matched) return false;
+  }
+  if (ctx.createdAtRange) {
+    var ts = toTimestamp(order.created_at);
+    if (ts < ctx.createdAtRange[0] || ts > ctx.createdAtRange[1]) return false;
+  }
+  if (ctx.updatedAtRange) {
+    var _ts = toTimestamp(order.updated_at);
+    if (_ts < ctx.updatedAtRange[0] || _ts > ctx.updatedAtRange[1]) return false;
+  }
+  if (ctx.totalAmountRange) {
+    var _order$summary$total_, _order$summary;
+    var raw = (_order$summary$total_ = (_order$summary = order.summary) === null || _order$summary === void 0 ? void 0 : _order$summary.total_amount) !== null && _order$summary$total_ !== void 0 ? _order$summary$total_ : order.total_amount;
+    var amt = Number(raw);
+    if (isNaN(amt)) return false;
+    if (ctx.totalAmountRange[0] != null && amt < ctx.totalAmountRange[0]) return false;
+    if (ctx.totalAmountRange[1] != null && amt > ctx.totalAmountRange[1]) return false;
+  }
+  return true;
+}
+
+// ─────────────────────────────────────────────────────────────────
+// Booking 级匹配：在订单通过之后逐条检查每个 booking
+// orderInfo 用于 keyword 搜索时的 JSON 序列化
+// ─────────────────────────────────────────────────────────────────
+
+function matchBooking(booking, orderInfo, ctx) {
+  if (ctx.enableChildBookingFilter) {
+    var _parent_id, _item_type;
+    var parentId = Number((_parent_id = booking.parent_id) !== null && _parent_id !== void 0 ? _parent_id : 0);
+    var itemType = String((_item_type = booking.item_type) !== null && _item_type !== void 0 ? _item_type : '');
+    var isMatched = parentId !== 0 && itemType !== 'recurring_booking' || parentId === 0 && itemType === 'recurring_booking';
+    if (!isMatched) return false;
+  }
+  if (ctx.appointmentStatusSet && !ctx.appointmentStatusSet.has(getBookingAppointmentStatus(booking))) return false;
+  if (ctx.bookingTimeRange) {
+    var ts = toTimestamp(booking.start_date);
+    if (ts < ctx.bookingTimeRange[0] || ts > ctx.bookingTimeRange[1]) return false;
+  }
+  if (ctx.afterExecutionTimeMs != null) {
+    var bookingStartMs = toTimestamp(bookingDateTimeString(booking.start_date, booking.start_time));
+    if (!Number.isFinite(bookingStartMs) || bookingStartMs < ctx.afterExecutionTimeMs) return false;
+  }
+  if (ctx.numberRange) {
+    var num = Number(booking.number);
+    if (isNaN(num) || num < ctx.numberRange[0] || num > ctx.numberRange[1]) return false;
+  }
+  if (ctx.formRecordIdSet) {
+    var formMatched = false;
+    var resources = booking.resources;
+    if (Array.isArray(resources)) {
+      for (var r = 0; r < resources.length; r++) {
+        if (resources[r].relation_type === 'form' && ctx.formRecordIdSet.has(resources[r].relation_id)) {
+          formMatched = true;
+          break;
+        }
+      }
+    }
+    if (!formMatched && booking.relation_type === 'form' && booking.relation_id && booking.relation_id > 0) {
+      formMatched = ctx.formRecordIdSet.has(booking.relation_id);
+    }
+    if (!formMatched) return false;
+  }
+  if (ctx.keywordLower) {
+    var target = orderInfo ? _objectSpread(_objectSpread({}, booking), {}, {
+      order: orderInfo
+    }) : booking;
+    var str = JSON.stringify(target).toLowerCase();
+    if (!str.includes(ctx.keywordLower)) return false;
+  }
+  return true;
+}
+
+// ─────────────────────────────────────────────────────────────────
+// 转换：OrderData[] → BookingData[]（独立导出，供其他场景使用）
+// ─────────────────────────────────────────────────────────────────
+
+export function flattenOrdersToBookings(orders) {
+  if (!orders || !Array.isArray(orders)) return [];
+  var result = [];
+  for (var i = 0, len = orders.length; i < len; i++) {
+    var order = orders[i];
+    var bookings = order.bookings;
+    if (!Array.isArray(bookings) || bookings.length === 0) continue;
+    var _omit = order.bookings,
+      orderInfo = _objectWithoutProperties(order, _excluded);
+    for (var j = 0, bLen = bookings.length; j < bLen; j++) {
+      result.push(_objectSpread(_objectSpread({}, bookings[j]), {}, {
+        order: orderInfo
+      }));
+    }
+  }
+  return result;
+}
+
+// ─────────────────────────────────────────────────────────────────
+// 核心：单遍扫描 — 展开 + 过滤 + 分页
+//
+// 性能策略：
+//  1. 订单级条件在外层循环 matchOrder 预判，不匹配则整组 bookings 跳过
+//  2. orderInfo 延迟到有命中 booking 时才创建，同一 order 只创建一次
+//  3. 只对最终命中的 booking 做 object spread
+// ─────────────────────────────────────────────────────────────────
+
+export function filterBookingsFromOrders(orders, filters) {
+  var f = filters || {};
+  if (!orders || !Array.isArray(orders)) {
+    return {
+      list: [],
+      count: 0,
+      size: 0,
+      skip: 0
+    };
+  }
+  var size = f.num || 20;
+  var page = f.skip || 1;
+  var startIndex = (page - 1) * size;
+  var ctx = prepareFilters(f);
+  var totalCount = 0;
+  var paginatedList = [];
+  for (var i = 0, oLen = orders.length; i < oLen; i++) {
+    var order = orders[i];
+    var bookings = order.bookings;
+    if (!Array.isArray(bookings) || bookings.length === 0) continue;
+
+    // 订单级预过滤
+    if (!matchOrder(order, ctx)) continue;
+
+    // 订单通过，遍历其 bookings；orderInfo 延迟创建
+    var orderInfo = null;
+    for (var j = 0, bLen = bookings.length; j < bLen; j++) {
+      var booking = bookings[j];
+
+      // keyword 匹配需要 orderInfo，提前创建
+      if (ctx.keywordLower && !orderInfo) {
+        var _omit = order.bookings,
+          rest = _objectWithoutProperties(order, _excluded2);
+        orderInfo = rest;
+      }
+      if (!matchBooking(booking, orderInfo, ctx)) continue;
+
+      // 命中：收集到分页窗口内
+      if (totalCount >= startIndex && paginatedList.length < size) {
+        if (!orderInfo) {
+          var _omit2 = order.bookings,
+            _rest = _objectWithoutProperties(order, _excluded3);
+          orderInfo = _rest;
+        }
+        paginatedList.push(_objectSpread(_objectSpread({}, booking), {}, {
+          order: orderInfo
+        }));
+      }
+      totalCount++;
+    }
+  }
+  return {
+    list: paginatedList,
+    count: totalCount,
+    size: size,
+    skip: page
+  };
+}
+
+// ─────────────────────────────────────────────────────────────────
+// 排序预约列表
+// order_by 格式："field:direction"，如 "start_at:desc"
+// 不带方向后缀则不排序
+// ─────────────────────────────────────────────────────────────────
+
+export function sortBookings(result, filters) {
+  var f = filters || {};
+  var orderBy = f.order_by;
+  if (!orderBy) return result;
+  var separatorIdx = orderBy.lastIndexOf(':');
+  if (separatorIdx === -1) return result;
+  var field = orderBy.slice(0, separatorIdx);
+  var direction = orderBy.slice(separatorIdx + 1);
+  if (direction !== 'asc' && direction !== 'desc') return result;
+  var multiplier = direction === 'asc' ? 1 : -1;
+  var getTimestamp = function getTimestamp(booking) {
+    switch (field) {
+      case 'start_at':
+        return toTimestamp(bookingDateTimeString(booking.start_date, booking.start_time));
+      case 'end_at':
+        return toTimestamp(bookingDateTimeString(booking.end_date, booking.end_time));
+      case 'created_at':
+        return toTimestamp(booking.order.created_at);
+      case 'updated_at':
+        return toTimestamp(booking.order.updated_at);
+      default:
+        return 0;
+    }
+  };
+  var sorted = result.list.slice().sort(function (a, b) {
+    return (getTimestamp(a) - getTimestamp(b)) * multiplier;
+  });
+  return _objectSpread(_objectSpread({}, result), {}, {
+    list: sorted
+  });
+}
+
+// ─────────────────────────────────────────────────────────────────
+// 兼容独立调用：对已展开的 BookingData[] 做筛选
+// 复用 matchOrder + matchBooking，仅负责迭代与分页
+// ─────────────────────────────────────────────────────────────────
+
+export function filterBookings(bookings, filters) {
+  var f = filters || {};
+  if (!bookings || !Array.isArray(bookings)) {
+    return {
+      list: [],
+      count: 0,
+      size: 0,
+      skip: 0
+    };
+  }
+  var size = f.num || 20;
+  var page = f.skip || 1;
+  var startIndex = (page - 1) * size;
+  var ctx = prepareFilters(f);
+  var totalCount = 0;
+  var paginatedList = [];
+  for (var i = 0, len = bookings.length; i < len; i++) {
+    var booking = bookings[i];
+    var order = booking.order;
+
+    // 订单级 + booking 级统一匹配
+    if (!matchOrder(order, ctx)) continue;
+    if (!matchBooking(booking, order, ctx)) continue;
+    if (totalCount >= startIndex && paginatedList.length < size) {
+      paginatedList.push(booking);
+    }
+    totalCount++;
+  }
+  return {
+    list: paginatedList,
+    count: totalCount,
+    size: size,
+    skip: page
+  };
+}

package/dist/server/modules/order/utils/filterOrders.d.ts

@@ -0,0 +1,15 @@
+import type { OrderData, OrderFilters, OrderFilterResult } from '../types';
+export type { OrderFilters, OrderFilterResult } from '../types';
+/**
+ * 订单过滤函数
+ * @param orders 原始订单列表
+ * @param filters 过滤条件
+ * @returns 过滤 + 排序 + 分页后的结果
+ *
+ * @优化口子 性能优化预留：
+ * - 可在此函数入口加缓存（按 filters 签名缓存结果）
+ * - 可对枚举字段建倒排索引（status/payment_status/shipping_status/customer_id）
+ * - 可对文本字段加前缀树或分词索引
+ * - 可做增量过滤而非全量遍历
+ */
+export declare function filterOrders(orders: OrderData[], filters: OrderFilters): OrderFilterResult;

package/dist/server/modules/order/utils/filterOrders.js

@@ -0,0 +1,226 @@
+/**
+ * 订单过滤函数
+ * @param orders 原始订单列表
+ * @param filters 过滤条件
+ * @returns 过滤 + 排序 + 分页后的结果
+ *
+ * @优化口子 性能优化预留：
+ * - 可在此函数入口加缓存（按 filters 签名缓存结果）
+ * - 可对枚举字段建倒排索引（status/payment_status/shipping_status/customer_id）
+ * - 可对文本字段加前缀树或分词索引
+ * - 可做增量过滤而非全量遍历
+ */
+export function filterOrders(orders, filters) {
+  // Bug 1 修复：防护 filters 为 null/undefined
+  var safeFilters = filters || {};
+  if (!orders || !Array.isArray(orders)) {
+    return {
+      list: [],
+      count: 0,
+      size: 0,
+      skip: 0
+    };
+  }
+
+  // 默认分页参数
+  var size = safeFilters.num || 20;
+  var page = safeFilters.skip || 1;
+
+  // 1. 过滤
+  var filteredList = orders.filter(function (order) {
+    // status - 订单状态
+    if (safeFilters.status && safeFilters.status.length > 0) {
+      if (!order.status || !safeFilters.status.includes(order.status)) {
+        return false;
+      }
+    }
+
+    // payment_status - 支付状态
+    if (safeFilters.payment_status && safeFilters.payment_status.length > 0) {
+      if (!order.payment_status || !safeFilters.payment_status.includes(order.payment_status)) {
+        return false;
+      }
+    }
+
+    // shipping_status - 处理状态
+    if (safeFilters.shipping_status && safeFilters.shipping_status.length > 0) {
+      if (!order.shipping_status || !safeFilters.shipping_status.includes(order.shipping_status)) {
+        return false;
+      }
+    }
+
+    // customer_id - 客户ID（精确匹配）
+    if (safeFilters.customer_id !== undefined && safeFilters.customer_id !== null) {
+      if (String(order.customer_id) !== String(safeFilters.customer_id)) {
+        return false;
+      }
+    }
+
+    // order_sales_channel - 销售渠道
+    if (safeFilters.order_sales_channel && safeFilters.order_sales_channel.length > 0) {
+      if (!order.order_sales_channel || !safeFilters.order_sales_channel.includes(order.order_sales_channel)) {
+        return false;
+      }
+    }
+
+    // payment_methods - 支付方式
+    if (safeFilters.payment_methods && safeFilters.payment_methods.length > 0) {
+      if (!order.payment_methods || !Array.isArray(order.payment_methods) || order.payment_methods.length === 0) {
+        return false;
+      }
+      var hasMatch = order.payment_methods.some(function (pm) {
+        return safeFilters.payment_methods.includes(pm);
+      });
+      if (!hasMatch) {
+        return false;
+      }
+    }
+
+    // min_total_amount / max_total_amount - 订单金额范围
+    if (safeFilters.min_total_amount !== undefined || safeFilters.max_total_amount !== undefined) {
+      var orderAmount = parseFloat(String(order.total_amount || 0));
+      if (safeFilters.min_total_amount !== undefined && orderAmount < safeFilters.min_total_amount) {
+        return false;
+      }
+      if (safeFilters.max_total_amount !== undefined && orderAmount > safeFilters.max_total_amount) {
+        return false;
+      }
+    }
+
+    // tag_ids - 标签（统一 String 比较，兼容 number/string）
+    if (safeFilters.tag_ids && safeFilters.tag_ids.length > 0) {
+      if (!order.tag_ids || !Array.isArray(order.tag_ids) || order.tag_ids.length === 0) {
+        return false;
+      }
+      var filterTagSet = new Set(safeFilters.tag_ids.map(String));
+      var _hasMatch = order.tag_ids.some(function (tag) {
+        return filterTagSet.has(String(tag));
+      });
+      if (!_hasMatch) {
+        return false;
+      }
+    }
+
+    // shipping_type - 配送方式
+    if (safeFilters.shipping_type && safeFilters.shipping_type.length > 0) {
+      if (!order.shipping_type || !safeFilters.shipping_type.includes(order.shipping_type)) {
+        return false;
+      }
+    }
+
+    // delivery_zone_name - 配送区域（模糊匹配）
+    if (safeFilters.delivery_zone_name !== undefined && safeFilters.delivery_zone_name !== null && safeFilters.delivery_zone_name !== '') {
+      if (!order.delivery_zone_name || !order.delivery_zone_name.toLowerCase().includes(safeFilters.delivery_zone_name.toLowerCase())) {
+        return false;
+      }
+    }
+
+    // location_id - 取货地点（精确匹配）
+    if (safeFilters.location_id !== undefined && safeFilters.location_id !== null) {
+      if (String(order.location_id) !== String(safeFilters.location_id)) {
+        return false;
+      }
+    }
+
+    // shipping_order_number - 物流单号（模糊匹配）
+    if (safeFilters.shipping_order_number !== undefined && safeFilters.shipping_order_number !== null && safeFilters.shipping_order_number !== '') {
+      if (!order.shipping_order_number || !order.shipping_order_number.toLowerCase().includes(safeFilters.shipping_order_number.toLowerCase())) {
+        return false;
+      }
+    }
+
+    // logistics_company_id - 物流公司
+    if (safeFilters.logistics_company_id && safeFilters.logistics_company_id.length > 0) {
+      if (!order.logistics_company_id) {
+        return false;
+      }
+      var orderLogisticsId = String(order.logistics_company_id);
+      var _hasMatch2 = safeFilters.logistics_company_id.some(function (id) {
+        return String(id) === orderLogisticsId;
+      });
+      if (!_hasMatch2) {
+        return false;
+      }
+    }
+
+    // zip - 邮编（模糊匹配）
+    if (safeFilters.zip !== undefined && safeFilters.zip !== null && safeFilters.zip !== '') {
+      if (!order.zip || !order.zip.toLowerCase().includes(safeFilters.zip.toLowerCase())) {
+        return false;
+      }
+    }
+
+    // business_code - 业务类型（精确匹配）
+    if (safeFilters.business_code) {
+      if (!order.business_code || order.business_code !== safeFilters.business_code) {
+        return false;
+      }
+    }
+
+    // start_time / end_time - 创建时间范围
+    if (safeFilters.start_time || safeFilters.end_time) {
+      var orderTime = order.created_at ? typeof order.created_at === 'number' ? order.created_at : new Date(String(order.created_at)).getTime() : 0;
+      if (safeFilters.start_time) {
+        var startTs = new Date(safeFilters.start_time).getTime();
+        if (orderTime < startTs) return false;
+      }
+      if (safeFilters.end_time) {
+        // end_time 为当天结束（23:59:59.999）
+        var endTs = new Date(safeFilters.end_time).getTime() + 86400000 - 1;
+        if (orderTime > endTs) return false;
+      }
+    }
+    return true;
+  });
+
+  // 2. 排序
+  if (safeFilters.order_by) {
+    var sortField = safeFilters.order_by;
+    var sortOrder = safeFilters.sort || 'desc';
+    filteredList.sort(function (a, b) {
+      var aVal;
+      var bVal;
+      switch (sortField) {
+        case 'created_at':
+          aVal = a.created_at ? typeof a.created_at === 'number' ? a.created_at : new Date(String(a.created_at)).getTime() : 0;
+          bVal = b.created_at ? typeof b.created_at === 'number' ? b.created_at : new Date(String(b.created_at)).getTime() : 0;
+          break;
+        case 'updated_at':
+          aVal = a.updated_at ? typeof a.updated_at === 'number' ? a.updated_at : new Date(String(a.updated_at)).getTime() : 0;
+          bVal = b.updated_at ? typeof b.updated_at === 'number' ? b.updated_at : new Date(String(b.updated_at)).getTime() : 0;
+          break;
+        case 'total_amount':
+          aVal = parseFloat(String(a.total_amount || 0));
+          bVal = parseFloat(String(b.total_amount || 0));
+          break;
+        case 'customer_name':
+          aVal = (a.customer_name || '').toLowerCase();
+          bVal = (b.customer_name || '').toLowerCase();
+          break;
+        case 'amount_gap':
+          return 0;
+        default:
+          return 0;
+      }
+      if (aVal < bVal) {
+        return sortOrder === 'asc' ? -1 : 1;
+      }
+      if (aVal > bVal) {
+        return sortOrder === 'asc' ? 1 : -1;
+      }
+      return 0;
+    });
+  }
+
+  // 3. 分页（skip 为页码，从 1 开始）
+  var totalCount = filteredList.length;
+  var startIndex = (page - 1) * size;
+  var endIndex = startIndex + size;
+  var paginatedList = filteredList.slice(startIndex, endIndex);
+  return {
+    list: paginatedList,
+    count: totalCount,
+    size: size,
+    skip: page
+  };
+}

package/dist/server/modules/resource/index.d.ts

@@ -0,0 +1,88 @@
+import { Module, ModuleOptions, PisellCore } from '../../../types';
+import { BaseModule } from '../../../modules/BaseModule';
+import { type ResourceBooking, type ResourceData, type ResourceId, type QueryOptions } from './types';
+/**
+ * Resource 模块
+ */
+export declare class ResourceModule extends BaseModule implements Module {
+    protected defaultName: string;
+    protected defaultVersion: string;
+    private store;
+    private dbManager;
+    private logger;
+    private resourceDataSource;
+    /** 倒排索引: resourceId -> ResourceBooking[] */
+    private resourceIdIndex;
+    /** 待处理的同步消息队列 */
+    private pendingSyncMessages;
+    private syncTimer?;
+    constructor(name?: string, version?: string);
+    initialize(core: PisellCore, options?: ModuleOptions): Promise<void>;
+    private logInfo;
+    private logError;
+    preload(): Promise<void>;
+    getRoutes(): never[];
+    destroy(): void;
+    /**
+     * 获取所有资源（支持 includeBookings 附加预订信息）
+     */
+    getResources(queryOptions?: QueryOptions): ResourceData[];
+    /**
+     * 根据 ID 获取单个资源
+     */
+    getResourceById(id: ResourceId, queryOptions?: QueryOptions): ResourceData | undefined;
+    /**
+     * 创建资源
+     */
+    createResource(data: Partial<ResourceData>): ResourceData;
+    /**
+     * 更新资源
+     */
+    updateResource(id: ResourceId, data: Partial<ResourceData>): ResourceData | undefined;
+    /**
+     * 删除资源
+     */
+    deleteResource(id: ResourceId): boolean;
+    /**
+     * 根据资源 ID 获取预订列表
+     */
+    getBookingsByResourceId(resourceId: ResourceId): ResourceBooking[];
+    /**
+     * 创建预订
+     */
+    createBooking(booking: Partial<ResourceBooking>): ResourceBooking;
+    /**
+     * 更新预订
+     */
+    updateBooking(id: ResourceId, data: Partial<ResourceBooking>): ResourceBooking | undefined;
+    /**
+     * 删除预订
+     */
+    deleteBooking(id: ResourceId): boolean;
+    /**
+     * 清空缓存
+     */
+    clear(): Promise<void>;
+    private attachBookingsToResource;
+    private normalizeResource;
+    private safeEmit;
+    private syncResourcesMap;
+    private syncBookingsIndex;
+    private rebuildBookingsIndex;
+    private getIdKey;
+    private loadResourcesByServer;
+    private loadResourcesFromSQLite;
+    private saveResourcesToSQLite;
+    private loadBookingsFromSQLite;
+    private saveBookingsToSQLite;
+    private initResourceDataSource;
+    private setupResourceSync;
+    private processSyncMessages;
+    private fetchResourcesBySSE;
+    private removeResourcesByIds;
+    private mergeResourcesToStore;
+    private uniqueResourceIds;
+}
+export declare const resourceModule: ResourceModule;
+export type { ResourceData, ResourceBooking, ResourceState, ResourceId, ResourcePageQuery, ResourcePageResult, QueryOptions, ScheduleEventResource, } from './types';
+export { ResourceHooks } from './types';