@pisell/pisellos 0.0.402 → 0.0.403

package/dist/modules/Summary/index.d.ts

@@ -22,4 +22,6 @@ export declare class SummaryModule extends BaseModule implements Module, ISummar
      */
     getProtocol(protocolId: string): Promise<any>;
     storeChange(): void;
+    private getTaxforUtils;
+    private getSurchargeforUtils;
 }

package/dist/modules/Summary/index.js

@@ -16,7 +16,8 @@ function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key i
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
 function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 import { BaseModule } from "../BaseModule";
-import { calculatePriceDetails } from "./utils";
+import { ScheduleModule } from "../Schedule";
+import { calculatePriceDetails, getSurcharge, getTax } from "./utils";
 export var SummaryModule = /*#__PURE__*/function (_BaseModule) {
   _inherits(SummaryModule, _BaseModule);
   var _super = _createSuper(SummaryModule);
@@ -165,6 +166,43 @@ export var SummaryModule = /*#__PURE__*/function (_BaseModule) {
         });
       }
     }
+  }, {
+    key: "getTaxforUtils",
+    value: function getTaxforUtils(items, shopInfo, subtotal) {
+      return getTax({
+        service: items,
+        bookingDetail: null,
+        bookingId: undefined
+      }, {
+        computed: {
+          productExpectAmount: subtotal.toNumber(),
+          shopDiscount: 0
+        },
+        isEdit: false,
+        tax_rate: shopInfo === null || shopInfo === void 0 ? void 0 : shopInfo.tax_rate,
+        is_price_include_tax: shopInfo === null || shopInfo === void 0 ? void 0 : shopInfo.is_price_include_tax
+      });
+    }
+  }, {
+    key: "getSurchargeforUtils",
+    value: function getSurchargeforUtils(items) {
+      var surchargeList = this.store.surchargeList;
+      var surchargeAmount = getSurcharge({
+        service: items,
+        addons: [],
+        bookingDetail: null,
+        bookingId: undefined
+      }, {
+        isEdit: false,
+        isInScheduleByDate: ScheduleModule.isInScheduleByDate,
+        surcharge_list: surchargeList,
+        scheduleById: {}
+      });
+      return {
+        surchargeList: surchargeList,
+        surchargeAmount: surchargeAmount
+      };
+    }
   }]);
   return SummaryModule;
 }(BaseModule);

package/dist/modules/Summary/utils.d.ts

@@ -7,6 +7,49 @@ export declare const calculatePriceDetails: (shopInfo: any, items: CartItem[], i
  * @param item
  */
 export declare const getBundleDiscountList: (bundle: any[]) => any[];
+/**
+ * 计算订单税费（折扣前/折扣后），并把单品税费信息回写到商品数据上（用于明细展示/后续计算）。
+ *
+ * - **折扣前税费**：`originTax`
+ * - **折扣后税费**：`tax`（会考虑 `computed.shopDiscount` 对每个商品的分摊影响）
+ * - **税率/是否含税**：优先取 `bookingDetail.tax_rate` / `bookingDetail.is_price_include_tax`，取不到再回退到 `options.tax_rate` / `options.is_price_include_tax`
+ *
+ * **副作用（会修改入参商品对象）**：
+ * - 主商品：写入 `item.original_tax_fee` / `item.tax_fee`（四舍五入保留两位）
+ * - bundle 原价子商品：写入 `bundleItem.original_tax_fee` / `bundleItem.tax_fee`
+ * - 加时商品（`relation_details`）：写入 `atItem.tax_fee`
+ * - 税费舍入差值：追加到最后一个“含税商品”的 `tax_fee_rounding_remainder` / `original_tax_fee_rounding_remainder`
+ *
+ * @param params 入参集合（RORO）
+ * @param params.service 服务商品数组（主商品）。通常是购物车商品结构（可能包含 `bundle` / `relation_details`）
+ * @param params.addons 附加商品数组（可选）。结构同商品数组
+ * @param params.bookingDetail 订单详情（编辑/详情场景用于读取后端税率配置），可选
+ * @param params.bookingId 订单/预约 ID（编辑/详情场景识别用），可选
+ * @param options 计算选项
+ * @param options.isEdit 是否处于“编辑中”。当前实现不强依赖该值（历史逻辑保留），但建议按真实状态传入
+ * @param options.computed 预计算结果（用于折扣分摊）
+ * @param options.computed.productExpectAmount 商品期望总金额（用于按比例分摊折扣）
+ * @param options.computed.shopDiscount 店铺折扣总额（用于按比例分摊到商品）
+ * @param options.tax_rate 管理端税率（百分比，如 5 表示 5%）。仅当 `bookingDetail.tax_rate` 不存在时生效
+ * @param options.is_price_include_tax 是否含税：`0` 不含税、`1` 含税。仅当 `bookingDetail.is_price_include_tax` 不存在时生效
+ * @returns 税费汇总（number，金额单位与商品价格一致，四舍五入保留两位）
+ * @returns.originTax 折扣前税费合计
+ * @returns.tax 折扣后税费合计
+ */
+export declare const getTax: ({ service, addons, bookingDetail, bookingId }: {
+    service?: any;
+    addons?: any;
+    bookingDetail?: any;
+    bookingId?: number | undefined;
+}, options: {
+    isEdit: boolean;
+    computed: Record<string, number>;
+    tax_rate?: number;
+    is_price_include_tax?: number;
+} & Record<string, any>) => {
+    originTax: number;
+    tax: number;
+};
 /**
  * 计算商品小计（不含其他费用）
  * @param items - 购物车商品数组
@@ -38,14 +81,52 @@ export declare const calculateDeposit: (items: CartItem[]) => {
     protocols: any[];
     hasDeposit: never;
 } | undefined;
+/**
+ * 计算订单附加费金额（订单级别合计）。
+ *
+ * - **详情未编辑**（`!options.isEdit && bookingId`）且存在后端详情时：直接返回 `bookingDetail.surcharge_fee`
+ * - **新增/编辑**时：对 `surcharge`（通常为 `getSurcharge` 的返回值）按 `item.value` 求和
+ *
+ * @param params 入参集合（RORO）
+ * @param params.bookingDetail 订单详情（详情未编辑时用于读取后端的 `surcharge_fee`），可选
+ * @param params.bookingId 订单/预约 ID（详情未编辑时生效），可选
+ * @param surcharge 附加费列表（通常来自 `getSurcharge`），元素结构至少包含 `value: number`
+ * @param options 计算选项
+ * @param options.isEdit 是否处于“编辑中”。`false` 时会优先走后端金额直取逻辑（若存在）
+ * @returns 订单附加费金额（number，金额单位与商品价格一致）
+ */
 export declare const getSurchargeAmount: ({ bookingDetail, bookingId }: {
     bookingDetail?: any;
     bookingId?: number | undefined;
 }, surcharge: any[], options: any) => any;
 /**
  * 订单附加费各项信息
- * @param state
- * @param options 包含 ScheduleModule 和其他附加费计算所需参数
+ *
+ * - **详情未编辑**（`!options.isEdit && bookingId`）时：直接返回 `bookingDetail.surcharge`（后端计算结果）
+ * - **新增/编辑**时：按 `options.surcharge_list` 逐条配置计算本次订单的附加费
+ *
+ * 规则要点：
+ * - 匹配范围包含：主商品（`service`）、原价 bundle 子商品（`item.bundle`）、加时商品（`item.relation_details`）、以及 addons（`addons.value`）
+ * - 固定附加费 `fixed`：只加一次，再按商品数量分摊（向下取整保留两位），剩余小数会以 `surcharge_rounding_remainder` 形式抹平到最后一个商品
+ * - 百分比附加费 `percentage`：按每个商品（价格 * 数量）分别计算再累加
+ * - 当 `open_product === 0`：不回写到商品，只在订单级别累加；否则会把单品附加费回写到商品
+ *
+ * **副作用（可能修改入参商品对象）**：
+ * - 当 `open_product !== 0` 时：写入 `item.surcharge_fee`（单品单数量附加费，保留两位、向下取整）
+ * - 写入 `item.relation_surcharge_ids`（关联到的 surcharge 配置 id 列表）
+ * - 写入 `item.surcharge_rounding_remainder`（用于抹平固定附加费/总额舍入差）
+ *
+ * @param params 入参集合（RORO）
+ * @param params.service 服务商品数组（主商品）。元素可能包含 `bundle` / `relation_details`
+ * @param params.addons 附加商品容器。当前实现读取 `addons.value` 作为商品数组（所以通常传 `{ value: CartItem[] }`）
+ * @param params.bookingDetail 订单详情（详情未编辑时用于直接取后端的 surcharge 列表），可选
+ * @param params.bookingId 订单/预约 ID（详情未编辑时生效），可选
+ * @param options 计算选项
+ * @param options.isEdit 是否处于“编辑中”。`false` 且存在 `bookingId` 时会走详情直取逻辑
+ * @param options.surcharge_list 附加费配置列表（后端下发）。缺失/为空则返回空数组
+ * @param options.isInScheduleByDate 判断日期是否落在某个 schedule 内的方法（通常来自 ScheduleModule）
+ * @param options.scheduleById schedule 映射表：`{ [scheduleId]: schedule }`（用于根据配置的 `available_schedule_ids` 做日程匹配）
+ * @returns 附加费列表（仅返回金额 > 0 的项）
  */
 export declare const getSurcharge: ({ service, addons, bookingDetail, bookingId }: {
     service: any;

package/dist/modules/Summary/utils.js

@@ -105,12 +105,35 @@ var getProductDiscountProductDiscountDifference = function getProductDiscountPro
 };
 
 /**
- * 税费
- * @param state
- * @param options 包含 isEdit、computed 和其他税费计算所需参数
- * @returns
+ * 计算订单税费（折扣前/折扣后），并把单品税费信息回写到商品数据上（用于明细展示/后续计算）。
+ *
+ * - **折扣前税费**：`originTax`
+ * - **折扣后税费**：`tax`（会考虑 `computed.shopDiscount` 对每个商品的分摊影响）
+ * - **税率/是否含税**：优先取 `bookingDetail.tax_rate` / `bookingDetail.is_price_include_tax`，取不到再回退到 `options.tax_rate` / `options.is_price_include_tax`
+ *
+ * **副作用（会修改入参商品对象）**：
+ * - 主商品：写入 `item.original_tax_fee` / `item.tax_fee`（四舍五入保留两位）
+ * - bundle 原价子商品：写入 `bundleItem.original_tax_fee` / `bundleItem.tax_fee`
+ * - 加时商品（`relation_details`）：写入 `atItem.tax_fee`
+ * - 税费舍入差值：追加到最后一个“含税商品”的 `tax_fee_rounding_remainder` / `original_tax_fee_rounding_remainder`
+ *
+ * @param params 入参集合（RORO）
+ * @param params.service 服务商品数组（主商品）。通常是购物车商品结构（可能包含 `bundle` / `relation_details`）
+ * @param params.addons 附加商品数组（可选）。结构同商品数组
+ * @param params.bookingDetail 订单详情（编辑/详情场景用于读取后端税率配置），可选
+ * @param params.bookingId 订单/预约 ID（编辑/详情场景识别用），可选
+ * @param options 计算选项
+ * @param options.isEdit 是否处于“编辑中”。当前实现不强依赖该值（历史逻辑保留），但建议按真实状态传入
+ * @param options.computed 预计算结果（用于折扣分摊）
+ * @param options.computed.productExpectAmount 商品期望总金额（用于按比例分摊折扣）
+ * @param options.computed.shopDiscount 店铺折扣总额（用于按比例分摊到商品）
+ * @param options.tax_rate 管理端税率（百分比，如 5 表示 5%）。仅当 `bookingDetail.tax_rate` 不存在时生效
+ * @param options.is_price_include_tax 是否含税：`0` 不含税、`1` 含税。仅当 `bookingDetail.is_price_include_tax` 不存在时生效
+ * @returns 税费汇总（number，金额单位与商品价格一致，四舍五入保留两位）
+ * @returns.originTax 折扣前税费合计
+ * @returns.tax 折扣后税费合计
  */
-var getTax = function getTax(_ref, options) {
+export var getTax = function getTax(_ref, options) {
   var service = _ref.service,
     addons = _ref.addons,
     bookingDetail = _ref.bookingDetail,
@@ -119,7 +142,6 @@ var getTax = function getTax(_ref, options) {
     computed = options.computed,
     tax_rate = options.tax_rate,
     is_price_include_tax = options.is_price_include_tax;
-  debugger;
 
   // 详情时未编辑的状态下, 取后端的值
   // if (!isEdit) {
@@ -586,7 +608,20 @@ export var calculateDeposit = function calculateDeposit(items) {
   return undefined;
 };
 
-// 订单附加费
+/**
+ * 计算订单附加费金额（订单级别合计）。
+ *
+ * - **详情未编辑**（`!options.isEdit && bookingId`）且存在后端详情时：直接返回 `bookingDetail.surcharge_fee`
+ * - **新增/编辑**时：对 `surcharge`（通常为 `getSurcharge` 的返回值）按 `item.value` 求和
+ *
+ * @param params 入参集合（RORO）
+ * @param params.bookingDetail 订单详情（详情未编辑时用于读取后端的 `surcharge_fee`），可选
+ * @param params.bookingId 订单/预约 ID（详情未编辑时生效），可选
+ * @param surcharge 附加费列表（通常来自 `getSurcharge`），元素结构至少包含 `value: number`
+ * @param options 计算选项
+ * @param options.isEdit 是否处于“编辑中”。`false` 时会优先走后端金额直取逻辑（若存在）
+ * @returns 订单附加费金额（number，金额单位与商品价格一致）
+ */
 export var getSurchargeAmount = function getSurchargeAmount(_ref6, surcharge, options) {
   var bookingDetail = _ref6.bookingDetail,
     bookingId = _ref6.bookingId;
@@ -749,8 +784,32 @@ var isProductMatchSurchargeCondition = function isProductMatchSurchargeCondition
 
 /**
  * 订单附加费各项信息
- * @param state
- * @param options 包含 ScheduleModule 和其他附加费计算所需参数
+ *
+ * - **详情未编辑**（`!options.isEdit && bookingId`）时：直接返回 `bookingDetail.surcharge`（后端计算结果）
+ * - **新增/编辑**时：按 `options.surcharge_list` 逐条配置计算本次订单的附加费
+ *
+ * 规则要点：
+ * - 匹配范围包含：主商品（`service`）、原价 bundle 子商品（`item.bundle`）、加时商品（`item.relation_details`）、以及 addons（`addons.value`）
+ * - 固定附加费 `fixed`：只加一次，再按商品数量分摊（向下取整保留两位），剩余小数会以 `surcharge_rounding_remainder` 形式抹平到最后一个商品
+ * - 百分比附加费 `percentage`：按每个商品（价格 * 数量）分别计算再累加
+ * - 当 `open_product === 0`：不回写到商品，只在订单级别累加；否则会把单品附加费回写到商品
+ *
+ * **副作用（可能修改入参商品对象）**：
+ * - 当 `open_product !== 0` 时：写入 `item.surcharge_fee`（单品单数量附加费，保留两位、向下取整）
+ * - 写入 `item.relation_surcharge_ids`（关联到的 surcharge 配置 id 列表）
+ * - 写入 `item.surcharge_rounding_remainder`（用于抹平固定附加费/总额舍入差）
+ *
+ * @param params 入参集合（RORO）
+ * @param params.service 服务商品数组（主商品）。元素可能包含 `bundle` / `relation_details`
+ * @param params.addons 附加商品容器。当前实现读取 `addons.value` 作为商品数组（所以通常传 `{ value: CartItem[] }`）
+ * @param params.bookingDetail 订单详情（详情未编辑时用于直接取后端的 surcharge 列表），可选
+ * @param params.bookingId 订单/预约 ID（详情未编辑时生效），可选
+ * @param options 计算选项
+ * @param options.isEdit 是否处于“编辑中”。`false` 且存在 `bookingId` 时会走详情直取逻辑
+ * @param options.surcharge_list 附加费配置列表（后端下发）。缺失/为空则返回空数组
+ * @param options.isInScheduleByDate 判断日期是否落在某个 schedule 内的方法（通常来自 ScheduleModule）
+ * @param options.scheduleById schedule 映射表：`{ [scheduleId]: schedule }`（用于根据配置的 `available_schedule_ids` 做日程匹配）
+ * @returns 附加费列表（仅返回金额 > 0 的项）
  */
 export var getSurcharge = function getSurcharge(_ref10, options) {
   var service = _ref10.service,

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

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

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

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

@@ -22,4 +22,6 @@ export declare class SummaryModule extends BaseModule implements Module, ISummar
      */
     getProtocol(protocolId: string): Promise<any>;
     storeChange(): void;
+    private getTaxforUtils;
+    private getSurchargeforUtils;
 }

package/lib/modules/Summary/index.js

@@ -23,6 +23,7 @@ __export(Summary_exports, {
 });
 module.exports = __toCommonJS(Summary_exports);
 var import_BaseModule = require("../BaseModule");
+var import_Schedule = require("../Schedule");
 var import_utils = require("./utils");
 var SummaryModule = class extends import_BaseModule.BaseModule {
   constructor(name, version) {
@@ -87,6 +88,25 @@ var SummaryModule = class extends import_BaseModule.BaseModule {
       });
     }
   }
+  getTaxforUtils(items, shopInfo, subtotal) {
+    return (0, import_utils.getTax)({ service: items, bookingDetail: null, bookingId: void 0 }, {
+      computed: {
+        productExpectAmount: subtotal.toNumber(),
+        shopDiscount: 0
+      },
+      isEdit: false,
+      tax_rate: shopInfo == null ? void 0 : shopInfo.tax_rate,
+      is_price_include_tax: shopInfo == null ? void 0 : shopInfo.is_price_include_tax
+    });
+  }
+  getSurchargeforUtils(items) {
+    const surchargeList = this.store.surchargeList;
+    const surchargeAmount = (0, import_utils.getSurcharge)({ service: items, addons: [], bookingDetail: null, bookingId: void 0 }, { isEdit: false, isInScheduleByDate: import_Schedule.ScheduleModule.isInScheduleByDate, surcharge_list: surchargeList, scheduleById: {} });
+    return {
+      surchargeList,
+      surchargeAmount
+    };
+  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

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

@@ -7,6 +7,49 @@ export declare const calculatePriceDetails: (shopInfo: any, items: CartItem[], i
  * @param item
  */
 export declare const getBundleDiscountList: (bundle: any[]) => any[];
+/**
+ * 计算订单税费（折扣前/折扣后），并把单品税费信息回写到商品数据上（用于明细展示/后续计算）。
+ *
+ * - **折扣前税费**：`originTax`
+ * - **折扣后税费**：`tax`（会考虑 `computed.shopDiscount` 对每个商品的分摊影响）
+ * - **税率/是否含税**：优先取 `bookingDetail.tax_rate` / `bookingDetail.is_price_include_tax`，取不到再回退到 `options.tax_rate` / `options.is_price_include_tax`
+ *
+ * **副作用（会修改入参商品对象）**：
+ * - 主商品：写入 `item.original_tax_fee` / `item.tax_fee`（四舍五入保留两位）
+ * - bundle 原价子商品：写入 `bundleItem.original_tax_fee` / `bundleItem.tax_fee`
+ * - 加时商品（`relation_details`）：写入 `atItem.tax_fee`
+ * - 税费舍入差值：追加到最后一个“含税商品”的 `tax_fee_rounding_remainder` / `original_tax_fee_rounding_remainder`
+ *
+ * @param params 入参集合（RORO）
+ * @param params.service 服务商品数组（主商品）。通常是购物车商品结构（可能包含 `bundle` / `relation_details`）
+ * @param params.addons 附加商品数组（可选）。结构同商品数组
+ * @param params.bookingDetail 订单详情（编辑/详情场景用于读取后端税率配置），可选
+ * @param params.bookingId 订单/预约 ID（编辑/详情场景识别用），可选
+ * @param options 计算选项
+ * @param options.isEdit 是否处于“编辑中”。当前实现不强依赖该值（历史逻辑保留），但建议按真实状态传入
+ * @param options.computed 预计算结果（用于折扣分摊）
+ * @param options.computed.productExpectAmount 商品期望总金额（用于按比例分摊折扣）
+ * @param options.computed.shopDiscount 店铺折扣总额（用于按比例分摊到商品）
+ * @param options.tax_rate 管理端税率（百分比，如 5 表示 5%）。仅当 `bookingDetail.tax_rate` 不存在时生效
+ * @param options.is_price_include_tax 是否含税：`0` 不含税、`1` 含税。仅当 `bookingDetail.is_price_include_tax` 不存在时生效
+ * @returns 税费汇总（number，金额单位与商品价格一致，四舍五入保留两位）
+ * @returns.originTax 折扣前税费合计
+ * @returns.tax 折扣后税费合计
+ */
+export declare const getTax: ({ service, addons, bookingDetail, bookingId }: {
+    service?: any;
+    addons?: any;
+    bookingDetail?: any;
+    bookingId?: number | undefined;
+}, options: {
+    isEdit: boolean;
+    computed: Record<string, number>;
+    tax_rate?: number;
+    is_price_include_tax?: number;
+} & Record<string, any>) => {
+    originTax: number;
+    tax: number;
+};
 /**
  * 计算商品小计（不含其他费用）
  * @param items - 购物车商品数组
@@ -38,14 +81,52 @@ export declare const calculateDeposit: (items: CartItem[]) => {
     protocols: any[];
     hasDeposit: never;
 } | undefined;
+/**
+ * 计算订单附加费金额（订单级别合计）。
+ *
+ * - **详情未编辑**（`!options.isEdit && bookingId`）且存在后端详情时：直接返回 `bookingDetail.surcharge_fee`
+ * - **新增/编辑**时：对 `surcharge`（通常为 `getSurcharge` 的返回值）按 `item.value` 求和
+ *
+ * @param params 入参集合（RORO）
+ * @param params.bookingDetail 订单详情（详情未编辑时用于读取后端的 `surcharge_fee`），可选
+ * @param params.bookingId 订单/预约 ID（详情未编辑时生效），可选
+ * @param surcharge 附加费列表（通常来自 `getSurcharge`），元素结构至少包含 `value: number`
+ * @param options 计算选项
+ * @param options.isEdit 是否处于“编辑中”。`false` 时会优先走后端金额直取逻辑（若存在）
+ * @returns 订单附加费金额（number，金额单位与商品价格一致）
+ */
 export declare const getSurchargeAmount: ({ bookingDetail, bookingId }: {
     bookingDetail?: any;
     bookingId?: number | undefined;
 }, surcharge: any[], options: any) => any;
 /**
  * 订单附加费各项信息
- * @param state
- * @param options 包含 ScheduleModule 和其他附加费计算所需参数
+ *
+ * - **详情未编辑**（`!options.isEdit && bookingId`）时：直接返回 `bookingDetail.surcharge`（后端计算结果）
+ * - **新增/编辑**时：按 `options.surcharge_list` 逐条配置计算本次订单的附加费
+ *
+ * 规则要点：
+ * - 匹配范围包含：主商品（`service`）、原价 bundle 子商品（`item.bundle`）、加时商品（`item.relation_details`）、以及 addons（`addons.value`）
+ * - 固定附加费 `fixed`：只加一次，再按商品数量分摊（向下取整保留两位），剩余小数会以 `surcharge_rounding_remainder` 形式抹平到最后一个商品
+ * - 百分比附加费 `percentage`：按每个商品（价格 * 数量）分别计算再累加
+ * - 当 `open_product === 0`：不回写到商品，只在订单级别累加；否则会把单品附加费回写到商品
+ *
+ * **副作用（可能修改入参商品对象）**：
+ * - 当 `open_product !== 0` 时：写入 `item.surcharge_fee`（单品单数量附加费，保留两位、向下取整）
+ * - 写入 `item.relation_surcharge_ids`（关联到的 surcharge 配置 id 列表）
+ * - 写入 `item.surcharge_rounding_remainder`（用于抹平固定附加费/总额舍入差）
+ *
+ * @param params 入参集合（RORO）
+ * @param params.service 服务商品数组（主商品）。元素可能包含 `bundle` / `relation_details`
+ * @param params.addons 附加商品容器。当前实现读取 `addons.value` 作为商品数组（所以通常传 `{ value: CartItem[] }`）
+ * @param params.bookingDetail 订单详情（详情未编辑时用于直接取后端的 surcharge 列表），可选
+ * @param params.bookingId 订单/预约 ID（详情未编辑时生效），可选
+ * @param options 计算选项
+ * @param options.isEdit 是否处于“编辑中”。`false` 且存在 `bookingId` 时会走详情直取逻辑
+ * @param options.surcharge_list 附加费配置列表（后端下发）。缺失/为空则返回空数组
+ * @param options.isInScheduleByDate 判断日期是否落在某个 schedule 内的方法（通常来自 ScheduleModule）
+ * @param options.scheduleById schedule 映射表：`{ [scheduleId]: schedule }`（用于根据配置的 `available_schedule_ids` 做日程匹配）
+ * @returns 附加费列表（仅返回金额 > 0 的项）
  */
 export declare const getSurcharge: ({ service, addons, bookingDetail, bookingId }: {
     service: any;

package/lib/modules/Summary/utils.js

@@ -36,7 +36,8 @@ __export(utils_exports, {
   calculateTaxFee: () => calculateTaxFee,
   getBundleDiscountList: () => getBundleDiscountList,
   getSurcharge: () => getSurcharge,
-  getSurchargeAmount: () => getSurchargeAmount
+  getSurchargeAmount: () => getSurchargeAmount,
+  getTax: () => getTax
 });
 module.exports = __toCommonJS(utils_exports);
 var import_decimal = __toESM(require("decimal.js"));
@@ -94,7 +95,6 @@ var getProductDiscountProductDiscountDifference = (item) => {
 };
 var getTax = ({ service, addons, bookingDetail, bookingId }, options) => {
   const { isEdit, computed, tax_rate, is_price_include_tax } = options;
-  debugger;
   let totalOriginTax = new import_decimal.default(0);
   let totalTax = new import_decimal.default(0);
   if (service || addons) {
@@ -717,5 +717,6 @@ var getSurcharge = ({ service, addons, bookingDetail, bookingId }, options) => {
   calculateTaxFee,
   getBundleDiscountList,
   getSurcharge,
-  getSurchargeAmount
+  getSurchargeAmount,
+  getTax
 });

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

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

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

package/package.json

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