@pisell/pisellos 0.10.65 → 0.10.67

package/dist/solution/UnifiedBookingSales/index.js

@@ -2152,7 +2152,7 @@ export var UnifiedBookingSalesImpl = /*#__PURE__*/function (_BookingTicket) {
               (_this$store$customer = this.store.customer) === null || _this$store$customer === void 0 || (_this$store$customer$ = _this$store$customer.setSelectedCustomer) === null || _this$store$customer$ === void 0 || _this$store$customer$.call(_this$store$customer, authenticatedCustomer);
               this.setOrderCustomer(authenticatedCustomer);
               _context8.next = 15;
-              return Promise.all([this.refreshDiscountConfigAfterOrderCustomerChange(authenticatedCustomerId), this.waitForOrderCustomerPromotionRefresh()]);
+              return Promise.all([this.refreshDiscountConfigAfterOrderCustomerChange(authenticatedCustomerId), this.waitForOrderCustomerPromotionRefresh(), this.waitForOrderCustomerContactInfo()]);
             case 15:
               return _context8.abrupt("return", true);
             case 16:

package/lib/model/strategy/adapter/promotion/index.js

@@ -1 +1,46 @@
-"use strict";
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "BUY_X_GET_Y_FREE_STRATEGY", {
+  enumerable: true,
+  get: function () {
+    return _examples.BUY_X_GET_Y_FREE_STRATEGY;
+  }
+});
+Object.defineProperty(exports, "ITEM_REWARD_STRATEGY", {
+  enumerable: true,
+  get: function () {
+    return _examples.ITEM_REWARD_STRATEGY;
+  }
+});
+Object.defineProperty(exports, "PromotionAdapter", {
+  enumerable: true,
+  get: function () {
+    return _adapter.PromotionAdapter;
+  }
+});
+Object.defineProperty(exports, "PromotionEvaluator", {
+  enumerable: true,
+  get: function () {
+    return _evaluator.PromotionEvaluator;
+  }
+});
+Object.defineProperty(exports, "X_ITEMS_FOR_Y_PRICE_STRATEGY", {
+  enumerable: true,
+  get: function () {
+    return _examples.X_ITEMS_FOR_Y_PRICE_STRATEGY;
+  }
+});
+Object.defineProperty(exports, "default", {
+  enumerable: true,
+  get: function () {
+    return _adapter.default;
+  }
+});
+var _evaluator = require("./evaluator");
+var _adapter = _interopRequireWildcard(require("./adapter"));
+var _examples = require("./examples");
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }

package/lib/modules/OpenData/contactInfo.d.ts

@@ -0,0 +1,20 @@
+import type { OpenDataConfig } from './types';
+export declare const CONTACT_INFO_FIELDS: readonly ["first_name", "last_name", "phone", "email"];
+export type ContactInfoField = typeof CONTACT_INFO_FIELDS[number];
+export interface ContactInfoConfig {
+    enabled: boolean;
+    fields: Record<ContactInfoField, {
+        visible: boolean;
+        required: boolean;
+    }>;
+}
+export declare function resolveContactInfoConfig(data?: OpenDataConfig | null): ContactInfoConfig;
+export declare function getMissingContactInfoFields(config: ContactInfoConfig, value: unknown): ContactInfoField[];
+export declare function isContactRecord(value: unknown): value is Record<string, any>;
+/** Customer relations wrap the contact in value; sales orders store the object itself. */
+export declare function extractCustomerContactInfo(customer: unknown): Record<string, any> | null;
+export declare class ContactInfoRequiredError extends Error {
+    readonly fields: ContactInfoField[];
+    readonly code = "CONTACT_INFO_REQUIRED";
+    constructor(fields: ContactInfoField[]);
+}

package/lib/modules/OpenData/contactInfo.js

@@ -0,0 +1,56 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ContactInfoRequiredError = exports.CONTACT_INFO_FIELDS = void 0;
+exports.extractCustomerContactInfo = extractCustomerContactInfo;
+exports.getMissingContactInfoFields = getMissingContactInfoFields;
+exports.isContactRecord = isContactRecord;
+exports.resolveContactInfoConfig = resolveContactInfoConfig;
+const CONTACT_INFO_FIELDS = exports.CONTACT_INFO_FIELDS = ['first_name', 'last_name', 'phone', 'email'];
+function resolveContactInfoConfig(data) {
+  const enabled = data?.['sale.enable_contact_info'] === true;
+  const fields = CONTACT_INFO_FIELDS.reduce((result, field) => {
+    const visible = data?.[`sale.${field}.visible`] !== false;
+    result[field] = {
+      visible,
+      required: enabled && visible && data?.[`sale.${field}.required`] === true
+    };
+    return result;
+  }, {});
+  return {
+    enabled: enabled && CONTACT_INFO_FIELDS.some(field => fields[field].visible),
+    fields
+  };
+}
+function getMissingContactInfoFields(config, value) {
+  if (!config.enabled) return [];
+  const contact = isContactRecord(value) ? value : {};
+  return CONTACT_INFO_FIELDS.filter(field => {
+    if (!config.fields[field].visible || !config.fields[field].required) return false;
+    const fieldValue = field === 'phone' ? isContactRecord(contact.phone) ? contact.phone.phone : undefined : contact[field];
+    return typeof fieldValue !== 'string' || !fieldValue.trim();
+  });
+}
+function isContactRecord(value) {
+  return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+
+/** Customer relations wrap the contact in value; sales orders store the object itself. */
+function extractCustomerContactInfo(customer) {
+  if (!isContactRecord(customer)) return null;
+  const contact = customer.contacts_info;
+  if (!isContactRecord(contact)) return null;
+  const value = Object.prototype.hasOwnProperty.call(contact, 'value') ? contact.value : contact;
+  return isContactRecord(value) ? value : null;
+}
+class ContactInfoRequiredError extends Error {
+  code = 'CONTACT_INFO_REQUIRED';
+  constructor(fields) {
+    super(`Contact information is required: ${fields.join(', ')}`);
+    this.fields = fields;
+    this.name = 'ContactInfoRequiredError';
+  }
+}
+exports.ContactInfoRequiredError = ContactInfoRequiredError;

package/lib/modules/OpenData/index.d.ts

@@ -3,6 +3,7 @@ import { BaseModule } from '../BaseModule';
 import type { ScheduleModule } from '../Schedule';
 import type { OpenDataConfig, OpenDataFetchParams, OpenDataAvailabilityResult, InvoiceLayoutConfig, InvoiceTemplateSettings } from './types';
 export * from './types';
+export * from './contactInfo';
 export { computeAvailability, getDefaultInvoiceLayoutConfig, getDefaultInvoiceTemplateSettings, normalizeInvoiceLayoutConfig, normalizeInvoiceLayoutFromTemplateSettings, normalizeInvoiceTemplateSettings, normalizeRawInvoiceTemplateSettings, resolveInvoiceReceiptLocales, } from './utils';
 export declare class OpenDataModule extends BaseModule implements Module {
     protected defaultName: string;

package/lib/modules/OpenData/index.js

@@ -77,6 +77,18 @@ Object.keys(_types).forEach(function (key) {
     }
   });
 });
+var _contactInfo = require("./contactInfo");
+Object.keys(_contactInfo).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _contactInfo[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _contactInfo[key];
+    }
+  });
+});
 function isRecord(value) {
   return !!value && typeof value === 'object' && !Array.isArray(value);
 }

package/lib/modules/OpenData/types.d.ts

@@ -69,6 +69,15 @@ export interface OpenDataConfig {
     'reservation.time_slice'?: number | string;
     'sale.allow_item_notes'?: boolean;
     'sale.allow_order_notes'?: boolean;
+    'sale.enable_contact_info'?: boolean;
+    'sale.first_name.visible'?: boolean;
+    'sale.first_name.required'?: boolean;
+    'sale.last_name.visible'?: boolean;
+    'sale.last_name.required'?: boolean;
+    'sale.phone.visible'?: boolean;
+    'sale.phone.required'?: boolean;
+    'sale.email.visible'?: boolean;
+    'sale.email.required'?: boolean;
     /** False submits an order without starting or confirming payment. */
     'sale.require_payment_on_submit'?: boolean | null;
     'sale.enable_item_rules'?: boolean;

package/lib/solution/BaseSales/index.d.ts

@@ -5,6 +5,7 @@ import { BaseSalesOrderProduct, BaseSalesOrderProductIdentity, BaseSalesPaymentS
 import { OrderModule } from '../../modules/Order';
 import { type PickupTimingBookingInput } from '../../modules/Order/pickupTiming';
 import type { PickupTimingAvailability, PickupTimingSelection, PickupTimingValidationResult } from '../../modules/FulfillmentTiming';
+import { type ContactInfoConfig } from '../../modules/OpenData/contactInfo';
 import type { AddProductBookingInput, AddProductToOrderOptions, LoadSalesDetailParams, OrderPaymentData, OrderPaymentUpdateOptions, OrderPaymentUpdateResult, OrderPaymentSource, SendCustomerPayLinkParams, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, UpdateTempOrderCustomerInput, UpdateOrderBookingParams, UpdateOrderProductParams, OrderTempOrder, OrderSummary, OrderPromotionEvaluator, OrderGiftSelectResolver, OrderUnfulfilledPromotion, OrderLastGiftActions, RemoveProductsFromOrderOptions, ReplaceTempOrderOptions, SalesNote, SalesNotesMutationSnapshot, SetSalesNoteInput, PickupReferenceMode, ShopServiceData, ShopServiceType } from '../../modules/Order/types';
 import type { SubmitPayloadEnhancer } from '../../modules/Order/utils';
 import type { Discount, VirtualCurrencyAsset } from '../../modules/Discount/types';
@@ -19,6 +20,7 @@ import { QuotationModule } from '../../modules/Quotation';
 import type { ISalesDetail, ISalesDetailHeader, ISalesBooking, ISalesPayment, ISalesSurcharge } from './utils/parseSalesResponse';
 import { AppPlugin } from '../../plugins/app';
 import { type TransformBaseProductToOrderProductParams } from './utils/transformBaseProductToOrderProduct';
+import type { OpenDataConfig } from '../../modules/OpenData/types';
 export interface BaseSalesState {
     order?: OrderModule;
     products?: ProductList;
@@ -283,6 +285,9 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     setPickupTimingBooking(input: PickupTimingBookingInput): import("../../modules/Order").PickupTimingBooking;
     clearPickupTimingBooking(): void;
     updateTempOrderContactsInfo(contactsInfo: Record<string, any> | null): Record<string, any> | null;
+    protected loadContactInfoOpenData(): Promise<OpenDataConfig | null>;
+    getContactInfoConfig(): Promise<ContactInfoConfig>;
+    validateContactInfo(): Promise<void>;
     /** @deprecated OrderModule 不再负责 tempOrder localStorage 持久化。 */
     setEnableTempOrderPersist(enabled: boolean): void;
     /** 是否允许 saveDraft 写入 IndexedDB 草稿。 */
@@ -359,6 +364,8 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
      * payments 会交给 OrderModule 统一映射为 Sales 协议支付项。
      */
     submitSalesOrder<T = any>(params?: BaseSalesSubmitSalesOrderParams): Promise<T>;
+    /** Validate required contact fields before a new payment is initiated. */
+    ensureSalesOrderReadyForPayment(): Promise<void>;
     saveSalesOrderDraft<T = any>(params?: {
         platform?: string;
         businessCode?: string;

package/lib/solution/BaseSales/index.js

@@ -25,6 +25,7 @@ var _Order = require("../../modules/Order");
 var _pickupTiming = require("../../modules/Order/pickupTiming");
 var _pickupTiming2 = require("./pickupTiming");
 var _holderRelations = require("../../modules/Order/holderRelations");
+var _contactInfo = require("../../modules/OpenData/contactInfo");
 var _decimal = _interopRequireDefault(require("decimal.js"));
 var _lodashEs = require("lodash-es");
 var _types2 = require("../BookingByStep/types");
@@ -1906,6 +1907,27 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
     if (!this.store.order) throw new Error('order 模块未初始化');
     return this.store.order.updateTempOrderContactsInfo(contactsInfo);
   }
+  async loadContactInfoOpenData() {
+    return this.otherParams?.openData ?? null;
+  }
+  async getContactInfoConfig() {
+    const scope = this.getPickupTimingScope();
+    const data = await this.loadContactInfoOpenData();
+    if (scope !== this.getPickupTimingScope()) throw new Error('Store settings changed. Please try again.');
+    return (0, _contactInfo.resolveContactInfoConfig)(data);
+  }
+  async validateContactInfo() {
+    const order = this.getTempOrder();
+    const identity = order?._extend?.localId || order?.external_sale_number || order?.order_id || order;
+    const customerId = order?.customer_id;
+    const config = await this.getContactInfoConfig();
+    const current = this.getTempOrder();
+    if (identity !== (current?._extend?.localId || current?.external_sale_number || current?.order_id || current) || customerId !== current?.customer_id) {
+      throw new Error('The order changed. Please try again.');
+    }
+    const missing = (0, _contactInfo.getMissingContactInfoFields)(config, current?.contacts_info);
+    if (missing.length) throw new _contactInfo.ContactInfoRequiredError(missing);
+  }
 
   /** @deprecated OrderModule 不再负责 tempOrder localStorage 持久化。 */
   setEnableTempOrderPersist(enabled) {
@@ -2706,6 +2728,7 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
     if (!this.store.order) {
       throw new Error('BaseSales 解决方案需要 order 模块支持');
     }
+    await this.validateContactInfo();
     if (this.isPickupTimingEnabled()) await this.preparePickupTimingForCheckout({
       freeze: true
     });
@@ -2779,6 +2802,11 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
     };
     return this.shouldUseCheckoutSyncTask() ? this.store.order.submitTempOrder(submitParams) : this.store.order.submitTempOrderAsync(submitParams);
   }
+
+  /** Validate required contact fields before a new payment is initiated. */
+  async ensureSalesOrderReadyForPayment() {
+    await this.validateContactInfo();
+  }
   async saveSalesOrderDraft(params) {
     if (!this.store.order) {
       throw new Error('BaseSales 解决方案需要 order 模块支持');
@@ -2801,6 +2829,7 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
     if (!this.store.order) {
       throw new Error('BaseSales 解决方案需要 order 模块支持');
     }
+    await this.validateContactInfo();
     if (this.isPickupTimingEnabled()) {
       await this.preparePickupTimingForCheckout({
         freeze: true
@@ -3637,6 +3666,7 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
    */
   async confirmWalletPayment() {
     if (!this.store.order) throw new Error('order 模块未初始化');
+    await this.validateContactInfo();
     const beforePayments = (0, _lodashEs.cloneDeep)(this.store.order.getOrderPayments());
     const pendingWalletAmount = this.getPendingWalletPaymentAmount(beforePayments);
     const amountSnapshot = this.store.order.getOrderAmountSnapshot?.();
@@ -3708,6 +3738,7 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
    */
   async payCash(params) {
     if (!this.store.order) throw new Error('order 模块未初始化');
+    await this.validateContactInfo();
     const amount = Number(params.amount || 0);
     if (!Number.isFinite(amount) || amount <= 0) {
       throw new Error('现金支付金额必须大于 0');

package/lib/solution/BookingByStep/index.d.ts

@@ -326,7 +326,7 @@ export declare class BookingByStepImpl extends BaseModule implements Module {
         date: string;
         status: string;
         week: string;
-        weekNum: 0 | 2 | 1 | 3 | 4 | 5 | 6;
+        weekNum: 0 | 6 | 5 | 1 | 2 | 3 | 4;
     }[]>;
     submitTimeSlot(timeSlots: TimeSliceItem): void;
     private getScheduleDataByIds;

package/lib/solution/BookingTicket/index.d.ts

@@ -32,6 +32,7 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
     private orderCustomerDiscountRefreshCustomerId;
     private orderCustomerDiscountRefreshTarget;
     private orderCustomerPromotionRefreshInFlight;
+    private orderCustomerContactRequest;
     private readonly customerResolveRequests;
     protected loadOpenDataInFlight: Promise<OpenDataConfig> | null;
     protected loadOpenDataInFlightTarget: string | null;
@@ -58,6 +59,7 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
     private getIdGeneratorPlugin;
     protected loadOpenDataConfig(): Promise<OpenDataConfig | null>;
     getOpenData(): Promise<OpenDataConfig | null>;
+    protected loadContactInfoOpenData(): Promise<OpenDataConfig | null>;
     getInvoiceLayoutConfig(): Promise<InvoiceLayoutConfig>;
     getInvoiceTemplateSettings(): Promise<InvoiceTemplateSettings>;
     protected isInvoiceOpenDataCacheCurrent(): boolean;
@@ -275,6 +277,16 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
     setOrderCustomer(customer: ICustomer | null, options?: {
         source?: OrderCustomerChangePayload['source'];
     }): void;
+    private resetOrderCustomerContactInfo;
+    /** Explicit edits, including clearing the contact, must win over a pending default. */
+    updateTempOrderContactsInfo(contact: Record<string, any> | null): Record<string, any> | null;
+    private getCustomerContactScope;
+    private getCustomerContactOrderKey;
+    replaceTempOrder(...args: Parameters<BaseSalesImpl['replaceTempOrder']>): Promise<import("../../modules/Order/types").OrderTempOrder>;
+    private applyDefaultOrderCustomerContactInfo;
+    private prefillOrderCustomerContactInfo;
+    protected waitForOrderCustomerContactInfo(): Promise<void>;
+    validateContactInfo(): Promise<void>;
     /**
      * 读取 tempOrder 上的下单客户协议字段；customer_id 缺失时返回 null。
      */
@@ -286,7 +298,9 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
     /**
      * 清空下单客户（协议字段 + snapshot）。
      */
-    clearOrderCustomer(): void;
+    clearOrderCustomer(options?: {
+        preserveContactInfo?: boolean;
+    }): void;
     /**
      * 重置 tempOrder，并同步清空下单客户运行态。
      *
@@ -346,7 +360,7 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
      * 获取当前的客户搜索条件
      * @returns 当前搜索条件
      */
-    getCurrentCustomerSearchParams(): Omit<import("../../modules").ShopGetCustomerListParams, "num" | "skip">;
+    getCurrentCustomerSearchParams(): Omit<import("../../modules").ShopGetCustomerListParams, "skip" | "num">;
     /**
      * 获取客户列表状态（包含滚动加载相关状态）
      * @returns 客户状态

package/lib/solution/BookingTicket/index.js

@@ -39,6 +39,9 @@ var _orderLineDisplay = require("../../modules/BookingContext/utils/orderLineDis
 var _bookingStatus = require("./utils/bookingStatus");
 var _resolveBestAddTimePlan = require("./utils/resolveBestAddTimePlan");
 var _utils = require("../../modules/Order/utils");
+var _contactInfo = require("../../modules/OpenData/contactInfo");
+var _platform = require("../../utils/platform");
+var _lodashEs = require("lodash-es");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 const OPEN_DATA_SECTION_CODES = ['sale', 'reservation', 'fulfillment', 'menu', 'workflow', 'documents'];
 const OPEN_DATA_CACHE_TTL = 5 * 60 * 1000;
@@ -162,6 +165,7 @@ class BookingTicketImpl extends _BaseSales.BaseSalesImpl {
   orderCustomerDiscountRefreshCustomerId = null;
   orderCustomerDiscountRefreshTarget = null;
   orderCustomerPromotionRefreshInFlight = null;
+  orderCustomerContactRequest = null;
   customerResolveRequests = new Map();
   loadOpenDataInFlight = null;
   loadOpenDataInFlightTarget = null;
@@ -289,6 +293,9 @@ class BookingTicketImpl extends _BaseSales.BaseSalesImpl {
   async getOpenData() {
     return this.loadOpenDataConfig();
   }
+  async loadContactInfoOpenData() {
+    return this.store.openData ? this.getOpenData() : super.loadContactInfoOpenData();
+  }
   async getInvoiceLayoutConfig() {
     const openData = await this.loadOpenDataConfig();
     if (!openData) return (0, _OpenData.getDefaultInvoiceLayoutConfig)();
@@ -1009,7 +1016,9 @@ class BookingTicketImpl extends _BaseSales.BaseSalesImpl {
    */
   setOrderCustomer(customer, options) {
     if (!customer) {
-      this.clearOrderCustomer();
+      this.clearOrderCustomer({
+        preserveContactInfo: options?.source === 'detailHydrate'
+      });
       return;
     }
     const previousCustomerId = this.store.order.getOrderCustomer()?.customer_id;
@@ -1020,7 +1029,16 @@ class BookingTicketImpl extends _BaseSales.BaseSalesImpl {
       this.discountConfigCacheKey = null;
       this.hasManualDiscountSelection = false;
     }
+    if (!customerUnchanged && options?.source !== 'detailHydrate') {
+      this.resetOrderCustomerContactInfo();
+      this.store.order.updateTempOrderContactsInfo((0, _lodashEs.cloneDeep)((0, _contactInfo.extractCustomerContactInfo)(customer)));
+    }
     this.store.order.setOrderCustomer(patch, customer);
+    if (options?.source === 'detailHydrate') {
+      this.orderCustomerContactRequest = null;
+    } else {
+      this.prefillOrderCustomerContactInfo(customer, !customerUnchanged);
+    }
     const snapshotAfterOrderSet = this.store.order.getOrderCustomerSnapshot();
     if (customerUnchanged) {
       // hydrate 后 customer_id 已存在但 _extend.customerSnapshot 仍为空时，
@@ -1053,6 +1071,105 @@ class BookingTicketImpl extends _BaseSales.BaseSalesImpl {
       this.orderCustomerPromotionRefreshInFlight = null;
     });
   }
+  resetOrderCustomerContactInfo() {
+    this.orderCustomerContactRequest = null;
+    const order = this.getTempOrder();
+    if (order?._extend) delete order._extend.contactInfoEdited;
+  }
+
+  /** Explicit edits, including clearing the contact, must win over a pending default. */
+  updateTempOrderContactsInfo(contact) {
+    const order = this.store.order.ensureTempOrder();
+    order._extend || (order._extend = {});
+    order._extend.contactInfoEdited = true;
+    this.orderCustomerContactRequest = null;
+    return super.updateTempOrderContactsInfo(contact);
+  }
+  getCustomerContactScope() {
+    return JSON.stringify([this.getPickupTimingScope(), this.otherParams?.channel, this.otherParams?.shop_id, this.otherParams?.tenantId]);
+  }
+  getCustomerContactOrderKey() {
+    const order = this.getTempOrder();
+    // Cart mutations can replace the object without changing the order.
+    const identity = order?.external_sale_number || order?.request_unique_idempotency_token || order?._extend?.localId || order?.order_id;
+    return identity ? JSON.stringify([identity, order?.order_id]) : order;
+  }
+  async replaceTempOrder(...args) {
+    this.orderCustomerContactRequest = null;
+    return super.replaceTempOrder(...args);
+  }
+  async applyDefaultOrderCustomerContactInfo(contact) {
+    this.store.order.updateTempOrderContactsInfo((0, _lodashEs.cloneDeep)(contact));
+    // Metadata may finish after promotion/discount refresh; publish the updated cart explicitly.
+    await this.effectsEmit('onTempOrderReplaced', {
+      tempOrder: this.getTempOrder()
+    });
+  }
+  prefillOrderCustomerContactInfo(customer, customerChanged) {
+    const order = this.getTempOrder();
+    const customerId = Number(order?.customer_id);
+    if (!order || !Number.isInteger(customerId) || customerId <= 1 || order.contacts_info != null || order._extend?.contactInfoEdited) return;
+    // A restored new cart may already have its customer ID. Existing sales keep their snapshot,
+    // even when it is empty; only an explicit customer switch replaces it.
+    if (!customerChanged && order.order_id && !String(order.order_id).startsWith('local_order')) return;
+    const contact = (0, _contactInfo.extractCustomerContactInfo)(customer);
+    if (contact) {
+      this.orderCustomerContactRequest = null;
+      void this.applyDefaultOrderCustomerContactInfo(contact);
+      return;
+    }
+    // A relation explicitly returned as null is authoritative. Only a missing relation needs fetching.
+    if (customer.contacts_info !== undefined) return;
+    const userPlatform = (0, _platform.isCustomerUserPlatform)(this.otherParams?.platform);
+    const getAuthenticatedCustomerId = () => Number(this.core?.getPlugin?.('user')?.get?.()?.id);
+    if (userPlatform && getAuthenticatedCustomerId() !== customerId) return;
+    const scope = this.getCustomerContactScope();
+    const orderKey = this.getCustomerContactOrderKey();
+    const previous = this.orderCustomerContactRequest;
+    if (previous?.orderKey === orderKey && previous.customerId === customerId && previous.scope === scope) return;
+    const pending = {
+      orderKey,
+      customerId,
+      scope,
+      promise: Promise.resolve()
+    };
+    this.orderCustomerContactRequest = pending;
+    const loadContact = async () => {
+      if (userPlatform) {
+        // Same endpoint as BookingByStep.getContactInfo; the PC/H5 host adds /h5 and login headers.
+        const result = await this.request.get('/customer/metadata', {
+          key: 'contacts_info'
+        });
+        if (result?.code !== 200 || result?.status === false) throw new Error('Customer contact lookup failed');
+        return (0, _contactInfo.isContactRecord)(result.data) ? result.data : null;
+      }
+      // POS and physical Kiosk share the /shop request plugin and current-shop customer resolver.
+      const resolved = await this.resolveCustomerById(customerId);
+      return Number(resolved?.id) === customerId ? (0, _contactInfo.extractCustomerContactInfo)(resolved) : null;
+    };
+    pending.promise = loadContact().then(async value => {
+      const current = this.getTempOrder();
+      if (this.orderCustomerContactRequest !== pending || this.getCustomerContactOrderKey() !== orderKey || Number(current?.customer_id) !== customerId || scope !== this.getCustomerContactScope() || current?._extend?.contactInfoEdited || current?.contacts_info != null || userPlatform && getAuthenticatedCustomerId() !== customerId) return;
+      if (value) await this.applyDefaultOrderCustomerContactInfo(value);
+    }).catch(() => {
+      // A failed default does not prevent manual entry; a subsequent sync can retry.
+      if (this.orderCustomerContactRequest === pending) this.orderCustomerContactRequest = null;
+      console.warn('[BookingTicket] Failed to load saved customer contact information');
+    });
+  }
+  waitForOrderCustomerContactInfo() {
+    return this.orderCustomerContactRequest?.promise ?? Promise.resolve();
+  }
+  async validateContactInfo() {
+    const orderKey = this.getCustomerContactOrderKey();
+    const customerId = this.getTempOrder()?.customer_id;
+    const scope = this.getCustomerContactScope();
+    await this.waitForOrderCustomerContactInfo();
+    if (this.getCustomerContactOrderKey() !== orderKey || this.getTempOrder()?.customer_id !== customerId || this.getCustomerContactScope() !== scope) {
+      throw new Error('The order changed. Please try again.');
+    }
+    await super.validateContactInfo();
+  }
 
   /**
    * 读取 tempOrder 上的下单客户协议字段；customer_id 缺失时返回 null。
@@ -1071,7 +1188,10 @@ class BookingTicketImpl extends _BaseSales.BaseSalesImpl {
   /**
    * 清空下单客户（协议字段 + snapshot）。
    */
-  clearOrderCustomer() {
+  clearOrderCustomer(options) {
+    this.orderCustomerContactRequest = null;
+    if (!options?.preserveContactInfo) this.resetOrderCustomerContactInfo();
+    if (!options?.preserveContactInfo) this.store.order.updateTempOrderContactsInfo(null);
     this.store.order.clearOrderCustomer();
     this.discountConfigCacheKey = null;
     this.hasManualDiscountSelection = false;
@@ -1891,6 +2011,11 @@ class BookingTicketImpl extends _BaseSales.BaseSalesImpl {
   async setOtherParams(params, {
     cover = false
   } = {}) {
+    const nextParams = cover ? params : {
+      ...this.otherParams,
+      ...params
+    };
+    if (['businessCode', 'business_code', 'channel', 'platform', 'shop_id', 'tenantId', 'cacheId'].some(key => nextParams?.[key] !== this.otherParams?.[key])) this.orderCustomerContactRequest = null;
     await super.setOtherParams(params, {
       cover
     });
@@ -2006,6 +2131,7 @@ class BookingTicketImpl extends _BaseSales.BaseSalesImpl {
    * 再清理 BookingTicket 自有资源（scan 监听 + scan 内存缓存）。
    */
   async destroy() {
+    this.orderCustomerContactRequest = null;
     await super.destroy();
     try {
       this.scan?.removeAllListeners();

package/lib/solution/UnifiedBookingSales/index.js

@@ -1718,7 +1718,7 @@ class UnifiedBookingSalesImpl extends _BookingTicket.BookingTicket {
     }
     this.store.customer?.setSelectedCustomer?.(authenticatedCustomer);
     this.setOrderCustomer(authenticatedCustomer);
-    await Promise.all([this.refreshDiscountConfigAfterOrderCustomerChange(authenticatedCustomerId), this.waitForOrderCustomerPromotionRefresh()]);
+    await Promise.all([this.refreshDiscountConfigAfterOrderCustomerChange(authenticatedCustomerId), this.waitForOrderCustomerPromotionRefresh(), this.waitForOrderCustomerContactInfo()]);
     return true;
   }
   isAuthenticatedCustomerUserPlatform() {

package/package.json

@@ -1,7 +1,7 @@
 {
   "private": false,
   "name": "@pisell/pisellos",
-  "version": "0.10.65",
+  "version": "0.10.67",
   "description": "一个可扩展的前端模块化SDK框架，支持插件系统",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",