@pisell/pisellos 0.0.567 → 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

@@ -1,34 +1,119 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+"use strict";
 
-// src/server/modules/order/types.ts
-var types_exports = {};
-__export(types_exports, {
-  OrderHooks: () => OrderHooks
-});
-module.exports = __toCommonJS(types_exports);
-var OrderHooks = /* @__PURE__ */ ((OrderHooks2) => {
-  OrderHooks2["onOrdersLoaded"] = "order:onOrdersLoaded";
-  OrderHooks2["onOrdersChanged"] = "order:onOrdersChanged";
-  OrderHooks2["onOrdersSyncCompleted"] = "order:onOrdersSyncCompleted";
-  return OrderHooks2;
-})(OrderHooks || {});
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  OrderHooks
+Object.defineProperty(exports, "__esModule", {
+  value: true
 });
+exports.OrderHooks = void 0;
+/**
+ * Order 模块主键类型（对齐标准 Sales 协议的 order_id）
+ */
+/**
+ * 协议中金额类字段多为 string 快照（交易时价格不可从基准商品重算）
+ */
+// ─────────────────────────────────────────────────────────────────
+// 订单类型 / 平台 / 渠道（Sales 协议枚举，保留 string 并置常用字面量）
+// ─────────────────────────────────────────────────────────────────
+/** 订单类型。文档：appointment_booking / ticket / virtual。来源：Order.type */
+/**
+ * 来源平台。文档：shop / pos / kiosk / h5 / app / mini-program。
+ * 来源：Order.platform
+ */
+/** 订单状态（仅输出）。文档：open / completed / cancelled。来源：Order.status */
+/** 支付状态。来源：Order.payment_status */
+/** 发货状态（仅输出）。来源：Order.shipping_status */
+/**
+ * 预约子事件状态（仅输出）。
+ * 文档：new / confirmed / arrived / started / completed / cancelled。
+ * 来源：ScheduleEvent.appointment_status
+ */
+/** 折扣类型：shop（整单）/ product（商品）。来源：Discount.type */
+/** 支付记录状态：paid / voided / payment_pending 等。来源：OrderPayment.status */
+/** 附加费类型。来源：OrderSurcharge.type */
+// ─────────────────────────────────────────────────────────────────
+// 3.3 products / 3.3.1 discount_list / 3.3.2 product_bundle
+// ─────────────────────────────────────────────────────────────────
+/** 商品折扣 metadata，常含 unique_identification_number */
+/**
+ * 商品折扣项（3.3.1 discount_list）
+ */
+/**
+ * 套餐子商品（3.3.2 product_bundle）
+ */
+/** 商品行 metadata，常含 unique_identification_number */
+/**
+ * 订单级商品行（3.3 products）。
+ * 订单级别的非预约关联商品；预约关联商品在 bookings 内。
+ * product_id 为关联 ID，展示信息从本地基准数据取；价格为交易快照须保留在 Sales 数据中。
+ */
+// ─────────────────────────────────────────────────────────────────
+// 3.4 bookings
+// ─────────────────────────────────────────────────────────────────
+/** 预约条目 metadata，常含 unique_identification_number */
+/**
+ * 单条预约（子 schedule_event，parent_id != 0）。
+ * product 结构同 products 单项；relation_products 结构同 products 数组。
+ */
+// ─────────────────────────────────────────────────────────────────
+// 3.5 payments
+// ─────────────────────────────────────────────────────────────────
+/** 支付记录 metadata，常含 unique_payment_number */
+/**
+ * 支付记录（3.5 payments）
+ */
+// ─────────────────────────────────────────────────────────────────
+// 3.6 surcharges
+// ─────────────────────────────────────────────────────────────────
+/**
+ * 订单附加费（3.6 surcharges）
+ */
+// ─────────────────────────────────────────────────────────────────
+// 3.7 summary（仅输出，由 OrderV2Service::computeOrderSummaryData 计算）
+// ─────────────────────────────────────────────────────────────────
+/**
+ * 订单数据结构（Server 侧对齐《统一 Sales 数据协议》）
+ */
+/** 去掉 bookings 后的订单快照；展开预约行时挂在 {@link BookingData.order} 上 */
+/**
+ * 展开后的单条预约视图：协议 {@link OrderBookingItem} 平铺字段 + 所属订单（不含 bookings）+
+ * 当前预约归属的商品行（由订单 products 按 schedule_event_id / relation_items 归集，不修改 order）
+ */
+/**
+ * 订单列表筛选条件（与 order.ts getFilterButtonList 等 UI 对齐）
+ */
+/**
+ * 预约展开列表筛选条件（订单级条件匹配 booking.order.*，预约级匹配 booking 自身）
+ */
+/** 分页筛选结果通用结构 */
+/** 单条筛选未命中说明（用于排查过滤原因） */
+/** 未通过筛选的订单及首个未满足条件（与过滤短路顺序一致） */
+/**
+ * SSE 同步配置
+ */
+/**
+ * Ably 事件类型
+ */
+/**
+ * Ably 事件载荷
+ */
+/**
+ * 订单变更广播载荷。
+ * 用于保留原有全量列表通知能力，同时让订阅方可按 changedOrders 做增量处理。
+ *
+ * @example
+ * const changedOrders = payload.changedOrders
+ */
+/**
+ * OrderSyncMessage - pubsub 同步消息结构
+ */
+/**
+ * Order 模块状态
+ */
+/**
+ * Order 模块钩子
+ */
+let OrderHooks = exports.OrderHooks = /*#__PURE__*/function (OrderHooks) {
+  OrderHooks["onOrdersLoaded"] = "order:onOrdersLoaded";
+  OrderHooks["onOrdersChanged"] = "order:onOrdersChanged";
+  OrderHooks["onOrdersSyncCompleted"] = "order:onOrdersSyncCompleted";
+  return OrderHooks;
+}({});

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;