@pisell/pisellos 0.0.500 → 0.0.502

package/dist/solution/VenueBooking/utils/timeSlot.js

@@ -1,3 +1,13 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+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); }
 function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
 function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
 function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
@@ -6,6 +16,7 @@ function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len
 function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 import dayjs from 'dayjs';
+import Decimal from 'decimal.js';
 export function isBusinessHoursCrossDay(config) {
   var _config$businessStart = config.businessStartTime.split(':').map(Number),
     _config$businessStart2 = _slicedToArray(_config$businessStart, 2),
@@ -152,6 +163,160 @@ export function computeSlotStatus(params) {
     remainingCapacity: remaining
   };
 }
+
+/**
+ * 合并多个子商品的同一个时段为一个"外层 slot"。
+ * - status 取优先级最高的（available > partially_occupied > occupied > unavailable / past）
+ * - price 取非空子 slot 中最小的那个
+ * - 其它字段使用第一个参考子 slot（外层 slot 不带 productId）
+ */
+function mergeSubSlots(subSlots) {
+  var priority = {
+    available: 5,
+    partially_occupied: 4,
+    occupied: 3,
+    unavailable: 2,
+    past: 1
+  };
+  var best = subSlots[0];
+  var _iterator5 = _createForOfIteratorHelper(subSlots),
+    _step5;
+  try {
+    for (_iterator5.s(); !(_step5 = _iterator5.n()).done;) {
+      var _priority$slot$status, _priority$best$status;
+      var slot = _step5.value;
+      if (((_priority$slot$status = priority[slot.status]) !== null && _priority$slot$status !== void 0 ? _priority$slot$status : 0) > ((_priority$best$status = priority[best.status]) !== null && _priority$best$status !== void 0 ? _priority$best$status : 0)) best = slot;
+    }
+  } catch (err) {
+    _iterator5.e(err);
+  } finally {
+    _iterator5.f();
+  }
+  var minPrice = null;
+  var _iterator6 = _createForOfIteratorHelper(subSlots),
+    _step6;
+  try {
+    for (_iterator6.s(); !(_step6 = _iterator6.n()).done;) {
+      var _slot = _step6.value;
+      if (_slot.price == null) continue;
+      var decimal = new Decimal(_slot.price || '0');
+      if (!minPrice || decimal.lt(minPrice)) minPrice = decimal;
+    }
+  } catch (err) {
+    _iterator6.e(err);
+  } finally {
+    _iterator6.f();
+  }
+  return {
+    startTime: best.startTime,
+    endTime: best.endTime,
+    status: best.status,
+    price: minPrice ? minPrice.toFixed(2) : null,
+    resourceId: best.resourceId,
+    resourceFormId: best.resourceFormId,
+    capacity: best.capacity,
+    remainingCapacity: best.remainingCapacity
+  };
+}
+function buildProductSlots(params) {
+  var date = params.date,
+    config = params.config,
+    resource = params.resource,
+    mapping = params.mapping,
+    timeLabels = params.timeLabels,
+    timesForDate = params.timesForDate,
+    events = params.events,
+    resCapacity = params.resCapacity,
+    now = params.now,
+    crossDay = params.crossDay,
+    quotationPriceMap = params.quotationPriceMap,
+    childRawResources = params.childRawResources,
+    childTimesCache = params.childTimesCache,
+    childEventsCache = params.childEventsCache,
+    config_businessStartHour = params.config_businessStartHour;
+  var slots = [];
+  var _iterator7 = _createForOfIteratorHelper(timeLabels),
+    _step7;
+  try {
+    for (_iterator7.s(); !(_step7 = _iterator7.n()).done;) {
+      var _quotationPriceMap$ge;
+      var label = _step7.value;
+      var _label$split$map = label.split(':').map(Number),
+        _label$split$map2 = _slicedToArray(_label$split$map, 1),
+        h = _label$split$map2[0];
+      var isNextDay = crossDay && h < config_businessStartHour;
+      var slotDate = isNextDay ? dayjs(date).add(1, 'day').format('YYYY-MM-DD') : date;
+      var slotStart = dayjs("".concat(slotDate, " ").concat(label));
+      var slotEnd = slotStart.add(config.slotDurationMinutes, 'minute');
+      var status = void 0;
+      var remainingCapacity = null;
+      if (slotStart.isBefore(now)) {
+        status = 'past';
+      } else if (!isSlotWithinResourceTimes(slotStart, slotEnd, timesForDate)) {
+        status = 'unavailable';
+      } else {
+        var result = computeSlotStatus({
+          slotStart: slotStart,
+          slotEnd: slotEnd,
+          events: events,
+          resourceType: mapping.resourceType,
+          capacity: resCapacity
+        });
+        status = result.status;
+        remainingCapacity = result.remainingCapacity;
+        if (status !== 'occupied' && childRawResources && childRawResources.length) {
+          for (var i = 0; i < childRawResources.length; i++) {
+            var _childTimesCache$i, _childEventsCache$i, _child$capacity;
+            var child = childRawResources[i];
+            var childTimes = (_childTimesCache$i = childTimesCache === null || childTimesCache === void 0 ? void 0 : childTimesCache[i]) !== null && _childTimesCache$i !== void 0 ? _childTimesCache$i : getResourceTimesForDate(child, date, config);
+            var childEvents = (_childEventsCache$i = childEventsCache === null || childEventsCache === void 0 ? void 0 : childEventsCache[i]) !== null && _childEventsCache$i !== void 0 ? _childEventsCache$i : collectEventsForDate(child, date, config);
+            if (!isSlotWithinResourceTimes(slotStart, slotEnd, childTimes)) {
+              status = 'unavailable';
+              remainingCapacity = null;
+              break;
+            }
+            var childType = child.type || 'single';
+            var childResult = computeSlotStatus({
+              slotStart: slotStart,
+              slotEnd: slotEnd,
+              events: childEvents,
+              resourceType: childType,
+              capacity: (_child$capacity = child.capacity) !== null && _child$capacity !== void 0 ? _child$capacity : 1
+            });
+            if (childResult.status === 'occupied') {
+              status = 'occupied';
+              remainingCapacity = 0;
+              break;
+            }
+            if (childResult.status === 'partially_occupied' && status === 'available') {
+              var _remainingCapacity;
+              status = 'partially_occupied';
+              remainingCapacity = Math.min((_remainingCapacity = remainingCapacity) !== null && _remainingCapacity !== void 0 ? _remainingCapacity : childResult.remainingCapacity, childResult.remainingCapacity);
+            }
+          }
+        }
+      }
+      var isBookable = status === 'available' || status === 'partially_occupied';
+      var slotStartStr = slotStart.format('YYYY-MM-DD HH:mm');
+      slots.push({
+        startTime: slotStartStr,
+        endTime: slotEnd.format('YYYY-MM-DD HH:mm'),
+        status: status,
+        price: isBookable ? (_quotationPriceMap$ge = quotationPriceMap === null || quotationPriceMap === void 0 ? void 0 : quotationPriceMap.get("".concat(mapping.productId, ":").concat(slotStartStr))) !== null && _quotationPriceMap$ge !== void 0 ? _quotationPriceMap$ge : mapping.price : null,
+        resourceId: resource.resourceId,
+        resourceFormId: resource.formId,
+        capacity: status === 'past' || status === 'unavailable' ? null : resCapacity,
+        remainingCapacity: remainingCapacity,
+        productId: mapping.productId
+      });
+    }
+  } catch (err) {
+    _iterator7.e(err);
+  } finally {
+    _iterator7.f();
+  }
+  return slots;
+}
 export function buildTimeSlotGrid(params) {
   var date = params.date,
     config = params.config,
@@ -161,83 +326,115 @@ export function buildTimeSlotGrid(params) {
   var timeLabels = generateTimeLabels(config);
   var now = dayjs();
   var crossDay = isBusinessHoursCrossDay(config);
+  var config_businessStartHour = Number(config.businessStartTime.split(':')[0]);
+  var rawResourceById = new Map();
+  var _iterator8 = _createForOfIteratorHelper(rawResources),
+    _step8;
+  try {
+    for (_iterator8.s(); !(_step8 = _iterator8.n()).done;) {
+      var item = _step8.value;
+      rawResourceById.set(item.resourceId, item);
+    }
+  } catch (err) {
+    _iterator8.e(err);
+  } finally {
+    _iterator8.f();
+  }
   var resources = [];
-  var _iterator5 = _createForOfIteratorHelper(rawResources),
-    _step5;
+  var _iterator9 = _createForOfIteratorHelper(rawResources),
+    _step9;
   try {
-    for (_iterator5.s(); !(_step5 = _iterator5.n()).done;) {
+    var _loop = function _loop() {
       var _resource$capacity;
-      var resource = _step5.value;
-      var mapping = resourceProductMap.get(resource.resourceId);
-      if (!mapping) continue;
+      var resource = _step9.value;
+      var mappings = resourceProductMap.get(resource.resourceId);
+      if (!mappings || !mappings.length) return 1; // continue
       var timesForDate = getResourceTimesForDate(resource, date, config);
       var events = collectEventsForDate(resource, date, config);
       var resCapacity = (_resource$capacity = resource.capacity) !== null && _resource$capacity !== void 0 ? _resource$capacity : 1;
-      var slots = [];
-      var _iterator6 = _createForOfIteratorHelper(timeLabels),
-        _step6;
-      try {
-        for (_iterator6.s(); !(_step6 = _iterator6.n()).done;) {
-          var _quotationPriceMap$ge;
-          var label = _step6.value;
-          var _label$split$map = label.split(':').map(Number),
-            _label$split$map2 = _slicedToArray(_label$split$map, 2),
-            h = _label$split$map2[0],
-            m = _label$split$map2[1];
-          var isNextDay = crossDay && h < Number(config.businessStartTime.split(':')[0]);
-          var slotDate = isNextDay ? dayjs(date).add(1, 'day').format('YYYY-MM-DD') : date;
-          var slotStart = dayjs("".concat(slotDate, " ").concat(label));
-          var slotEnd = slotStart.add(config.slotDurationMinutes, 'minute');
-          var status = void 0;
-          var remainingCapacity = null;
-          if (slotStart.isBefore(now)) {
-            status = 'past';
-          } else if (!isSlotWithinResourceTimes(slotStart, slotEnd, timesForDate)) {
-            status = 'unavailable';
-          } else {
-            var result = computeSlotStatus({
-              slotStart: slotStart,
-              slotEnd: slotEnd,
-              events: events,
-              resourceType: mapping.resourceType,
-              capacity: resCapacity
-            });
-            status = result.status;
-            remainingCapacity = result.remainingCapacity;
-          }
-          var isBookable = status === 'available' || status === 'partially_occupied';
-          var slotStartStr = slotStart.format('YYYY-MM-DD HH:mm');
-          slots.push({
-            startTime: slotStartStr,
-            endTime: slotEnd.format('YYYY-MM-DD HH:mm'),
-            status: status,
-            price: isBookable ? (_quotationPriceMap$ge = quotationPriceMap === null || quotationPriceMap === void 0 ? void 0 : quotationPriceMap.get("".concat(mapping.productId, ":").concat(slotStartStr))) !== null && _quotationPriceMap$ge !== void 0 ? _quotationPriceMap$ge : mapping.price : null,
-            resourceId: resource.resourceId,
-            resourceFormId: resource.formId,
-            capacity: status === 'past' || status === 'unavailable' ? null : resCapacity,
-            remainingCapacity: remainingCapacity
+      var combined = resource.combined_resource;
+      var isCombined = !!(combined && combined.status === 1 && Array.isArray(combined.resource_ids) && combined.resource_ids.length);
+      var childRawResources = isCombined ? combined.resource_ids.map(function (id) {
+        return rawResourceById.get(id);
+      }).filter(function (r) {
+        return !!r;
+      }) : undefined;
+      var childTimesCache = childRawResources === null || childRawResources === void 0 ? void 0 : childRawResources.map(function (child) {
+        return getResourceTimesForDate(child, date, config);
+      });
+      var childEventsCache = childRawResources === null || childRawResources === void 0 ? void 0 : childRawResources.map(function (child) {
+        return collectEventsForDate(child, date, config);
+      });
+      var subRows = mappings.map(function (mapping) {
+        var productSlots = buildProductSlots({
+          date: date,
+          config: config,
+          resource: resource,
+          mapping: mapping,
+          timeLabels: timeLabels,
+          timesForDate: timesForDate,
+          events: events,
+          resCapacity: resCapacity,
+          now: now,
+          crossDay: crossDay,
+          quotationPriceMap: quotationPriceMap,
+          childRawResources: childRawResources,
+          childTimesCache: childTimesCache,
+          childEventsCache: childEventsCache,
+          config_businessStartHour: config_businessStartHour
+        });
+        return {
+          productId: mapping.productId,
+          productTitle: mapping.productTitle,
+          price: mapping.price,
+          slots: productSlots
+        };
+      });
+      var hasMultipleProducts = subRows.length > 1;
+      var primary = mappings[0];
+      var outerSlots;
+      if (hasMultipleProducts) {
+        outerSlots = timeLabels.map(function (_label, slotIndex) {
+          var group = subRows.map(function (row) {
+            return row.slots[slotIndex];
           });
-        }
-      } catch (err) {
-        _iterator6.e(err);
-      } finally {
-        _iterator6.f();
+          return mergeSubSlots(group);
+        });
+      } else {
+        outerSlots = subRows[0].slots.map(function (slot) {
+          return _objectSpread(_objectSpread({}, slot), {}, {
+            productId: undefined
+          });
+        });
       }
-      resources.push({
+      var row = {
         resourceId: resource.resourceId,
         resourceFormId: resource.formId,
-        resourceName: resource.main_field || mapping.resourceName,
-        productId: mapping.productId,
-        productTitle: mapping.productTitle,
-        slots: slots
-      });
+        resourceName: resource.main_field || primary.resourceName,
+        productId: primary.productId,
+        productTitle: primary.productTitle,
+        slots: outerSlots
+      };
+      if (hasMultipleProducts) {
+        row.products = subRows;
+        row.hasMultipleProducts = true;
+      }
+      if (isCombined && combined) {
+        row.combinedResource = {
+          resourceIds: _toConsumableArray(combined.resource_ids)
+        };
+      }
+      resources.push(row);
+    };
+    for (_iterator9.s(); !(_step9 = _iterator9.n()).done;) {
+      if (_loop()) continue;
     }
 
     // 按 productId 分组排序，确保同一商品的场地连续排列
   } catch (err) {
-    _iterator5.e(err);
+    _iterator9.e(err);
   } finally {
-    _iterator5.f();
+    _iterator9.f();
   }
   var productOrder = new Map();
   for (var _i = 0, _resources = resources; _i < _resources.length; _i++) {

package/lib/model/strategy/adapter/itemRule/adapter.d.ts

@@ -50,6 +50,14 @@ export declare class ItemRuleAdapter implements BusinessAdapter {
      * 不适用或无配置时返回 null。
      */
     extractQuantityLimits(action: ActionEffect, businessData: ItemRuleBusinessData): QuantityLimitResult | null;
+    /**
+     * 计算当前提交剩余可选的最大数量。
+     *
+     * 仅在 scope='cumulative' 且存在 requiredMax 时生效：
+     * 用 requiredMax 减去 historicalItems 中目标商品的累计数量，保底 0。
+     * 其余场景返回 undefined，保持向后兼容。
+     */
+    private calculateRemainingMax;
     private processPrefillCart;
     /**
      * 根据 quantityFrom 计算预填数量

package/lib/model/strategy/adapter/itemRule/adapter.js

@@ -250,7 +250,7 @@ var ItemRuleAdapter = class {
     const config = action.config;
     if (!config)
       return null;
-    const { scope, quantityRules, targetType, targets } = config;
+    const { scope, quantityRules, targetType, targets, validationMessage } = config;
     if (!this.shouldEvaluateForScope(scope, businessData.submissionIndex ?? 0)) {
       return null;
     }
@@ -283,17 +283,56 @@ var ItemRuleAdapter = class {
         }
       }
     }
+    const remainingMax = this.calculateRemainingMax(
+      scope,
+      requiredMax,
+      targets,
+      businessData
+    );
+    const formattedValidationMessage = this.formatValidationMessage(
+      validationMessage,
+      requiredMin,
+      requiredMax,
+      requiredExact
+    );
     return {
       ruleId: action.id,
       targetType,
       targets,
       requiredMin,
       requiredMax,
+      remainingMax,
       requiredExact,
       mustInclude,
-      scope
+      scope,
+      validationMessage: formattedValidationMessage,
+      rawValidationMessage: validationMessage
     };
   }
+  /**
+   * 计算当前提交剩余可选的最大数量。
+   *
+   * 仅在 scope='cumulative' 且存在 requiredMax 时生效：
+   * 用 requiredMax 减去 historicalItems 中目标商品的累计数量，保底 0。
+   * 其余场景返回 undefined，保持向后兼容。
+   */
+  calculateRemainingMax(scope, requiredMax, targets, businessData) {
+    if (scope !== "cumulative" || typeof requiredMax !== "number") {
+      return void 0;
+    }
+    const historicalItems = businessData.historicalItems;
+    if (!(historicalItems == null ? void 0 : historicalItems.length)) {
+      return Math.max(0, requiredMax);
+    }
+    const targetIds = new Set(targets.map((t) => t.product_id));
+    let historicalQty = 0;
+    for (const item of historicalItems) {
+      if (targetIds.has(item.product_id)) {
+        historicalQty += item.quantity;
+      }
+    }
+    return Math.max(0, requiredMax - historicalQty);
+  }
   // ============================================
   // Prefill Cart 处理
   // ============================================

package/lib/model/strategy/adapter/itemRule/examples.d.ts

@@ -25,6 +25,21 @@ export declare const MAX_BUNS_PER_TABLE_STRATEGY: StrategyConfig;
  *   - Prefill Cart: 自动添加默认锅底 x 1
  */
 export declare const HOTPOT_BASE_REQUIRED_STRATEGY: StrategyConfig;
+/**
+ * 场景：4 款锅底里任选至少 1 款，不自动预填，不限制多选上限
+ *
+ * WHEN: Always active
+ * THEN:
+ *   - Quantity Check: 4 个锅底商品合计数量 >= 1 （OR 组语义）
+ *
+ * 说明：
+ *   - targets 里放多个 product_id 时，ItemRuleAdapter 会把它们视为 OR 组，
+ *     仅校验「合计数量」，不会要求每款各自满足 min。
+ *   - ScanOrder 工具层 buildQuantityLimitIndex 会跳过多目标规则的
+ *     单品索引，避免 UI 把组级 min 误当作每张商品卡的减号下限，
+ *     锁死用户切换锅底的操作。
+ */
+export declare const HOTPOT_BASE_PICK_ONE_STRATEGY: StrategyConfig;
 /**
  * ItemRuleEvaluator 简洁调用示例
  *

package/lib/model/strategy/adapter/itemRule/examples.js

@@ -19,6 +19,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/model/strategy/adapter/itemRule/examples.ts
 var examples_exports = {};
 __export(examples_exports, {
+  HOTPOT_BASE_PICK_ONE_STRATEGY: () => HOTPOT_BASE_PICK_ONE_STRATEGY,
   HOTPOT_BASE_REQUIRED_STRATEGY: () => HOTPOT_BASE_REQUIRED_STRATEGY,
   MAX_BUNS_PER_TABLE_STRATEGY: () => MAX_BUNS_PER_TABLE_STRATEGY,
   MIN_CONDIMENT_PER_PERSON_STRATEGY: () => MIN_CONDIMENT_PER_PERSON_STRATEGY,
@@ -190,6 +191,51 @@ var HOTPOT_BASE_REQUIRED_STRATEGY = {
     }
   ]
 };
+var HOTPOT_BASE_PICK_ONE_STRATEGY = {
+  metadata: {
+    id: "RULE_HOTPOT_BASE_PICK_ONE",
+    name: {
+      "zh-CN": "锅底必选（四选一）",
+      en: "Hotpot base required (pick any)"
+    },
+    type: "item_rule",
+    description: {
+      "zh-CN": "4 款锅底任选至少 1 份",
+      en: "Pick at least 1 hotpot base from the available options"
+    }
+  },
+  conditions: {
+    operator: "and",
+    rules: [],
+    actionIds: ["quantity_check_hotpot_base_group"]
+  },
+  actions: [
+    {
+      id: "quantity_check_hotpot_base_group",
+      type: import_type.ITEM_RULE_ACTION_TYPES.QUANTITY_CHECK,
+      value: null,
+      target: "cart",
+      priority: 10,
+      config: {
+        targetType: "product",
+        targets: [
+          { product_id: 30001 },
+          { product_id: 30002 },
+          { product_id: 30003 },
+          { product_id: 30004 }
+        ],
+        quantityRules: [
+          { comparison: "minimum", source: "fixed", value: 1 }
+        ],
+        scope: "first_submission_only",
+        validationMessage: {
+          "zh-CN": "请至少选择 {min} 款锅底",
+          en: "Please select at least {min} hotpot base"
+        }
+      }
+    }
+  ]
+};
 function quickUseItemRuleEvaluator() {
   const evaluator = new import_evaluator.ItemRuleEvaluator();
   evaluator.setStrategyConfigs([
@@ -261,6 +307,7 @@ function runItemRuleEvaluatorDemo() {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  HOTPOT_BASE_PICK_ONE_STRATEGY,
   HOTPOT_BASE_REQUIRED_STRATEGY,
   MAX_BUNS_PER_TABLE_STRATEGY,
   MIN_CONDIMENT_PER_PERSON_STRATEGY,

package/lib/model/strategy/adapter/itemRule/index.d.ts

@@ -1,5 +1,5 @@
 export { ItemRuleEvaluator } from './evaluator';
 export { ItemRuleAdapter } from './adapter';
 export { default } from './adapter';
-export { MIN_CONDIMENT_PER_PERSON_STRATEGY, MAX_BUNS_PER_TABLE_STRATEGY, HOTPOT_BASE_REQUIRED_STRATEGY, quickUseItemRuleEvaluator, runItemRuleEvaluatorDemo, } from './examples';
+export { MIN_CONDIMENT_PER_PERSON_STRATEGY, MAX_BUNS_PER_TABLE_STRATEGY, HOTPOT_BASE_REQUIRED_STRATEGY, HOTPOT_BASE_PICK_ONE_STRATEGY, quickUseItemRuleEvaluator, runItemRuleEvaluatorDemo, } from './examples';
 export * from './type';

package/lib/model/strategy/adapter/itemRule/index.js

@@ -30,6 +30,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/model/strategy/adapter/itemRule/index.ts
 var itemRule_exports = {};
 __export(itemRule_exports, {
+  HOTPOT_BASE_PICK_ONE_STRATEGY: () => import_examples.HOTPOT_BASE_PICK_ONE_STRATEGY,
   HOTPOT_BASE_REQUIRED_STRATEGY: () => import_examples.HOTPOT_BASE_REQUIRED_STRATEGY,
   ItemRuleAdapter: () => import_adapter.ItemRuleAdapter,
   ItemRuleEvaluator: () => import_evaluator.ItemRuleEvaluator,
@@ -47,6 +48,7 @@ var import_examples = require("./examples");
 __reExport(itemRule_exports, require("./type"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  HOTPOT_BASE_PICK_ONE_STRATEGY,
   HOTPOT_BASE_REQUIRED_STRATEGY,
   ItemRuleAdapter,
   ItemRuleEvaluator,

package/lib/model/strategy/adapter/itemRule/type.d.ts

@@ -180,14 +180,33 @@ export interface QuantityLimitResult {
     targets: TargetItem[];
     /** 要求的最小数量 */
     requiredMin?: number;
-    /** 要求的最大数量 */
+    /** 要求的最大数量（规则配置的原始上限，用于 UI 文案展示） */
     requiredMax?: number;
+    /**
+     * 当前提交剩余可选的最大数量。
+     *
+     * 仅在 scope='cumulative' 且存在 requiredMax 时计算：
+     *   remainingMax = max(0, requiredMax - historicalItems 中目标商品累计数量)
+     *
+     * 非 cumulative 场景不设置此字段；调用方用于限制加购上限时，
+     * 应优先读取本字段，未定义时回退到 requiredMax。
+     */
+    remainingMax?: number;
     /** 要求的精确数量 */
     requiredExact?: number;
     /** 是否必须包含 */
     mustInclude?: boolean;
     /** 作用范围 */
     scope: RuleScope;
+    /**
+     * 校验失败时的提示语（已做 {min}/{max}/{exact} 占位符替换）。
+     * 当 rawValidationMessage 为多语言对象时，后端不做 locale 选择，
+     * 默认按 en → Object.values()[0] 的顺序兜底，前端可再根据自身 locale
+     * 读取 rawValidationMessage 做精确匹配。
+     */
+    validationMessage?: string;
+    /** 原始多语言模板，前端可根据自身 locale 做二次选择 */
+    rawValidationMessage?: string | Record<string, string>;
 }
 /**
  * ItemRule 评估器的完整输出结果

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

@@ -2,6 +2,7 @@ import { Module, PisellCore, ModuleOptions } from '../../types';
 import { BaseModule } from '../BaseModule';
 import { OrderModuleAPI, CommitOrderParams, SubmitScanOrderParams, ScanOrderMoreParams, CheckoutOrderParams } from './types';
 import { CartItem } from '../Cart/types';
+import { type SubmitPayloadEnhancer } from './utils';
 import type { ScanOrderOrderProduct, ScanOrderOrderProductIdentity, ScanOrderSummary, ScanOrderTempOrder } from '../../solution/ScanOrder/types';
 import type { Discount } from '../Discount/types';
 import { UnavailableReason } from '../Rules/types';
@@ -57,6 +58,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     persistTempOrder(): void;
     private createDefaultTempOrderInstance;
     ensureTempOrder(): ScanOrderTempOrder;
+    restoreOrder(): ScanOrderTempOrder;
     getTempOrder(): ScanOrderTempOrder | null;
     addNewOrder(): Promise<ScanOrderTempOrder>;
     getOrderProducts(): ScanOrderOrderProduct[];
@@ -66,6 +68,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     }): Promise<ScanOrderSummary | null>;
     getScanOrderSummary(): Promise<ScanOrderSummary>;
     updateTempOrderNote(note: string): string;
+    updateTempOrderBuzzer(buzzer: string): string;
     updateTempOrderContactsInfo(contactsInfo: any[]): any[];
     addProductToOrder(product: Partial<ScanOrderOrderProduct> & ScanOrderOrderProductIdentity): Promise<ScanOrderOrderProduct[]>;
     updateProductInOrder(params: {
@@ -76,6 +79,11 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     removeProductFromOrder(identity: ScanOrderOrderProductIdentity): Promise<ScanOrderOrderProduct[]>;
     submitTempOrder<T = any>(params?: {
         cacheId?: string;
+        platform?: string;
+        businessCode?: string;
+        channel?: string;
+        type?: string;
+        enhancePayload?: SubmitPayloadEnhancer;
     }): Promise<T>;
     createOrder(params: CommitOrderParams['query']): {
         type: "virtual" | "appointment_booking";
@@ -108,4 +116,6 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     createOrderByCheckout(params: CheckoutOrderParams): Promise<any>;
     submitScanOrder<T = any>(params: SubmitScanOrderParams): Promise<T>;
     scanOrderMore<T = any>(params: ScanOrderMoreParams): Promise<T>;
+    getOrderInfoByRemote(order_id: number): Promise<any>;
+    getLastOrderInfo(): Record<string, any> | undefined;
 }