@pisell/pisellos 0.0.511 → 0.0.513

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

@@ -1,21 +1,66 @@
+import Decimal from 'decimal.js';
 import { CartItem } from "../Cart";
 import type { ScanOrderSubmitPayload, ScanOrderSubmitProduct, ScanOrderSummary, ScanOrderTempOrder } from '../../solution/ScanOrder/types';
 import type { RulesParamsHooks } from '../Rules/types';
+/**
+ * 把"含 option 的主商品单价"与 bundle 合成"单行 composite 单价"。
+ *
+ * 新语义 v2 约定：
+ * - `mainPrice` 必须是**已经包含 option 的主商品单价**（即 `metadata.main_product_selling_price`
+ *   或 `metadata.main_product_original_price`），option 价格不由本函数叠加。
+ * - 套餐价：Σ((bundle.bundle_selling_price ?? bundle.price) × (bundle.num ?? bundle.quantity ?? 1))
+ *   当 `useOriginalBundle=true` 时，改用 `bundle.original_price ?? bundle.product_price ?? bundle.price`。
+ * - 返回值：保留 2 位小数的字符串，方便直接写回 `selling_price` / `original_price` 字段。
+ *
+ * 被 `normalizeOrderProduct`、Rules setProduct 钩子、各 Solution 的 setDiscountSelected 共用，
+ * 保证合成逻辑单点来源。
+ */
+export declare function composeLinePrice(params: {
+    mainPrice: string | number | null | undefined;
+    bundle?: Array<{
+        bundle_selling_price?: any;
+        price?: any;
+        num?: any;
+        quantity?: any;
+        original_price?: any;
+        product_price?: any;
+    }> | null;
+    useOriginalBundle?: boolean;
+}): string;
+/**
+ * 计算 option 单价合计：Σ(option.price × option.num)。
+ * 在新语义 v2 下，main_product_original_price = source_product_price + 本函数结果。
+ */
+export declare function sumOptionUnitPrice(options?: Array<{
+    price?: any;
+    num?: any;
+}> | null): Decimal;
 /**
  * OrderModule 默认 Rules 钩子工厂。
  *
- * 价格语义约定（订单域）：
- * - `selling_price`：券后单品单价（实际成交单价）。初次加购 = `original_price`；券应用后由 Rules 引擎更新。
- * - `original_price`：券前单品单价（店铺售价）。不承载后台划线价语义。
- * - `payment_price`：已从内部字段移除；只在出站 payload 中由 `selling_price` 派生以兼容后端。
+ * 价格语义约定（订单域，v2 composite 口径）：
+ * - `selling_price`：券后 **行 composite 单价**
+ *   = `metadata.main_product_selling_price` + Σ(bundle_selling_price × num)。
+ * - `original_price`：券前 **行 composite 单价**
+ *   = `metadata.main_product_original_price` + Σ(bundle 原价 × num)。
+ * - `metadata.source_product_price`：主商品/variant 基础价（已应用报价单），不含 option、
+ *   不含折扣。**权威源**。
+ * - `metadata.main_product_original_price` = source + Σ(option.price × option.num)（含 option、不含折扣）。
+ * - `metadata.main_product_selling_price` = main_original − 主商品券 per-unit amount（含 option、含折扣）。
+ * - `payment_price`：出站 payload 中由 `selling_price` 派生以兼容后端（composite）。
  *
- * Rules 钩子契约：
- * - `getProduct.total` = `selling_price × num`（当前成交总价）
- * - `getProduct.origin_total` = `original_price × num`（券前总价）
- * - `setProduct` 写回 `selling_price` 的优先级：
- *   1. `values.main_product_selling_price`（券应用分支，per-unit 券后主价）
- *   2. `values.price`（还原分支 `restoredPrice`、good_pass 归零）
- *   3. `values.total / num`（仅当 Rules 只给出总价时的兜底）
+ * Rules 钩子契约（hook_adapt 方案，Rules 内部保持不变）：
+ * - `getProduct.price` / `getProduct.original_price` 回传 **source-level 主价**
+ *   （`metadata.source_product_price`）。Rules 内部 `getProductTotalPrice` /
+ *   `getProductOriginTotalPrice` 会自行叠加 option + bundle，喂 source 可避免 option 双加。
+ * - `getProduct.total` = `selling_price × num`（行 composite × num），与 Rules 内部产出的
+ *   total（source + option + bundle）对齐。
+ * - `setProduct` 反向流程：把 Rules 返回的 source-level `main_product_selling_price` / `price`
+ *   加回 Σoptions，重新合成含 option 的 main_product_* 并派生 composite。
+ *   优先级：
+ *     1. `values.main_product_selling_price`（券应用分支，per-unit 券后 source-level 主价）
+ *     2. `values.price`（还原分支 `restoredPrice`、good_pass 归零）
+ *     3. `values.total / num`（仅当 Rules 只给出总价时的兜底）
  *
  * 导出为纯函数方便单测直接驱动钩子，不依赖 OrderModule 实例。
  */
@@ -74,6 +119,13 @@ export declare function buildSubmitPayload(params: {
 }): ScanOrderSubmitPayload;
 /** 加单（scanOrderMore）不应提交 booking 关联的虚拟规则商品行 */
 export declare function filterProductsForScanOrderMore(products: ScanOrderSubmitProduct[]): ScanOrderSubmitProduct[];
+/**
+ * 历史 V1 加餐结构映射器。
+ *
+ * @deprecated 加餐（`PUT /order/order/product/:id`）已改为与正常 checkout 共用
+ * `ScanOrderSubmitProduct` 新结构（见 `OrderModule.submitTempOrder` 的加餐分支）。
+ * 本函数仅保留以兼容历史接入方，未来会移除。新代码请勿再调用。
+ */
 export declare function formatV1Product(products: ScanOrderSubmitProduct[]): {
     bundle: any[];
     key: number | null;

package/lib/modules/Order/utils.js

@@ -30,6 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var utils_exports = {};
 __export(utils_exports, {
   buildSubmitPayload: () => buildSubmitPayload,
+  composeLinePrice: () => composeLinePrice,
   createDefaultOrderRulesHooks: () => createDefaultOrderRulesHooks,
   createDefaultTempOrder: () => createDefaultTempOrder,
   createEmptySummary: () => import_utils2.createEmptySummary,
@@ -43,13 +44,39 @@ __export(utils_exports, {
   mergeRelationForms: () => mergeRelationForms,
   normalizeSubmitBooking: () => normalizeSubmitBooking,
   normalizeSubmitCollectPaxValue: () => normalizeSubmitCollectPaxValue,
-  resolveSubmitCollectPax: () => resolveSubmitCollectPax
+  resolveSubmitCollectPax: () => resolveSubmitCollectPax,
+  sumOptionUnitPrice: () => sumOptionUnitPrice
 });
 module.exports = __toCommonJS(utils_exports);
 var import_dayjs = __toESM(require("dayjs"));
 var import_decimal = __toESM(require("decimal.js"));
 var import_utils = require("../../solution/ScanOrder/utils");
 var import_utils2 = require("../../solution/ScanOrder/utils");
+function composeLinePrice(params) {
+  const { mainPrice, bundle, useOriginalBundle } = params;
+  let total = new import_decimal.default(Number(mainPrice) || 0);
+  if (Array.isArray(bundle)) {
+    for (const item of bundle) {
+      const rawPrice = useOriginalBundle ? (item == null ? void 0 : item.original_price) ?? (item == null ? void 0 : item.product_price) ?? (item == null ? void 0 : item.price) : (item == null ? void 0 : item.bundle_selling_price) ?? (item == null ? void 0 : item.price);
+      const price = new import_decimal.default(Number(rawPrice) || 0);
+      const rawNum = (item == null ? void 0 : item.num) ?? (item == null ? void 0 : item.quantity) ?? 1;
+      const num = new import_decimal.default(Number(rawNum) || 0);
+      total = total.plus(price.times(num));
+    }
+  }
+  return total.toDecimalPlaces(2).toFixed(2);
+}
+function sumOptionUnitPrice(options) {
+  let total = new import_decimal.default(0);
+  if (!Array.isArray(options))
+    return total;
+  for (const opt of options) {
+    const price = new import_decimal.default(Number(opt == null ? void 0 : opt.price) || 0);
+    const num = new import_decimal.default(Number(opt == null ? void 0 : opt.num) || 0);
+    total = total.plus(price.times(num));
+  }
+  return total;
+}
 function createDefaultOrderRulesHooks() {
   const toUnitPriceString = (totalLike, num) => {
     const effectiveNum = Number(num) > 0 ? Number(num) : 1;
@@ -58,6 +85,28 @@ function createDefaultOrderRulesHooks() {
   return {
     getProduct: (product) => {
       var _a, _b, _c, _d;
+      const metadataAny = product.metadata || {};
+      const optionSum = sumOptionUnitPrice(product.product_option_item);
+      let sourcePrice;
+      if (metadataAny.source_product_price !== void 0) {
+        sourcePrice = String(metadataAny.source_product_price);
+      } else if (metadataAny.main_product_selling_price !== void 0) {
+        sourcePrice = new import_decimal.default(
+          Number(metadataAny.main_product_selling_price) || 0
+        ).minus(optionSum).toDecimalPlaces(2).toString();
+      } else {
+        sourcePrice = String(product.selling_price ?? 0);
+      }
+      let sourceOriginalPrice;
+      if (metadataAny.source_product_price !== void 0) {
+        sourceOriginalPrice = String(metadataAny.source_product_price);
+      } else if (metadataAny.main_product_original_price !== void 0) {
+        sourceOriginalPrice = new import_decimal.default(
+          Number(metadataAny.main_product_original_price) || 0
+        ).minus(optionSum).toDecimalPlaces(2).toString();
+      } else {
+        sourceOriginalPrice = sourcePrice;
+      }
       return {
         id: product.product_id,
         // Rules 引擎用 _id 作为 processedProductsMap 键；必须与购物车行级 identity 一致，
@@ -68,10 +117,15 @@ function createDefaultOrderRulesHooks() {
           product.product_option_item,
           product.product_bundle
         )}`,
-        price: product.selling_price,
+        // Rules 内部 getProductTotalPrice / getProductOriginTotalPrice 会各自再叠加 bundle + option，
+        // 所以这里必须喂 source-level（不含 option、不含 bundle、不含折扣）单价，避免双加 option。
+        price: sourcePrice,
+        // total / origin_total 使用 composite × num，跟 Rules 内部产出的 total 对齐（含 option + bundle）。
         total: new import_decimal.default(product.selling_price || 0).times(product.num || 1).toNumber(),
-        origin_total: new import_decimal.default(product.original_price || product.selling_price || 0).times(product.num || 1).toNumber(),
-        original_price: product.original_price,
+        origin_total: new import_decimal.default(
+          product.original_price || product.selling_price || 0
+        ).times(product.num || 1).toNumber(),
+        original_price: sourceOriginalPrice,
         quantity: product.num || 1,
         num: product.num || 1,
         discount_list: product.discount_list || [],
@@ -85,17 +139,37 @@ function createDefaultOrderRulesHooks() {
     },
     setProduct: (product, values) => {
       const nextNum = Number(values.quantity ?? product.num ?? 1) || 1;
-      const nextSellingPrice = values.main_product_selling_price !== void 0 ? String(values.main_product_selling_price) : values.price !== void 0 ? String(values.price) : values.total !== void 0 ? toUnitPriceString(values.total, nextNum) : product.selling_price;
+      const metadataAny = product.metadata || {};
+      const existedSource = metadataAny.source_product_price ?? product.selling_price ?? "0";
+      const nextOptions = product.product_option_item;
+      const optionSum = sumOptionUnitPrice(nextOptions);
+      const nextSourceSellingPrice = values.main_product_selling_price !== void 0 ? String(values.main_product_selling_price) : values.price !== void 0 ? String(values.price) : values.total !== void 0 ? toUnitPriceString(values.total, nextNum) : String(existedSource);
+      const nextSourceOriginalPrice = values.original_price !== void 0 ? String(values.original_price) : String(existedSource);
+      const nextMainSellingPrice = new import_decimal.default(Number(nextSourceSellingPrice) || 0).plus(optionSum).toDecimalPlaces(2).toFixed(2);
+      const nextMainOriginalPrice = new import_decimal.default(Number(nextSourceOriginalPrice) || 0).plus(optionSum).toDecimalPlaces(2).toFixed(2);
+      const nextBundle = values.bundle ?? product.product_bundle;
+      const composedSellingPrice = composeLinePrice({
+        mainPrice: nextMainSellingPrice,
+        bundle: nextBundle
+      });
+      const composedOriginalPrice = composeLinePrice({
+        mainPrice: nextMainOriginalPrice,
+        bundle: nextBundle,
+        useOriginalBundle: true
+      });
       return {
         ...product,
-        selling_price: nextSellingPrice,
-        original_price: values.original_price !== void 0 ? String(values.original_price) : product.original_price,
+        selling_price: composedSellingPrice,
+        original_price: composedOriginalPrice,
         discount_list: values.discount_list ?? product.discount_list,
         num: values.quantity ?? product.num,
-        product_bundle: values.bundle ?? product.product_bundle,
+        product_bundle: nextBundle,
         metadata: {
-          ...product.metadata || {},
-          ...values.main_product_selling_price !== void 0 ? { main_product_selling_price: String(values.main_product_selling_price) } : {}
+          ...metadataAny,
+          source_product_price: nextSourceSellingPrice,
+          main_product_selling_price: nextMainSellingPrice,
+          main_product_original_price: nextMainOriginalPrice,
+          price_schema_version: 2
         }
       };
     }
@@ -168,13 +242,67 @@ function formatSubmitOptionItems(options) {
     option_group_id: d == null ? void 0 : d.option_group_id
   }));
 }
+function toBundleNumber(value, fallback = 0) {
+  const parsed = Number(value);
+  return Number.isFinite(parsed) ? parsed : fallback;
+}
+function toBundleCustomPriceString(value) {
+  const parsed = Number(value);
+  if (Number.isFinite(parsed))
+    return parsed.toFixed(2);
+  if (value === null || value === void 0 || value === "")
+    return "0.00";
+  return String(value);
+}
 function formatSubmitBundleItems(bundle) {
   if (!Array.isArray(bundle))
     return [];
-  return bundle.map((b) => ({
-    ...b,
-    option: formatSubmitOptionItems(b == null ? void 0 : b.option)
-  }));
+  return bundle.map((b) => {
+    const rawBundle = b && typeof b === "object" ? b : {};
+    const existedMetadata = rawBundle.metadata && typeof rawBundle.metadata === "object" ? rawBundle.metadata : {};
+    const sellingPriceNum = toBundleNumber(
+      rawBundle.bundle_selling_price ?? rawBundle.price,
+      0
+    );
+    const priceNum = toBundleNumber(rawBundle.price, sellingPriceNum);
+    const priceType = rawBundle.price_type ?? "";
+    const customPriceStr = toBundleCustomPriceString(
+      rawBundle.custom_price ?? rawBundle.bundle_selling_price ?? rawBundle.price
+    );
+    const relationSurchargeIds = Array.isArray(rawBundle.relation_surcharge_ids) ? rawBundle.relation_surcharge_ids : Array.isArray(existedMetadata.relation_surcharge_ids) ? existedMetadata.relation_surcharge_ids : [];
+    const surchargeFee = toBundleNumber(
+      rawBundle.surcharge_fee ?? existedMetadata.surcharge_fee,
+      0
+    );
+    const productDiscountDifference = toBundleNumber(
+      existedMetadata.product_discount_difference,
+      0
+    );
+    return {
+      ...rawBundle,
+      is_charge_tax: rawBundle.is_charge_tax ?? 0,
+      tax_fee: toBundleNumber(rawBundle.tax_fee, 0),
+      bundle_variant_id: rawBundle.bundle_variant_id ?? 0,
+      num: toBundleNumber(rawBundle.num, 1),
+      extension_id: rawBundle.extension_id ?? 0,
+      extension_type: rawBundle.extension_type ?? "normal",
+      price: priceNum,
+      price_type: priceType,
+      price_type_ext: rawBundle.price_type_ext ?? "",
+      custom_price: customPriceStr,
+      custom_price_type: rawBundle.custom_price_type ?? priceType ?? "",
+      bundle_selling_price: sellingPriceNum,
+      option: formatSubmitOptionItems(rawBundle.option),
+      bundle_group_id: rawBundle == null ? void 0 : rawBundle.group_id,
+      bundle_id: rawBundle == null ? void 0 : rawBundle.id,
+      metadata: {
+        ...existedMetadata,
+        surcharge_fee: surchargeFee,
+        relation_surcharge_ids: relationSurchargeIds,
+        product_discount_difference: productDiscountDifference
+      }
+    };
+  });
 }
 function normalizeSubmitProduct(product) {
   const { _origin, identity_key, ...submitProduct } = product;
@@ -187,7 +315,8 @@ function normalizeSubmitProduct(product) {
   const priceMetaKeys = [
     "main_product_original_price",
     "main_product_selling_price",
-    "source_product_price"
+    "source_product_price",
+    "price_schema_version"
   ];
   for (const key of priceMetaKeys) {
     if (rawMetadata[key] !== void 0) {
@@ -207,7 +336,8 @@ function normalizeSubmitProduct(product) {
     discount_list: submitProduct.discount_list || [],
     product_bundle: formatSubmitBundleItems(submitProduct.product_bundle),
     metadata: cleanMetadata,
-    // 出站兼容：后端仍消费 payment_price 字段，从 selling_price（券后单价）派生。
+    // 出站兼容：后端消费 payment_price 字段，这里从 selling_price 直接派生。
+    // 新语义下 selling_price 是 composite（含 option/bundle），payment_price 同语义。
     payment_price: submitProduct.selling_price
   };
 }
@@ -416,6 +546,7 @@ function formatV1Product(products) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   buildSubmitPayload,
+  composeLinePrice,
   createDefaultOrderRulesHooks,
   createDefaultTempOrder,
   createEmptySummary,
@@ -429,5 +560,6 @@ function formatV1Product(products) {
   mergeRelationForms,
   normalizeSubmitBooking,
   normalizeSubmitCollectPaxValue,
-  resolveSubmitCollectPax
+  resolveSubmitCollectPax,
+  sumOptionUnitPrice
 });

package/lib/modules/SalesSummary/utils.js

@@ -48,30 +48,6 @@ function getSafeNum(num) {
     return 1;
   return Math.floor(num);
 }
-function getVariantPrice(product) {
-  var _a, _b;
-  const variantId = Number(product.product_variant_id || 0);
-  if (!variantId)
-    return null;
-  const metadataVariantList = (_b = (_a = product.metadata) == null ? void 0 : _a.origin) == null ? void 0 : _b.variant;
-  if (Array.isArray(metadataVariantList)) {
-    const variant = metadataVariantList.find(
-      (item) => Number(item.id) === variantId
-    );
-    if ((variant == null ? void 0 : variant.price) !== void 0 && (variant == null ? void 0 : variant.price) !== null) {
-      return toDecimal(variant.price);
-    }
-  }
-  return null;
-}
-function getOptionUnitPrice(product) {
-  const optionItems = product.product_option_item || [];
-  return optionItems.reduce((sum, item) => {
-    const quantity = getSafeNum(item == null ? void 0 : item.num);
-    const itemPrice = toDecimal(item == null ? void 0 : item.price);
-    return sum.plus(itemPrice.times(quantity));
-  }, new import_decimal.default(0));
-}
 function getBundleUnitPrice(product, useOriginal = false) {
   const bundleItems = product.product_bundle || [];
   return bundleItems.reduce((sum, item) => {
@@ -81,13 +57,18 @@ function getBundleUnitPrice(product, useOriginal = false) {
   }, new import_decimal.default(0));
 }
 function getUnitPaymentTotal(product) {
-  const variantPrice = getVariantPrice(product);
-  const basePrice = variantPrice || toDecimal(product.selling_price);
-  return basePrice.plus(getOptionUnitPrice(product)).plus(getBundleUnitPrice(product));
+  var _a, _b;
+  const mainSelling = (_a = product.metadata) == null ? void 0 : _a.main_product_selling_price;
+  const mainOriginal = (_b = product.metadata) == null ? void 0 : _b.main_product_original_price;
+  const basePrice = mainSelling !== void 0 ? toDecimal(mainSelling) : mainOriginal !== void 0 ? toDecimal(mainOriginal) : toDecimal(product.selling_price);
+  return basePrice.plus(getBundleUnitPrice(product));
 }
 function getUnitOriginalTotal(product) {
-  const basePrice = toDecimal(product.original_price || product.selling_price);
-  return basePrice.plus(getOptionUnitPrice(product)).plus(getBundleUnitPrice(product, true));
+  var _a, _b;
+  const mainOriginal = (_a = product.metadata) == null ? void 0 : _a.main_product_original_price;
+  const mainSelling = (_b = product.metadata) == null ? void 0 : _b.main_product_selling_price;
+  const basePrice = mainOriginal !== void 0 ? toDecimal(mainOriginal) : mainSelling !== void 0 ? toDecimal(mainSelling) : toDecimal(product.original_price || product.selling_price);
+  return basePrice.plus(getBundleUnitPrice(product, true));
 }
 function buildSurchargeServiceItems(products) {
   return products.map((product) => {
@@ -207,12 +188,6 @@ function isBundleMarkupOrDiscount(item) {
   const isDiscount = (item == null ? void 0 : item.price_type) === "markdown" && ((item == null ? void 0 : item.price_type_ext) === "" || !(item == null ? void 0 : item.price_type_ext));
   return isMarkup || isDiscount;
 }
-function getDiscountListAmount(discountList) {
-  return (discountList || []).reduce(
-    (total, d) => total.plus(toDecimal(d.amount)),
-    new import_decimal.default(0)
-  );
-}
 function calculateSingleItemTax(params) {
   const { price, taxRate, isPriceIncludeTax, isChargeTax } = params;
   if (price.lte(0))
@@ -229,22 +204,15 @@ function calculateSingleItemTax(params) {
   return price.dividedBy(divisor).times(rate);
 }
 function getMainProductPaymentTotal(product) {
-  var _a, _b, _c, _d;
-  const variantPrice = getVariantPrice(product);
-  let total = variantPrice || toDecimal(((_a = product.metadata) == null ? void 0 : _a.main_product_selling_price) ?? product.selling_price);
-  const mainDiscountList = ((_c = (_b = product._origin) == null ? void 0 : _b.product) == null ? void 0 : _c.discount_list) || ((_d = product._origin) == null ? void 0 : _d.discount_list) || [];
-  const mainDiscountAmount = getDiscountListAmount(
-    mainDiscountList.filter((d) => {
-      var _a2;
-      return !((_a2 = d == null ? void 0 : d.metadata) == null ? void 0 : _a2.custom_product_bundle_map_id);
-    })
-  );
-  total = total.minus(mainDiscountAmount);
-  total = total.plus(getOptionUnitPrice(product));
+  var _a, _b;
+  const mainSelling = ((_a = product.metadata) == null ? void 0 : _a.main_product_selling_price) ?? ((_b = product.metadata) == null ? void 0 : _b.main_product_original_price) ?? 0;
+  let total = toDecimal(mainSelling);
   const bundleItems = product.product_bundle || [];
   for (const bundleItem of bundleItems) {
     if (isBundleMarkupOrDiscount(bundleItem)) {
-      total = total.plus(toDecimal(bundleItem.bundle_selling_price ?? bundleItem.price ?? 0));
+      const unit = toDecimal(bundleItem.bundle_selling_price ?? bundleItem.price ?? 0);
+      const qty = getSafeNum(bundleItem.num ?? bundleItem.quantity);
+      total = total.plus(unit.times(qty));
     }
   }
   return import_decimal.default.max(total, 0);

package/lib/modules/Summary/utils.js

@@ -437,25 +437,11 @@ var getBundleItemIsDiscountPrice = (item) => {
 var getBundleItemIsMarkupOrDiscountPrice = (item) => {
   return getBundleItemIsMarkupPrice(item) || getBundleItemIsDiscountPrice(item);
 };
-var getDiscountAmount = (discounts) => {
-  return (discounts || []).reduce((total, discount) => {
-    return total.add(new import_decimal.default(discount.amount || 0));
-  }, new import_decimal.default(0)).toNumber();
-};
 var getMainProductTotal = (item) => {
-  var _a, _b, _c, _d, _e, _f;
-  let total = new import_decimal.default((item == null ? void 0 : item.main_product_selling_price) ?? ((_a = item == null ? void 0 : item.metadata) == null ? void 0 : _a.main_product_selling_price) ?? item.price ?? 0);
-  const discount = ((_c = (_b = item == null ? void 0 : item._origin) == null ? void 0 : _b.product) == null ? void 0 : _c.discount_list) || ((_f = (_e = (_d = item == null ? void 0 : item._originData) == null ? void 0 : _d.product) == null ? void 0 : _e.discount_list) == null ? void 0 : _f.filter((item2) => {
-    var _a2;
-    return !((_a2 = item2 == null ? void 0 : item2.metadata) == null ? void 0 : _a2.custom_product_bundle_map_id);
-  })) || [];
-  const mainProductDiscountAmount = getDiscountAmount(discount);
-  total = total.minus(mainProductDiscountAmount);
-  if ((item == null ? void 0 : item.option) && Array.isArray(item == null ? void 0 : item.option)) {
-    total = total.add(item == null ? void 0 : item.option.reduce((t, option) => {
-      return t.add(new import_decimal.default(option.price || 0).mul(option.num || 1));
-    }, new import_decimal.default(0)));
-  }
+  var _a, _b;
+  let total = new import_decimal.default(
+    (item == null ? void 0 : item.main_product_selling_price) ?? ((_a = item == null ? void 0 : item.metadata) == null ? void 0 : _a.main_product_selling_price) ?? ((_b = item == null ? void 0 : item.metadata) == null ? void 0 : _b.main_product_original_price) ?? 0
+  );
   for (let bundleItem of (item == null ? void 0 : item.bundle) || []) {
     if (getBundleItemIsMarkupOrDiscountPrice(bundleItem)) {
       const bundleItemTotal = new import_decimal.default(bundleItem.bundle_selling_price ?? bundleItem.price ?? 0);

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

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

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

@@ -131,7 +131,7 @@ export declare class BookingTicketImpl extends BaseModule implements Module {
      * 获取当前的客户搜索条件
      * @returns 当前搜索条件
      */
-    getCurrentCustomerSearchParams(): Omit<import("../../modules").ShopGetCustomerListParams, "num" | "skip">;
+    getCurrentCustomerSearchParams(): Omit<import("../../modules").ShopGetCustomerListParams, "skip" | "num">;
     /**
      * 获取客户列表状态（包含滚动加载相关状态）
      * @returns 客户状态

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

@@ -49,6 +49,9 @@ export declare class ScanOrderImpl extends BaseModule implements Module {
     private registerCustomerLoginListeners;
     private refreshOrderMarketingAfterLogin;
     constructor(name?: string, version?: string);
+    /** 与 `otherParams.cacheId` 一致，供宿主在 URL 变化时判断是否需要重新注册模块 */
+    getCacheId(): string | undefined;
+    private destroyRegisteredChildModules;
     initialize(core: PisellCore, options?: ModuleOptions): Promise<void>;
     destroy(): Promise<void>;
     retryInit(): Promise<void>;

package/lib/solution/ScanOrder/index.js

@@ -260,6 +260,23 @@ var _ScanOrderImpl = class extends import_BaseModule.BaseModule {
       }
     }
   }
+  /** 与 `otherParams.cacheId` 一致，供宿主在 URL 变化时判断是否需要重新注册模块 */
+  getCacheId() {
+    return this.cacheId;
+  }
+  async destroyRegisteredChildModules() {
+    const modules = [
+      this.store.schedule,
+      this.store.salesSummary,
+      this.store.order,
+      this.store.products,
+      this.store.scanOrderLogger
+    ];
+    for (const mod of modules) {
+      if (mod && typeof mod.destroy === "function")
+        await Promise.resolve(mod.destroy());
+    }
+  }
   async initialize(core, options = {}) {
     var _a, _b, _c, _d, _e, _f;
     this.logMethodStart("initialize");
@@ -375,6 +392,8 @@ var _ScanOrderImpl = class extends import_BaseModule.BaseModule {
     this.logMethodStart("destroy");
     this.clearLoginEffectListeners();
     await this.core.effects.emit(import_types.ScanOrderHooks.onDestroy, {});
+    await this.destroyRegisteredChildModules();
+    super.destroy();
     console.log("[ScanOrder] 已销毁");
     this.logMethodSuccess("destroy");
   }
@@ -626,7 +645,7 @@ var _ScanOrderImpl = class extends import_BaseModule.BaseModule {
     }
   }
   async setDiscountSelected(params) {
-    var _a, _b, _c;
+    var _a, _b, _c, _d, _e;
     this.logMethodStart("setDiscountSelected", params);
     try {
       if (!this.store.order)
@@ -691,11 +710,18 @@ var _ScanOrderImpl = class extends import_BaseModule.BaseModule {
           (sum, pd) => sum + (pd.amount || 0),
           0
         );
-        const newSellingPrice = new import_decimal.default(product.original_price || 0).minus(totalPerUnitDiscount).toDecimalPlaces(2).toString();
-        product.selling_price = newSellingPrice;
+        const optionSum = (0, import_utils2.sumOptionUnitPrice)(product.product_option_item);
+        const sourcePrice = ((_d = product.metadata) == null ? void 0 : _d.source_product_price) ?? (((_e = product.metadata) == null ? void 0 : _e.main_product_original_price) != null ? new import_decimal.default(Number(product.metadata.main_product_original_price) || 0).minus(optionSum).toFixed(2) : product.original_price ?? "0");
+        const newSourceSellingPrice = new import_decimal.default(Number(sourcePrice) || 0).minus(totalPerUnitDiscount).toDecimalPlaces(2).toString();
+        const newMainSellingPrice = new import_decimal.default(Number(newSourceSellingPrice) || 0).plus(optionSum).toDecimalPlaces(2).toFixed(2);
         if (product.metadata) {
-          product.metadata.main_product_selling_price = newSellingPrice;
+          product.metadata.main_product_selling_price = newMainSellingPrice;
+          product.metadata.price_schema_version = 2;
         }
+        product.selling_price = (0, import_utils2.composeLinePrice)({
+          mainPrice: newMainSellingPrice,
+          bundle: product.product_bundle
+        });
       }
       import_Order.OrderModule.populateSavedAmounts(tempOrder.products, nextDiscountList);
       await (discountModule == null ? void 0 : discountModule.setDiscountList(nextDiscountList));

package/lib/solution/ScanOrder/types.d.ts

@@ -39,14 +39,39 @@ export interface ScanOrderOrderProduct extends ScanOrderOrderProductIdentity {
     order_detail_id: number | null;
     num: number;
     product_option_item: any[];
-    /** 券后单品单价（= 订单域实际成交单价）。未应用券时等同 original_price。 */
+    /**
+     * 券后 **行 composite 单价** = `metadata.main_product_selling_price`
+     *   + Σ((bundle.bundle_selling_price ?? bundle.price) × (bundle.num ?? 1))
+     *
+     * 新语义 v2 下 `metadata.main_product_selling_price` 已经**含 option**、含主商品折扣，
+     * 因此本字段不再叠加 option。未应用券时等同 `original_price`。
+     * Rules 钩子、主商品计税、Summary 统一读 metadata，不以此字段反推。
+     */
     selling_price: string;
-    /** 券前单品单价（= 店铺售价），不承载后台划线价语义。 */
+    /**
+     * 券前 **行 composite 单价** = `metadata.main_product_original_price`
+     *   + Σ(bundle 原价 × num)
+     *
+     * 新语义 v2 下 `metadata.main_product_original_price` 已经**含 option**、不含折扣。
+     * 不承载后台划线价语义。
+     */
     original_price: string;
     tax_fee: string;
     is_charge_tax: number;
     discount_list: any[];
     product_bundle: any[];
+    /**
+     * 行级扩展 metadata。价格相关的权威字段：
+     *
+     * - `source_product_price`：主商品/variant 基础价（已应用报价单），**不含 option、不含折扣**。
+     *   是派生 `main_product_*` 的唯一源。variant 分支优先读 `metadata.origin.variant[vid].price`。
+     * - `main_product_original_price` = `source_product_price + Σ(option.price × option.num)`，
+     *   **含 option、不含折扣**。
+     * - `main_product_selling_price` = `main_product_original_price − 主商品券 per-unit amount`，
+     *   **含 option、含主商品折扣**。Rules 钩子 / Summary / 计税均以此为主商品权威源。
+     * - `price_schema_version`（当前 = 2）：schema 版本 sentinel，用于跨端协商价格口径、
+     *   区分 v1 旧缓存以便 `normalizeOrderProduct` 触发迁移。
+     */
     metadata: Record<string, any>;
     /** 商品行备注（如顾客对单品的特殊要求） */
     note?: string;
@@ -68,6 +93,8 @@ export interface ScanOrderSubmitProduct extends Omit<ScanOrderOrderProduct, '_or
     /**
      * 出站兼容字段：SDK 内部不再消费 payment_price，
      * 仅在提交后端时由 selling_price 派生，保持原有后端契约。
+     * 新语义 v2 下 selling_price 是 composite（含 option、含 bundle、含主商品折扣），
+     * 因此 payment_price 同样是 composite。
      */
     payment_price: string;
 }

package/lib/solution/ScanOrder/utils.d.ts

@@ -108,10 +108,26 @@ export declare function isIdentityMatch(a: ScanOrderOrderProductIdentity, b: Sca
  */
 export declare function getProductIdentityIndex(products: ScanOrderOrderProduct[], identity: ScanOrderOrderProductIdentity): number;
 /**
- * 对外部传入的商品对象做归一化：
+ * 对外部传入的商品对象做归一化（v2 composite 语义）：
  * - 补全可选字段默认值（未传则使用兜底值，避免后续计算时因 undefined 导致异常）
  * - 对 num 调用 getSafeProductNum 做安全处理
  * - 保留 _origin 供后续业务流程（如促销规则）使用
+ *
+ * 价格字段语义（metadata 权威源 + composite 派生）：
+ * - `metadata.source_product_price`：主商品/variant 基础价（已应用报价单），**不含 option**、
+ *   **不含折扣**。是推导 main_product_* 的起点。variant 分支优先读 `metadata.origin.variant[vid].price`。
+ * - `metadata.main_product_original_price`：`source + Σ(option.price × option.num)`，**含 option**、
+ *   **不含折扣**。
+ * - `metadata.main_product_selling_price`：`main_product_original_price - 主商品券 per-unit amount`，
+ *   **含 option**、**含折扣**。
+ * - 行级 `selling_price` = `main_product_selling_price + Σ(bundle_selling_price × num)`。
+ * - 行级 `original_price` = `main_product_original_price + Σ(bundle 原价 × num)`。
+ *
+ * 迁移与幂等：
+ * - `metadata.price_schema_version === 2` → 已新语义归一化，保留 main_product_* 原值（保留折扣）。
+ * - 其它情况（v1 / 缺字段 / 无 metadata）→ 按"main_product_selling_price 曾是 main-only"的旧约定
+ *   反推 legacyDiscount，再以新 source + options 基准重算。最终统一打上 `price_schema_version: 2`。
+ * - 因此多次 normalize 不会重复叠加 option/bundle。
  */
 export declare function normalizeOrderProduct(product: Partial<ScanOrderOrderProduct> & ScanOrderOrderProductIdentity): ScanOrderOrderProduct;
 /**
@@ -127,7 +143,7 @@ export declare function hasCustomCapacityProduct(products: ProductData[]): boole
 /**
  * 根据预约规则商品的 resource.type 计算桌台是否已被"占满"。
  * - single：只要有 `lastOrderId` 即视为占用
- * - multiple：当前时间落在 `capacity_list[i]` 的 `[start_at, end_at]`（inclusive）内的 pax 之和 > 总容量
+ * - multiple：当前时间落在 `capacity_list[i]` 的 `[start_at, end_at]`（inclusive）内的 pax 之和 >= 总容量
  * - 其他（'capacity' / undefined）：返回 false，不施加限制
  */
 export declare function computeResourceIsFull(params: {