@pisell/pisellos 0.0.568 → 0.0.570

package/lib/modules/SalesSummary/utils.js

@@ -7,6 +7,7 @@ exports.calculateSalesSummary = calculateSalesSummary;
 exports.createEmptySalesSummary = createEmptySalesSummary;
 var _decimal = _interopRequireDefault(require("decimal.js"));
 var _utils = require("../Summary/utils");
+var _utils2 = require("../Order/utils");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 function toDecimal(value) {
   return new _decimal.default(value || 0);
@@ -14,6 +15,30 @@ function toDecimal(value) {
 function toFixed2(value) {
   return new _decimal.default(value || 0).toFixed(2);
 }
+function toAmountFormat(value) {
+  return new _decimal.default(value || 0).toDecimalPlaces(2, _decimal.default.ROUND_HALF_UP);
+}
+function toBackendTaxFee(value) {
+  return toBcScale(value, 2);
+}
+function toBcScale(value, scale) {
+  const factor = new _decimal.default(10).pow(scale);
+  return new _decimal.default(value || 0).times(factor).toDecimalPlaces(0, _decimal.default.ROUND_DOWN).div(factor);
+}
+function bcAdd(left, right, scale) {
+  return toBcScale(new _decimal.default(left || 0).plus(right || 0), scale);
+}
+function bcSub(left, right, scale) {
+  return toBcScale(new _decimal.default(left || 0).minus(right || 0), scale);
+}
+function bcMul(left, right, scale) {
+  return toBcScale(new _decimal.default(left || 0).times(right || 0), scale);
+}
+function bcDiv(left, right, scale) {
+  const divisor = new _decimal.default(right || 0);
+  if (divisor.eq(0)) return new _decimal.default(0);
+  return toBcScale(new _decimal.default(left || 0).div(divisor), scale);
+}
 function getSafeNum(num) {
   if (!num || Number.isNaN(num)) return 1;
   if (num < 1) return 1;
@@ -23,8 +48,11 @@ function getBundleUnitPrice(product, useOriginal = false) {
   const bundleItems = product.product_bundle || [];
   return bundleItems.reduce((sum, item) => {
     const quantity = getSafeNum(item?.num);
-    const price = useOriginal ? toDecimal(item?.original_price ?? item?.product_price ?? item?.price) : toDecimal(item?.bundle_selling_price ?? item?.price);
-    return sum.plus(price.times(quantity));
+    // markdown（减价）按带符号净额取减；markup/原价维持相加。
+    const signedUnit = (0, _utils2.getBundleSignedUnit)(item, {
+      useOriginal
+    });
+    return sum.plus(signedUnit.times(quantity));
   }, new _decimal.default(0));
 }
 
@@ -44,10 +72,17 @@ function getUnitOriginalTotal(product) {
   const basePrice = mainOriginal !== undefined ? toDecimal(mainOriginal) : mainSelling !== undefined ? toDecimal(mainSelling) : toDecimal(product.original_price || product.selling_price);
   return basePrice.plus(getBundleUnitPrice(product, true));
 }
+function isGeneratedVoucherProduct(product) {
+  const record = product;
+  const metadata = record?.metadata || {};
+  return record?.extension_type === 'product_voucher' || metadata.parent_order_detail_id !== undefined || metadata.gift_card_type !== undefined;
+}
 function buildSurchargeServiceItems(products) {
   return products.map(product => {
     const quantity = getSafeNum(product.num);
     const unitTotal = getUnitPaymentTotal(product);
+    const options = (0, _utils2.getProductSkuOptions)(product);
+    const persistedSurchargeFee = getPersistedMainSurchargeFee(product);
     return {
       id: product.product_id,
       num: quantity,
@@ -59,19 +94,339 @@ function buildSurchargeServiceItems(products) {
         product: {
           discount_list: product.discount_list || [],
           product_bundle: product.product_bundle || [],
-          product_option_item: product.product_option_item || []
+          product_sku: product.product_sku || {
+            option: options
+          }
         }
       },
       bundle: product.product_bundle || [],
-      option: product.product_option_item || [],
-      options: product.product_option_item || [],
+      option: options,
+      options,
       relation_details: [],
-      metadata: product.metadata || {},
+      metadata: {
+        ...(product.metadata || {}),
+        __persisted_surcharge_fee: persistedSurchargeFee?.toFixed(2)
+      },
       start_date: product.metadata?.start_date || '',
       start_time: product.metadata?.start_time || ''
     };
   });
 }
+function getRelationSurchargeIds(item) {
+  const ids = [...(Array.isArray(item?.relation_surcharge_ids) ? item.relation_surcharge_ids : []), ...(Array.isArray(item?.metadata?.relation_surcharge_ids) ? item.metadata.relation_surcharge_ids : [])];
+  return [...new Set(ids.filter(id => id !== undefined && id !== null && id !== ''))];
+}
+function getSurchargeConfigId(config) {
+  return config?.id ?? config?.surcharge_id;
+}
+function getSurchargeConfigById(surchargeList) {
+  const map = new Map();
+  for (const config of surchargeList || []) {
+    const id = getSurchargeConfigId(config);
+    if (id !== undefined) map.set(id, config);
+  }
+  return map;
+}
+function getMainSurchargeUnitAmount(product) {
+  const record = product;
+  return toDecimal(record.metadata?.main_product_attached_bundle_selling_price ?? record.metadata?.main_product_selling_price ?? record.selling_price ?? 0);
+}
+function getBundleSurchargeUnitAmount(bundle) {
+  return toDecimal(bundle?.bundle_selling_price ?? bundle?.bundle_sum_price ?? bundle?.price ?? 0);
+}
+function getBundleProductId(bundle) {
+  const id = bundle?.bundle_product_id ?? bundle?._bundle_product_id ?? bundle?.product_id;
+  if (id === undefined || id === null || id === '') return null;
+  const parsed = Number(id);
+  if (!Number.isFinite(parsed)) return null;
+  return parsed;
+}
+function getPersistedMainSurchargeFee(product) {
+  if (product?.order_detail_id === undefined || product?.order_detail_id === null) return null;
+  const value = product?.surcharge_fee ?? product?.main_product_attached_bundle_surcharge_fee ?? product?.metadata?.main_product_attached_bundle_surcharge_fee;
+  if (value === undefined || value === null || value === '') return null;
+  return toDecimal(value);
+}
+function getPersistedSourceSurchargeFee(sourceItem) {
+  const value = sourceItem?.metadata?.__persisted_surcharge_fee;
+  if (value === undefined || value === null || value === '') return null;
+  return toDecimal(value);
+}
+function getPersistedSurchargeRemainder(item, sourceItem) {
+  const value = sourceItem?.metadata?.surcharge_rounding_remainder ?? item?.surcharge_rounding_remainder ?? item?.metadata?.surcharge_rounding_remainder;
+  if (value === undefined || value === null || value === '') return null;
+  return toDecimal(value);
+}
+function getPersistedQuantity(item, fallbackQuantity) {
+  const isPersistedLine = item?.order_detail_id !== undefined && item?.order_detail_id !== null;
+  if (!isPersistedLine) return new _decimal.default(0);
+  const value = item?.product_quantity ?? item?.quantity;
+  const parsed = new _decimal.default(value || 0);
+  if (parsed.lte(0)) return _decimal.default.min(fallbackQuantity, 1);
+  return _decimal.default.min(fallbackQuantity, parsed);
+}
+function getPersistedBundleSurchargeFee(bundle, product) {
+  if (bundle?.order_detail_id === undefined && product?.order_detail_id === undefined) return null;
+  if (bundle?.order_detail_id === null && product?.order_detail_id === null) return null;
+  const value = bundle?.surcharge_fee ?? bundle?.metadata?.surcharge_fee;
+  if (value === undefined || value === null || value === '') return null;
+  return toDecimal(value);
+}
+function createSurchargeAllocationNodes(products, sourceItems) {
+  const nodes = [];
+  for (let productIndex = 0; productIndex < products.length; productIndex++) {
+    const product = products[productIndex];
+    const sourceItem = sourceItems[productIndex] || {};
+    const productQuantity = new _decimal.default(getSafeNum(product.num));
+    for (let bundleIndex = 0; bundleIndex < (product.product_bundle || []).length; bundleIndex++) {
+      const bundle = product.product_bundle[bundleIndex];
+      if (!isBundleOriginalPrice(bundle)) continue;
+      const sourceBundle = sourceItem?.bundle?.[bundleIndex] || {};
+      nodes.push({
+        kind: 'bundle',
+        target: bundle,
+        source: sourceBundle,
+        productId: getBundleProductId(bundle),
+        unitAmount: getBundleSurchargeUnitAmount(bundle),
+        quantity: new _decimal.default(getSafeNum(bundle?.num ?? bundle?.quantity)).times(productQuantity),
+        persistedQuantity: getPersistedQuantity(bundle, new _decimal.default(getSafeNum(bundle?.num ?? bundle?.quantity)).times(productQuantity)),
+        relationSurchargeIds: getRelationSurchargeIds(sourceBundle).length ? getRelationSurchargeIds(sourceBundle) : getRelationSurchargeIds(bundle),
+        persistedUnitSurchargeFee: getPersistedBundleSurchargeFee(bundle, product),
+        persistedSurchargeRemainder: getPersistedSurchargeRemainder(bundle, sourceBundle)
+      });
+    }
+    nodes.push({
+      kind: 'main',
+      target: product,
+      source: sourceItem,
+      productId: product.product_id ?? null,
+      unitAmount: getMainSurchargeUnitAmount(product),
+      quantity: productQuantity,
+      persistedQuantity: getPersistedQuantity(product, productQuantity),
+      relationSurchargeIds: getRelationSurchargeIds(sourceItem).length ? getRelationSurchargeIds(sourceItem) : getRelationSurchargeIds(product),
+      persistedUnitSurchargeFee: getPersistedSourceSurchargeFee(sourceItem) ?? getPersistedMainSurchargeFee(product),
+      persistedSurchargeRemainder: getPersistedSurchargeRemainder(product, sourceItem)
+    });
+  }
+  return nodes;
+}
+function resetProductSurchargeFields(products) {
+  for (const product of products) {
+    product.surcharge_fee = 0;
+    product.main_product_attached_bundle_surcharge_fee = '0.00';
+    product.surcharge_rounding_remainder = 0;
+    product.relation_surcharge_ids = [];
+    for (const bundle of product.product_bundle || []) {
+      bundle.surcharge_fee = 0;
+      bundle.relation_surcharge_ids = [];
+      bundle.metadata = {
+        ...(bundle.metadata || {}),
+        surcharge_fee: '0.00',
+        surcharge_rounding_remainder: '0.00',
+        relation_surcharge_ids: []
+      };
+    }
+  }
+}
+function getPersistedSurchargeIds(nodes) {
+  const ids = new Set();
+  for (const node of nodes) {
+    if (!node.persistedUnitSurchargeFee || node.persistedUnitSurchargeFee.lte(0)) continue;
+    for (const surchargeId of node.relationSurchargeIds) {
+      ids.add(surchargeId);
+    }
+  }
+  return ids;
+}
+function buildSurchargeQuantityTotals(nodes) {
+  const totals = new Map();
+  for (const node of nodes) {
+    for (const surchargeId of node.relationSurchargeIds) {
+      totals.set(surchargeId, (totals.get(surchargeId) || new _decimal.default(0)).plus(node.quantity));
+    }
+  }
+  return totals;
+}
+function getFallbackAllProductSurchargeIds(surchargeList) {
+  return (surchargeList || []).reduce((ids, config) => {
+    const id = getSurchargeConfigId(config);
+    if (id === undefined) return ids;
+    if (Number(config.open_product ?? 0) === 0) return ids;
+    if (Number(config.is_all ?? 0) !== 1) return ids;
+    if (Number(config.open_schedule ?? 0) === 1 && config.schedule_type !== 'all') return ids;
+    ids.push(id);
+    return ids;
+  }, []);
+}
+function getBackendSurchargeState(stateMap, surchargeId, config) {
+  let state = stateMap.get(surchargeId);
+  if (!state) {
+    state = {
+      config,
+      amount: new _decimal.default(0),
+      totalOffsetFee: new _decimal.default(0),
+      calculatedQuantity: new _decimal.default(0),
+      fixedIncluded: false,
+      fixedRemainderAssigned: false
+    };
+    stateMap.set(surchargeId, state);
+  }
+  return state;
+}
+function buildSurchargeResultItem(config, surchargeId, amount, index) {
+  const name = config?.name || config?.label || {};
+  return {
+    key: `custom_surcharge_${index}`,
+    label: name,
+    name,
+    value: amount.toNumber(),
+    surcharge_id: surchargeId,
+    description: config?.description,
+    type: 'default',
+    fixed: config?.fixed,
+    amount: amount.toNumber(),
+    percentage: config?.percentage,
+    metadata: {
+      open_product: config?.open_product
+    }
+  };
+}
+function applySurchargeNodeResult(node, params) {
+  const {
+    unitSurchargeFee,
+    roundingRemainder,
+    surchargeIds
+  } = params;
+  if (node.kind === 'main') {
+    node.target.surcharge_fee = unitSurchargeFee.toNumber();
+    node.target.main_product_attached_bundle_surcharge_fee = toFixed2(unitSurchargeFee);
+    node.target.surcharge_rounding_remainder = roundingRemainder.toNumber();
+    node.target.relation_surcharge_ids = surchargeIds;
+    return;
+  }
+  node.target.surcharge_fee = unitSurchargeFee.toNumber();
+  node.target.relation_surcharge_ids = surchargeIds;
+  node.target.metadata = {
+    ...(node.target.metadata || {}),
+    surcharge_fee: toFixed2(unitSurchargeFee),
+    surcharge_rounding_remainder: toFixed2(roundingRemainder),
+    relation_surcharge_ids: surchargeIds
+  };
+}
+function calculateBackendProductSurcharges(params) {
+  const {
+    products,
+    sourceItems,
+    surchargeList
+  } = params;
+  resetProductSurchargeFields(products);
+  const configById = getSurchargeConfigById(surchargeList);
+  const nodes = createSurchargeAllocationNodes(products, sourceItems);
+  const fallbackAllProductSurchargeIds = getFallbackAllProductSurchargeIds(surchargeList);
+  for (const node of nodes) {
+    if (node.relationSurchargeIds.length === 0) {
+      node.relationSurchargeIds = fallbackAllProductSurchargeIds;
+    }
+  }
+  const persistedSurchargeIds = getPersistedSurchargeIds(nodes);
+  const quantityTotals = buildSurchargeQuantityTotals(nodes);
+  const stateMap = new Map();
+  for (const node of nodes) {
+    let unitSurchargeFee = new _decimal.default(0);
+    let roundingRemainder = new _decimal.default(0);
+    const appliedSurchargeIds = [];
+    let persistedRemainderApplied = false;
+    for (const surchargeId of node.relationSurchargeIds) {
+      const config = configById.get(surchargeId);
+      const totalQuantity = quantityTotals.get(surchargeId) || new _decimal.default(0);
+      if (totalQuantity.lte(0)) continue;
+      const persistedUnitSurchargeFee = node.persistedUnitSurchargeFee;
+      if (persistedUnitSurchargeFee && persistedUnitSurchargeFee.gt(0)) {
+        const persistedQuantity = _decimal.default.min(node.persistedQuantity, node.quantity);
+        const deltaQuantity = _decimal.default.max(node.quantity.minus(persistedQuantity), 0);
+        const state = getBackendSurchargeState(stateMap, surchargeId, config || {
+          surcharge_id: surchargeId
+        });
+        const persistedSurchargeRemainder = !persistedRemainderApplied && node.persistedSurchargeRemainder ? node.persistedSurchargeRemainder : new _decimal.default(0);
+        state.amount = bcAdd(bcAdd(state.amount, bcMul(persistedUnitSurchargeFee, persistedQuantity, 2), 2), persistedSurchargeRemainder, 2);
+        const fixed = new _decimal.default(config?.fixed || 0);
+        if (fixed.gt(0)) state.fixedIncluded = true;
+        let nodeTotalSurcharge = bcAdd(bcMul(persistedUnitSurchargeFee, persistedQuantity, 2), persistedSurchargeRemainder, 2);
+        if (config && deltaQuantity.gt(0)) {
+          const percentage = new _decimal.default(config.percentage || 0);
+          const deltaUnitPercentageFee = _decimal.default.max(0, bcMul(node.unitAmount, percentage, 2));
+          const deltaSurcharge = bcMul(deltaQuantity, deltaUnitPercentageFee, 2);
+          state.amount = bcAdd(state.amount, deltaSurcharge, 2);
+          nodeTotalSurcharge = bcAdd(nodeTotalSurcharge, deltaSurcharge, 2);
+        }
+        if (node.quantity.gt(0)) {
+          unitSurchargeFee = bcAdd(unitSurchargeFee, bcDiv(nodeTotalSurcharge, node.quantity, 2), 2);
+        }
+        if (!persistedSurchargeRemainder.eq(0)) {
+          roundingRemainder = bcAdd(roundingRemainder, persistedSurchargeRemainder, 2);
+          persistedRemainderApplied = true;
+        }
+        appliedSurchargeIds.push(surchargeId);
+        continue;
+      }
+      if (!config) continue;
+      const percentage = new _decimal.default(config.percentage || 0);
+      const fixed = new _decimal.default(config.fixed || 0);
+      const unitPercentageFee = _decimal.default.max(0, bcMul(node.unitAmount, percentage, 2));
+      const percentageTotalFee = bcMul(node.quantity, unitPercentageFee, 2);
+      let unitFixedFee = new _decimal.default(0);
+      let fixedRemainder = new _decimal.default(0);
+      if (fixed.gt(0) && !persistedSurchargeIds.has(surchargeId)) {
+        unitFixedFee = bcDiv(fixed, totalQuantity, 2);
+        const distributedFixed = bcMul(unitFixedFee, totalQuantity, 2);
+        fixedRemainder = bcSub(fixed, distributedFixed, 2);
+      }
+      const currentUnitSurcharge = _decimal.default.max(0, bcAdd(unitPercentageFee, unitFixedFee, 2));
+      if (currentUnitSurcharge.lte(0)) continue;
+      const state = getBackendSurchargeState(stateMap, surchargeId, config);
+      state.amount = bcAdd(state.amount, percentageTotalFee, 2);
+      const precisePercentage = _decimal.default.max(0, bcMul(node.unitAmount, percentage, 6));
+      const offsetBaseFee = _decimal.default.max(0, bcSub(precisePercentage, unitPercentageFee, 6));
+      state.totalOffsetFee = bcAdd(state.totalOffsetFee, bcMul(offsetBaseFee, node.quantity, 6), 6);
+      state.calculatedQuantity = bcAdd(state.calculatedQuantity, node.quantity, 6);
+      if (!state.fixedIncluded && fixed.gt(0) && !persistedSurchargeIds.has(surchargeId)) {
+        state.amount = bcAdd(state.amount, fixed, 2);
+        state.fixedIncluded = true;
+      }
+      if (!state.fixedRemainderAssigned && !fixedRemainder.eq(0)) {
+        state.fixedRemainderAssigned = true;
+        roundingRemainder = bcAdd(roundingRemainder, fixedRemainder, 2);
+      }
+      if (state.calculatedQuantity.gte(totalQuantity) && state.totalOffsetFee.gt(0)) {
+        const totalOffsetFee = toAmountFormat(state.totalOffsetFee);
+        state.amount = bcAdd(state.amount, totalOffsetFee, 2);
+        roundingRemainder = bcAdd(roundingRemainder, totalOffsetFee, 2);
+        state.totalOffsetFee = new _decimal.default(0);
+      }
+      unitSurchargeFee = bcAdd(unitSurchargeFee, currentUnitSurcharge, 2);
+      appliedSurchargeIds.push(surchargeId);
+    }
+    applySurchargeNodeResult(node, {
+      unitSurchargeFee,
+      roundingRemainder,
+      surchargeIds: appliedSurchargeIds
+    });
+  }
+  const result = (surchargeList || []).reduce((items, config, index) => {
+    const surchargeId = getSurchargeConfigId(config);
+    if (surchargeId === undefined) return items;
+    const state = stateMap.get(surchargeId);
+    if (!state || state.amount.lte(0)) return items;
+    items.push(buildSurchargeResultItem(config, surchargeId, state.amount, index));
+    return items;
+  }, []);
+  const includedIds = new Set(result.map(item => item?.surcharge_id).filter(id => id !== undefined));
+  for (const [surchargeId, state] of stateMap.entries()) {
+    if (includedIds.has(surchargeId) || state.amount.lte(0)) continue;
+    result.push(buildSurchargeResultItem(state.config, surchargeId, state.amount, result.length));
+  }
+  return result;
+}
 function getProductDepositData(product) {
   const rootDepositData = product._origin?.custom_deposit_data;
   if (rootDepositData && typeof rootDepositData === 'object') return rootDepositData;
@@ -180,20 +535,20 @@ function calculateSingleItemTax(params) {
 }
 
 /**
- * 获取主商品折扣后总价（含 option、含主商品折扣、含加价/减价 bundle）。
+ * 主商品 + 非原价(加价/减价)子商品的"折扣后"售价合计（含 option、含主商品折扣，未减整单折扣）。
  *
- * 新语义 v2 下：
- * - `metadata.main_product_selling_price` 已是"含 option、含折扣"的主价，直接读即可；
- * - 无需再 `minus(mainDiscountAmount)` 或 `plus(getOptionUnitPrice)`；
- * - 仅需叠加 `markup` / `markdown` 类 bundle（原价 bundle 已由 `calculateProductsTax` 独立处理）。
+ * 对齐后端 metadata.main_product_attached_bundle_selling_price：
+ * - `metadata.main_product_selling_price` 已是"含 option、含折扣"的主价；
+ * - 叠加 `markup` / `markdown` 类 bundle（原价 bundle 由 `calculateProductsTax` 独立处理）。
  */
-function getMainProductPaymentTotal(product) {
+function getMainAttachedBundleSellingTotal(product) {
   const mainSelling = product.metadata?.main_product_selling_price ?? product.metadata?.main_product_original_price ?? 0;
   let total = toDecimal(mainSelling);
   const bundleItems = product.product_bundle || [];
   for (const bundleItem of bundleItems) {
     if (isBundleMarkupOrDiscount(bundleItem)) {
-      const unit = toDecimal(bundleItem.bundle_selling_price ?? bundleItem.price ?? 0);
+      // markdown（减价）按带符号净额取减；markup 维持相加。
+      const unit = (0, _utils2.getBundleSignedUnit)(bundleItem);
       const qty = getSafeNum(bundleItem.num ?? bundleItem.quantity);
       total = total.plus(unit.times(qty));
     }
@@ -201,21 +556,145 @@ function getMainProductPaymentTotal(product) {
   return _decimal.default.max(total, 0);
 }
 
+/**
+ * 获取主商品税费基数（含 option、含主商品折扣、含加价/减价 bundle、已减整单折扣均摊）。
+ *
+ * 对齐后端 handleMainProductTaxFee：税基使用 main_product_attached_bundle_payment_price。
+ * - 优先读取均摊层写入的 payment 价；
+ * - 兜底退化为 selling 合计（无整单折扣时两者相等）。
+ */
+function getMainProductPaymentTotal(product) {
+  const attachedPayment = product.metadata?.main_product_attached_bundle_payment_price;
+  if (attachedPayment !== undefined && attachedPayment !== null && attachedPayment !== '') {
+    return _decimal.default.max(toDecimal(attachedPayment), 0);
+  }
+  return getMainAttachedBundleSellingTotal(product);
+}
+function getExplicitTaxRemainder(item) {
+  const value = item?.tax_fee_rounding_remainder ?? item?.metadata?.tax_fee_rounding_remainder;
+  if (value === undefined || value === null || value === '') return null;
+  return new _decimal.default(value || 0);
+}
+function getPersistedTaxRemainder(item, parentProduct) {
+  const isPersistedLine = item?.order_detail_id !== undefined && item?.order_detail_id !== null || parentProduct?.order_detail_id !== undefined && parentProduct?.order_detail_id !== null;
+  if (!isPersistedLine) return null;
+  return getExplicitTaxRemainder(item);
+}
+function getPersistedMainTaxFee(product) {
+  if (product?.order_detail_id === undefined || product?.order_detail_id === null) return null;
+  const value = product?.metadata?.main_product_attached_bundle_tax_fee ?? product?.main_product_attached_bundle_tax_fee ?? product?.tax_fee;
+  if (value === undefined || value === null || value === '') return null;
+  return toDecimal(value);
+}
+function writeTaxRemainder(item, roundingRemainder) {
+  item.tax_fee_rounding_remainder = roundingRemainder.toNumber();
+  if (item.metadata && typeof item.metadata === 'object') {
+    item.metadata.tax_fee_rounding_remainder = roundingRemainder.toFixed(2);
+  }
+}
+function resetTaxRemainderFields(products) {
+  for (const product of products) {
+    const productRemainder = getPersistedTaxRemainder(product);
+    if (productRemainder !== null) {
+      product.tax_fee_rounding_remainder = productRemainder.toNumber();
+    } else {
+      delete product.tax_fee_rounding_remainder;
+    }
+    product.original_tax_fee_rounding_remainder = 0;
+    for (const bundle of product.product_bundle || []) {
+      const bundleRemainder = getPersistedTaxRemainder(bundle, product);
+      bundle.metadata = {
+        ...(bundle.metadata || {})
+      };
+      if (bundleRemainder !== null) {
+        bundle.metadata.tax_fee_rounding_remainder = bundleRemainder.toFixed(2);
+        bundle.tax_fee_rounding_remainder = bundleRemainder.toNumber();
+      } else {
+        delete bundle.metadata.tax_fee_rounding_remainder;
+        delete bundle.tax_fee_rounding_remainder;
+      }
+      bundle.original_tax_fee_rounding_remainder = 0;
+    }
+  }
+}
+function getBundlePaymentPrice(bundle, product) {
+  if (bundle?.bundle_payment_price !== undefined) return toDecimal(bundle.bundle_payment_price);
+  const basePrice = toDecimal(bundle?.bundle_selling_price ?? bundle?.bundle_sum_price ?? bundle?.price ?? 0);
+  if (!isBundleOriginalPrice(bundle)) return basePrice;
+  const averageDiscountRate = toDecimal(product.metadata?.average_discount_amount_rate ?? 1);
+  return toAmountFormat(bcMul(basePrice, averageDiscountRate, 6));
+}
+function applyBackendTaxRemainder(params) {
+  const {
+    target,
+    rawTax,
+    formattedTax,
+    quantity,
+    state
+  } = params;
+  const taxFeeDifference = bcMul(bcSub(rawTax, formattedTax, 6), quantity, 6);
+  state.difference = bcAdd(state.difference, taxFeeDifference, 6);
+  if (state.difference.lt(0.005)) return new _decimal.default(0);
+  const roundingRemainder = toAmountFormat(state.difference);
+  writeTaxRemainder(target, roundingRemainder);
+  state.difference = bcSub(state.difference, roundingRemainder, 6);
+  return roundingRemainder;
+}
+
 /**
  * 遍历所有商品计算税费，回写 tax_fee 到每个商品及 bundle 原价子商品，处理舍入差值。
  * 参照 Summary/utils.ts 的 processItemsTax，适配 SalesSummaryProduct 结构。
  */
 function calculateProductsTax(products, taxRate, isPriceIncludeTax) {
   const rate = new _decimal.default(taxRate);
-  let preciseTax = new _decimal.default(0);
-  let roundedTax = new _decimal.default(0);
-  let preciseOriginTax = new _decimal.default(0);
-  let roundedOriginTax = new _decimal.default(0);
-  let lastTaxableItem = null;
+  const taxRemainderState = {
+    difference: new _decimal.default(0)
+  };
+  let totalTax = new _decimal.default(0);
+  let totalOriginTax = new _decimal.default(0);
+  resetTaxRemainderFields(products);
   for (const product of products) {
     const quantity = new _decimal.default(getSafeNum(product.num));
-
-    // --- 主商品折后税费 ---
+    let productUnitTax = new _decimal.default(0);
+    let productUnitOriginTax = new _decimal.default(0);
+    const bundleItems = product.product_bundle || [];
+    for (const bundleItem of bundleItems) {
+      if (!isBundleOriginalPrice(bundleItem)) continue;
+      const bundleQuantity = new _decimal.default(getSafeNum(bundleItem.num ?? bundleItem.quantity));
+      const totalBundleQuantity = bundleQuantity.times(quantity);
+      const bundlePrice = getBundlePaymentPrice(bundleItem, product);
+      const bundleOriginalPrice = toDecimal(bundleItem.original_price ?? bundleItem.product_price ?? bundleItem.price ?? 0);
+      const bundleSurchargeFee = toDecimal(bundleItem.surcharge_fee);
+      const bundleTaxPrecise = calculateSingleItemTax({
+        price: bundlePrice.plus(bundleSurchargeFee),
+        taxRate: rate,
+        isPriceIncludeTax,
+        isChargeTax: bundleItem.is_charge_tax ?? product.is_charge_tax ?? 0
+      });
+      const bundleTaxRounded = toBackendTaxFee(bundleTaxPrecise);
+      bundleItem.tax_fee = bundleTaxRounded.toNumber();
+      const persistedBundleRemainder = getPersistedTaxRemainder(bundleItem, product);
+      const bundleRemainder = persistedBundleRemainder ?? applyBackendTaxRemainder({
+        target: bundleItem,
+        rawTax: bundleTaxPrecise,
+        formattedTax: bundleTaxRounded,
+        quantity: totalBundleQuantity,
+        state: taxRemainderState
+      });
+      if (persistedBundleRemainder) writeTaxRemainder(bundleItem, persistedBundleRemainder);
+      const bundleOrigTaxPrecise = calculateSingleItemTax({
+        price: bundleOriginalPrice.plus(bundleSurchargeFee),
+        taxRate: rate,
+        isPriceIncludeTax,
+        isChargeTax: bundleItem.is_charge_tax ?? product.is_charge_tax ?? 0
+      });
+      const bundleOrigTaxRounded = toAmountFormat(bundleOrigTaxPrecise);
+      bundleItem.original_tax_fee = bundleOrigTaxRounded.toNumber();
+      productUnitTax = productUnitTax.plus(bundleTaxRounded.times(bundleQuantity));
+      productUnitOriginTax = productUnitOriginTax.plus(bundleOrigTaxRounded.times(bundleQuantity));
+      totalTax = totalTax.plus(bundleTaxRounded.times(totalBundleQuantity)).plus(bundleRemainder);
+      totalOriginTax = totalOriginTax.plus(bundleOrigTaxRounded.times(totalBundleQuantity));
+    }
     const mainTotal = getMainProductPaymentTotal(product);
     const surchargeRoundingRemainder = toDecimal(product.surcharge_rounding_remainder);
     const surchargeFee = toDecimal(product.surcharge_fee).plus(quantity.gt(0) ? surchargeRoundingRemainder.div(quantity) : 0);
@@ -226,15 +705,23 @@ function calculateProductsTax(products, taxRate, isPriceIncludeTax) {
       isPriceIncludeTax,
       isChargeTax: product.is_charge_tax ?? 0
     });
-    const mainTaxRounded = mainTaxPrecise.toDecimalPlaces(2, _decimal.default.ROUND_HALF_UP);
-    if (mainTaxPrecise.gt(0)) {
-      lastTaxableItem = {
-        type: 'main',
-        item: product
-      };
+    const mainTaxRounded = toBackendTaxFee(mainTaxPrecise);
+    const persistedMainRemainder = getPersistedTaxRemainder(product);
+    const persistedMainTaxFee = getPersistedMainTaxFee(product);
+    const persistedQuantity = getPersistedQuantity(product, quantity);
+    const deltaQuantity = _decimal.default.max(quantity.minus(persistedQuantity), 0);
+    const shouldUsePersistedMainTax = persistedMainTaxFee && persistedMainTaxFee.gt(0) && persistedQuantity.gte(quantity);
+    const shouldSplitPersistedMainTax = persistedMainTaxFee && persistedMainTaxFee.gt(0) && persistedQuantity.gt(0) && deltaQuantity.gt(0);
+    const mainRemainder = shouldUsePersistedMainTax || shouldSplitPersistedMainTax ? new _decimal.default(0) : persistedMainRemainder ?? applyBackendTaxRemainder({
+      target: product,
+      rawTax: mainTaxPrecise,
+      formattedTax: mainTaxRounded,
+      quantity,
+      state: taxRemainderState
+    });
+    if (persistedMainRemainder && !shouldSplitPersistedMainTax) {
+      writeTaxRemainder(product, persistedMainRemainder);
     }
-
-    // --- 主商品原价税费 ---
     const originalTotal = getUnitOriginalTotal(product);
     const originalTaxableBase = originalTotal.lte(0) ? surchargeFee : originalTotal.plus(surchargeFee);
     const originalTaxPrecise = calculateSingleItemTax({
@@ -243,77 +730,76 @@ function calculateProductsTax(products, taxRate, isPriceIncludeTax) {
       isPriceIncludeTax,
       isChargeTax: product.is_charge_tax ?? 0
     });
-
-    // --- bundle 原价子商品独立计税 ---
-    let bundlePreciseTax = new _decimal.default(0);
-    let bundleRoundedTax = new _decimal.default(0);
-    let bundlePreciseOriginTax = new _decimal.default(0);
-    let bundleRoundedOriginTax = new _decimal.default(0);
-    const bundleItems = product.product_bundle || [];
-    for (const bundleItem of bundleItems) {
-      if (!isBundleOriginalPrice(bundleItem)) continue;
-      const bundleQuantity = new _decimal.default(getSafeNum(bundleItem.num ?? bundleItem.quantity));
-      const bundlePrice = toDecimal(bundleItem.bundle_selling_price ?? bundleItem.price ?? 0);
-      const bundleOriginalPrice = toDecimal(bundleItem.original_price ?? bundleItem.product_price ?? bundleItem.price ?? 0);
-      const bundleTaxPrecise = calculateSingleItemTax({
-        price: bundlePrice,
-        taxRate: rate,
-        isPriceIncludeTax,
-        isChargeTax: bundleItem.is_charge_tax ?? product.is_charge_tax ?? 0
-      });
-      const bundleTaxRounded = bundleTaxPrecise.toDecimalPlaces(2, _decimal.default.ROUND_HALF_UP);
-      const bundleOrigTaxPrecise = calculateSingleItemTax({
-        price: bundleOriginalPrice,
-        taxRate: rate,
-        isPriceIncludeTax,
-        isChargeTax: bundleItem.is_charge_tax ?? product.is_charge_tax ?? 0
-      });
-      const bundleOrigTaxRounded = bundleOrigTaxPrecise.toDecimalPlaces(2, _decimal.default.ROUND_HALF_UP);
-      bundleItem.tax_fee = bundleTaxRounded.toNumber();
-      bundleItem.original_tax_fee = bundleOrigTaxRounded.toNumber();
-      bundlePreciseTax = bundlePreciseTax.plus(bundleTaxPrecise.times(bundleQuantity));
-      bundleRoundedTax = bundleRoundedTax.plus(bundleTaxRounded.times(bundleQuantity));
-      bundlePreciseOriginTax = bundlePreciseOriginTax.plus(bundleOrigTaxPrecise.times(bundleQuantity));
-      bundleRoundedOriginTax = bundleRoundedOriginTax.plus(bundleOrigTaxRounded.times(bundleQuantity));
-      if (bundleTaxPrecise.gt(0)) {
-        lastTaxableItem = {
-          type: 'bundle',
-          item: bundleItem
-        };
-      }
-    }
-
-    // --- 汇总到商品级 ---
-    const itemTaxPrecise = mainTaxPrecise.plus(bundlePreciseTax);
-    const itemTaxRounded = mainTaxRounded.plus(bundleRoundedTax);
-    const itemOriginTaxPrecise = originalTaxPrecise.plus(bundlePreciseOriginTax);
-    const itemOriginTaxRounded = originalTaxPrecise.toDecimalPlaces(2, _decimal.default.ROUND_HALF_UP).plus(bundleRoundedOriginTax);
-    product.tax_fee = itemTaxRounded.toDecimalPlaces(2, _decimal.default.ROUND_HALF_UP).toFixed(2);
-    product.original_tax_fee = itemOriginTaxRounded.toDecimalPlaces(2, _decimal.default.ROUND_HALF_UP).toNumber();
-    preciseTax = preciseTax.plus(itemTaxPrecise.times(quantity));
-    roundedTax = roundedTax.plus(itemTaxRounded.times(quantity));
-    preciseOriginTax = preciseOriginTax.plus(itemOriginTaxPrecise.times(quantity));
-    roundedOriginTax = roundedOriginTax.plus(itemOriginTaxRounded.times(quantity));
-  }
-
-  // --- 舍入差值处理 ---
-  const expectedTax = preciseTax.toDecimalPlaces(2, _decimal.default.ROUND_HALF_UP);
-  const expectedOriginTax = preciseOriginTax.toDecimalPlaces(2, _decimal.default.ROUND_HALF_UP);
-  const taxRemainder = expectedTax.minus(roundedTax).toNumber();
-  const originTaxRemainder = expectedOriginTax.minus(roundedOriginTax).toNumber();
-  if (lastTaxableItem) {
-    if (taxRemainder !== 0) {
-      lastTaxableItem.item.tax_fee_rounding_remainder = taxRemainder;
-    }
-    if (originTaxRemainder !== 0) {
-      lastTaxableItem.item.original_tax_fee_rounding_remainder = originTaxRemainder;
+    const originalTaxRounded = toAmountFormat(originalTaxPrecise);
+    const effectiveMainUnitTax = shouldUsePersistedMainTax ? persistedMainTaxFee : shouldSplitPersistedMainTax ? persistedMainTaxFee.times(persistedQuantity).plus(mainTaxRounded.times(deltaQuantity)).div(quantity).toDecimalPlaces(2, _decimal.default.ROUND_HALF_UP) : mainTaxRounded;
+    productUnitTax = productUnitTax.plus(effectiveMainUnitTax);
+    productUnitOriginTax = productUnitOriginTax.plus(originalTaxRounded);
+    product.main_product_attached_bundle_tax_fee = effectiveMainUnitTax.toDecimalPlaces(2, _decimal.default.ROUND_HALF_UP).toFixed(2);
+    product.tax_fee = productUnitTax.toDecimalPlaces(2, _decimal.default.ROUND_HALF_UP).toFixed(2);
+    product.original_tax_fee = productUnitOriginTax.toDecimalPlaces(2, _decimal.default.ROUND_HALF_UP).toNumber();
+    totalTax = totalTax.plus(shouldUsePersistedMainTax ? persistedMainTaxFee.times(quantity).plus(persistedMainRemainder || 0) : shouldSplitPersistedMainTax ? persistedMainTaxFee.times(persistedQuantity).plus(mainTaxRounded.times(deltaQuantity)) : mainTaxRounded.times(quantity).plus(mainRemainder));
+    totalOriginTax = totalOriginTax.plus(originalTaxRounded.times(quantity));
+    if (product.tax_fee_rounding_remainder === undefined) {
+      product.tax_fee_rounding_remainder = 0;
     }
   }
   return {
-    tax: expectedTax,
-    originTax: expectedOriginTax
+    tax: totalTax.toDecimalPlaces(2, _decimal.default.ROUND_HALF_UP),
+    originTax: totalOriginTax.toDecimalPlaces(2, _decimal.default.ROUND_HALF_UP)
   };
 }
+
+/**
+ * 整单折扣（shop_discount）按各行 selling 合计占比均摊到 payment 维度。
+ *
+ * 文档口径：
+ * - payment_price = selling_price − 整单折扣均摊；rate = payment/selling（全行同一 rate）；
+ * - 附加费不受整单折扣影响（基数仍用 selling，本函数写 main_product_attached_bundle_selling_price）；
+ * - 税费受整单折扣影响（基数用 payment，本函数写 main_product_attached_bundle_payment_price 与
+ *   原价子商品 bundle_payment_price）。
+ *
+ * 与后端一致：bundle_payment_price = bundle_selling_price × rate，
+ * main_product_attached_bundle_payment_price = main_product_attached_bundle_selling_price × rate。
+ */
+function allocateShopDiscountToPayment(products, productAmount, shopDiscountAmount) {
+  const effectiveDiscount = productAmount.lte(0) ? new _decimal.default(0) : _decimal.default.max(_decimal.default.min(productAmount, shopDiscountAmount), 0);
+  let allocatedDiscount = new _decimal.default(0);
+  products.forEach((product, index) => {
+    const quantity = new _decimal.default(getSafeNum(product.num));
+    const sellingUnit = getUnitPaymentTotal(product);
+    const lineSellingTotal = sellingUnit.times(quantity);
+    const lineDiscount = effectiveDiscount.lte(0) ? new _decimal.default(0) : index === products.length - 1 ? _decimal.default.max(effectiveDiscount.minus(allocatedDiscount), 0) : toAmountFormat(lineSellingTotal.div(productAmount).times(effectiveDiscount));
+    allocatedDiscount = allocatedDiscount.plus(lineDiscount);
+    const unitDiscount = quantity.lte(0) ? new _decimal.default(0) : lineDiscount.div(quantity);
+    const paymentUnit = _decimal.default.max(sellingUnit.minus(unitDiscount), 0);
+    const rate = sellingUnit.lte(0) ? new _decimal.default(1) : toBcScale(paymentUnit.div(sellingUnit), 6);
+    const mainSellingTotal = getMainAttachedBundleSellingTotal(product);
+    const mainPaymentTotal = toAmountFormat(bcMul(mainSellingTotal, rate, 6));
+    product.metadata = {
+      ...(product.metadata || {}),
+      average_discount_amount_rate: rate.toString(),
+      main_product_attached_bundle_selling_price: mainSellingTotal.toFixed(2),
+      main_product_attached_bundle_payment_price: mainPaymentTotal.toFixed(2)
+    };
+    for (const bundle of product.product_bundle || []) {
+      // 原价子商品：bundle_payment_price = bundle_selling_price × rate
+      // markdown 子商品：以净额幅度 × rate（与后端一致，存正净额）
+      if (isBundleOriginalPrice(bundle)) {
+        const bundleSelling = toDecimal(bundle.bundle_selling_price ?? bundle.bundle_sum_price ?? bundle.price ?? 0);
+        bundle.bundle_payment_price = toAmountFormat(bcMul(bundleSelling, rate, 6)).toFixed(2);
+        continue;
+      }
+      if ((0, _utils2.isMarkdownBundle)(bundle)) {
+        const magnitude = (0, _utils2.getBundleSellingMagnitude)(bundle);
+        bundle.custom_price = bundle.custom_price ?? bundle.price;
+        bundle.price = magnitude.toFixed(2);
+        bundle.bundle_selling_price = magnitude.toFixed(2);
+        bundle.bundle_payment_price = toAmountFormat(bcMul(magnitude, rate, 6)).toFixed(2);
+      }
+    }
+    product.payment_price = paymentUnit.toFixed(2);
+  });
+}
 function createEmptySalesSummary() {
   return {
     product_quantity: 0,
@@ -330,6 +816,9 @@ function createEmptySalesSummary() {
     deposit_amount: '0.00',
     expect_amount: '0.00',
     total_amount: '0.00',
+    total_refund_amount: '0.00',
+    customer_paid_amount: '0.00',
+    order_paid_amount: '0.00',
     amount_gap: '0.00',
     rounding_amount: '0.00',
     pay_service_charge_amount: '0.00'
@@ -342,14 +831,26 @@ function calculateSalesSummary(params) {
     taxRate,
     surchargeList,
     scheduleById = {},
-    isInScheduleByDate
+    isInScheduleByDate,
+    shopDiscount
   } = params;
   if (!products?.length) return createEmptySalesSummary();
-  const productQuantity = products.reduce((sum, item) => sum + getSafeNum(item.num), 0);
-  const productOriginalAmount = products.reduce((sum, item) => sum.plus(getUnitOriginalTotal(item).times(getSafeNum(item.num))), new _decimal.default(0));
-  const productAmount = products.reduce((sum, item) => sum.plus(getUnitPaymentTotal(item).times(getSafeNum(item.num))), new _decimal.default(0));
-  const surchargeServiceItems = buildSurchargeServiceItems(products);
-  const surcharge = (0, _utils.getSurcharge)({
+  const summaryProducts = products.filter(product => !isGeneratedVoucherProduct(product));
+  if (!summaryProducts.length) return createEmptySalesSummary();
+  const productQuantity = summaryProducts.reduce((sum, item) => sum + getSafeNum(item.num), 0);
+  const productOriginalAmount = summaryProducts.reduce((sum, item) => sum.plus(getUnitOriginalTotal(item).times(getSafeNum(item.num))), new _decimal.default(0));
+  const productAmount = summaryProducts.reduce((sum, item) => sum.plus(getUnitPaymentTotal(item).times(getSafeNum(item.num))), new _decimal.default(0));
+  const shopDiscountAmount = _decimal.default.max(new _decimal.default(Number(shopDiscount) || 0), 0);
+  const hasPersistedSurchargeSnapshot = summaryProducts.some(product => {
+    return getPersistedMainSurchargeFee(product)?.gt(0);
+  });
+  // 整单折扣均摊：附加费基数用 selling（不受折扣），税费基数用 payment（受折扣）。
+  // persisted 快照（已下单编辑）优先采信后端回传值，不重算均摊。
+  if (!hasPersistedSurchargeSnapshot) {
+    allocateShopDiscountToPayment(summaryProducts, productAmount, shopDiscountAmount);
+  }
+  const surchargeServiceItems = buildSurchargeServiceItems(summaryProducts);
+  (0, _utils.getSurcharge)({
     service: surchargeServiceItems,
     addons: [],
     bookingDetail: null,
@@ -360,27 +861,28 @@ function calculateSalesSummary(params) {
     surcharge_list: surchargeList,
     scheduleById
   });
+  const surcharge = calculateBackendProductSurcharges({
+    products: summaryProducts,
+    sourceItems: surchargeServiceItems,
+    surchargeList
+  });
   const surchargeAmount = new _decimal.default((0, _utils.getSurchargeAmount)({
     bookingDetail: null,
     bookingId: undefined
   }, surcharge, {
     isEdit: false
   }) || 0);
-  for (let i = 0; i < products.length; i++) {
-    products[i].surcharge_fee = surchargeServiceItems[i]?.surcharge_fee || 0;
-    products[i].surcharge_rounding_remainder = surchargeServiceItems[i]?.surcharge_rounding_remainder || 0;
-  }
   const hasTaxRate = taxRate !== undefined && taxRate !== null && taxRate > 0;
   let productTaxFee;
   if (hasTaxRate) {
-    const taxResult = calculateProductsTax(products, taxRate, isPriceIncludeTax);
+    const taxResult = calculateProductsTax(summaryProducts, taxRate, isPriceIncludeTax);
     productTaxFee = taxResult.tax;
   } else {
-    productTaxFee = products.reduce((sum, item) => sum.plus(toDecimal(item.tax_fee).times(getSafeNum(item.num))), new _decimal.default(0));
+    productTaxFee = summaryProducts.reduce((sum, item) => sum.plus(toDecimal(item.tax_fee).times(getSafeNum(item.num))), new _decimal.default(0));
   }
-  const expectAmount = productAmount.plus(surchargeAmount);
-  const totalAmount = isPriceIncludeTax === 1 ? expectAmount : expectAmount.plus(productTaxFee);
-  const deposit = calculateProductsDeposit(products);
+  const orderAmountBeforeDiscount = productAmount.plus(surchargeAmount).plus(isPriceIncludeTax === 1 ? 0 : productTaxFee);
+  const totalAmount = _decimal.default.max(0, orderAmountBeforeDiscount.minus(shopDiscountAmount));
+  const deposit = calculateProductsDeposit(summaryProducts);
   return {
     product_quantity: productQuantity,
     product_original_amount: toFixed2(productOriginalAmount),
@@ -392,11 +894,14 @@ function calculateSalesSummary(params) {
     tax_fee: toFixed2(productTaxFee),
     surcharge_fee: toFixed2(surchargeAmount),
     surcharges: surcharge,
-    discount_amount: toFixed2(_decimal.default.max(productOriginalAmount.minus(productAmount), 0)),
+    discount_amount: toFixed2(shopDiscountAmount),
     deposit_amount: deposit ? deposit.total : '0.00',
     deposit,
-    expect_amount: toFixed2(expectAmount),
+    expect_amount: toFixed2(totalAmount),
     total_amount: toFixed2(totalAmount),
+    total_refund_amount: '0.00',
+    customer_paid_amount: '0.00',
+    order_paid_amount: '0.00',
     amount_gap: '0.00',
     rounding_amount: '0.00',
     pay_service_charge_amount: '0.00',