@pisell/pisellos 2.2.264 → 2.2.265

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;
     /** 数量 */
@@ -104,6 +106,8 @@ export interface OrderProductLineItem {
     num: number;
     /** 商品标题快照；本地待同步订单会补齐为多语言对象。 */
     product_title?: OrderProductTitleSnapshot | string | null;
+    /** 商品封面图 */
+    product_cover?: string | null;
     /** 多规格 ID。来源：Detail.product_variant_id */
     product_variant_id?: number;
     /**
@@ -209,10 +213,12 @@ export interface OrderBookingItem {
         [key: string]: unknown;
     }[];
 }
-/** 支付记录 metadata，常含 unique_payment_number */
+/** 支付记录 metadata */
 export interface OrderPaymentMetadata {
-    /** 设备端本地支付唯一标识 */
+    /** 三方支付交易流水号 */
     unique_payment_number?: string;
+    /** 刷卡机设备快照；server 不解析内部字段，仅透传并持久化 */
+    card_reader_snapshot?: Record<string, unknown>;
     [key: string]: unknown;
 }
 /**
@@ -221,6 +227,8 @@ export interface OrderPaymentMetadata {
 export interface OrderPaymentItem {
     /** 支付记录 ID；存量/更新时传。来源：OrderPayment.id */
     order_payment_id?: number | null;
+    /** 支付项稳定唯一号；历史支付项允许缺失 */
+    payment_number?: string;
     /** 支付方式 ID（设备端从本地支付方式配置取详情）。来源：OrderPayment.custom_payment_id */
     custom_payment_id?: number;
     /** 支付方式编码。来源：OrderPayment.payment_method */
@@ -245,11 +253,13 @@ export interface OrderPaymentItem {
     created_at?: string | null;
     /** 手续费配置。来源：OrderPayment.service_charge */
     service_charge?: Record<string, unknown> | null;
+    /** 已计算的支付手续费。来源：OrderPayment.service_fee */
+    service_fee?: OrderMoneyString;
     /** Wallet Pass 使用单位 */
     wallet_pass_usage_unit?: unknown[] | null;
     /** Wallet Pass 使用值 */
     wallet_pass_use_value?: number | null;
-    /** 元数据；含 unique_payment_number。来源：OrderPayment.metadata */
+    /** 元数据；三方支付成功后可含 unique_payment_number */
     metadata?: OrderPaymentMetadata | null;
 }
 /**
@@ -409,6 +419,8 @@ export interface OrderData {
     create_date?: string;
     /** 本地待同步标记：1 表示需要后续同步到云端 */
     need_sync?: 0 | 1 | number;
+    /** 本地草稿标记：1 表示仅为 POS 可恢复草稿，不代表已提交云端 */
+    is_draft_order?: 0 | 1 | number;
     /** 兼容：部分场景仍使用顶层 total_amount */
     total_amount?: OrderMoneyString | number;
     /** 扩展字段（物流、标签等）；使用 any 以便筛选与数据源扩展 */

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

@@ -72,7 +72,7 @@
 // 3.5 payments
 // ─────────────────────────────────────────────────────────────────
 
-/** 支付记录 metadata，常含 unique_payment_number */
+/** 支付记录 metadata */
 
 /**
  * 支付记录（3.5 payments）

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

@@ -2,7 +2,7 @@ import { Module, PisellCore } from '../../../types';
 import { BaseModule } from '../../../modules/BaseModule';
 import { ProductData } from '../../../modules/Product/types';
 import type { RouteDefinition } from '../../types';
-import { ProductIdScope, ProductFormatter, ProductFormatterContext } from './types';
+import { ProductIdScope, type ProductSnapshot, ProductFormatter, ProductFormatterContext } from './types';
 /**
  * Products 模块 - 用于获取和管理完整的商品详细数据
  * 相比 ProductList 模块，Products 会获取所有详细信息并缓存
@@ -18,7 +18,8 @@ export declare class ProductsModule extends BaseModule implements Module {
     private productsPriceCache;
     private readonly CACHE_MAX_DAYS;
     private formatters;
-    private isPriceFormatterRegistered;
+    private isBuiltinFormatterRegistered;
+    private isLegacyPriceFormatterEnabled;
     private quotationPriceBridge?;
     private quotationBridgeChannel?;
     private quotationBridgeLoadedKey?;
@@ -36,6 +37,8 @@ export declare class ProductsModule extends BaseModule implements Module {
     private lastPreloadCompletedAtMs;
     /** IndexDB 写入串行队列，避免快照与 patch 并发交错 */
     private productIndexDBSaveQueue;
+    /** 最近一次智能定价评估提取的 schedule 变价时间点（HH:mm），供 Server 订阅定时刷新使用 */
+    private lastScheduleTimePoints;
     constructor(name?: string, version?: string);
     initialize(core: PisellCore, options: any): Promise<void>;
     /**
@@ -108,6 +111,10 @@ export declare class ProductsModule extends BaseModule implements Module {
      */
     private prepareProductsWithPrice;
     private getProductsPriceCacheKey;
+    /**
+     * 稳定序列化策略上下文，避免对象 key 顺序不同导致缓存 key 抖动。
+     */
+    private stringifyStable;
     private normalizeProductIds;
     /**
      * 按轻量范围返回商品 ID，不做 structuredClone。
@@ -122,14 +129,26 @@ export declare class ProductsModule extends BaseModule implements Module {
      */
     private applyFormatters;
     /**
-     * 注册内置的价格格式化器
-     * 这个格式化器负责将价格数据应用到商品上
+     * 注册内置商品格式化器。
+     *
+     * 智能定价默认替代报价单逻辑；报价单 formatter 仅在 enableLegacyPriceFormatter=true 时启用。
      * @private
      */
-    private registerBuiltinPriceFormatter;
+    private registerBuiltinProductFormatters;
+    /**
+     * 是否启用旧报价单价格 formatter。
+     *
+     * 默认关闭，避免报价单逻辑覆盖智能定价结果。
+     */
+    private shouldEnableLegacyPriceFormatter;
+    /**
+     * 返回最近一次 prepareProductsWithPrice / DataVariant 评估提取的变价时间点（HH:mm）。
+     * 供 OS Server 商品 query 订阅定时刷新使用。
+     */
+    getLastScheduleTimePoints(): string[];
     /**
      * 注册商品格式化器
-     * 格式化器会按注册顺序依次执行（内置价格格式化器始终是第一个）
+     * 格式化器会按注册顺序依次执行；legacy 启用时先兜底报价，再由智能定价覆盖。
      * @param formatter 格式化函数
      * @param prepend 是否插入到队列开头（默认 false，追加到末尾）
      * @example
@@ -144,8 +163,8 @@ export declare class ProductsModule extends BaseModule implements Module {
      */
     registerFormatter(formatter: ProductFormatter, prepend?: boolean): void;
     /**
-     * 清空所有格式化器（包括内置价格格式化器）
-     * @param keepBuiltin 是否保留内置价格格式化器（默认 true）
+     * 清空所有格式化器（包括内置智能定价格式化器）
+     * @param keepBuiltin 是否保留内置智能定价格式化器（默认 true）
      */
     clearFormatters(keepBuiltin?: boolean): void;
     /**
@@ -185,6 +204,10 @@ export declare class ProductsModule extends BaseModule implements Module {
      * 获取商品列表（深拷贝，供外部安全使用）
      */
     getProducts(): Promise<ProductData[]>;
+    /**
+     * 批量获取商品轻量快照，供订单详情等响应补齐展示协议字段。
+     */
+    getProductSnapshotsByIds(ids: number[]): Promise<Record<string, ProductSnapshot>>;
     /**
      * 内部获取商品列表的直接引用（无拷贝）
      * 仅供内部 formatter 流程使用，因为 formatter 会创建新对象