@pisell/pisellos 2.2.244 → 2.2.245

package/dist/solution/BookingTicket/utils/exampleData.js

@@ -0,0 +1,183 @@
+var data = [{
+  "id": 58299,
+  "title": "玄-加时商品-与数量无关-不指定商品",
+  "price": 1,
+  "minMinutes": 30,
+  "maxMinutes": 30,
+  "unitMinutes": 30,
+  "unlimited": false,
+  "_originalProduct": {
+    "id": 58299,
+    "extension_id": 384,
+    "extension_type": "product_add_time",
+    "shop_id": 9,
+    "title": "玄-加时商品-与数量无关-不指定商品",
+    "slug": "玄-加时商品-与数量无关-指定商品",
+    "status": "published",
+    "stock_quantity": -119,
+    "sales_quantity": 113,
+    "sum_stock": -119,
+    "price": "1.00",
+    "original_price": "4.00",
+    "cost_price": "0.00",
+    "cover": "",
+    "channel_application": ["online-store", "pos", "bbc-module:mebook"],
+    "is_track": 0,
+    "over_sold": 0,
+    "is_gst": 1,
+    "code": "",
+    "barcode": "",
+    "is_delivery": 0,
+    "weight_unit": "KILOGRAMS",
+    "weight_value": "0.00",
+    "type": "physical",
+    "unit": "",
+    "sort": 9999999,
+    "subtitle": "",
+    "minimum_markup_price": "0.00",
+    "is_bundle": 0,
+    "description": "",
+    "open_sold_weight": 0,
+    "unit_value": 0,
+    "is_variant": 0,
+    "variant_count": 0,
+    "add_time": {
+      "unit_duration": 30,
+      "min_add_time": 30,
+      "max_add_time": 30,
+      "calculate_type": "not_related_to_quantity",
+      "relation_product": {
+        "type": "product_all",
+        "products": []
+      }
+    },
+    "shelf_product_datas": [],
+    "step_value": 1,
+    "min_num_unit": 1,
+    "is_charge_tax": 1,
+    "base_price": "1.00",
+    "variant": []
+  }
+}, {
+  "id": 58279,
+  "title": "加时商品2",
+  "price": 10,
+  "minMinutes": 30,
+  "maxMinutes": 120,
+  "unitMinutes": 10,
+  "unlimited": false,
+  "_originalProduct": {
+    "id": 58279,
+    "extension_id": 384,
+    "extension_type": "product_add_time",
+    "shop_id": 9,
+    "title": "加时商品2",
+    "slug": "加时商品2",
+    "status": "published",
+    "stock_quantity": -275,
+    "sales_quantity": 261,
+    "sum_stock": -275,
+    "price": "10.00",
+    "original_price": "10.00",
+    "cost_price": "0.00",
+    "cover": "",
+    "channel_application": ["online-store", "pos", "bbc-module:mebook"],
+    "is_track": 0,
+    "over_sold": 0,
+    "is_gst": 1,
+    "code": "",
+    "barcode": "",
+    "is_delivery": 0,
+    "weight_unit": "KILOGRAMS",
+    "weight_value": "0.00",
+    "type": "physical",
+    "unit": "",
+    "sort": 9999999,
+    "subtitle": "",
+    "minimum_markup_price": "0.00",
+    "is_bundle": 0,
+    "description": "",
+    "open_sold_weight": 0,
+    "unit_value": 0,
+    "is_variant": 0,
+    "variant_count": 0,
+    "add_time": {
+      "additional_time_options": "explicit_durations",
+      "unit_duration": 10,
+      "min_add_time": 30,
+      "max_add_time": 120,
+      "calculate_type": "not_related_to_quantity",
+      "relation_product": {
+        "type": "product_all",
+        "products": []
+      }
+    },
+    "shelf_product_datas": [],
+    "step_value": 1,
+    "min_num_unit": 1,
+    "is_charge_tax": 1,
+    "base_price": "10.00",
+    "variant": []
+  }
+}, {
+  "id": 58277,
+  "title": "测试加时商品",
+  "price": 2,
+  "minMinutes": 30,
+  "maxMinutes": 780,
+  "unitMinutes": 30,
+  "unlimited": true,
+  "_originalProduct": {
+    "id": 58277,
+    "extension_id": 384,
+    "extension_type": "product_add_time",
+    "shop_id": 9,
+    "title": "测试加时商品",
+    "slug": "测试加时商品",
+    "status": "published",
+    "stock_quantity": -7,
+    "sales_quantity": 8,
+    "sum_stock": -7,
+    "price": "2.00",
+    "original_price": "0.00",
+    "cost_price": "0.00",
+    "cover": "",
+    "channel_application": ["online-store", "pos", "bbc-module:mebook"],
+    "is_track": 0,
+    "over_sold": 0,
+    "is_gst": 1,
+    "code": "",
+    "barcode": "",
+    "is_delivery": 0,
+    "weight_unit": "KILOGRAMS",
+    "weight_value": "0.00",
+    "type": "physical",
+    "unit": "",
+    "sort": 9999999,
+    "subtitle": "",
+    "minimum_markup_price": "0.00",
+    "is_bundle": 0,
+    "description": "",
+    "open_sold_weight": 0,
+    "unit_value": 0,
+    "is_variant": 0,
+    "variant_count": 0,
+    "add_time": {
+      "additional_time_options": "unlimited",
+      "unit_duration": 30,
+      "min_add_time": 30,
+      "max_add_time": 780,
+      "calculate_type": "select_quantity",
+      "relation_product": {
+        "type": "product_all",
+        "products": []
+      }
+    },
+    "shelf_product_datas": [],
+    "step_value": 1,
+    "min_num_unit": 1,
+    "is_charge_tax": 1,
+    "base_price": "2.00",
+    "variant": []
+  }
+}];

package/dist/solution/BookingTicket/utils/resolveBestAddTimePlan.d.ts

@@ -0,0 +1,185 @@
+/**
+ * 计算指定加时时长下的最优购买方案。
+ *
+ * 输入的商品结构来自旧版 booking addTimeModal 的加时商品配置映射：
+ * - `minMinutes`：该商品第一次可选择的最小时长。
+ * - `maxMinutes`：单次购买该商品可覆盖的最大时长。
+ * - `unitMinutes`：超过最小时长后，每次递增的时长切片。
+ * - `price`：每个 `unitMinutes` 切片的价格。
+ * - `unlimited`：固定价格商品，可覆盖任意目标时长。
+ *
+ * 算法流程：
+ *
+ * ```
+ * products
+ *   |
+ *   v
+ * 将每个普通商品展开成有限候选档位
+ *   商品 A: min=30, max=60, unit=10, price=10
+ *   => 30m/$30, 40m/$40, 50m/$50, 60m/$60
+ *   |
+ *   v
+ * 单独加入 unlimited 候选
+ *   unlimited 商品 => targetMinutes / 固定商品价格
+ *   |
+ *   v
+ * 按 covered minutes 做动态规划
+ *   dp[minutes] = 正好覆盖 `minutes` 时的最低价候选组合
+ *   |
+ *   v
+ * 从所有 dp[minutes >= targetMinutes] 中挑选最优方案
+ * ```
+ *
+ * 候选档位生成刻意对齐旧版 addTimeModal：
+ * `totalPrice = minutes / unitMinutes * price`.
+ * 例如 `minMinutes=30`、`unitMinutes=10`、`price=10` 时：
+ * - 30 分钟 => 30 / 10 * 10 = 30
+ * - 60 分钟 => 60 / 10 * 10 = 60
+ *
+ * 目标时长不要求精确命中某个档位，只需要覆盖即可。例如目标是 51 分钟时，
+ * 60 分钟档位可以作为候选。动态规划也允许跨商品组合，例如商品 A 的 30m
+ * 加上商品 B 的 30m。最终方案按以下优先级比较：
+ * 1. 总价更低；
+ * 2. 超出时长更少，即 `coveredMinutes - targetMinutes` 更小；
+ * 3. 结果行数更少，让购买方案尽量简单。
+ *
+ * 典型匹配示例：
+ *
+ * 示例 1：精确命中，直接选择更便宜的商品。
+ * ```
+ * target = 30
+ * 商品 A: min=30, max=30, unit=30, price=10 => 30m/$10
+ * 商品 B: min=30, max=30, unit=30, price=8  => 30m/$8
+ * 结果：选择商品 B，coveredMinutes=30，totalPrice=8
+ * ```
+ *
+ * 示例 2：目标时长落在两个档位之间，向上选择可覆盖的档位。
+ * ```
+ * target = 51
+ * 商品 A: min=30, max=120, unit=10, price=10
+ * 候选：30m/$30, 40m/$40, 50m/$50, 60m/$60 ...
+ * 结果：50m 不足以覆盖 51m，因此选择 60m/$60
+ * ```
+ *
+ * 示例 3：不同商品都能覆盖同一目标时长，比较最终价格。
+ * ```
+ * target = 51
+ * 商品 A: min=30, max=120, unit=10, price=10 => 60m/$60
+ * 商品 B: min=30, max=120, unit=30, price=25 => 60m/$50
+ * 结果：两个方案都覆盖 60m，但商品 B 更便宜，所以选择商品 B
+ * ```
+ *
+ * 示例 4：允许跨商品组合，组合价更低时会选择组合。
+ * ```
+ * target = 90
+ * 商品 A: min=30, max=30, unit=30, price=5  => 30m/$5
+ * 商品 B: min=60, max=60, unit=60, price=8  => 60m/$8
+ * 商品 C: min=90, max=90, unit=90, price=20 => 90m/$20
+ * 结果：商品 A + 商品 B = 90m/$13，比商品 C 更便宜
+ * ```
+ *
+ * 示例 5：允许重复购买同一个候选档位。
+ * ```
+ * target = 90
+ * 商品 A: min=30, max=30, unit=30, price=5 => 30m/$5
+ * 结果：购买 3 份商品 A，coveredMinutes=90，totalPrice=15，
+ * lines 中会合并为一行：product_add_schedule_time=30，num=3
+ * ```
+ *
+ * 示例 6：unlimited 可以覆盖任意目标时长，并参与价格比较。
+ * ```
+ * target = 180
+ * 商品 A: min=30, max=120, unit=30, price=10
+ * 商品 B: unlimited=true, price=35
+ * 普通商品可以组合成 180m，例如 120m + 60m，总价 $60
+ * unlimited 商品固定 $35
+ * 结果：选择 unlimited 商品，coveredMinutes=180，totalPrice=35
+ * ```
+ *
+ * 示例 7：unlimited 不一定优先，普通商品更便宜时选择普通商品。
+ * ```
+ * target = 60
+ * 商品 A: min=30, max=60, unit=30, price=10 => 60m/$20
+ * 商品 B: unlimited=true, price=50
+ * 结果：选择商品 A 的 60m 档位
+ * ```
+ *
+ * 示例 8：价格相同，优先选择超出时长更少的方案。
+ * ```
+ * target = 51
+ * 商品 A: 60m/$20
+ * 商品 B: 90m/$20
+ * 结果：选择 60m，因为 overage=9，小于 90m 的 overage=39
+ * ```
+ *
+ * 示例 9：价格和覆盖时长都相同，优先选择结果行数更少的方案。
+ * ```
+ * target = 60
+ * 商品 A: 60m/$20
+ * 商品 B: 30m/$10
+ * 商品 C: 30m/$10
+ * 结果：商品 A 单行方案和 B+C 两行方案价格、时长相同，选择商品 A
+ * ```
+ *
+ * 示例 10：没有任何有效商品时返回 `NO_PRODUCTS`。
+ * ```
+ * target = 30
+ * products = []
+ * 结果：available=false，unavailableReason='NO_PRODUCTS'
+ * ```
+ *
+ * 示例 11：有商品但没有可用候选时返回 `NO_COVERAGE`。
+ * ```
+ * target = 30
+ * 商品 A: price=0，或 minMinutes 缺失/无效
+ * 结果：available=false，unavailableReason='NO_COVERAGE'
+ * ```
+ *
+ * 示例 12：目标时长小于等于 0 时无需购买。
+ * ```
+ * target = 0
+ * 结果：available=true，coveredMinutes=0，totalPrice=0，lines=[]
+ * ```
+ *
+ * 搜索边界：
+ * 有限档位只需要搜索到 `targetMinutes + maxFiniteCandidateMinutes`。
+ * 这里的 `maxFiniteCandidateMinutes` 是所有普通候选档位里的最大时长。
+ * 例如目标是 51 分钟，最大普通档位是 120 分钟，则只搜索到 171 分钟。
+ * 如果某个组合覆盖了 180 分钟，那么移除其中任意一个普通档位后，剩余时长
+ * 仍然有机会覆盖 51 分钟，而且价格一定不会更高，所以 180 分钟这个组合不
+ * 可能是最优解。
+ */
+export interface AddTimeProduct {
+    id: string | number;
+    title?: string;
+    price: number;
+    minMinutes?: number;
+    maxMinutes?: number;
+    unitMinutes?: number;
+    unlimited?: boolean;
+    _originalProduct?: unknown;
+}
+export interface AddTimePlanLine {
+    product_id: string | number;
+    product_title?: string;
+    product_add_schedule_time: number;
+    num: number;
+    price: number;
+    _originalProduct?: unknown;
+}
+export interface AddTimePlan {
+    available: boolean;
+    unavailableReason?: 'NO_PRODUCTS' | 'NO_COVERAGE';
+    targetMinutes: number;
+    coveredMinutes: number;
+    totalPrice: number;
+    lines: AddTimePlanLine[];
+}
+interface AddTimeCandidate extends AddTimePlanLine {
+    totalPrice: number;
+    unlimited?: boolean;
+}
+export declare const ADD_TIME_UNIT_MINUTES: readonly [10, 15, 20, 30, 45, 60];
+export declare function buildAddTimeCandidates(products: AddTimeProduct[]): AddTimeCandidate[];
+export declare function resolveBestAddTimePlan(products: AddTimeProduct[], targetMinutes: number): AddTimePlan;
+export {};