@pisell/pisellos 2.3.86 → 2.3.88

package/dist/solution/UnifiedBookingSales/index.js

@@ -52,6 +52,30 @@ function normalizePositiveInteger(value) {
   if (!Number.isInteger(normalized) || normalized <= 0) return undefined;
   return normalized;
 }
+function getCandidateDurationMinutes(candidate) {
+  var startAt = candidate.bookingStartAt || candidate.startAt;
+  var endAt = candidate.bookingEndAt || candidate.endAt;
+  try {
+    var start = localDateTimeToScalar(parseLocalDateTime(startAt));
+    var end = localDateTimeToScalar(parseLocalDateTime(endAt));
+    var minutes = Math.round((end - start) / 60000);
+    return Number.isInteger(minutes) && minutes > 0 ? minutes : undefined;
+  } catch (_error) {
+    return undefined;
+  }
+}
+function getCandidateStartTime(candidate) {
+  if (/^([01]\d|2[0-3]):[0-5]\d$/.test(candidate.startTime || '')) {
+    return candidate.startTime;
+  }
+  var startAt = candidate.bookingStartAt || candidate.startAt;
+  try {
+    var start = parseLocalDateTime(startAt);
+    return "".concat(String(start.hour).padStart(2, '0'), ":").concat(String(start.minute).padStart(2, '0'));
+  } catch (_error) {
+    return undefined;
+  }
+}
 function isRecord(value) {
   return !!value && _typeof(value) === 'object' && !Array.isArray(value);
 }
@@ -4332,7 +4356,7 @@ export var UnifiedBookingSalesImpl = /*#__PURE__*/function (_BookingTicket) {
     key: "commitAvailabilitySelection",
     value: (function () {
       var _commitAvailabilitySelection = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee37(contextId, params) {
-        var normalizedContextId, _params$bookingCount, _ref46, _params$orderProduct$, _params$orderProduct, _params$orderProduct2, _params$orderProduct3, _params$orderProduct$2, _params$orderProduct4, _params$orderProduct5, _editingLine$product_, _baseProjection$meta$, _refreshedProjection$, _baseProjection$meta$2, _this$otherParams$pla, _this$otherParams17, _ref47, _params$orderProduct$3, _params$orderProduct6, _existingBooking$meta, _ref48, _ref49, _params$orderProduct$4, _params$orderProduct7, _params$orderProduct8, _existingBooking$meta2, _existingBooking$hold, bookingCount, orderProductQuantity, partySize, _yield$this$ensureAva3, context, projectionEntry, refreshed, boundEditingUids, orderProductId, editingLine, _editingLine$product_2, baseProjection, commitWriteGuard, prepareParams, fallbackResources, commitSnapshot, refreshedProjection, _baseProjection$meta$3, latestContext, refreshedRanges, refreshedCandidateBase, product, validation, allowPosAvailabilityOverride, forced, capacityConflict, revalidationEntry, revalidatedContext, refreshedCandidate, existingBooking, existingBookingUid, booking, transformed, productLineUid, bookingUid, productLineUids, bookingUids, _transformed$product_, _transformed$product_2, _transformed$product_3, _ref50, _transformed$product_4, _this$getTempOrder4, _this$getTempOrder5, _this$getTempOrder6, beforeProductLineUids, beforeBookingUids, products, addedLines, addedBookings, nextContext, result;
+        var normalizedContextId, _params$bookingCount, _ref46, _params$orderProduct$, _params$orderProduct, _params$orderProduct2, _params$orderProduct3, _params$orderProduct$2, _params$orderProduct4, _params$orderProduct5, _editingLine$product_, _baseProjection$meta$, _refreshedProjection$, _baseProjection$meta$2, _this$otherParams$pla, _this$otherParams17, _ref47, _params$orderProduct$3, _params$orderProduct6, _existingBooking$meta, _ref48, _ref49, _params$orderProduct$4, _params$orderProduct7, _params$orderProduct8, _existingBooking$meta2, _existingBooking$hold, bookingCount, orderProductQuantity, partySize, _yield$this$ensureAva3, context, projectionEntry, refreshed, boundEditingUids, orderProductId, editingLine, _editingLine$product_2, baseProjection, commitWriteGuard, prepareParams, fallbackResources, commitSnapshot, refreshedProjection, _baseProjection$meta$3, latestContext, candidateDurationMinutes, candidateStartTime, refreshedRanges, refreshedCandidateBase, product, validation, allowPosAvailabilityOverride, forced, capacityConflict, revalidationEntry, revalidatedContext, refreshedCandidate, existingBooking, existingBookingUid, booking, transformed, productLineUid, bookingUid, productLineUids, bookingUids, _transformed$product_, _transformed$product_2, _transformed$product_3, _ref50, _transformed$product_4, _this$getTempOrder4, _this$getTempOrder5, _this$getTempOrder6, beforeProductLineUids, beforeBookingUids, products, addedLines, addedBookings, nextContext, result;
         return _regeneratorRuntime().wrap(function _callee37$(_context37) {
           while (1) switch (_context37.prev = _context37.next) {
             case 0:
@@ -4560,20 +4584,26 @@ export var UnifiedBookingSalesImpl = /*#__PURE__*/function (_BookingTicket) {
               });
             case 67:
               this.assertAvailabilityCommitWriteCAS(commitWriteGuard);
-              refreshedRanges = getProjectionProductTimeRanges(refreshedProjection, {
+              candidateDurationMinutes = getCandidateDurationMinutes(params.candidate);
+              candidateStartTime = getCandidateStartTime(params.candidate);
+              refreshedRanges = getProjectionProductTimeRanges(refreshedProjection, _objectSpread({
                 productIds: [params.candidate.productId],
                 dateRange: {
                   startDate: params.candidate.startAt.slice(0, 10),
                   endDate: params.candidate.startAt.slice(0, 10)
                 }
-              }).flatMap(function (group) {
+              }, candidateDurationMinutes ? _objectSpread({
+                durationMinutesByProductId: _defineProperty({}, String(params.candidate.productId), candidateDurationMinutes)
+              }, candidateStartTime ? {
+                durationStartTimesByProductId: _defineProperty({}, String(params.candidate.productId), [candidateStartTime])
+              } : {}) : {})).flatMap(function (group) {
                 return group.ranges;
               });
               refreshedCandidateBase = refreshedRanges.find(function (candidate) {
                 return candidate.startAt === params.candidate.startAt && candidate.endAt === params.candidate.endAt && candidate.bookingStartAt === params.candidate.bookingStartAt && candidate.bookingEndAt === params.candidate.bookingEndAt;
               });
               if (refreshedCandidateBase) {
-                _context37.next = 72;
+                _context37.next = 74;
                 break;
               }
               throw new AvailabilityError('REVALIDATION_FAILED', '缓存重校验后候选时间已不在商品配置中', {
@@ -4581,18 +4611,18 @@ export var UnifiedBookingSalesImpl = /*#__PURE__*/function (_BookingTicket) {
                 candidate: params.candidate,
                 refreshedSnapshotId: refreshedProjection.meta.snapshotId
               });
-            case 72:
+            case 74:
               product = refreshedProjection.products.find(function (item) {
                 return sameAvailabilityId(item.id, refreshedCandidateBase.productId);
               });
               if (product) {
-                _context37.next = 75;
+                _context37.next = 77;
                 break;
               }
               throw new AvailabilityError('REVALIDATION_FAILED', '缓存重校验后商品不在 projection 中', {
                 productId: refreshedCandidateBase.productId
               });
-            case 75:
+            case 77:
               validation = validateAvailabilitySelection(refreshedProjection, {
                 candidate: refreshedCandidateBase,
                 requirementSelections: params.requirementSelections,
@@ -4621,7 +4651,7 @@ export var UnifiedBookingSalesImpl = /*#__PURE__*/function (_BookingTicket) {
                 });
               }
               if (validation.ok) {
-                _context37.next = 81;
+                _context37.next = 83;
                 break;
               }
               capacityConflict = validation.conflicts.find(function (conflict) {
@@ -4631,7 +4661,7 @@ export var UnifiedBookingSalesImpl = /*#__PURE__*/function (_BookingTicket) {
                 validation: validation,
                 refreshedSnapshotId: refreshedProjection.meta.snapshotId
               });
-            case 81:
+            case 83:
               // Revalidation failure must leave the caller's candidate reusable. Only publish the
               // refreshed projection/version after candidate and resource validation has passed;
               // otherwise a second Confirm from the still-open modal would incorrectly become stale.
@@ -4644,7 +4674,7 @@ export var UnifiedBookingSalesImpl = /*#__PURE__*/function (_BookingTicket) {
                 incrementVersion: true
               });
               revalidatedContext = this.getAvailabilityContextEntry(normalizedContextId);
-              _context37.next = 85;
+              _context37.next = 87;
               return this.emitAvailabilityDiagnostic({
                 action: 'refresh',
                 contextId: normalizedContextId,
@@ -4655,7 +4685,7 @@ export var UnifiedBookingSalesImpl = /*#__PURE__*/function (_BookingTicket) {
                 previousOrderRevision: baseProjection.meta.orderRevision,
                 reason: 'commit_cached_occupancy_revalidation'
               });
-            case 85:
+            case 87:
               commitWriteGuard = {
                 contextId: normalizedContextId,
                 expectedVersion: revalidatedContext.activeVersion,
@@ -4667,13 +4697,13 @@ export var UnifiedBookingSalesImpl = /*#__PURE__*/function (_BookingTicket) {
               existingBooking = editingLine ? this.findLinkedBooking(editingLine) : undefined;
               existingBookingUid = existingBooking ? getBookingUid(existingBooking) : '';
               if (!(params.mode === 'edit' && !existingBookingUid)) {
-                _context37.next = 91;
+                _context37.next = 93;
                 break;
               }
               throw new AvailabilityError('PRODUCT_LINE_NOT_FOUND', '编辑商品行缺少关联 booking', {
                 productLineUid: params.productLineUid
               });
-            case 91:
+            case 93:
               this.assertAvailabilityCommitWriteCAS(commitWriteGuard);
               booking = buildBookingFromAvailabilitySelection({
                 assignments: validation.assignments,
@@ -4689,13 +4719,13 @@ export var UnifiedBookingSalesImpl = /*#__PURE__*/function (_BookingTicket) {
                 quantity: bookingCount
               }), 'unified_booking_sales', product);
               if (transformed) {
-                _context37.next = 96;
+                _context37.next = 98;
                 break;
               }
               throw new AvailabilityError('INVALID_TARGET_FILTER', 'orderProduct 无法转换为订单行', {
                 orderProduct: params.orderProduct
               });
-            case 96:
+            case 98:
               transformed.num = bookingCount;
               transformed.metadata = _objectSpread(_objectSpread({}, transformed.metadata || {}), {}, {
                 unified_booking_sales: true,
@@ -4708,7 +4738,7 @@ export var UnifiedBookingSalesImpl = /*#__PURE__*/function (_BookingTicket) {
               productLineUids = [];
               bookingUids = [];
               if (!(params.mode === 'edit' && editingLine && params.productLineUid)) {
-                _context37.next = 115;
+                _context37.next = 117;
                 break;
               }
               transformed.product_sku = (_transformed$product_ = transformed.product_sku) !== null && _transformed$product_ !== void 0 ? _transformed$product_ : editingLine.product_sku;
@@ -4718,7 +4748,7 @@ export var UnifiedBookingSalesImpl = /*#__PURE__*/function (_BookingTicket) {
                 unique_identification_number: params.productLineUid,
                 booking_uid: existingBookingUid
               });
-              _context37.next = 109;
+              _context37.next = 111;
               return this.updateOrderProduct(_objectSpread(_objectSpread({
                 product_id: (_transformed$product_3 = transformed.product_id) !== null && _transformed$product_3 !== void 0 ? _transformed$product_3 : editingLine.product_id,
                 product_variant_id: (_ref50 = (_transformed$product_4 = transformed.product_variant_id) !== null && _transformed$product_4 !== void 0 ? _transformed$product_4 : editingLine.product_variant_id) !== null && _ref50 !== void 0 ? _ref50 : 0,
@@ -4730,23 +4760,23 @@ export var UnifiedBookingSalesImpl = /*#__PURE__*/function (_BookingTicket) {
               } : {}), params.allowBookingDiscountReapply !== undefined ? {
                 allow_booking_discount_reapply: params.allowBookingDiscountReapply
               } : {}));
-            case 109:
+            case 111:
               productLineUid = params.productLineUid;
               bookingUid = existingBookingUid;
               productLineUids = [productLineUid];
               bookingUids = [bookingUid];
-              _context37.next = 127;
+              _context37.next = 129;
               break;
-            case 115:
+            case 117:
               beforeProductLineUids = new Set((((_this$getTempOrder4 = this.getTempOrder()) === null || _this$getTempOrder4 === void 0 ? void 0 : _this$getTempOrder4.products) || []).map(function (line) {
                 return getProductLineUid(line);
               }).filter(Boolean));
               beforeBookingUids = new Set((((_this$getTempOrder5 = this.getTempOrder()) === null || _this$getTempOrder5 === void 0 ? void 0 : _this$getTempOrder5.bookings) || []).map(function (item) {
                 return getBookingUid(item);
               }).filter(Boolean));
-              _context37.next = 119;
+              _context37.next = 121;
               return this.addProductToOrder(transformed, booking);
-            case 119:
+            case 121:
               products = _context37.sent;
               addedLines = products.filter(function (line) {
                 var _line$product_id, _line$metadata;
@@ -4770,7 +4800,7 @@ export var UnifiedBookingSalesImpl = /*#__PURE__*/function (_BookingTicket) {
               }
               productLineUid = productLineUids[productLineUids.length - 1] || '';
               bookingUid = bookingUids[bookingUids.length - 1] || '';
-            case 127:
+            case 129:
               this.invalidateAvailabilityContextsAfterCommit();
               nextContext = this.getAvailabilityContextEntry(normalizedContextId);
               result = {
@@ -4784,21 +4814,21 @@ export var UnifiedBookingSalesImpl = /*#__PURE__*/function (_BookingTicket) {
                 productLineUids: productLineUids,
                 bookingUids: bookingUids
               };
-              _context37.next = 132;
+              _context37.next = 134;
               return this.core.effects.emit("".concat(this.name, ":").concat(UnifiedBookingSalesHooks.onAvailabilitySelectionCommitted), result);
-            case 132:
+            case 134:
               return _context37.abrupt("return", result);
-            case 133:
-              _context37.prev = 133;
-              _context37.next = 136;
+            case 135:
+              _context37.prev = 135;
+              _context37.next = 138;
               return this.releaseAvailabilityCommitLock(normalizedContextId);
-            case 136:
-              return _context37.finish(133);
-            case 137:
+            case 138:
+              return _context37.finish(135);
+            case 139:
             case "end":
               return _context37.stop();
           }
-        }, _callee37, this, [[5,, 133, 137]]);
+        }, _callee37, this, [[5,, 135, 139]]);
       }));
       function commitAvailabilitySelection(_x32, _x33) {
         return _commitAvailabilitySelection.apply(this, arguments);

package/lib/modules/Order/index.js

@@ -3794,6 +3794,13 @@ class OrderModule extends _BaseModule.BaseModule {
     }
     this.store.syncState = 'submitting';
     const paymentSyncIdempotencyToken = this.buildPaymentSyncIdempotencyToken(tempOrder, effectivePayments);
+    const enhancePayload = (payload, ctx) => {
+      const enhancedPayload = params.enhancePayload ? params.enhancePayload(payload, ctx) : payload;
+      return {
+        ...enhancedPayload,
+        request_unique_idempotency_token: paymentSyncIdempotencyToken
+      };
+    };
     const submitParams = {
       payments: effectivePayments,
       paymentStatus,
@@ -3801,13 +3808,7 @@ class OrderModule extends _BaseModule.BaseModule {
       businessCode: params.businessCode,
       channel: params.channel,
       confirmPendingVoucherPayments: true,
-      enhancePayload: payload => {
-        const nextPayload = {
-          ...payload,
-          request_unique_idempotency_token: paymentSyncIdempotencyToken
-        };
-        return nextPayload;
-      }
+      enhancePayload
     };
     const submitResult = params.checkoutSyncTaskEnabled === false ? await this.submitTempOrderAsync(submitParams) : await this.submitTempOrder(submitParams);
     return {

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

@@ -608,6 +608,7 @@ export interface SyncPaymentsToOrderParams {
     businessCode?: string;
     channel?: string;
     confirmPendingVoucherPayments?: boolean;
+    enhancePayload?: SubmitPayloadEnhancer;
 }
 export interface SyncPaymentsToOrderResult<T = any> {
     isFullyPaid: boolean;

package/lib/modules/ResourcePlanner/planner.js

@@ -48,6 +48,19 @@ function normalizeBookingCount(bookingCount) {
   }
   return normalized;
 }
+function resolveRequestedDurationMinutes(product, request) {
+  const configured = Math.max(1, Number(product.durationMinutes || 30) || 30);
+  if (product.kind !== 'duration') return configured;
+  const override = request.durationMinutesByProductId?.[String(product.id)];
+  const normalized = Number(override);
+  return Number.isInteger(normalized) && normalized > 0 ? normalized : configured;
+}
+function resolveRequestedDurationStartTimes(product, request) {
+  if (product.kind !== 'duration') return [];
+  const values = request.durationStartTimesByProductId?.[String(product.id)];
+  if (!Array.isArray(values)) return [];
+  return Array.from(new Set(values.filter(value => typeof value === 'string' && /^([01]\d|2[0-3]):[0-5]\d$/.test(value))));
+}
 function toDateTime(value, _timezoneName) {
   try {
     return (0, _localClock.localDateTimeToScalar)((0, _localClock.parseLocalDateTime)(value));
@@ -865,9 +878,27 @@ function dedupeProductRanges(ranges) {
   });
   return Array.from(map.values()).sort((left, right) => left.startAt.localeCompare(right.startAt));
 }
+function createDurationTimeRange(product, start, durationMinutes, projection, fixedOffsetMinutes) {
+  const bookingEnd = addMinutesZoned(start, durationMinutes, projection.meta.timezone);
+  return {
+    key: `${String(product.id)}:${start}:${bookingEnd}`,
+    productId: product.id,
+    source: 'duration_window',
+    startAt: formatDateTime(start, projection.meta.timezone, fixedOffsetMinutes),
+    endAt: formatDateTime(bookingEnd, projection.meta.timezone, fixedOffsetMinutes),
+    bookingStartAt: formatDateTime(start, projection.meta.timezone, fixedOffsetMinutes),
+    bookingEndAt: formatDateTime(bookingEnd, projection.meta.timezone, fixedOffsetMinutes),
+    date: formatDate(start, projection.meta.timezone),
+    startTime: formatTime(start, projection.meta.timezone),
+    endTime: formatTime(bookingEnd, projection.meta.timezone),
+    timezone: projection.meta.timezone,
+    scheduleRefs: []
+  };
+}
 function getProductTimeRanges(projection, request = {}) {
   const normalizedPartySize = normalizePartySize(request.partySize);
   const dateRange = resolveProjectionDateRange(projection, request.dateRange);
+  const slotStepMinutes = projection.meta.defaults.slotStepMinutes;
   const fixedOffsetMinutes = (0, _localClock.extractFixedOffsetMinutes)(projection.meta.now) ?? (0, _localClock.captureRuntimeOffsetMinutes)();
   const resourceWindowIndex = buildResourceWindowIndex(projection);
   const filteredProductIdSet = request.productIds?.length ? new Set(request.productIds.map(String)) : null;
@@ -877,6 +908,7 @@ function getProductTimeRanges(projection, request = {}) {
         productId: product.id,
         title: product.title,
         kind: product.kind,
+        slotStepMinutes,
         ranges: []
       };
     }
@@ -885,6 +917,7 @@ function getProductTimeRanges(projection, request = {}) {
         productId: product.id,
         title: product.title,
         kind: product.kind,
+        slotStepMinutes,
         ranges: getSessionRangesForProduct(projection, product, dateRange)
       };
     }
@@ -900,9 +933,9 @@ function getProductTimeRanges(projection, request = {}) {
       resourceWindowIndex
     })).reduce((current, ranges) => current === null ? ranges : intersectRangeLists(current, ranges), null) || [] : null;
     const baseRanges = resourceRanges === null ? operatingRanges : intersectRangeLists(resourceRanges, operatingRanges);
-    const durationMinutes = Math.max(1, Number(product.durationMinutes || 30) || 30);
-    const timeSliceMinutes = projection.meta.defaults.slotStepMinutes;
+    const durationMinutes = resolveRequestedDurationMinutes(product, request);
     const durationAnchor = ceilToTenMinutes(toDateTime(projection.meta.durationCandidateAnchorAt, projection.meta.timezone), projection.meta.timezone);
+    const requestedStartTimes = resolveRequestedDurationStartTimes(product, request);
     const ranges = [];
     baseRanges.forEach(range => {
       if (range.end <= durationAnchor) return;
@@ -915,28 +948,26 @@ function getProductTimeRanges(projection, request = {}) {
         if (bookingEnd > range.end) break;
         const bookingDate = formatDate(cursor);
         if (bookingDate >= dateRange.startDate && bookingDate <= dateRange.endDate) {
-          ranges.push({
-            key: `${String(product.id)}:${cursor}:${bookingEnd}`,
-            productId: product.id,
-            source: 'duration_window',
-            startAt: formatDateTime(cursor, projection.meta.timezone, fixedOffsetMinutes),
-            endAt: formatDateTime(bookingEnd, projection.meta.timezone, fixedOffsetMinutes),
-            bookingStartAt: formatDateTime(cursor, projection.meta.timezone, fixedOffsetMinutes),
-            bookingEndAt: formatDateTime(bookingEnd, projection.meta.timezone, fixedOffsetMinutes),
-            date: formatDate(cursor, projection.meta.timezone),
-            startTime: formatTime(cursor, projection.meta.timezone),
-            endTime: formatTime(bookingEnd, projection.meta.timezone),
-            timezone: projection.meta.timezone,
-            scheduleRefs: []
-          });
+          ranges.push(createDurationTimeRange(product, cursor, durationMinutes, projection, fixedOffsetMinutes));
         }
-        cursor = addMinutesZoned(cursor, timeSliceMinutes, projection.meta.timezone);
+        cursor = addMinutesZoned(cursor, slotStepMinutes, projection.meta.timezone);
       }
     });
+    if (dateRange.startDate === dateRange.endDate && requestedStartTimes.length > 0) {
+      requestedStartTimes.forEach(startTime => {
+        const start = toDateTimeInDate(dateRange.startDate, startTime, projection.meta.timezone);
+        if (!Number.isFinite(start)) return;
+        const end = addMinutesZoned(start, durationMinutes, projection.meta.timezone);
+        const startsInOperatingRange = operatingRanges.some(range => range.start <= start && start < range.end);
+        if (!startsInOperatingRange) return;
+        ranges.push(createDurationTimeRange(product, start, durationMinutes, projection, fixedOffsetMinutes));
+      });
+    }
     return {
       productId: product.id,
       title: product.title,
       kind: product.kind,
+      slotStepMinutes,
       ranges: dedupeProductRanges(ranges)
     };
   });

package/lib/modules/ResourcePlanner/types.d.ts

@@ -211,6 +211,7 @@ export interface ProductTimeRangeGroup {
     productId: AvailabilityId;
     title?: string;
     kind: AvailabilityProductKind;
+    slotStepMinutes?: number;
     ranges: ProductTimeRange[];
 }
 export interface AvailabilityAssignment extends AvailabilityAbsoluteRange {
@@ -231,6 +232,8 @@ export interface GetProductTimeRangesRequest {
     dateRange?: Partial<AvailabilityDateRange>;
     resourceIds?: AvailabilityId[];
     partySize?: number;
+    durationMinutesByProductId?: Record<string, number>;
+    durationStartTimesByProductId?: Record<string, string[]>;
 }
 export interface QueryAvailabilityBaseRequest {
     productIds?: AvailabilityId[];

package/lib/server/index.d.ts

@@ -511,6 +511,10 @@ declare class Server {
     private buildCheckoutTaskIdempotencyKey;
     private isBlankCheckoutValue;
     private isLocalCheckoutOrderId;
+    private applyCheckoutFulfillmentBuzzer;
+    private buildCheckoutResourceIdentifierBuzzer;
+    private getCheckoutResourceIdentifier;
+    private stringifyCheckoutResourceIdentifier;
     private normalizeCheckoutSubmitData;
     private ensureCheckoutOrderNumbers;
     private dispatchCheckoutSyncTask;

package/lib/server/index.js

@@ -40,6 +40,8 @@ Object.keys(_modules).forEach(function (key) {
   });
 });
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+const OS_FULFILLMENT_REF_MODE_FIELD = '_os_fulfillment_ref_mode';
+
 // 重新导出类型供外部使用
 
 /** 商品查询订阅者 */
@@ -624,7 +626,8 @@ class Server {
       title
     } = params;
     const normalizedData = await this.normalizeCheckoutSubmitData(params.data, title);
-    const checkoutData = await this.ensureCheckoutOrderNumbers(normalizedData, title);
+    const numberedData = await this.ensureCheckoutOrderNumbers(normalizedData, title);
+    const checkoutData = this.applyCheckoutFulfillmentBuzzer(numberedData, title);
     const remoteCheckoutData = this.buildRemoteCheckoutData(checkoutData, title);
     if (!this.app?.request?.post) {
       throw new Error('app.request 不可用');
@@ -693,6 +696,7 @@ class Server {
     const next = (0, _lodashEs.cloneDeep)(this.omitCheckoutSyncMode(data));
     if (!next || typeof next !== 'object') return next;
     const record = next;
+    delete record[OS_FULFILLMENT_REF_MODE_FIELD];
     if (!Array.isArray(record.payments)) return next;
     const originalPayments = record.payments;
     const filteredPayments = originalPayments.filter(payment => !(0, _paymentUtils.isPendingOrderPayment)(payment));
@@ -3379,6 +3383,82 @@ class Server {
   isLocalCheckoutOrderId(orderId) {
     return typeof orderId === 'string' && orderId.startsWith('LOCAL_');
   }
+  applyCheckoutFulfillmentBuzzer(data, title) {
+    if (!data || typeof data !== 'object') return data;
+    const next = {
+      ...data
+    };
+    const refMode = String(next[OS_FULFILLMENT_REF_MODE_FIELD] || '').trim();
+    delete next[OS_FULFILLMENT_REF_MODE_FIELD];
+    if (!refMode) return next;
+    if (refMode === 'manual_input') {
+      this.logInfo(`${title}: fulfillment ref mode 保留手动 buzzer`, {
+        fulfillment_ref_mode: refMode,
+        has_buzzer: !this.isBlankCheckoutValue(next.buzzer)
+      });
+      return next;
+    }
+    if (refMode === 'resource_identifier') {
+      next.buzzer = this.buildCheckoutResourceIdentifierBuzzer(next.bookings);
+    } else if (refMode === 'sale_number') {
+      next.buzzer = this.isBlankCheckoutValue(next.shop_order_number) ? '' : String(next.shop_order_number);
+    } else if (refMode === 'short_number') {
+      next.buzzer = this.isBlankCheckoutValue(next.shop_full_order_number) ? '' : String(next.shop_full_order_number);
+    } else {
+      this.logWarning(`${title}: 未识别的 fulfillment ref mode，跳过 buzzer 自动填充`, {
+        fulfillment_ref_mode: refMode
+      });
+      return next;
+    }
+    this.logInfo(`${title}: fulfillment ref mode 已填充 buzzer`, {
+      fulfillment_ref_mode: refMode,
+      buzzer: next.buzzer
+    });
+    return next;
+  }
+  buildCheckoutResourceIdentifierBuzzer(bookings) {
+    if (!Array.isArray(bookings)) return '';
+    const values = [];
+    const seen = new Set();
+    const visitResource = resource => {
+      const identifier = this.getCheckoutResourceIdentifier(resource);
+      if (identifier && !seen.has(identifier)) {
+        seen.add(identifier);
+        values.push(identifier);
+      }
+      if (Array.isArray(resource?.children)) {
+        resource.children.forEach(visitResource);
+      }
+    };
+    bookings.forEach(booking => {
+      if (Array.isArray(booking?.resources)) {
+        booking.resources.forEach(visitResource);
+      }
+    });
+    return values.join(',');
+  }
+  getCheckoutResourceIdentifier(resource) {
+    if (!resource || typeof resource !== 'object') return '';
+    const candidates = [resource.main_field, resource.name, resource.title, resource.metadata?.resource_name, resource.metadata?.name, resource.relation_id, resource.id];
+    for (const candidate of candidates) {
+      const value = this.stringifyCheckoutResourceIdentifier(candidate);
+      if (value) return value;
+    }
+    return '';
+  }
+  stringifyCheckoutResourceIdentifier(value) {
+    if (value === undefined || value === null) return '';
+    if (typeof value === 'string' || typeof value === 'number') {
+      return String(value).trim();
+    }
+    if (typeof value !== 'object' || Array.isArray(value)) return '';
+    const localeCandidates = [value.original, value.auto, value.en, value['zh-CN'], value.zh_CN, value['zh-HK'], value.zh_HK];
+    for (const candidate of localeCandidates) {
+      const normalized = this.stringifyCheckoutResourceIdentifier(candidate);
+      if (normalized) return normalized;
+    }
+    return '';
+  }
   async normalizeCheckoutSubmitData(data, title) {
     if (!data || typeof data !== 'object') return data;
     const next = {
@@ -3936,7 +4016,8 @@ class Server {
       });
     }
     const normalizedData = await this.normalizeCheckoutSubmitData(data, title);
-    const checkoutData = await this.ensureCheckoutOrderNumbers(normalizedData, title);
+    const numberedData = await this.ensureCheckoutOrderNumbers(normalizedData, title);
+    const checkoutData = this.applyCheckoutFulfillmentBuzzer(numberedData, title);
     const pendingResult = await this.handlePendingSyncCheckoutOrder({
       backendPath,
       data: checkoutData,

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

@@ -151,6 +151,9 @@ export declare class BaseSalesImpl extends BaseModule implements Module {
     private getAuthoritativeBundleUnitPrice;
     private mergeProductForPriceQuery;
     protected getSubmitOrderSalesChannel(): string | undefined;
+    private getFulfillmentRefModeConfigs;
+    private getFulfillmentRefMode;
+    private buildSubmitPayloadEnhancerWithFulfillmentRefMode;
     /**
      * 工厂入口：根据子模块名实例化对应模块。
      * 默认使用 BookingByStep 公共 `createModule`。子类若需引入额外类型（如 customer），

package/lib/solution/BaseSales/index.js

@@ -36,6 +36,7 @@ var _transformBaseProductToOrderProduct = require("./utils/transformBaseProductT
 var _quotationPrice = require("./utils/quotationPrice");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 const SERVER_ORDER_CHANGED_EVENT = 'order:onOrdersChanged';
+const OS_FULFILLMENT_REF_MODE_FIELD = '_os_fulfillment_ref_mode';
 const WALLET_PAYMENT_CODE_BY_TAG = {
   product_voucher: 'PRODUCTVOUCHER',
   gift_card: 'GIFTCARD',
@@ -1041,6 +1042,30 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
   getSubmitOrderSalesChannel() {
     return this.otherParams?.channel;
   }
+  getFulfillmentRefModeConfigs() {
+    const candidates = [this.otherParams?.openData, this.otherParams?.dineInConfig, this.store?.openData?.getOpenData?.()];
+    return candidates.filter(candidate => candidate && typeof candidate === 'object' && !Array.isArray(candidate));
+  }
+  getFulfillmentRefMode() {
+    for (const config of this.getFulfillmentRefModeConfigs()) {
+      const mode = config['fulfillment.fulfillment_ref_mode'];
+      if (mode === undefined || mode === null) continue;
+      const normalized = String(mode).trim();
+      if (normalized) return normalized;
+    }
+    return undefined;
+  }
+  buildSubmitPayloadEnhancerWithFulfillmentRefMode(enhancePayload) {
+    const fulfillmentRefMode = this.getFulfillmentRefMode();
+    if (!fulfillmentRefMode) return enhancePayload;
+    return (payload, ctx) => {
+      const enhancedPayload = enhancePayload ? enhancePayload(payload, ctx) : payload;
+      return {
+        ...enhancedPayload,
+        [OS_FULFILLMENT_REF_MODE_FIELD]: fulfillmentRefMode
+      };
+    };
+  }
 
   /**
    * 工厂入口：根据子模块名实例化对应模块。
@@ -2018,6 +2043,7 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
     // this.store.order.persistTempOrder();
     const inferredPaymentStatus = this.getSubmitPaymentStatus(params?.paymentStatus);
     const smallTicketDataFlag = params?.smallTicketDataFlag ?? this.getDefaultCheckoutSmallTicketDataFlag();
+    const enhancePayload = this.buildSubmitPayloadEnhancerWithFulfillmentRefMode(params?.enhancePayload);
     const submitParams = {
       cacheId: this.cacheId,
       platform: this.otherParams?.platform,
@@ -2037,8 +2063,8 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
       ...(params?.confirmPendingVoucherPayments !== undefined ? {
         confirmPendingVoucherPayments: params.confirmPendingVoucherPayments
       } : {}),
-      ...(params?.enhancePayload !== undefined ? {
-        enhancePayload: params.enhancePayload
+      ...(enhancePayload !== undefined ? {
+        enhancePayload
       } : {})
     };
     return this.shouldUseCheckoutSyncTask() ? this.store.order.submitTempOrder(submitParams) : this.store.order.submitTempOrderAsync(submitParams);
@@ -2064,6 +2090,7 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
     }
     const inferredPaymentStatus = this.getSubmitPaymentStatus(params?.paymentStatus);
     const smallTicketDataFlag = params?.smallTicketDataFlag ?? this.getDefaultCheckoutSmallTicketDataFlag();
+    const enhancePayload = this.buildSubmitPayloadEnhancerWithFulfillmentRefMode(params?.enhancePayload);
     const submitParams = {
       cacheId: this.cacheId,
       platform: this.otherParams?.platform,
@@ -2083,8 +2110,8 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
       ...(params?.confirmPendingVoucherPayments !== undefined ? {
         confirmPendingVoucherPayments: params.confirmPendingVoucherPayments
       } : {}),
-      ...(params?.enhancePayload !== undefined ? {
-        enhancePayload: params.enhancePayload
+      ...(enhancePayload !== undefined ? {
+        enhancePayload
       } : {})
     };
     return this.store.order.submitTempOrderAsync(submitParams);
@@ -2157,6 +2184,7 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
     if (!this.store.order) throw new Error('order 模块未初始化');
     const businessCode = params.businessCode ?? this.otherParams?.businessCode ?? this.otherParams?.business_code;
     const channel = params.channel ?? this.getSubmitOrderSalesChannel();
+    const enhancePayload = this.buildSubmitPayloadEnhancerWithFulfillmentRefMode(params.enhancePayload);
     const syncParams = {
       ...params,
       checkoutSyncTaskEnabled: this.shouldUseCheckoutSyncTask(),
@@ -2165,6 +2193,9 @@ class BaseSalesImpl extends _BaseModule.BaseModule {
       } : {}),
       ...(channel !== undefined ? {
         channel
+      } : {}),
+      ...(enhancePayload !== undefined ? {
+        enhancePayload
       } : {})
     };
     const syncState = this.store.order.getOrderSyncState();