@pisell/pisellos 0.0.568 → 0.0.569

package/lib/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/lib/server/modules/order/types.js

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

package/lib/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/lib/server/modules/order/utils/filterBookings.js

@@ -6,7 +6,10 @@ Object.defineProperty(exports, "__esModule", {
 exports.filterBookings = filterBookings;
 exports.filterBookingsFromOrders = filterBookingsFromOrders;
 exports.flattenOrdersToBookings = flattenOrdersToBookings;
+exports.productsForBooking = productsForBooking;
 exports.sortBookings = sortBookings;
+var _dayjs = _interopRequireDefault(require("dayjs"));
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 /** 预约状态：协议 appointment_status 优先，兼容历史 status */
 function getBookingAppointmentStatus(booking) {
   return String(booking.appointment_status ?? booking.status ?? '');
@@ -19,7 +22,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 点
+  const d = (0, _dayjs.default)(value);
+  return d.isValid() ? d.valueOf() : 0;
+}
+
+/** 日期范围端点解析：纯日期串自动对齐到当天起止边界（本地时区） */
+const 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;
+  const str = String(value).trim();
+  const d = (0, _dayjs.default)(str);
+  if (!d.isValid()) return 0;
+  if (DATE_ONLY_RE.test(str)) {
+    return (isEnd ? d.endOf('day') : d.startOf('day')).valueOf();
+  }
+  return d.valueOf();
 }
 
 /**
@@ -34,10 +53,33 @@ function bookingDateTimeString(datePart, timePart) {
   }
   return `${d} ${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) {
+  const start = toTimestamp(bookingDateTimeString(booking.start_date, booking.start_time));
+  if (!start) return null;
+  const 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;
-  const start = toTimestamp(range[0]);
-  const end = toTimestamp(range[1]);
+  const start = toRangeBoundary(range[0], false);
+  const end = toRangeBoundary(range[1], true);
   if (!start && !end) return null;
   return [start, end];
 }
@@ -54,8 +96,14 @@ function parseNumberRange(range) {
 // 供 matchOrder、matchBooking 复用，避免重复计算
 // ─────────────────────────────────────────────────────────────────
 
+/** 预约列表搜索兼容前端通用 `keyword` 与后端协议 `keywords` 两种字段 */
+function resolveBookingKeyword(f) {
+  const keyword = f.keyword ?? f.keywords;
+  return typeof keyword === 'string' ? keyword.trim() : '';
+}
 function prepareFilters(f) {
   const hasCustomerId = f.customer_id !== undefined && f.customer_id !== null;
+  const keyword = resolveBookingKeyword(f);
   return {
     orderPaymentStatusSet: f.order_payment_status?.length ? new Set(f.order_payment_status) : null,
     orderStatusSet: f.order_status?.length ? new Set(f.order_status) : null,
@@ -72,7 +120,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: (() => {
       const raw = f.after_execution_time;
       if (raw === undefined || raw === null || raw === '') return null;
@@ -129,7 +177,7 @@ function matchOrder(order, ctx) {
 // ─────────────────────────────────────────────────────────────────
 
 function matchBooking(booking, orderInfo, ctx) {
-  if (ctx.enableChildBookingFilter) {
+  if (ctx.enableChildBookingFilter && booking.booking_id) {
     const parentId = Number(booking.parent_id ?? 0);
     const itemType = String(booking.item_type ?? '');
     const isMatched = parentId !== 0 && itemType !== 'recurring_booking' || parentId === 0 && itemType === 'recurring_booking';
@@ -137,8 +185,8 @@ function matchBooking(booking, orderInfo, ctx) {
   }
   if (ctx.appointmentStatusSet && !ctx.appointmentStatusSet.has(getBookingAppointmentStatus(booking))) return false;
   if (ctx.bookingTimeRange) {
-    const ts = toTimestamp(booking.start_date);
-    if (ts < ctx.bookingTimeRange[0] || ts > ctx.bookingTimeRange[1]) return false;
+    const bookingRange = resolveBookingTimeRange(booking);
+    if (!bookingRange || !isRangeOverlapping(bookingRange, ctx.bookingTimeRange)) return false;
   }
   if (ctx.afterExecutionTimeMs != null) {
     const bookingStartMs = toTimestamp(bookingDateTimeString(booking.start_date, booking.start_time));
@@ -175,6 +223,60 @@ 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` 匹配且尚未收录的行
+ */
+function productsForBooking(order, booking) {
+  const products = order.products;
+  if (!Array.isArray(products) || products.length === 0) return [];
+  const bookingEventId = booking.schedule_event_id;
+  const byDetailId = new Map();
+  for (let i = 0, len = products.length; i < len; i++) {
+    const p = products[i];
+    const oid = p.order_detail_id;
+    if (oid === undefined || oid === null) continue;
+    const detailId = Number(oid);
+    if (Number.isNaN(detailId)) continue;
+    byDetailId.set(detailId, p);
+  }
+  const seen = new Set();
+  const out = [];
+  for (let i = 0, len = products.length; i < len; i++) {
+    const p = products[i];
+    const oid = p.order_detail_id;
+    if (oid === undefined || oid === null) continue;
+    const 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);
+      }
+    }
+  }
+  const relationItems = booking.relation_items;
+  if (Array.isArray(relationItems) && relationItems.length > 0) {
+    for (let r = 0, rLen = relationItems.length; r < rLen; r++) {
+      const rid = relationItems[r]?.resource_id;
+      if (rid === undefined || rid === null) continue;
+      const detailId = Number(rid);
+      if (Number.isNaN(detailId) || seen.has(detailId)) continue;
+      const line = byDetailId.get(detailId);
+      if (line) {
+        seen.add(detailId);
+        out.push(line);
+      }
+    }
+  }
+  return out;
+}
+
 // ─────────────────────────────────────────────────────────────────
 // 转换：OrderData[] → BookingData[]（独立导出，供其他场景使用）
 // ─────────────────────────────────────────────────────────────────
@@ -191,9 +293,11 @@ function flattenOrdersToBookings(orders) {
       ...orderInfo
     } = order;
     for (let j = 0, bLen = bookings.length; j < bLen; j++) {
+      const booking = bookings[j];
       result.push({
-        ...bookings[j],
-        order: orderInfo
+        ...booking,
+        order: orderInfo,
+        products: order.products
       });
     }
   }
@@ -259,7 +363,8 @@ function filterBookingsFromOrders(orders, filters) {
         }
         paginatedList.push({
           ...booking,
-          order: orderInfo
+          order: orderInfo,
+          products: order.products
         });
       }
       totalCount++;
@@ -341,7 +446,10 @@ 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({
+        ...booking,
+        products: booking.order.products
+      });
     }
     totalCount++;
   }