@pisell/pisellos 2.2.299 → 2.2.301

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)) {
@@ -213,10 +281,12 @@ function evaluateCandidateTimeGate(params) {
     };
   }
   if (policy.type === 'before_start') {
-    // Flexible-duration candidates start at minute precision. Keep the current
-    // minute selectable instead of treating the freshly generated candidate as
-    // already started because the query clock still contains seconds.
-    const hasNotReachedStart = product.isFlexibleDuration ? floorToMinute(now) <= candidateRange.start : now < candidateRange.start;
+    // Flexible-duration candidates and POS fixed-duration anchors start at
+    // minute precision. Keep that current minute selectable instead of treating
+    // the freshly generated candidate as already started because the query
+    // clock still contains seconds.
+    const usesMinutePrecision = product.isFlexibleDuration || evaluationContext.useExactDurationCandidateMinute && product.kind === 'duration';
+    const hasNotReachedStart = usesMinutePrecision ? floorToMinute(now) <= candidateRange.start : now < candidateRange.start;
     if (hasNotReachedStart) return null;
     return {
       status: 'unavailable',
@@ -324,8 +394,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 +459,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 +481,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 +776,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 +805,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 +836,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 +873,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 +919,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 +944,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 +994,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 +1008,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 +1028,7 @@ 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,
@@ -958,7 +1037,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);
@@ -972,7 +1052,8 @@ function getProductTimeRanges(projection, request = {}, runtimeOptions = {}) {
       }
       return floorToMinute(evaluatedAt);
     })();
-    const durationAnchor = ceilToTenMinutes(toDateTime(projection.meta.durationCandidateAnchorAt, projection.meta.timezone), projection.meta.timezone);
+    const durationCandidateAnchor = toDateTime(projection.meta.durationCandidateAnchorAt, projection.meta.timezone);
+    const durationAnchor = runtimeOptions.useExactDurationCandidateMinute ? floorToMinute(durationCandidateAnchor) : ceilToTenMinutes(durationCandidateAnchor, projection.meta.timezone);
     const requestedStartTimes = resolveRequestedDurationStartTimes(product, request);
     const ranges = [];
     baseRanges.forEach(range => {
@@ -1177,7 +1258,9 @@ function buildEvaluationContext(params) {
     evaluatedAt,
     evaluatedAtMs: evaluatedAt,
     resourceIdSet: params.resourceIds?.length ? new Set(params.resourceIds.map(String)) : null,
-    selectionsByGroupKey
+    selectionsByGroupKey,
+    useExactDurationCandidateMinute: params.useExactDurationCandidateMinute === true,
+    allowExcludedScheduleDateOverride: params.allowExcludedScheduleDateOverride === true
   };
 }
 function summarizeStatuses(statuses) {
@@ -1327,7 +1410,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({
@@ -1341,7 +1425,9 @@ function evaluateCandidateSummary(projection, candidate, request) {
     groupResourceIndex: request.groupResourceIndex
   }));
   const gate = evaluateCandidateTimeGate({
+    projection,
     product,
+    candidate,
     candidateRange,
     evaluationContext,
     timezoneName: projection.meta.timezone
@@ -1383,7 +1469,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;
@@ -1396,6 +1483,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 {
@@ -1406,7 +1499,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;
@@ -1414,6 +1507,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';
@@ -1431,7 +1525,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
       };
     });
@@ -1471,7 +1565,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
@@ -1547,7 +1643,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') {
@@ -1570,7 +1666,9 @@ function queryAvailabilityProjection(projection, request) {
   const evaluationContext = buildEvaluationContext({
     projection,
     evaluatedAt,
-    resourceIds: request.resourceIds
+    resourceIds: request.resourceIds,
+    useExactDurationCandidateMinute: runtimeOptions.useExactDurationCandidateMinute,
+    allowExcludedScheduleDateOverride: runtimeOptions.allowExcludedScheduleDateOverride
   });
   if (request.target === 'time') {
     const candidates = dedupeProductRanges(request.candidates);
@@ -1644,7 +1742,9 @@ function queryAvailabilityProjection(projection, request) {
     resourceIds: request.resourceIds,
     partySize: normalizedPartySize
   }, {
-    evaluatedAt
+    evaluatedAt,
+    useExactDurationCandidateMinute: runtimeOptions.useExactDurationCandidateMinute,
+    allowExcludedScheduleDateOverride: runtimeOptions.allowExcludedScheduleDateOverride
   });
   const candidateGroupMap = new Map(candidateGroups.map(group => [String(group.productId), group]));
   if (request.target === 'date') {
@@ -1794,7 +1894,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]);
@@ -1815,14 +1915,16 @@ function validateAvailabilitySelection(projection, params) {
     evaluationContext: buildEvaluationContext({
       projection,
       evaluatedAt,
-      requirementSelections: params.requirementSelections
+      requirementSelections: params.requirementSelections,
+      useExactDurationCandidateMinute: runtimeOptions.useExactDurationCandidateMinute,
+      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 {
@@ -245,6 +250,13 @@ export interface GetProductTimeRangesRequest {
 }
 export interface GetProductTimeRangesRuntimeOptions {
     evaluatedAt?: string;
+    /**
+     * Internal POS capability: fixed-duration candidates start from the stable
+     * context anchor's current minute instead of rounding up to ten minutes, and
+     * that minute remains selectable during before-start cutoff evaluation.
+     * Other callers keep the legacy alignment and strict second-level cutoff.
+     */
+    useExactDurationCandidateMinute?: boolean;
     /**
      * Internal POS capability: allow explicit duration/start overrides to append
      * a custom duration candidate for Session products. Fixed Session ranges are
@@ -252,6 +264,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[];

package/lib/solution/UnifiedBookingSales/index.js

@@ -638,6 +638,22 @@ function normalizeResource(raw, fixedOffsetMinutes = (0, _localClock.captureRunt
   const id = raw.resourceId ?? raw.resource_id ?? raw.id;
   if (id === undefined || id === null || id === '') return null;
   const rawWindows = raw.windows || raw.times || [];
+  const rawExcludedWindows = raw.excludedWindows || raw.excluded_windows || [];
+  const normalizeWindows = windows => (Array.isArray(windows) ? windows : []).flatMap(window => {
+    const range = normalizeAvailabilityLocalDateTimeRange({
+      startAt: window.startAt || window.start_at || window.start,
+      endAt: window.endAt || window.end_at || window.end,
+      fixedOffsetMinutes,
+      rollOverEnd: true
+    });
+    if (!range) return [];
+    return [{
+      startAt: range.startAt,
+      endAt: range.endAt,
+      source: window.source,
+      raw: window
+    }];
+  });
   return {
     id,
     formId: raw.formId ?? raw.form_id ?? raw.resource_form_id,
@@ -645,21 +661,8 @@ function normalizeResource(raw, fixedOffsetMinutes = (0, _localClock.captureRunt
     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(window => {
-      const range = normalizeAvailabilityLocalDateTimeRange({
-        startAt: window.startAt || window.start_at || window.start,
-        endAt: window.endAt || window.end_at || window.end,
-        fixedOffsetMinutes,
-        rollOverEnd: true
-      });
-      if (!range) return [];
-      return [{
-        startAt: range.startAt,
-        endAt: range.endAt,
-        source: window.source,
-        raw: window
-      }];
-    }),
+    windows: normalizeWindows(rawWindows),
+    excludedWindows: normalizeWindows(rawExcludedWindows),
     raw
   };
 }
@@ -678,6 +681,17 @@ function dateRangeDays(dateRange) {
   }
   return dates;
 }
+function getExcludedScheduleDateOverrideTimePoints(date, schedule) {
+  if (!schedule.repeat_rule?.excluded_date?.length) return [];
+  if ((0, _getDateIsInSchedule.getScheduleStartEndTimePoints)(date, [schedule]).length > 0) return [];
+  return (0, _getDateIsInSchedule.getScheduleStartEndTimePoints)(date, [{
+    ...schedule,
+    repeat_rule: {
+      ...schedule.repeat_rule,
+      excluded_date: []
+    }
+  }]);
+}
 function normalizeResourceOccupancy(rawEvent, resourceId, source = 'remote', fixedOffsetMinutes = (0, _localClock.captureRuntimeOffsetMinutes)()) {
   const range = normalizeAvailabilityLocalDateTimeRange({
     startAt: rawEvent.start_at ?? rawEvent.startAt ?? rawEvent.start_time ?? rawEvent.startTime,
@@ -770,7 +784,26 @@ function buildAvailabilityResourcesFromV2(params) {
         }
       }];
     })));
+    const excludedWindows = dates.flatMap(date => schedules.flatMap(schedule => getExcludedScheduleDateOverrideTimePoints(date, schedule).flatMap(slot => {
+      const range = normalizeAvailabilityLocalDateTimeRange({
+        startAt: slot.start_at,
+        endAt: slot.end_at,
+        fixedOffsetMinutes,
+        rollOverEnd: true
+      });
+      if (!range) return [];
+      return [{
+        startAt: range.startAt,
+        endAt: range.endAt,
+        source: `resource_schedule_excluded:${schedule.id}`,
+        raw: {
+          scheduleId: schedule.id,
+          excludedDate: date
+        }
+      }];
+    })));
     resource.windows = materializedWindows.length > 0 ? materializedWindows : explicitWindows;
+    resource.excludedWindows = [...(resource.excludedWindows || []), ...excludedWindows];
     if (resource.windows.length === 0 && missingScheduleIds.length > 0) {
       resource.windows = buildResourceWindowFallbackTimes({
         raw,
@@ -1011,7 +1044,7 @@ function buildBookingFromAvailabilitySelection(params) {
     }
   };
 }
-const POS_OVERRIDABLE_AVAILABILITY_CONFLICT_CODES = new Set(['past', 'booking_cutoff', 'resource_full', 'resource_unavailable', 'resource_capacity_exceeded',
+const 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.
@@ -2118,11 +2151,31 @@ class UnifiedBookingSalesImpl extends _BookingTicket.BookingTicket {
         source: `operating_schedule:${descriptor.scheduleIds.map(String).join(',')}`
       }] : [];
     }));
+    const excludedWindows = dateRangeDays(params.dateRange).flatMap(date => schedules.flatMap(schedule => getExcludedScheduleDateOverrideTimePoints(date, schedule).flatMap(slot => {
+      const range = normalizeAvailabilityLocalDateTimeRange({
+        startAt: slot.start_at,
+        endAt: slot.end_at,
+        fixedOffsetMinutes: this.getAvailabilityRuntimeOffsetMinutes(),
+        rollOverEnd: true
+      });
+      return range ? [{
+        startAt: range.startAt,
+        endAt: range.endAt,
+        source: `operating_schedule_excluded:${schedule.id}`,
+        raw: {
+          scheduleId: schedule.id,
+          excludedDate: date
+        }
+      }] : [];
+    })));
     return {
       source: descriptor.source,
       scheduleIds: [...descriptor.scheduleIds],
       missingScheduleIds,
-      windows
+      windows,
+      ...(excludedWindows.length > 0 ? {
+        excludedWindows
+      } : {})
     };
   }
   async loadAvailabilityProducts(params) {
@@ -2820,7 +2873,9 @@ class UnifiedBookingSalesImpl extends _BookingTicket.BookingTicket {
       } : {})
     }, {
       evaluatedAt: this.getAvailabilityRuntimeDateTime(),
-      allowSessionCustomRanges: isPosAvailabilityRequest
+      useExactDurationCandidateMinute: isPosAvailabilityRequest,
+      allowSessionCustomRanges: isPosAvailabilityRequest,
+      allowExcludedScheduleDateOverride: isPosAvailabilityRequest
     }).map(group => ({
       ...group,
       ranges: group.ranges.map(candidate => this.decorateAvailabilityCandidate(context.contextId, contextVersion, candidate))
@@ -2835,7 +2890,11 @@ class UnifiedBookingSalesImpl extends _BookingTicket.BookingTicket {
       refreshed
     } = await this.ensureAvailabilityContextProjection(contextId, 'query_booking_availability');
     this.assertContextualQueryFreshness(context, request);
-    const result = (0, _ResourcePlanner.queryAvailabilityProjection)(projectionEntry.projection, request);
+    const isPosAvailabilityRequest = String(this.otherParams?.platform ?? '').trim().toLowerCase() === 'pos';
+    const result = (0, _ResourcePlanner.queryAvailabilityProjection)(projectionEntry.projection, request, {
+      useExactDurationCandidateMinute: isPosAvailabilityRequest,
+      allowExcludedScheduleDateOverride: isPosAvailabilityRequest
+    });
     const contextVersion = context.activeVersion;
     const contextualResult = result.target === 'time' ? {
       ...result,
@@ -3092,7 +3151,9 @@ class UnifiedBookingSalesImpl extends _BookingTicket.BookingTicket {
           } : {})
         } : {})
       }, {
-        allowSessionCustomRanges: allowPosAvailabilityOverride
+        useExactDurationCandidateMinute: allowPosAvailabilityOverride,
+        allowSessionCustomRanges: allowPosAvailabilityOverride,
+        allowExcludedScheduleDateOverride: allowPosAvailabilityOverride
       }).flatMap(group => group.ranges);
       const refreshedCandidateBase = refreshedRanges.find(candidate => candidate.startAt === params.candidate.startAt && candidate.endAt === params.candidate.endAt && candidate.bookingStartAt === params.candidate.bookingStartAt && candidate.bookingEndAt === params.candidate.bookingEndAt);
       if (!refreshedCandidateBase) {
@@ -3113,6 +3174,9 @@ class UnifiedBookingSalesImpl extends _BookingTicket.BookingTicket {
         requirementSelections: params.requirementSelections,
         partySize,
         bookingCount
+      }, {
+        useExactDurationCandidateMinute: allowPosAvailabilityOverride,
+        allowExcludedScheduleDateOverride: allowPosAvailabilityOverride
       });
       if (allowPosAvailabilityOverride && !validation.ok && validation.conflicts.every(conflict => POS_OVERRIDABLE_AVAILABILITY_CONFLICT_CODES.has(conflict.code))) {
         const forced = buildPosForcedAvailabilityAssignments({

package/package.json

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