@pisell/pisellos 0.0.568 → 0.10.1

package/dist/server/modules/order/types.d.ts

@@ -63,6 +63,8 @@ export interface OrderProductBundleItem {
     bundle_group_id?: number;
     /** 套餐商品 ID */
     bundle_id?: number;
+    /** 套餐子商品封面图 */
+    cover?: string | null;
     /** 套餐商品规格 ID */
     bundle_variant_id?: number;
     /** 数量 */
@@ -80,6 +82,16 @@ export interface OrderProductMetadata {
     unique_identification_number?: string;
     [key: string]: unknown;
 }
+export interface OrderProductTitleSnapshot {
+    en: string | null;
+    ja: string | null;
+    pt: string | null;
+    auto: string | null;
+    'zh-CN': string | null;
+    'zh-HK': string | null;
+    kitchen: string | null;
+    original: string | null;
+}
 /**
  * 订单级商品行（3.3 products）。
  * 订单级别的非预约关联商品；预约关联商品在 bookings 内。
@@ -92,10 +104,12 @@ export interface OrderProductLineItem {
     product_id?: number | null;
     /** 数量。创建/更新时必填。来源：Detail.product_quantity */
     num: number;
+    /** 商品标题快照；本地待同步订单会补齐为多语言对象。 */
+    product_title?: OrderProductTitleSnapshot | string | null;
+    /** 商品封面图 */
+    product_cover?: string | null;
     /** 多规格 ID。来源：Detail.product_variant_id */
     product_variant_id?: number;
-    /** 选项配置 */
-    product_option_item?: unknown[];
     /**
      * 销售单价（交易快照，仅输出）。
      * 来源：Detail.selling_price
@@ -121,6 +135,8 @@ export interface OrderProductLineItem {
     product_bundle?: OrderProductBundleItem[];
     /** 元数据；含 unique_identification_number。来源：Detail.metadata */
     metadata?: OrderProductMetadata | null;
+    /** 关联子预约 ID（仅输出，预约订单场景）。来源：Detail.schedule_event_id */
+    schedule_event_id?: number | null;
 }
 /** 预约条目 metadata，常含 unique_identification_number */
 export interface OrderBookingMetadata {
@@ -188,6 +204,14 @@ export interface OrderBookingItem {
     holder?: Record<string, unknown> | null;
     /** 元数据；含 unique_identification_number。来源：ScheduleEvent.metadata */
     metadata?: OrderBookingMetadata | null;
+    /**
+     * 与订单明细等资源的关联（如 resource_type 为订单 Detail 时 resource_id 对应 order_detail_id）。
+     * 来源：服务端 ScheduleEvent 关联表。
+     */
+    relation_items?: {
+        resource_id?: number | null;
+        [key: string]: unknown;
+    }[];
 }
 /** 支付记录 metadata，常含 unique_payment_number */
 export interface OrderPaymentMetadata {
@@ -219,8 +243,10 @@ export interface OrderPaymentItem {
     rounding_amount?: OrderMoneyString;
     /** 支付状态：paid / voided / payment_pending 等 */
     status?: OrderPaymentRecordStatus;
-    /** 支付时间（仅输出）。来源：OrderPayment.payment_time */
+    /** 支付时间（输入/输出均保留）。来源：OrderPayment.payment_time */
     payment_time?: string | null;
+    /** 支付创建时间（输入/输出均保留）。来源：OrderPayment.created_at */
+    created_at?: string | null;
     /** 手续费配置。来源：OrderPayment.service_charge */
     service_charge?: Record<string, unknown> | null;
     /** Wallet Pass 使用单位 */
@@ -314,6 +340,8 @@ export interface OrderData {
     payment_status?: OrderPaymentStatus;
     /** 发货状态（仅输出）。来源：Order.shipping_status */
     shipping_status?: OrderShippingStatus;
+    /** 券列表。来源：Order.vouchers */
+    vouchers?: any[];
     /**
      * 客户 ID（设备端从本地客户数据取详情）。
      * 来源：Order.customer_id
@@ -383,6 +411,8 @@ export interface OrderData {
     /** 本地辅助字段 */
     shop_id?: number;
     create_date?: string;
+    /** 本地待同步标记：1 表示需要后续同步到云端 */
+    need_sync?: 0 | 1 | number;
     /** 兼容：部分场景仍使用顶层 total_amount */
     total_amount?: OrderMoneyString | number;
     /** 扩展字段（物流、标签等）；使用 any 以便筛选与数据源扩展 */
@@ -391,15 +421,18 @@ export interface OrderData {
 /** 去掉 bookings 后的订单快照；展开预约行时挂在 {@link BookingData.order} 上 */
 export type OrderWithoutBookings = Omit<OrderData, 'bookings'>;
 /**
- * 展开后的单条预约视图：协议 {@link OrderBookingItem} 平铺字段 + 所属订单（不含 bookings）
+ * 展开后的单条预约视图：协议 {@link OrderBookingItem} 平铺字段 + 所属订单（不含 bookings）+
+ * 当前预约归属的商品行（由订单 products 按 schedule_event_id / relation_items 归集，不修改 order）
  */
 export type BookingData = OrderBookingItem & {
     order: OrderWithoutBookings;
+    products: OrderProductLineItem[];
 };
 /**
  * 订单列表筛选条件（与 order.ts getFilterButtonList 等 UI 对齐）
  */
 export interface OrderFilters {
+    keyword?: string;
     order_by?: string;
     sort?: 'desc' | 'asc';
     status?: string[];
@@ -429,7 +462,10 @@ export interface OrderFilters {
  * 预约展开列表筛选条件（订单级条件匹配 booking.order.*，预约级匹配 booking 自身）
  */
 export interface BookingFilters {
+    /** RecordBoard 通用搜索字段（单数），用于本地预约过滤 */
     keyword?: string;
+    /** `/shop/schedule/booking` 后端协议搜索字段（复数），OS Server 需兼容 */
+    keywords?: string;
     order_by?: string;
     order_payment_status?: string[];
     order_status?: string[];
@@ -466,7 +502,27 @@ export interface OrderModulePagedResult<T> {
     size: number;
     skip: number;
 }
-export type OrderFilterResult = OrderModulePagedResult<OrderData>;
+/** 单条筛选未命中说明（用于排查过滤原因） */
+export interface OrderFilterRejectDetail {
+    /** 对应 OrderFilters 维度的标识 */
+    field: string;
+    /** 订单上该维度的当前值 */
+    actual: unknown;
+    /** 本次筛选的期望值/区间（便于对照） */
+    expected?: unknown;
+}
+/** 未通过筛选的订单及首个未满足条件（与过滤短路顺序一致） */
+export interface OrderFilterRejectedEntry {
+    order_id?: OrderId | null;
+    /** 系统订单号等，便于与业务「订单号」对照 */
+    order_number?: string;
+    /** 按筛选顺序命中的第一条未满足条件 */
+    reason: OrderFilterRejectDetail;
+}
+export type OrderFilterResult = OrderModulePagedResult<OrderData> & {
+    /** 被过滤掉的订单及首个命中原因（与筛选短路顺序一致；不含仅分页未展示的已通过订单） */
+    rejected: OrderFilterRejectedEntry[];
+};
 export type BookingFilterResult = OrderModulePagedResult<BookingData>;
 /**
  * SSE 同步配置
@@ -489,6 +545,21 @@ export interface OrderAblyEventPayload {
     order_id?: OrderId;
     timestamp: number;
 }
+/**
+ * 订单变更广播载荷。
+ * 用于保留原有全量列表通知能力，同时让订阅方可按 changedOrders 做增量处理。
+ *
+ * @example
+ * const changedOrders = payload.changedOrders
+ */
+export interface OrderChangedPayload {
+    /** 当前订单 store 全量列表，兼容既有重算列表订阅 */
+    list: OrderData[];
+    /** 本次明确发生变更的订单；全量刷新等无法确定 delta 的场景可为空 */
+    changedOrders: OrderData[];
+    /** 触发来源，便于订阅者区分 pubsub / 远端覆盖 / 清空等场景 */
+    source?: string;
+}
 /**
  * OrderSyncMessage - pubsub 同步消息结构
  */

package/dist/server/modules/order/types.js

@@ -97,7 +97,8 @@
 /** 去掉 bookings 后的订单快照；展开预约行时挂在 {@link BookingData.order} 上 */
 
 /**
- * 展开后的单条预约视图：协议 {@link OrderBookingItem} 平铺字段 + 所属订单（不含 bookings）
+ * 展开后的单条预约视图：协议 {@link OrderBookingItem} 平铺字段 + 所属订单（不含 bookings）+
+ * 当前预约归属的商品行（由订单 products 按 schedule_event_id / relation_items 归集，不修改 order）
  */
 
 /**
@@ -110,6 +111,10 @@
 
 /** 分页筛选结果通用结构 */
 
+/** 单条筛选未命中说明（用于排查过滤原因） */
+
+/** 未通过筛选的订单及首个未满足条件（与过滤短路顺序一致） */
+
 /**
  * SSE 同步配置
  */
@@ -122,6 +127,14 @@
  * Ably 事件载荷
  */
 
+/**
+ * 订单变更广播载荷。
+ * 用于保留原有全量列表通知能力，同时让订阅方可按 changedOrders 做增量处理。
+ *
+ * @example
+ * const changedOrders = payload.changedOrders
+ */
+
 /**
  * OrderSyncMessage - pubsub 同步消息结构
  */

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

@@ -1,5 +1,11 @@
-import type { BookingData, BookingFilters, BookingFilterResult, OrderData } from '../types';
+import type { BookingData, BookingFilters, BookingFilterResult, OrderBookingItem, OrderData, OrderProductLineItem } from '../types';
 export type { BookingData, BookingFilters, BookingFilterResult } from '../types';
+/**
+ * 从整单 `order.products` 中归集属于指定 `booking` 的明细行。
+ * - 第一遍：`product.schedule_event_id === booking.schedule_event_id`（保持 products 原顺序）
+ * - 第二遍：按 `relation_items` 顺序追加 `resource_id` 与 `order_detail_id` 匹配且尚未收录的行
+ */
+export declare function productsForBooking(order: OrderData, booking: OrderBookingItem): OrderProductLineItem[];
 export declare function flattenOrdersToBookings(orders: OrderData[]): BookingData[];
 export declare function filterBookingsFromOrders(orders: OrderData[], filters: BookingFilters): BookingFilterResult;
 export declare function sortBookings(result: BookingFilterResult, filters: BookingFilters): BookingFilterResult;

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

@@ -9,6 +9,7 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
 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';
 /** 预约状态：协议 appointment_status 优先，兼容历史 status */
 function getBookingAppointmentStatus(booking) {
   var _ref, _booking$appointment_;
@@ -22,7 +23,23 @@ function getBookingAppointmentStatus(booking) {
 function toTimestamp(value) {
   if (value === undefined || value === null || value === '') return 0;
   if (typeof value === 'number') return value;
-  return new Date(value).getTime();
+  // 使用 dayjs 按本地时区解析，避免 new Date("YYYY-MM-DD") 被当作 UTC 0 点
+  var d = dayjs(value);
+  return d.isValid() ? d.valueOf() : 0;
+}
+
+/** 日期范围端点解析：纯日期串自动对齐到当天起止边界（本地时区） */
+var DATE_ONLY_RE = /^\d{4}-\d{2}-\d{2}$/;
+function toRangeBoundary(value, isEnd) {
+  if (value === undefined || value === null || value === '') return 0;
+  if (typeof value === 'number') return value;
+  var str = String(value).trim();
+  var d = dayjs(str);
+  if (!d.isValid()) return 0;
+  if (DATE_ONLY_RE.test(str)) {
+    return (isEnd ? d.endOf('day') : d.startOf('day')).valueOf();
+  }
+  return d.valueOf();
 }
 
 /**
@@ -37,10 +54,33 @@ function bookingDateTimeString(datePart, timePart) {
   }
   return "".concat(d, " ").concat(t).trim();
 }
+
+/**
+ * 解析预约自身的起止时间区间，供 `sales_time_between` 做区间重叠匹配。
+ *
+ * @example
+ * const span = resolveBookingTimeRange({ start_date: '2026-06-09', start_time: '10:00', end_date: '2026-06-15', end_time: '10:00' })
+ */
+function resolveBookingTimeRange(booking) {
+  var start = toTimestamp(bookingDateTimeString(booking.start_date, booking.start_time));
+  if (!start) return null;
+  var end = toTimestamp(bookingDateTimeString(booking.end_date || booking.start_date, booking.end_time || booking.start_time)) || start;
+  return end >= start ? [start, end] : [end, start];
+}
+
+/**
+ * 判断两个闭区间是否有交集。
+ *
+ * @example
+ * isRangeOverlapping([1, 10], [5, 6]) // true
+ */
+function isRangeOverlapping(left, right) {
+  return left[0] <= right[1] && left[1] >= right[0];
+}
 function parseDateRange(range) {
   if (!Array.isArray(range) || range.length < 2) return null;
-  var start = toTimestamp(range[0]);
-  var end = toTimestamp(range[1]);
+  var start = toRangeBoundary(range[0], false);
+  var end = toRangeBoundary(range[1], true);
   if (!start && !end) return null;
   return [start, end];
 }
@@ -57,9 +97,16 @@ function parseNumberRange(range) {
 // 供 matchOrder、matchBooking 复用，避免重复计算
 // ─────────────────────────────────────────────────────────────────
 
+/** 预约列表搜索兼容前端通用 `keyword` 与后端协议 `keywords` 两种字段 */
+function resolveBookingKeyword(f) {
+  var _f$keyword;
+  var keyword = (_f$keyword = f.keyword) !== null && _f$keyword !== void 0 ? _f$keyword : f.keywords;
+  return typeof keyword === 'string' ? keyword.trim() : '';
+}
 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;
+  var keyword = resolveBookingKeyword(f);
   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,
@@ -76,7 +123,7 @@ function prepareFilters(f) {
     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() : '',
+    keywordLower: keyword ? keyword.toLowerCase() : '',
     afterExecutionTimeMs: function () {
       var raw = f.after_execution_time;
       if (raw === undefined || raw === null || raw === '') return null;
@@ -134,7 +181,7 @@ function matchOrder(order, ctx) {
 // ─────────────────────────────────────────────────────────────────
 
 function matchBooking(booking, orderInfo, ctx) {
-  if (ctx.enableChildBookingFilter) {
+  if (ctx.enableChildBookingFilter && booking.booking_id) {
     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 : '');
@@ -143,8 +190,8 @@ function matchBooking(booking, orderInfo, ctx) {
   }
   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;
+    var bookingRange = resolveBookingTimeRange(booking);
+    if (!bookingRange || !isRangeOverlapping(bookingRange, ctx.bookingTimeRange)) return false;
   }
   if (ctx.afterExecutionTimeMs != null) {
     var bookingStartMs = toTimestamp(bookingDateTimeString(booking.start_date, booking.start_time));
@@ -180,6 +227,61 @@ function matchBooking(booking, orderInfo, ctx) {
   return true;
 }
 
+// ─────────────────────────────────────────────────────────────────
+// 当前预约归属商品：先按 schedule_event_id 命中，再按 relation_items.resource_id 追加（去重保序）
+// ─────────────────────────────────────────────────────────────────
+
+/**
+ * 从整单 `order.products` 中归集属于指定 `booking` 的明细行。
+ * - 第一遍：`product.schedule_event_id === booking.schedule_event_id`（保持 products 原顺序）
+ * - 第二遍：按 `relation_items` 顺序追加 `resource_id` 与 `order_detail_id` 匹配且尚未收录的行
+ */
+export function productsForBooking(order, booking) {
+  var products = order.products;
+  if (!Array.isArray(products) || products.length === 0) return [];
+  var bookingEventId = booking.schedule_event_id;
+  var byDetailId = new Map();
+  for (var i = 0, len = products.length; i < len; i++) {
+    var p = products[i];
+    var oid = p.order_detail_id;
+    if (oid === undefined || oid === null) continue;
+    var detailId = Number(oid);
+    if (Number.isNaN(detailId)) continue;
+    byDetailId.set(detailId, p);
+  }
+  var seen = new Set();
+  var out = [];
+  for (var _i = 0, _len = products.length; _i < _len; _i++) {
+    var _p = products[_i];
+    var _oid = _p.order_detail_id;
+    if (_oid === undefined || _oid === null) continue;
+    var _detailId = Number(_oid);
+    if (Number.isNaN(_detailId)) continue;
+    if (bookingEventId !== undefined && bookingEventId !== null && _p.schedule_event_id !== undefined && _p.schedule_event_id !== null && Number(_p.schedule_event_id) === Number(bookingEventId)) {
+      if (!seen.has(_detailId)) {
+        seen.add(_detailId);
+        out.push(_p);
+      }
+    }
+  }
+  var relationItems = booking.relation_items;
+  if (Array.isArray(relationItems) && relationItems.length > 0) {
+    for (var r = 0, rLen = relationItems.length; r < rLen; r++) {
+      var _relationItems$r;
+      var rid = (_relationItems$r = relationItems[r]) === null || _relationItems$r === void 0 ? void 0 : _relationItems$r.resource_id;
+      if (rid === undefined || rid === null) continue;
+      var _detailId2 = Number(rid);
+      if (Number.isNaN(_detailId2) || seen.has(_detailId2)) continue;
+      var line = byDetailId.get(_detailId2);
+      if (line) {
+        seen.add(_detailId2);
+        out.push(line);
+      }
+    }
+  }
+  return out;
+}
+
 // ─────────────────────────────────────────────────────────────────
 // 转换：OrderData[] → BookingData[]（独立导出，供其他场景使用）
 // ─────────────────────────────────────────────────────────────────
@@ -194,8 +296,10 @@ export function flattenOrdersToBookings(orders) {
     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
+      var booking = bookings[j];
+      result.push(_objectSpread(_objectSpread({}, booking), {}, {
+        order: orderInfo,
+        products: order.products
       }));
     }
   }
@@ -256,7 +360,8 @@ export function filterBookingsFromOrders(orders, filters) {
           orderInfo = _rest;
         }
         paginatedList.push(_objectSpread(_objectSpread({}, booking), {}, {
-          order: orderInfo
+          order: orderInfo,
+          products: order.products
         }));
       }
       totalCount++;
@@ -337,7 +442,9 @@ export function filterBookings(bookings, filters) {
     if (!matchOrder(order, ctx)) continue;
     if (!matchBooking(booking, order, ctx)) continue;
     if (totalCount >= startIndex && paginatedList.length < size) {
-      paginatedList.push(booking);
+      paginatedList.push(_objectSpread(_objectSpread({}, booking), {}, {
+        products: booking.order.products
+      }));
     }
     totalCount++;
   }