@pisell/pisellos 2.2.298 → 2.2.300

package/dist/solution/UnifiedBookingSales/index.js

@@ -673,14 +673,9 @@ function normalizeResource(raw) {
   var id = (_ref5 = (_raw$resourceId = raw.resourceId) !== null && _raw$resourceId !== void 0 ? _raw$resourceId : raw.resource_id) !== null && _ref5 !== void 0 ? _ref5 : raw.id;
   if (id === undefined || id === null || id === '') return null;
   var rawWindows = raw.windows || raw.times || [];
-  return {
-    id: id,
-    formId: (_ref6 = (_raw$formId = raw.formId) !== null && _raw$formId !== void 0 ? _raw$formId : raw.form_id) !== null && _ref6 !== void 0 ? _ref6 : raw.resource_form_id,
-    name: raw.resourceName || raw.main_field || raw.name || raw.title,
-    code: raw.code,
-    resourceType: normalizeResourceType(raw.type || raw.resourceType),
-    capacity: Math.max(1, Number(raw.capacity || raw.max_capacity || 1) || 1),
-    windows: (Array.isArray(rawWindows) ? rawWindows : []).flatMap(function (window) {
+  var rawExcludedWindows = raw.excludedWindows || raw.excluded_windows || [];
+  var normalizeWindows = function normalizeWindows(windows) {
+    return (Array.isArray(windows) ? windows : []).flatMap(function (window) {
       var range = normalizeAvailabilityLocalDateTimeRange({
         startAt: window.startAt || window.start_at || window.start,
         endAt: window.endAt || window.end_at || window.end,
@@ -694,7 +689,17 @@ function normalizeResource(raw) {
         source: window.source,
         raw: window
       }];
-    }),
+    });
+  };
+  return {
+    id: id,
+    formId: (_ref6 = (_raw$formId = raw.formId) !== null && _raw$formId !== void 0 ? _raw$formId : raw.form_id) !== null && _ref6 !== void 0 ? _ref6 : raw.resource_form_id,
+    name: raw.resourceName || raw.main_field || raw.name || raw.title,
+    code: raw.code,
+    resourceType: normalizeResourceType(raw.type || raw.resourceType),
+    capacity: Math.max(1, Number(raw.capacity || raw.max_capacity || 1) || 1),
+    windows: normalizeWindows(rawWindows),
+    excludedWindows: normalizeWindows(rawExcludedWindows),
     raw: raw
   };
 }
@@ -718,6 +723,16 @@ function dateRangeDays(dateRange) {
   }
   return dates;
 }
+function getExcludedScheduleDateOverrideTimePoints(date, schedule) {
+  var _schedule$repeat_rule;
+  if (!((_schedule$repeat_rule = schedule.repeat_rule) !== null && _schedule$repeat_rule !== void 0 && (_schedule$repeat_rule = _schedule$repeat_rule.excluded_date) !== null && _schedule$repeat_rule !== void 0 && _schedule$repeat_rule.length)) return [];
+  if (getScheduleStartEndTimePoints(date, [schedule]).length > 0) return [];
+  return getScheduleStartEndTimePoints(date, [_objectSpread(_objectSpread({}, schedule), {}, {
+    repeat_rule: _objectSpread(_objectSpread({}, schedule.repeat_rule), {}, {
+      excluded_date: []
+    })
+  })]);
+}
 function normalizeResourceOccupancy(rawEvent, resourceId) {
   var _ref9, _ref10, _rawEvent$start_at, _ref11, _ref12, _rawEvent$end_at, _ref13, _ref14, _rawEvent$pax, _rawEvent$schedule_ev, _ref15, _rawEvent$schedule_ev2, _ref16, _rawEvent$booking_uid, _rawEvent$metadata, _ref17, _rawEvent$product_uid, _rawEvent$metadata2;
   var source = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'remote';
@@ -824,7 +839,30 @@ export function buildAvailabilityResourcesFromV2(params) {
         });
       });
     });
+    var excludedWindows = dates.flatMap(function (date) {
+      return schedules.flatMap(function (schedule) {
+        return getExcludedScheduleDateOverrideTimePoints(date, schedule).flatMap(function (slot) {
+          var range = normalizeAvailabilityLocalDateTimeRange({
+            startAt: slot.start_at,
+            endAt: slot.end_at,
+            fixedOffsetMinutes: fixedOffsetMinutes,
+            rollOverEnd: true
+          });
+          if (!range) return [];
+          return [{
+            startAt: range.startAt,
+            endAt: range.endAt,
+            source: "resource_schedule_excluded:".concat(schedule.id),
+            raw: {
+              scheduleId: schedule.id,
+              excludedDate: date
+            }
+          }];
+        });
+      });
+    });
     resource.windows = materializedWindows.length > 0 ? materializedWindows : explicitWindows;
+    resource.excludedWindows = [].concat(_toConsumableArray(resource.excludedWindows || []), _toConsumableArray(excludedWindows));
     if (resource.windows.length === 0 && missingScheduleIds.length > 0) {
       resource.windows = buildResourceWindowFallbackTimes({
         raw: raw,
@@ -1092,7 +1130,7 @@ function buildBookingFromAvailabilitySelection(params) {
     } : {})
   });
 }
-var POS_OVERRIDABLE_AVAILABILITY_CONFLICT_CODES = new Set(['past', 'booking_cutoff', 'resource_full', 'resource_unavailable', 'resource_capacity_exceeded',
+var POS_OVERRIDABLE_AVAILABILITY_CONFLICT_CODES = new Set(['past', 'booking_cutoff', 'schedule_excluded_date', 'resource_full', 'resource_unavailable', 'resource_capacity_exceeded',
 // A required group whose selected resource is outside its window is surfaced
 // as missing_resource at group level. Structural validation below still
 // rejects a genuinely missing selection.
@@ -3053,12 +3091,35 @@ export var UnifiedBookingSalesImpl = /*#__PURE__*/function (_BookingTicket) {
           }] : [];
         });
       });
-      return {
+      var excludedWindows = dateRangeDays(params.dateRange).flatMap(function (date) {
+        return schedules.flatMap(function (schedule) {
+          return getExcludedScheduleDateOverrideTimePoints(date, schedule).flatMap(function (slot) {
+            var range = normalizeAvailabilityLocalDateTimeRange({
+              startAt: slot.start_at,
+              endAt: slot.end_at,
+              fixedOffsetMinutes: _this3.getAvailabilityRuntimeOffsetMinutes(),
+              rollOverEnd: true
+            });
+            return range ? [{
+              startAt: range.startAt,
+              endAt: range.endAt,
+              source: "operating_schedule_excluded:".concat(schedule.id),
+              raw: {
+                scheduleId: schedule.id,
+                excludedDate: date
+              }
+            }] : [];
+          });
+        });
+      });
+      return _objectSpread({
         source: descriptor.source,
         scheduleIds: _toConsumableArray(descriptor.scheduleIds),
         missingScheduleIds: missingScheduleIds,
         windows: windows
-      };
+      }, excludedWindows.length > 0 ? {
+        excludedWindows: excludedWindows
+      } : {});
     }
   }, {
     key: "loadAvailabilityProducts",
@@ -4232,7 +4293,8 @@ export var UnifiedBookingSalesImpl = /*#__PURE__*/function (_BookingTicket) {
                 allowOutsideOperatingHoursForRequestedStartTimes: true
               } : {}), {
                 evaluatedAt: this.getAvailabilityRuntimeDateTime(),
-                allowSessionCustomRanges: isPosAvailabilityRequest
+                allowSessionCustomRanges: isPosAvailabilityRequest,
+                allowExcludedScheduleDateOverride: isPosAvailabilityRequest
               }).map(function (group) {
                 return _objectSpread(_objectSpread({}, group), {}, {
                   ranges: group.ranges.map(function (candidate) {
@@ -4255,7 +4317,8 @@ export var UnifiedBookingSalesImpl = /*#__PURE__*/function (_BookingTicket) {
     key: "queryBookingAvailability",
     value: (function () {
       var _queryBookingAvailability = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee36(contextId, request) {
-        var _yield$this$ensureAva2, context, projectionEntry, refreshed, result, contextVersion, contextualResult;
+        var _this$otherParams$pla2, _this$otherParams19;
+        var _yield$this$ensureAva2, context, projectionEntry, refreshed, isPosAvailabilityRequest, result, contextVersion, contextualResult;
         return _regeneratorRuntime().wrap(function _callee36$(_context36) {
           while (1) switch (_context36.prev = _context36.next) {
             case 0:
@@ -4267,7 +4330,10 @@ export var UnifiedBookingSalesImpl = /*#__PURE__*/function (_BookingTicket) {
               projectionEntry = _yield$this$ensureAva2.projectionEntry;
               refreshed = _yield$this$ensureAva2.refreshed;
               this.assertContextualQueryFreshness(context, request);
-              result = queryAvailabilityProjection(projectionEntry.projection, request);
+              isPosAvailabilityRequest = String((_this$otherParams$pla2 = (_this$otherParams19 = this.otherParams) === null || _this$otherParams19 === void 0 ? void 0 : _this$otherParams19.platform) !== null && _this$otherParams$pla2 !== void 0 ? _this$otherParams$pla2 : '').trim().toLowerCase() === 'pos';
+              result = queryAvailabilityProjection(projectionEntry.projection, request, {
+                allowExcludedScheduleDateOverride: isPosAvailabilityRequest
+              });
               contextVersion = context.activeVersion;
               contextualResult = result.target === 'time' ? _objectSpread(_objectSpread({}, result), {}, {
                 data: result.data.map(function (group) {
@@ -4299,7 +4365,7 @@ export var UnifiedBookingSalesImpl = /*#__PURE__*/function (_BookingTicket) {
                 contextVersion: contextVersion,
                 refreshed: refreshed
               }));
-            case 11:
+            case 12:
             case "end":
               return _context36.stop();
           }
@@ -4376,7 +4442,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$pla2, _this$otherParams19, _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, allowPosAvailabilityOverride, refreshedRanges, refreshedCandidateBase, product, validation, 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$pla3, _this$otherParams20, _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, allowPosAvailabilityOverride, refreshedRanges, refreshedCandidateBase, product, validation, 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:
@@ -4606,7 +4672,7 @@ export var UnifiedBookingSalesImpl = /*#__PURE__*/function (_BookingTicket) {
               this.assertAvailabilityCommitWriteCAS(commitWriteGuard);
               candidateDurationMinutes = getCandidateDurationMinutes(params.candidate);
               candidateStartTime = getCandidateStartTime(params.candidate);
-              allowPosAvailabilityOverride = String((_this$otherParams$pla2 = (_this$otherParams19 = this.otherParams) === null || _this$otherParams19 === void 0 ? void 0 : _this$otherParams19.platform) !== null && _this$otherParams$pla2 !== void 0 ? _this$otherParams$pla2 : '').trim().toLowerCase() === 'pos';
+              allowPosAvailabilityOverride = String((_this$otherParams$pla3 = (_this$otherParams20 = this.otherParams) === null || _this$otherParams20 === void 0 ? void 0 : _this$otherParams20.platform) !== null && _this$otherParams$pla3 !== void 0 ? _this$otherParams$pla3 : '').trim().toLowerCase() === 'pos';
               refreshedRanges = getProjectionProductTimeRanges(refreshedProjection, _objectSpread({
                 productIds: [params.candidate.productId],
                 dateRange: {
@@ -4620,7 +4686,8 @@ export var UnifiedBookingSalesImpl = /*#__PURE__*/function (_BookingTicket) {
               }, allowPosAvailabilityOverride ? {
                 allowOutsideOperatingHoursForRequestedStartTimes: true
               } : {}) : {}) : {}), {
-                allowSessionCustomRanges: allowPosAvailabilityOverride
+                allowSessionCustomRanges: allowPosAvailabilityOverride,
+                allowExcludedScheduleDateOverride: allowPosAvailabilityOverride
               }).flatMap(function (group) {
                 return group.ranges;
               });
@@ -4653,6 +4720,8 @@ export var UnifiedBookingSalesImpl = /*#__PURE__*/function (_BookingTicket) {
                 requirementSelections: params.requirementSelections,
                 partySize: partySize,
                 bookingCount: bookingCount
+              }, {
+                allowExcludedScheduleDateOverride: allowPosAvailabilityOverride
               });
               if (allowPosAvailabilityOverride && !validation.ok && validation.conflicts.every(function (conflict) {
                 return POS_OVERRIDABLE_AVAILABILITY_CONFLICT_CODES.has(conflict.code);

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

@@ -1,5 +1,5 @@
 import type { AvailabilityProjection, AvailabilityProjectionInput, AvailabilityQuery, AvailabilityQueryResult, AvailabilitySelectionValidationParams, AvailabilitySelectionValidationResult, GetProductTimeRangesRequest, GetProductTimeRangesRuntimeOptions, ProductTimeRangeGroup } from './types';
 export declare function createAvailabilityProjection(input: AvailabilityProjectionInput): AvailabilityProjection;
 export declare function getProductTimeRanges(projection: AvailabilityProjection, request?: GetProductTimeRangesRequest, runtimeOptions?: GetProductTimeRangesRuntimeOptions): ProductTimeRangeGroup[];
-export declare function queryAvailabilityProjection(projection: AvailabilityProjection, request: AvailabilityQuery): AvailabilityQueryResult;
-export declare function validateAvailabilitySelection(projection: AvailabilityProjection, params: AvailabilitySelectionValidationParams): AvailabilitySelectionValidationResult;
+export declare function queryAvailabilityProjection(projection: AvailabilityProjection, request: AvailabilityQuery, runtimeOptions?: GetProductTimeRangesRuntimeOptions): AvailabilityQueryResult;
+export declare function validateAvailabilitySelection(projection: AvailabilityProjection, params: AvailabilitySelectionValidationParams, runtimeOptions?: GetProductTimeRangesRuntimeOptions): AvailabilitySelectionValidationResult;

package/lib/modules/ResourcePlanner/planner.js

@@ -166,9 +166,65 @@ function addLeadWindow(base, unit, unitType, _timezoneName) {
   if (unitType === 'hours') return (0, _localClock.addLocalHours)(base, unit);
   return (0, _localClock.addLocalMinutes)(base, unit);
 }
+function normalizedWindowContainsRange(windows, candidateRange, timezoneName) {
+  return windows.some(window => {
+    const normalized = normalizeAbsoluteRange(window, timezoneName);
+    return Boolean(normalized && contains(normalized, candidateRange));
+  });
+}
+function normalizedWindowsContainDate(windows, date, timezoneName) {
+  return windows.some(window => {
+    const normalized = normalizeAbsoluteRange(window, timezoneName);
+    return Boolean(normalized && formatDate(normalized.start, timezoneName) === date);
+  });
+}
+function isRangeFromExcludedWindows(params) {
+  const candidateDate = formatDate(params.candidateRange.start, params.timezoneName);
+  const hasNormalWindowOnDate = normalizedWindowsContainDate(params.normalWindows, candidateDate, params.timezoneName);
+  const hasExcludedWindowOnDate = normalizedWindowsContainDate(params.excludedWindows, candidateDate, params.timezoneName);
+  if (!hasNormalWindowOnDate && hasExcludedWindowOnDate) return true;
+  return !normalizedWindowContainsRange(params.normalWindows, params.candidateRange, params.timezoneName) && normalizedWindowContainsRange(params.excludedWindows, params.candidateRange, params.timezoneName);
+}
+function isCandidateFromExcludedScheduleDate(params) {
+  const {
+    projection,
+    product,
+    candidate,
+    candidateRange
+  } = params;
+  const operatingHours = projection.meta.defaults.operatingHours;
+  if (isRangeFromExcludedWindows({
+    normalWindows: operatingHours.windows,
+    excludedWindows: operatingHours.excludedWindows || [],
+    candidateRange,
+    timezoneName: projection.meta.timezone
+  })) {
+    return true;
+  }
+  if (product.kind !== 'session' && product.kind !== 'venue_slot') {
+    return false;
+  }
+  if (candidate.source !== 'session_schedule') {
+    const hasNormalRule = (product.sessionRules || []).some(rule => matchesScheduleRuleDate(rule, candidate.date, projection.meta.timezone));
+    const hasExcludedOverrideRule = (product.sessionRules || []).some(rule => !matchesScheduleRuleDate(rule, candidate.date, projection.meta.timezone) && matchesScheduleRuleDate(rule, candidate.date, projection.meta.timezone, true));
+    return !hasNormalRule && hasExcludedOverrideRule;
+  }
+  const candidateDateRange = {
+    startDate: candidate.date,
+    endDate: candidate.date
+  };
+  const candidateIdentity = getProductTimeRangeIdentity(candidate);
+  const normalRanges = getSessionRangesForProduct(projection, product, candidateDateRange);
+  if (normalRanges.some(range => getProductTimeRangeIdentity(range) === candidateIdentity)) {
+    return false;
+  }
+  return getSessionRangesForProduct(projection, product, candidateDateRange, true).some(range => getProductTimeRangeIdentity(range) === candidateIdentity);
+}
 function evaluateCandidateTimeGate(params) {
   const {
+    projection,
     product,
+    candidate,
     candidateRange,
     evaluationContext,
     timezoneName
@@ -181,6 +237,18 @@ function evaluateCandidateTimeGate(params) {
       conflictCode: 'past'
     };
   }
+  if (evaluationContext.allowExcludedScheduleDateOverride && isCandidateFromExcludedScheduleDate({
+    projection,
+    product,
+    candidate,
+    candidateRange
+  })) {
+    return {
+      status: 'unavailable',
+      reasonCodes: ['schedule_excluded_date'],
+      conflictCode: 'schedule_excluded_date'
+    };
+  }
   const policy = product.cutOffPolicy;
   if (!policy) return null;
   if (resolveCutOffPolicyIssue(policy)) {
@@ -324,8 +392,8 @@ function normalizeCoverage(input) {
     }
   };
 }
-function normalizeResourceWindow(resource, coverage, timezoneName) {
-  return mergeRanges((resource.windows || []).map(window => normalizeAbsoluteRange(window, timezoneName)).filter(window => Boolean(window)).map(window => clipRange(window, coverage)).filter(window => Boolean(window)));
+function normalizeResourceWindow(resource, coverage, timezoneName, includeExcludedWindows = false) {
+  return mergeRanges([...(resource.windows || []), ...(includeExcludedWindows ? resource.excludedWindows || [] : [])].map(window => normalizeAbsoluteRange(window, timezoneName)).filter(window => Boolean(window)).map(window => clipRange(window, coverage)).filter(window => Boolean(window)));
 }
 function normalizeOccupancy(occupancy, coverage, timezoneName, fixedOffsetMinutes) {
   const normalized = normalizeAbsoluteRange(occupancy, timezoneName);
@@ -389,6 +457,9 @@ function normalizeResources(resources) {
     capacity: Math.max(1, Number(resource.capacity || 1) || 1),
     windows: (resource.windows || []).map(window => ({
       ...window
+    })),
+    excludedWindows: (resource.excludedWindows || []).map(window => ({
+      ...window
     }))
   }));
 }
@@ -408,15 +479,20 @@ function normalizeOperatingHours(params) {
     startAt: formatDateTime(range.start, params.timezoneName, params.fixedOffsetMinutes),
     endAt: formatDateTime(range.end, params.timezoneName, params.fixedOffsetMinutes)
   }));
-  const windows = mergeRanges(sourceWindows.map(window => normalizeAbsoluteRange(window, params.timezoneName)).filter(window => Boolean(window)).map(window => clipRange(window, params.coverage)).filter(window => Boolean(window))).map(range => ({
+  const normalizeWindows = source => mergeRanges(source.map(window => normalizeAbsoluteRange(window, params.timezoneName)).filter(window => Boolean(window)).map(window => clipRange(window, params.coverage)).filter(window => Boolean(window))).map(range => ({
     startAt: formatDateTime(range.start, params.timezoneName, params.fixedOffsetMinutes),
     endAt: formatDateTime(range.end, params.timezoneName, params.fixedOffsetMinutes)
   }));
+  const windows = normalizeWindows(sourceWindows);
+  const excludedWindows = normalizeWindows(params.input?.excludedWindows || []);
   return {
     source: params.input?.source || params.fallbackSource,
     scheduleIds: uniqById(params.input?.scheduleIds || []),
     missingScheduleIds: uniqById(params.input?.missingScheduleIds || []),
-    windows
+    windows,
+    ...(excludedWindows.length > 0 ? {
+      excludedWindows
+    } : {})
   };
 }
 function matchesRequirementGroup(requirementGroup, resource, product, partySize = 1) {
@@ -698,19 +774,19 @@ function resolveProjectionDateRange(projection, requestDateRange) {
     endDate
   };
 }
-function buildOperatingRanges(projection, dateRange) {
+function buildOperatingRanges(projection, dateRange, includeExcludedWindows = false) {
   const coverage = {
     start: toDateStart(dateRange.startDate, projection.meta.timezone),
     end: toDateEnd(nextDate(dateRange.endDate), projection.meta.timezone)
   };
-  return mergeRanges(projection.meta.defaults.operatingHours.windows.map(window => normalizeAbsoluteRange(window, projection.meta.timezone)).filter(window => Boolean(window)).map(window => clipRange(window, coverage)).filter(window => Boolean(window)));
+  return mergeRanges([...projection.meta.defaults.operatingHours.windows, ...(includeExcludedWindows ? projection.meta.defaults.operatingHours.excludedWindows || [] : [])].map(window => normalizeAbsoluteRange(window, projection.meta.timezone)).filter(window => Boolean(window)).map(window => clipRange(window, coverage)).filter(window => Boolean(window)));
 }
-function buildResourceWindowIndex(projection) {
+function buildResourceWindowIndex(projection, includeExcludedWindows = false) {
   const coverage = {
     start: toDateTime(projection.meta.coverage.startAt, projection.meta.timezone),
     end: toDateTime(projection.meta.coverage.endAt, projection.meta.timezone)
   };
-  return new Map(projection.resources.map(resource => [String(resource.id), normalizeResourceWindow(resource, coverage, projection.meta.timezone)]));
+  return new Map(projection.resources.map(resource => [String(resource.id), normalizeResourceWindow(resource, coverage, projection.meta.timezone, includeExcludedWindows)]));
 }
 function buildGroupWorkingRanges(params) {
   const {
@@ -727,7 +803,7 @@ function buildGroupWorkingRanges(params) {
   };
   const filteredResourceIdSet = resourceIds?.length ? new Set(resourceIds.map(String)) : null;
   const resourceWindows = projection.resources.filter(resource => matchesRequirementGroup(requirementGroup, resource, params.product, partySize)).filter(resource => !filteredResourceIdSet || filteredResourceIdSet.has(String(resource.id))).map(resource => {
-    const windows = params.resourceWindowIndex?.get(String(resource.id)) || normalizeResourceWindow(resource, coverage, projection.meta.timezone);
+    const windows = params.resourceWindowIndex?.get(String(resource.id)) || normalizeResourceWindow(resource, coverage, projection.meta.timezone, params.includeExcludedWindows === true);
     return windows.map(window => clipRange(window, coverage)).filter(window => Boolean(window));
   });
   const requiredConcurrentResources = Math.max(requirementGroup.required === false ? 0 : 1, Number(requirementGroup.min ?? (requirementGroup.required === false ? 0 : 1)) || 0);
@@ -758,12 +834,12 @@ function buildGroupWorkingRanges(params) {
   }
   return mergeRanges(satisfiedRanges);
 }
-function materializeScheduleRules(rules, dateRange, timezoneName, fixedOffsetMinutes) {
+function materializeScheduleRules(rules, dateRange, timezoneName, fixedOffsetMinutes, allowExcludedScheduleDates = false) {
   const dates = enumerateDates(dateRange.startDate, dateRange.endDate);
   const seen = new Map();
   rules.forEach(rule => {
     dates.forEach(date => {
-      if (!matchesScheduleRuleDate(rule, date, timezoneName)) return;
+      if (!matchesScheduleRuleDate(rule, date, timezoneName, allowExcludedScheduleDates)) return;
       const start = toDateTimeInDate(date, rule.startTime, timezoneName);
       let end = toDateTimeInDate(date, rule.endTime, timezoneName);
       if (end <= start) end = toDateTimeInDate(nextDate(date, timezoneName), rule.endTime, timezoneName);
@@ -795,9 +871,9 @@ function materializeScheduleRules(rules, dateRange, timezoneName, fixedOffsetMin
   });
   return Array.from(seen.values());
 }
-function matchesScheduleRuleDate(rule, date, _timezoneName) {
+function matchesScheduleRuleDate(rule, date, _timezoneName, allowExcludedScheduleDate = false) {
   if (rule.includeDates?.includes(date)) return true;
-  if (rule.excludeDates?.includes(date)) return false;
+  if (!allowExcludedScheduleDate && rule.excludeDates?.includes(date)) return false;
   if (rule.startDate && date < rule.startDate) return false;
   if (rule.endDate && date > rule.endDate) return false;
   if (rule.mode === 'designation') {
@@ -841,7 +917,7 @@ function buildGroupResourceIndex(params) {
   });
   return index;
 }
-function getSessionRangesForProduct(projection, product, dateRange) {
+function getSessionRangesForProduct(projection, product, dateRange, allowExcludedScheduleDates = false) {
   const fixedOffsetMinutes = (0, _localClock.extractFixedOffsetMinutes)(projection.meta.now) ?? (0, _localClock.captureRuntimeOffsetMinutes)();
   const ranges = (product.sessionRanges || []).map(range => {
     const normalized = normalizeAbsoluteRange(range, projection.meta.timezone);
@@ -866,7 +942,7 @@ function getSessionRangesForProduct(projection, product, dateRange) {
       primaryScheduleRef: range.scheduleRefs?.[0]
     };
   }).filter(Boolean);
-  const ruleRanges = materializeScheduleRules(product.sessionRules || [], dateRange, projection.meta.timezone, fixedOffsetMinutes);
+  const ruleRanges = materializeScheduleRules(product.sessionRules || [], dateRange, projection.meta.timezone, fixedOffsetMinutes, allowExcludedScheduleDates);
   return dedupeProductRanges([...ranges, ...ruleRanges.map(range => ({
     ...range,
     key: `${String(product.id)}:${range.startAt}:${range.endAt}`,
@@ -916,7 +992,8 @@ function getProductTimeRanges(projection, request = {}, runtimeOptions = {}) {
   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 allowExcludedScheduleDateOverride = runtimeOptions.allowExcludedScheduleDateOverride === true;
+  const resourceWindowIndex = buildResourceWindowIndex(projection, allowExcludedScheduleDateOverride);
   const filteredProductIdSet = request.productIds?.length ? new Set(request.productIds.map(String)) : null;
   return projection.products.filter(product => !filteredProductIdSet || filteredProductIdSet.has(String(product.id))).map(product => {
     if (product.kind === 'normal') {
@@ -929,7 +1006,7 @@ function getProductTimeRanges(projection, request = {}, runtimeOptions = {}) {
       };
     }
     if (product.kind === 'session' || product.kind === 'venue_slot') {
-      const fixedRanges = getSessionRangesForProduct(projection, product, dateRange);
+      const fixedRanges = getSessionRangesForProduct(projection, product, dateRange, allowExcludedScheduleDateOverride);
       const customRanges = [];
       const customDurationMinutes = resolveRequestedSessionDurationMinutes(product, request, runtimeOptions.allowSessionCustomRanges === true);
       const requestedStartTimes = resolveRequestedDurationStartTimes(product, request, runtimeOptions.allowSessionCustomRanges === true);
@@ -949,7 +1026,8 @@ function getProductTimeRanges(projection, request = {}, runtimeOptions = {}) {
       };
     }
     const requiredGroups = (product.requirementGroups || []).filter(group => group.required !== false);
-    const operatingRanges = buildOperatingRanges(projection, dateRange);
+    const operatingRanges = buildOperatingRanges(projection, dateRange, allowExcludedScheduleDateOverride);
+    const operatingEndAt = dateRange.startDate === dateRange.endDate && operatingRanges.length > 0 ? formatDateTime(Math.max(...operatingRanges.map(range => range.end)), projection.meta.timezone, fixedOffsetMinutes) : undefined;
     const resourceRanges = requiredGroups.length ? requiredGroups.map(group => buildGroupWorkingRanges({
       projection,
       product,
@@ -957,7 +1035,8 @@ function getProductTimeRanges(projection, request = {}, runtimeOptions = {}) {
       dateRange,
       resourceIds: request.resourceIds,
       partySize: normalizedPartySize,
-      resourceWindowIndex
+      resourceWindowIndex,
+      includeExcludedWindows: allowExcludedScheduleDateOverride
     })).reduce((current, ranges) => current === null ? ranges : intersectRangeLists(current, ranges), null) || [] : null;
     const baseRanges = resourceRanges === null ? operatingRanges : intersectRangeLists(resourceRanges, operatingRanges);
     const durationMinutes = resolveRequestedDurationMinutes(product, request);
@@ -1016,6 +1095,9 @@ function getProductTimeRanges(projection, request = {}, runtimeOptions = {}) {
       title: product.title,
       kind: product.kind,
       slotStepMinutes,
+      ...(operatingEndAt ? {
+        operatingEndAt
+      } : {}),
       ranges: dedupeProductRanges(ranges)
     };
   });
@@ -1173,7 +1255,8 @@ function buildEvaluationContext(params) {
     evaluatedAt,
     evaluatedAtMs: evaluatedAt,
     resourceIdSet: params.resourceIds?.length ? new Set(params.resourceIds.map(String)) : null,
-    selectionsByGroupKey
+    selectionsByGroupKey,
+    allowExcludedScheduleDateOverride: params.allowExcludedScheduleDateOverride === true
   };
 }
 function summarizeStatuses(statuses) {
@@ -1323,7 +1406,8 @@ function evaluateCandidateSummary(projection, candidate, request) {
   const evaluationContext = request.evaluationContext || buildEvaluationContext({
     projection,
     evaluatedAt: request.evaluatedAt,
-    resourceIds: request.resourceIds
+    resourceIds: request.resourceIds,
+    allowExcludedScheduleDateOverride: request.allowExcludedScheduleDateOverride
   });
   const requestedPartySize = normalizePartySize(request.partySize);
   const requiredGroups = (product.requirementGroups || []).filter(group => group.required !== false).map(requirementGroup => evaluateRequirementGroupSummary({
@@ -1337,7 +1421,9 @@ function evaluateCandidateSummary(projection, candidate, request) {
     groupResourceIndex: request.groupResourceIndex
   }));
   const gate = evaluateCandidateTimeGate({
+    projection,
     product,
+    candidate,
     candidateRange,
     evaluationContext,
     timezoneName: projection.meta.timezone
@@ -1379,7 +1465,8 @@ function evaluateCandidate(projection, candidate, request) {
     projection,
     evaluatedAt: request.evaluatedAt,
     resourceIds: request.resourceIds,
-    requirementSelections: request.requirementSelections
+    requirementSelections: request.requirementSelections,
+    allowExcludedScheduleDateOverride: request.allowExcludedScheduleDateOverride
   });
   const requestedPartySize = normalizePartySize(request.partySize);
   const partySize = requestedPartySize ?? 1;
@@ -1392,6 +1479,12 @@ function evaluateCandidate(projection, candidate, request) {
     const matchedResources = (request.groupResourceIndex?.get([String(product.id), requirementGroup.id].join(':')) || projection.resources.filter(resource => matchesRequirementGroup(requirementGroup, resource, product, partySize)).filter(resource => !evaluationContext.resourceIdSet || evaluationContext.resourceIdSet.has(String(resource.id)))).filter(resource => !selection || selection.resourceIds.some(resourceId => sameId(resourceId, resource.id)));
     const options = matchedResources.map(resource => {
       const matchedCell = aggregateMatchedCells(product.id, requirementGroup.id, resource.id, candidateRange, request.cellIndex?.get([String(product.id), requirementGroup.id, String(resource.id)].join(':')) || []);
+      const isExcludedScheduleDate = evaluationContext.allowExcludedScheduleDateOverride && isRangeFromExcludedWindows({
+        normalWindows: resource.windows || [],
+        excludedWindows: resource.excludedWindows || [],
+        candidateRange,
+        timezoneName: projection.meta.timezone
+      });
       if (!matchedCell) {
         const isPast = candidateRange.endMs <= evaluationContext.evaluatedAtMs;
         return {
@@ -1402,7 +1495,7 @@ function evaluateCandidate(projection, candidate, request) {
           resourceType: resource.resourceType,
           status: isPast ? 'past' : 'unavailable',
           maxPartySize: 0,
-          reasonCodes: isPast ? ['past'] : ['outside_resource_window']
+          reasonCodes: isPast ? ['past'] : [...(isExcludedScheduleDate ? ['schedule_excluded_date'] : []), 'outside_resource_window']
         };
       }
       const remainingCapacity = matchedCell.remainingCapacity;
@@ -1410,6 +1503,7 @@ function evaluateCandidate(projection, candidate, request) {
       const isPast = candidateRange.endMs <= evaluationContext.evaluatedAtMs;
       const maxPartySize = isPast ? 0 : Math.max(0, remainingCapacity || 0);
       const requiredCapacity = resolveRequiredCapacity(requirementGroup, product, requestedPartySize);
+      const reasonCodes = Array.from(new Set([...matchedCell.reasonCodes, ...(isExcludedScheduleDate ? ['schedule_excluded_date'] : [])]));
       const status = (() => {
         if (isPast) return 'past';
         if (matchedCell.status === 'unavailable') return 'unavailable';
@@ -1427,7 +1521,7 @@ function evaluateCandidate(projection, candidate, request) {
         remainingCapacity,
         maxCapacity,
         maxPartySize,
-        reasonCodes: isPast ? Array.from(new Set([...matchedCell.reasonCodes, 'past'])) : matchedCell.reasonCodes,
+        reasonCodes: isPast ? Array.from(new Set([...reasonCodes, 'past'])) : reasonCodes,
         matchedCell
       };
     });
@@ -1467,7 +1561,9 @@ function evaluateCandidate(projection, candidate, request) {
   const requiredGroups = requirementGroups.filter(group => group.required);
   const requiredStatuses = requiredGroups.map(group => group.status);
   const gate = evaluateCandidateTimeGate({
+    projection,
     product,
+    candidate,
     candidateRange,
     evaluationContext,
     timezoneName: projection.meta.timezone
@@ -1543,7 +1639,7 @@ function assertRangesWithinProjection(projection, ranges) {
     }
   });
 }
-function queryAvailabilityProjection(projection, request) {
+function queryAvailabilityProjection(projection, request, runtimeOptions = {}) {
   const normalizedPartySize = normalizePartySize(request.partySize);
   const evaluatedAt = formatDateTime((0, _localClock.localDateToScalar)(new Date()), projection.meta.timezone, (0, _localClock.extractFixedOffsetMinutes)(projection.meta.now) ?? (0, _localClock.captureRuntimeOffsetMinutes)());
   if (request.target === 'time') {
@@ -1566,7 +1662,8 @@ function queryAvailabilityProjection(projection, request) {
   const evaluationContext = buildEvaluationContext({
     projection,
     evaluatedAt,
-    resourceIds: request.resourceIds
+    resourceIds: request.resourceIds,
+    allowExcludedScheduleDateOverride: runtimeOptions.allowExcludedScheduleDateOverride
   });
   if (request.target === 'time') {
     const candidates = dedupeProductRanges(request.candidates);
@@ -1640,7 +1737,8 @@ function queryAvailabilityProjection(projection, request) {
     resourceIds: request.resourceIds,
     partySize: normalizedPartySize
   }, {
-    evaluatedAt
+    evaluatedAt,
+    allowExcludedScheduleDateOverride: runtimeOptions.allowExcludedScheduleDateOverride
   });
   const candidateGroupMap = new Map(candidateGroups.map(group => [String(group.productId), group]));
   if (request.target === 'date') {
@@ -1790,7 +1888,7 @@ function summarizeProductStatus(statuses) {
   if (statuses.every(status => status === 'past')) return 'past';
   return 'unavailable';
 }
-function validateAvailabilitySelection(projection, params) {
+function validateAvailabilitySelection(projection, params, runtimeOptions = {}) {
   const normalizedPartySize = normalizePartySize(params.partySize);
   const normalizedBookingCount = normalizeBookingCount(params.bookingCount);
   assertRangesWithinProjection(projection, [params.candidate]);
@@ -1811,14 +1909,15 @@ function validateAvailabilitySelection(projection, params) {
     evaluationContext: buildEvaluationContext({
       projection,
       evaluatedAt,
-      requirementSelections: params.requirementSelections
+      requirementSelections: params.requirementSelections,
+      allowExcludedScheduleDateOverride: runtimeOptions.allowExcludedScheduleDateOverride
     })
   });
   const conflicts = [];
   if (evaluated.gate) {
     conflicts.push({
       code: evaluated.gate.conflictCode,
-      message: evaluated.gate.status === 'past' ? '候选时间已过期' : '候选时间不满足预订时间门禁',
+      message: evaluated.gate.conflictCode === 'past' ? '候选时间已过期' : evaluated.gate.conflictCode === 'schedule_excluded_date' ? '候选日期已被日程排除' : '候选时间不满足预订时间门禁',
       reasonCodes: evaluated.gate.reasonCodes,
       productId: params.candidate.productId,
       candidateKey: params.candidate.key

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

@@ -101,6 +101,9 @@ export interface AvailabilityOperatingHoursSnapshot {
     scheduleIds: AvailabilityId[];
     missingScheduleIds: AvailabilityId[];
     windows: AvailabilityResourceWindow[];
+    /** Schedule windows omitted only because their date is excluded. POS may use
+     * these to surface an unavailable, manually selectable candidate. */
+    excludedWindows?: AvailabilityResourceWindow[];
 }
 export interface AvailabilityResource {
     id: AvailabilityId;
@@ -110,6 +113,8 @@ export interface AvailabilityResource {
     resourceType: AvailabilityResourceType;
     capacity: number;
     windows: AvailabilityResourceWindow[];
+    /** Resource work windows omitted only by an excluded schedule date. */
+    excludedWindows?: AvailabilityResourceWindow[];
     raw?: Record<string, any>;
 }
 export interface AvailabilityOccupancy extends AvailabilityAbsoluteRange {
@@ -213,6 +218,8 @@ export interface ProductTimeRangeGroup {
     title?: string;
     kind: AvailabilityProductKind;
     slotStepMinutes?: number;
+    /** 单日查询对应营业窗口的最终结束时刻，不受资源排班是否为空影响。 */
+    operatingEndAt?: string;
     ranges: ProductTimeRange[];
 }
 export interface AvailabilityAssignment extends AvailabilityAbsoluteRange {
@@ -250,6 +257,11 @@ export interface GetProductTimeRangesRuntimeOptions {
      * disabled.
      */
     allowSessionCustomRanges?: boolean;
+    /**
+     * Internal POS capability: materialize candidates whose schedule date was
+     * explicitly excluded, while availability evaluation keeps them unavailable.
+     */
+    allowExcludedScheduleDateOverride?: boolean;
 }
 export interface QueryAvailabilityBaseRequest {
     productIds?: AvailabilityId[];