@pisell/pisellos 0.10.64 → 0.10.66

package/dist/solution/BookingTicket/types.d.ts

@@ -208,6 +208,8 @@ export interface AddAddTimeProductsToBookingInput {
 }
 /** 扫码宿主桥接：SalesSdk 在 pubsub 订阅回调里注入，OS 需要 UI 时直接调用 */
 export interface GlobalScanHostBridge {
+    /** Restrict redemption scans before customer/product side effects. */
+    scanScope?: 'all' | 'product-voucher';
     openProductDetail?: (payload: Record<string, any>) => Promise<any | null>;
     openBookingEdit?: (payload: Record<string, any>) => Promise<any | null>;
     confirmDetail?: (input: {

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/modules/Order/index.d.ts

@@ -4,6 +4,7 @@ import { OrderModuleAPI, CommitOrderParams, UpdateOrderBookingParams, UpdateOrde
 import { CartItem } from '../Cart/types';
 import { type SubmitPayloadEnhancer } from './utils';
 import { type PickupTimingBooking, type PickupTimingBookingInput } from './pickupTiming';
+import { type ProductVoucherGroup } from './utils/productVoucherGroups';
 import type { OrderAmountSnapshot, AddProductBookingInput, AddProductToOrderOptions, OrderIdentitySnapshot, OrderPaymentSource, OrderSnapshot, OrderSyncState, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, SubmitSalesOrderParams, OrderProduct, OrderProductIdentity, OrderSummary, OrderTempOrder, OrderPaymentData, OrderPaymentUpdateOptions, OrderPaymentUpdateResult, SendCustomerPayLinkParams, UpdateTempOrderCustomerInput, OrderCustomerPatch, OrderCustomerView, OrderHooksConfig, OrderCartIntentCommitContext, ReplaceTempOrderOptions, OrderPromotionEvaluator, OrderGiftSelectResolver, OrderUnfulfilledPromotion, OrderLastGiftActions, RemoveProductsFromOrderOptions, SalesNote, SalesNotesMutationSnapshot, SetSalesNoteInput, PickupReferenceMode, PointCardSnapshotMergeContext, PointCardSnapshotItem, ShopServiceData, ShopServiceType } from './types';
 import type { ICustomer } from '../AccountList/types';
 import type { Discount } from '../Discount/types';
@@ -94,6 +95,8 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
      */
     private logError;
     private registerDiscountModules;
+    setProductVoucherGroups(groups: ProductVoucherGroup[]): void;
+    validateProductVoucherSelection(): void;
     private createDefaultRulesHooks;
     /**
      * Stable across notifyTempOrderChanged's immutable copy, but changes when a
@@ -112,7 +115,9 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     getCustomerWalletPrepareConfigEpoch(): number;
     private syncScannedDiscountsToOriginalDiscountList;
     private ensureEditDiscountConfigForProductChange;
-    scanCode(code: string, customerId?: number): Promise<{
+    scanCode(code: string, customerId?: number, options?: {
+        productVouchersOnly?: boolean;
+    }): Promise<{
         isAvailable: boolean;
         isAccepted?: boolean;
         discountList: Discount[];

package/lib/modules/Order/index.js

@@ -20,6 +20,7 @@ var _weighedProduct = require("./utils/weighedProduct");
 var _pickupTiming = require("./pickupTiming");
 var _dayjs = _interopRequireDefault(require("dayjs"));
 var _availability = require("../Discount/availability");
+var _productVoucherGroups = require("./utils/productVoucherGroups");
 var _osPrivatePayload = require("../../utils/os-private-payload");
 var _salesNotes = require("./salesNotes");
 var _paymentUtils = require("./payment-utils");
@@ -148,7 +149,7 @@ class OrderModule extends _BaseModule.BaseModule {
   orderHooks;
   cartCommandQueue = Promise.resolve();
   queueCartCommand(run) {
-    if (!this.orderHooks?.onBeforeCartCommit) return run();
+    if (!this.orderHooks?.onBeforeCartCommit && !this.store.tempOrder?._extend?.productVoucherGroups?.length) return run();
     const pending = this.cartCommandQueue.then(run, run);
     this.cartCommandQueue = pending.catch(() => undefined);
     return pending;
@@ -158,7 +159,7 @@ class OrderModule extends _BaseModule.BaseModule {
   beginCartMutation() {
     const current = this.ensureTempOrder();
     const guard = this.orderHooks?.onBeforeCartCommit;
-    if (!guard) return {
+    if (!guard && !current._extend?.productVoucherGroups?.length) return {
       current,
       draft: current,
       commit: undefined
@@ -169,7 +170,8 @@ class OrderModule extends _BaseModule.BaseModule {
       current,
       draft,
       commit: async beforeCommit => {
-        await guard({
+        (0, _productVoucherGroups.validateProductVoucherGroups)(draft, this.getDiscountList(), before);
+        await guard?.({
           currentItems: (0, _lodashEs.cloneDeep)(before.products),
           proposedItems: (0, _lodashEs.cloneDeep)(draft.products)
         });
@@ -190,6 +192,7 @@ class OrderModule extends _BaseModule.BaseModule {
   async prepareCheckout(prepare) {
     const run = async () => {
       const order = this.ensureTempOrder();
+      (0, _productVoucherGroups.validateProductVoucherGroups)(order, this.getDiscountList(), undefined, true);
       const items = (0, _lodashEs.cloneDeep)(order.products);
       const result = await prepare(items);
       if (this.store.tempOrder !== order || !(0, _lodashEs.isEqual)(order.products, items)) {
@@ -197,6 +200,7 @@ class OrderModule extends _BaseModule.BaseModule {
           code: 'SALES_GUARD_REJECTED'
         });
       }
+      (0, _productVoucherGroups.validateProductVoucherGroups)(order, this.getDiscountList(), undefined, true);
       return result;
     };
     const pending = this.cartCommandQueue.then(run, run);
@@ -601,6 +605,26 @@ class OrderModule extends _BaseModule.BaseModule {
       hooks: this.rulesHooksOverride || this.createDefaultRulesHooks()
     });
     this.store.rules = rules;
+    rules.setDiscountScope((product, discount) => (0, _productVoucherGroups.allowsProductVoucher)(this.store.tempOrder, product, discount));
+  }
+  setProductVoucherGroups(groups) {
+    const order = this.ensureTempOrder();
+    const ids = new Set();
+    const keys = new Set();
+    const known = new Map(this.getDiscountList().map(discount => [String(discount.id), discount]));
+    for (const group of groups) {
+      if (!group.key || keys.has(group.key)) throw (0, _productVoucherGroups.voucherGroupError)();
+      keys.add(group.key);
+      for (const id of group.discountIds) {
+        const discount = known.get(String(id));
+        if (!discount || (discount.tag || discount.type) !== 'good_pass' || ids.has(String(id))) throw (0, _productVoucherGroups.voucherGroupError)();
+        ids.add(String(id));
+      }
+    }
+    this.ensureExtend(order).productVoucherGroups = (0, _lodashEs.cloneDeep)(groups);
+  }
+  validateProductVoucherSelection() {
+    (0, _productVoucherGroups.validateProductVoucherGroups)(this.ensureTempOrder(), this.getDiscountList(), undefined, true);
   }
   createDefaultRulesHooks() {
     return (0, _utils.createDefaultOrderRulesHooks)(() => this.store.tempOrder?.bookings || [], () => this.store.tempOrder?.holder_relations);
@@ -752,7 +776,7 @@ class OrderModule extends _BaseModule.BaseModule {
       apply: false
     });
   }
-  async scanCode(code, customerId) {
+  async scanCode(code, customerId, options) {
     const beforeCommit = this.createCartIntentCommitGuard('scan_promotion');
     if (this.isActiveVirtualSettlementOrder(this.store.tempOrder)) {
       return {
@@ -764,16 +788,22 @@ class OrderModule extends _BaseModule.BaseModule {
         unavailableReason: _types2.UnavailableReason.ProductNotApplicable
       };
     }
+    const scanOrderKey = this.getDiscountConfigOrderIdentityKey(this.store.tempOrder);
     const resultDiscountWithReason = (await this.store.discount?.batchSearch(code, {
       customerId
     })) || {
       discountList: [],
       unavailableReasonKey: null
     };
+    if (scanOrderKey !== this.getDiscountConfigOrderIdentityKey(this.store.tempOrder)) {
+      throw Object.assign(new Error('The scan session ended.'), {
+        code: 'SALES_GUARD_REJECTED'
+      });
+    }
     const {
-      discountList: resultDiscountList,
       unavailableReasonKey
     } = resultDiscountWithReason;
+    const resultDiscountList = resultDiscountWithReason.discountList.filter(discount => !options?.productVouchersOnly || (discount.tag || discount.type) === 'good_pass');
     const rulesModule = this.store.rules;
     if (!rulesModule) {
       return {
@@ -800,7 +830,7 @@ class OrderModule extends _BaseModule.BaseModule {
       isScan: true
     }));
     const currentSelected = this.getDiscountList().filter(n => n.isSelected);
-    if (currentSelected.length && currentSelected.some(n => withScanList.some(m => m.id === n.id))) {
+    if (currentSelected.length && (options?.productVouchersOnly ? withScanList.every(scanned => currentSelected.some(selected => selected.id === scanned.id)) : currentSelected.some(n => withScanList.some(m => m.id === n.id)))) {
       beforeCommit();
       await this.syncScannedDiscountsToOriginalDiscountList(this.getDiscountList());
       return {
@@ -2307,8 +2337,12 @@ class OrderModule extends _BaseModule.BaseModule {
       ...existed,
       ...(origin !== undefined ? {
         origin
+      } : {}),
+      ...(rawProduct._productVoucherGroupKey ? {
+        productVoucherGroupKey: rawProduct._productVoucherGroupKey
       } : {})
     };
+    delete normalizedProduct._productVoucherGroupKey;
     delete normalizedProduct._origin;
     delete normalizedProduct.unique_identification_number;
   }
@@ -3602,6 +3636,7 @@ class OrderModule extends _BaseModule.BaseModule {
     const isIncomingCustomItem = productToAdd.metadata?.origin?.isCustomItem === true || productToAdd._origin?.isCustomItem === true;
     const shouldForceNewLine = disableMerge || !!booking || hasIncomingGoodPass || isIncomingPersistedEntitlementPass || hasIncomingBookingUid || hasIncomingHolder || isIncomingCustomItem || isWeighingProduct;
     const matchedIndex = shouldForceNewLine ? -1 : tempOrder.products.findIndex(item => {
+      if ((0, _productVoucherGroups.productVoucherGroupKey)(tempOrder, item) !== productToAdd._productVoucherGroupKey) return false;
       if (this.hasGoodPassDiscount(item)) return false;
       if ((0, _holderRelations.getProductHolderRelations)(tempOrder, item).length > 0 || (0, _utils.hasAssignedHolderId)(item.metadata?.holder_id)) return false;
       const isRuntimeEntitlementPass = this.isRuntimeEntitlementAppend(item, tempOrder);
@@ -3791,6 +3826,13 @@ class OrderModule extends _BaseModule.BaseModule {
     const mutation = this.beginCartMutation();
     let tempOrder = mutation.draft;
     const beforeCommit = this.createCartIntentCommitGuard('add_product', mutation.current);
+    if (options?.productVoucherGroupKey) {
+      if (!tempOrder._extend?.productVoucherGroups?.some(group => group.key === options.productVoucherGroupKey)) throw (0, _productVoucherGroups.voucherGroupError)();
+      product = {
+        ...product,
+        _productVoucherGroupKey: options.productVoucherGroupKey
+      };
+    }
     const salesNoteDrafts = (options?.salesNotes || []).map(draft => ({
       note_type: String(draft.note_type || '').trim(),
       text: {
@@ -4734,6 +4776,7 @@ class OrderModule extends _BaseModule.BaseModule {
   }
   async runSubmitTempOrder(params) {
     const tempOrder = this.ensureTempOrder();
+    (0, _productVoucherGroups.validateProductVoucherGroups)(tempOrder, this.getDiscountList(), undefined, true);
     this.prepareVirtualSettlementTempOrder(tempOrder);
     const isOnlineStorePlatform = this.isOnlineStorePlatform();
     const shouldConfirmPendingVoucherPayments = params?.confirmPendingVoucherPayments !== false;

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

@@ -456,6 +456,8 @@ export type AddProductBookingInput = Record<string, any>;
  * 避免步进器修改数量改变该组展示位置。
  */
 export interface AddProductToOrderOptions {
+    /** Associates a selection with an existing runtime voucher group. */
+    productVoucherGroupKey?: string;
     insertAfterProductUid?: string;
     /** 跳过同商品/规格匹配，始终新增购物车行。 */
     disableMerge?: boolean;

package/lib/modules/Order/utils/discountProductLineIdentity.js

@@ -241,7 +241,7 @@ function consolidateDiscountFreeProductLines(tempOrder) {
         bundle_selling_price: String(bundle?.bundle_selling_price ?? '')
       }))
     });
-    const mergeKey = [discountSplitOriginUid, product.product_id, product.product_variant_id ?? 0, fingerprint, priceSignature].join('#');
+    const mergeKey = [discountSplitOriginUid, productUid ? tempOrder._extend?.productsByUid?.[productUid]?.productVoucherGroupKey ?? '' : '', product.product_id, product.product_variant_id ?? 0, fingerprint, priceSignature].join('#');
     const matchedIndex = productIndexByKey.get(mergeKey);
 
     // 当前拆分来源 + 商品结构组合第一次出现时，保留该行作为回并目标。

package/lib/modules/Order/utils/productVoucherGroups.d.ts

@@ -0,0 +1,15 @@
+import type { Discount } from '../../Discount/types';
+import type { OrderTempOrder } from '../types';
+/** Runtime-only allocation constraints. Never copied into order/product metadata. */
+export interface ProductVoucherGroup {
+    key: string;
+    discountIds: Array<number | string>;
+}
+export declare function productVoucherGroupKey(order: OrderTempOrder, product: any): string | undefined;
+export declare function isUsableProductVoucher(discount: Discount): boolean;
+export declare function voucherGroupError(): Error & {
+    code: string;
+};
+export declare function allowsProductVoucher(order: OrderTempOrder | null | undefined, product: any, discount: Discount): boolean;
+/** Reductions stay possible when a voucher expires; checkout always requires full coverage. */
+export declare function validateProductVoucherGroups(order: OrderTempOrder, discounts: Discount[], previous?: OrderTempOrder, requireCoverage?: boolean): void;

package/lib/modules/Order/utils/productVoucherGroups.js

@@ -0,0 +1,64 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.allowsProductVoucher = allowsProductVoucher;
+exports.isUsableProductVoucher = isUsableProductVoucher;
+exports.productVoucherGroupKey = productVoucherGroupKey;
+exports.validateProductVoucherGroups = validateProductVoucherGroups;
+exports.voucherGroupError = voucherGroupError;
+var _availability = require("../../Discount/availability");
+var _dayjs = _interopRequireDefault(require("dayjs"));
+var _utils = require("../../../solution/ShopDiscount/utils");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+/** Runtime-only allocation constraints. Never copied into order/product metadata. */
+
+function productVoucherGroupKey(order, product) {
+  const uid = product?.metadata?.unique_identification_number ?? product?.unique_identification_number;
+  return order._extend?.productsByUid?.[String(uid)]?.productVoucherGroupKey;
+}
+function isUsableProductVoucher(discount) {
+  return (discount.tag || discount.type) === 'good_pass' && !discount.isEditMode && !discount.isDisabled && !(0, _availability.getDiscountUsageBlockReason)(discount) && !(0, _utils.getDiscountTimeUnavailableReason)(discount, (0, _dayjs.default)().format('YYYY-MM-DD HH:mm:ss'));
+}
+function voucherGroupError() {
+  return Object.assign(new Error('The selected items no longer match the available vouchers. Please adjust your selection.'), {
+    code: 'PRODUCT_VOUCHER_GROUP_INVALID'
+  });
+}
+function allowsProductVoucher(order, product, discount) {
+  const groups = order?._extend?.productVoucherGroups;
+  if (!order || !groups?.length) return true;
+  const key = productVoucherGroupKey(order, product);
+  if (!key) return !groups.some(group => group.discountIds.some(id => String(id) === String(discount.id)));
+  return (discount.tag || discount.type) === 'good_pass' && Boolean(groups.find(group => group.key === key)?.discountIds.some(id => String(id) === String(discount.id)));
+}
+
+/** Reductions stay possible when a voucher expires; checkout always requires full coverage. */
+function validateProductVoucherGroups(order, discounts, previous, requireCoverage = false) {
+  const groups = order._extend?.productVoucherGroups;
+  if (!groups?.length) return;
+  const usedIds = new Set();
+  const byId = new Map(discounts.filter(isUsableProductVoucher).map(discount => [String(discount.id), discount]));
+  const quantity = item => Number(item.num ?? item.product_quantity ?? 0);
+  for (const group of groups) {
+    const items = order.products.filter(item => productVoucherGroupKey(order, item) === group.key);
+    const selected = items.reduce((sum, item) => sum + quantity(item), 0);
+    const before = previous?.products.filter(item => productVoucherGroupKey(previous, item) === group.key).reduce((sum, item) => sum + quantity(item), 0) ?? 0;
+    if (!requireCoverage && previous && selected <= before) continue;
+    const ids = new Set(group.discountIds.map(String).filter(id => byId.has(id)));
+    if (!Number.isInteger(selected) || selected < 0 || selected > ids.size) throw voucherGroupError();
+    if (!requireCoverage) continue;
+    for (const item of items) {
+      const applied = (item.discount_list || []).filter(entry => (entry.type || entry.tag) === 'good_pass');
+      // Rules splits a good_pass allocation into one physical line per instance.
+      const id = String(applied[0]?.discount?.resource_id ?? '');
+      const voucher = byId.get(id);
+      if (quantity(item) !== 1 || applied.length !== 1 || !ids.has(id) || !voucher?.isAvailable || voucher.config?.isAvailable === false || usedIds.has(id)) throw voucherGroupError();
+      usedIds.add(id);
+    }
+  }
+  if (order.products.some(item => !groups.some(group => group.key === productVoucherGroupKey(order, item)))) {
+    throw voucherGroupError();
+  }
+}

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

@@ -49,5 +49,5 @@ export declare class Product extends BaseModule implements Module {
     getCategories(): ProductCategory[];
     setOtherParams(key: string, value: any): void;
     getOtherParams(): any;
-    getProductType(): "duration" | "session" | "normal";
+    getProductType(): "normal" | "duration" | "session";
 }

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

@@ -9,6 +9,8 @@ export declare class RulesModule extends BaseModule implements Module, RulesModu
     private store;
     window: WindowPlugin;
     private hooks;
+    private discountScope?;
+    setDiscountScope(scope: (product: any, discount: Discount) => boolean): void;
     constructor(name?: string, version?: string);
     initialize(core: PisellCore, options?: ModuleOptions): Promise<void>;
     setRulesList(rulesList: Rules[]): Promise<void>;

package/lib/modules/Rules/index.js

@@ -20,6 +20,10 @@ class RulesModule extends _BaseModule.BaseModule {
   store;
   window; // WindowPlugin 实例
   hooks;
+  discountScope;
+  setDiscountScope(scope) {
+    this.discountScope = scope;
+  }
   constructor(name, version) {
     super(name, version);
     this.hooks = {};
@@ -722,6 +726,7 @@ class RulesModule extends _BaseModule.BaseModule {
 
     // 辅助函数：检查商品是否对某个折扣卡可用
     const checkItemApplicableForDiscount = (flatItem, discount) => {
+      if (this.discountScope && !this.discountScope(flatItem.originProduct, discount)) return false;
       if (discount.config?.isAvailable === false) return false;
       let product;
       if (flatItem.type === 'main') {
@@ -1093,6 +1098,7 @@ class RulesModule extends _BaseModule.BaseModule {
 
       // 找到适用于此商品的所有优惠券，仅考虑isSelected不为false的优惠券
       const applicableDiscounts = sortedDiscountList.filter(discount => {
+        if (this.discountScope && !this.discountScope(originProduct, discount)) return false;
         if (this.isItemRewardProductDiscount(product)) return false;
         // 🔥 检查策略可用性（针对全额抵扣卡和折扣卡）
         const discountType = discount.tag || discount.type;

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 草稿。 */
@@ -338,7 +343,9 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
         discountList: Discount[];
         originalDiscountList?: Discount[];
     }): Promise<void>;
-    scanPromotionCode(code: string, customerId?: number): Promise<BaseSalesScanCodeResult>;
+    scanPromotionCode(code: string, customerId?: number, options?: {
+        productVouchersOnly?: boolean;
+    }): Promise<BaseSalesScanCodeResult>;
     setDiscountSelected(params: {
         discountId: number;
         isSelected: boolean;
@@ -357,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;
@@ -519,6 +528,11 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     private hasSmartPricingStrategies;
     shouldRecalculateProductBookingPricesForContextChange(params: BaseSalesPriceRecalculationContextChange): boolean;
     calculateProductBookingPrices(paramsList: BaseSalesCalculateProductBookingPriceParams[]): Promise<BaseSalesProductBookingPriceResult[]>;
+    setProductVoucherGroups(groups: Array<{
+        key: string;
+        discountIds: Array<number | string>;
+    }>): void;
+    validateProductVoucherSelection(): void;
     addProductToOrder(product: Partial<BaseSalesOrderProduct> & BaseSalesOrderProductIdentity, booking?: AddProductBookingInput, options?: AddProductToOrderOptions): Promise<import("../../modules/Order/types").OrderProduct[]>;
     updateOrderProduct(params: UpdateOrderProductParams): Promise<import("../../modules/Order/types").OrderProduct[]>;
     updateOrderProducts(paramsList: UpdateOrderProductParams[]): Promise<import("../../modules/Order/types").OrderProduct[]>;

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) {
@@ -2412,10 +2434,10 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
     }
     await discountModule.setDiscountList(params.discountList);
   }
-  async scanPromotionCode(code, customerId) {
+  async scanPromotionCode(code, customerId, options) {
     try {
       if (!this.store.order) throw new Error('order 模块未初始化');
-      const raw = await this.store.order.scanCode(code, customerId);
+      const raw = await this.store.order.scanCode(code, customerId, options);
       if (raw.isAvailable) {
         await this.store.order.recalculateSummary({
           createIfMissing: true
@@ -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');
@@ -4112,6 +4143,13 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
       });
     });
   }
+  setProductVoucherGroups(groups) {
+    if (!this.store.order) throw new Error('order 模块未初始化');
+    this.store.order.setProductVoucherGroups(groups);
+  }
+  validateProductVoucherSelection() {
+    this.store.order?.validateProductVoucherSelection();
+  }
   async addProductToOrder(product, booking, options) {
     try {
       if (!this.store.order) throw new Error('order 模块未初始化');

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 | 2 | 1 | 6 | 4 | 5 | 3;
     }[]>;
     submitTimeSlot(timeSlots: TimeSliceItem): void;
     private getScheduleDataByIds;
@@ -373,7 +373,7 @@ export declare class BookingByStepImpl extends BaseModule implements Module {
     };
     setOtherData(key: string, value: any): void;
     getOtherData(key: string): any;
-    getProductTypeById(id: number): Promise<"duration" | "session" | "normal">;
+    getProductTypeById(id: number): Promise<"normal" | "duration" | "session">;
     /**
      * 提供给 UI 的方法，减轻 UI 层的计算压力，UI 层只需要传递 cartItemId 和 resourceCode 即返回对应的 renderList
      *