@pisell/pisellos 0.10.20 → 0.10.21

package/dist/solution/BaseSales/index.js

@@ -293,6 +293,24 @@ function normalizeBaseSalesRecordCollections(sourceRecord, options) {
   }
   return normalizedRecord;
 }
+function isValidBaseSalesSmallTicketDataSnapshot(value) {
+  if (!value || _typeof(value) !== 'object' || Array.isArray(value)) return false;
+  var localeSnapshots = Object.values(value);
+  return localeSnapshots.length > 0 && localeSnapshots.some(function (localeSnapshot) {
+    return localeSnapshot !== null && _typeof(localeSnapshot) === 'object' && !Array.isArray(localeSnapshot);
+  });
+}
+function mergeBaseSalesSmallTicketDataSnapshot(currentValue, loadedValue) {
+  if (isValidBaseSalesSmallTicketDataSnapshot(loadedValue)) {
+    return cloneDeep(loadedValue);
+  }
+  if (isValidBaseSalesSmallTicketDataSnapshot(currentValue)) {
+    return cloneDeep(currentValue);
+  }
+  if (loadedValue !== undefined) return cloneDeep(loadedValue);
+  if (currentValue !== undefined) return cloneDeep(currentValue);
+  return undefined;
+}
 function getBaseSalesMetadataUid(item, metadataKey) {
   var _item$metadata$metada, _item$metadata;
   var uid = (_item$metadata$metada = item === null || item === void 0 || (_item$metadata = item.metadata) === null || _item$metadata === void 0 ? void 0 : _item$metadata[metadataKey]) !== null && _item$metadata$metada !== void 0 ? _item$metadata$metada : item === null || item === void 0 ? void 0 : item[metadataKey];
@@ -333,6 +351,11 @@ function mergeSalesDetailRecordWithTempOrder(currentTempOrder, loadedRecord, str
   });
   var uidRemaps = [];
   var mergedRecord = mergeWith(normalizedCurrentTempOrder, normalizedLoadedRecord, function (currentValue, loadedValue, key) {
+    // small_ticket_data 是由 Server 一次性生成的完整展示快照，不能递归进入
+    // locale 内部继续套用订单集合或普通数组的合并规则。
+    if (key === 'small_ticket_data') {
+      return mergeBaseSalesSmallTicketDataSnapshot(currentValue, loadedValue);
+    }
     var collectionKind = getBaseSalesOrderCollectionKind(key);
     if (collectionKind && Array.isArray(loadedValue)) {
       return mergeBaseSalesOrderCollection(collectionKind, Array.isArray(currentValue) ? currentValue : [], loadedValue, strategy, uidRemaps);

package/dist/solution/BookingTicket/index.d.ts

@@ -339,7 +339,7 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
      * 获取当前的客户搜索条件
      * @returns 当前搜索条件
      */
-    getCurrentCustomerSearchParams(): Omit<import("../../modules").ShopGetCustomerListParams, "skip" | "num">;
+    getCurrentCustomerSearchParams(): Omit<import("../../modules").ShopGetCustomerListParams, "num" | "skip">;
     /**
      * 获取客户列表状态（包含滚动加载相关状态）
      * @returns 客户状态
@@ -458,7 +458,19 @@ export declare class BookingTicketImpl extends BaseSalesImpl implements Module {
      * 加车两阶段主决策（规格弹窗 / 资源编辑 / 直接加车）。
      * 与 ticketBooking `handleSelectProduct` + `handleBooking4Service` 等价。
      */
-    decideAddProduct(item: any, options?: Partial<AddProductDecideContext>): import("./utils/addProductDecision").AddProductDecision;
+    decideAddProduct(item: any, options?: Partial<AddProductDecideContext>): {
+        action: "reloadCatalog";
+    } | {
+        action: "add";
+        cacheItem: any;
+    } | {
+        action: "requiresDetail";
+        payload: AddProductRequiresDetailPayload;
+    } | {
+        action: "requiresBookingEdit";
+        cacheItem: any;
+        payload: import("./utils/addProductDecision").AddProductRequiresBookingEditPayload;
+    };
     /** 规格弹窗 callback 后的第二段决策。 */
     decideAfterDetail(cacheItem: any, options?: Partial<AddProductDecideContext>): import("./utils/addProductDecision").AddProductDecision;
     /**

package/dist/solution/BookingTicket/index.js

@@ -298,30 +298,37 @@ export var BookingTicketImpl = /*#__PURE__*/function (_BaseSalesImpl) {
               lastFetchedAt = this.store.openData.getLastFetchedAt();
               cachedData = this.store.openData.getOpenData();
               if (!(cachedData && this.openDataTarget === target && lastFetchedAt && Date.now() - lastFetchedAt < OPEN_DATA_CACHE_TTL)) {
-                _context2.next = 13;
+                _context2.next = 16;
                 break;
               }
+              if (!(typeof this.store.openData.ensureInvoiceTemplateSettings === 'function')) {
+                _context2.next = 14;
+                break;
+              }
+              _context2.next = 14;
+              return this.store.openData.ensureInvoiceTemplateSettings(target);
+            case 14:
               this.otherParams.openData = cachedData;
               return _context2.abrupt("return", cachedData);
-            case 13:
+            case 16:
               if (!this.loadOpenDataInFlight) {
-                _context2.next = 21;
+                _context2.next = 24;
                 break;
               }
               if (!(this.loadOpenDataInFlightTarget === target)) {
-                _context2.next = 18;
+                _context2.next = 21;
                 break;
               }
-              _context2.next = 17;
-              return this.loadOpenDataInFlight;
-            case 17:
-              return _context2.abrupt("return", _context2.sent);
-            case 18:
               _context2.next = 20;
               return this.loadOpenDataInFlight;
             case 20:
-              return _context2.abrupt("return", this.loadOpenDataConfig());
+              return _context2.abrupt("return", _context2.sent);
             case 21:
+              _context2.next = 23;
+              return this.loadOpenDataInFlight;
+            case 23:
+              return _context2.abrupt("return", this.loadOpenDataConfig());
+            case 24:
               this.loadOpenDataInFlightTarget = target;
               request = this.store.openData.fetchOpenData({
                 scope: 'board',
@@ -330,10 +337,10 @@ export var BookingTicketImpl = /*#__PURE__*/function (_BaseSalesImpl) {
                 section_code: [].concat(OPEN_DATA_SECTION_CODES)
               });
               this.loadOpenDataInFlight = request;
-              _context2.prev = 24;
-              _context2.next = 27;
+              _context2.prev = 27;
+              _context2.next = 30;
               return request;
-            case 27:
+            case 30:
               openDataConfig = _context2.sent;
               // clearOpenDataCache() 或新请求已接管时，旧响应只能返回给原调用方，不能复活缓存归属。
               if (this.loadOpenDataInFlight === request) {
@@ -341,18 +348,18 @@ export var BookingTicketImpl = /*#__PURE__*/function (_BaseSalesImpl) {
                 this.otherParams.openData = openDataConfig;
               }
               return _context2.abrupt("return", openDataConfig);
-            case 30:
-              _context2.prev = 30;
+            case 33:
+              _context2.prev = 33;
               if (this.loadOpenDataInFlight === request) {
                 this.loadOpenDataInFlight = null;
                 this.loadOpenDataInFlightTarget = null;
               }
-              return _context2.finish(30);
-            case 33:
+              return _context2.finish(33);
+            case 36:
             case "end":
               return _context2.stop();
           }
-        }, _callee2, this, [[24,, 30, 33]]);
+        }, _callee2, this, [[27,, 33, 36]]);
       }));
       function loadOpenDataConfig() {
         return _loadOpenDataConfig.apply(this, arguments);

package/dist/solution/Sales/index.js

@@ -275,33 +275,40 @@ export var SalesImpl = /*#__PURE__*/function (_BaseModule) {
               cachedData = this.invoiceOpenDataModule.getOpenData();
               lastFetchedAt = this.invoiceOpenDataModule.getLastFetchedAt();
               if (!(cachedData && this.invoiceOpenDataTarget === target && typeof lastFetchedAt === 'number' && Date.now() - lastFetchedAt < INVOICE_OPEN_DATA_CACHE_TTL)) {
-                _context4.next = 7;
+                _context4.next = 10;
+                break;
+              }
+              if (!(typeof this.invoiceOpenDataModule.ensureInvoiceTemplateSettings === 'function')) {
+                _context4.next = 9;
                 break;
               }
+              _context4.next = 9;
+              return this.invoiceOpenDataModule.ensureInvoiceTemplateSettings(target);
+            case 9:
               return _context4.abrupt("return", cachedData);
-            case 7:
+            case 10:
               if (!this.invoiceOpenDataInFlight) {
-                _context4.next = 18;
+                _context4.next = 21;
                 break;
               }
               if (!(this.invoiceOpenDataInFlightTarget === target)) {
-                _context4.next = 10;
+                _context4.next = 13;
                 break;
               }
               return _context4.abrupt("return", this.invoiceOpenDataInFlight);
-            case 10:
-              _context4.prev = 10;
-              _context4.next = 13;
-              return this.invoiceOpenDataInFlight;
             case 13:
-              _context4.next = 17;
+              _context4.prev = 13;
+              _context4.next = 16;
+              return this.invoiceOpenDataInFlight;
+            case 16:
+              _context4.next = 20;
               break;
-            case 15:
-              _context4.prev = 15;
-              _context4.t0 = _context4["catch"](10);
-            case 17:
-              return _context4.abrupt("return", this.loadInvoiceOpenData(businessCode, channel));
             case 18:
+              _context4.prev = 18;
+              _context4.t0 = _context4["catch"](13);
+            case 20:
+              return _context4.abrupt("return", this.loadInvoiceOpenData(businessCode, channel));
+            case 21:
               request = this.invoiceOpenDataModule.fetchOpenData({
                 scope: 'board',
                 target: target,
@@ -309,28 +316,28 @@ export var SalesImpl = /*#__PURE__*/function (_BaseModule) {
               });
               this.invoiceOpenDataInFlight = request;
               this.invoiceOpenDataInFlightTarget = target;
-              _context4.prev = 21;
-              _context4.next = 24;
+              _context4.prev = 24;
+              _context4.next = 27;
               return request;
-            case 24:
+            case 27:
               openData = _context4.sent;
               // clearOpenDataCache() 或后续请求接管后，旧响应不得复活 target 归属。
               if (this.invoiceOpenDataInFlight === request) {
                 this.invoiceOpenDataTarget = target;
               }
               return _context4.abrupt("return", openData);
-            case 27:
-              _context4.prev = 27;
+            case 30:
+              _context4.prev = 30;
               if (this.invoiceOpenDataInFlight === request) {
                 this.invoiceOpenDataInFlight = null;
                 this.invoiceOpenDataInFlightTarget = null;
               }
-              return _context4.finish(27);
-            case 30:
+              return _context4.finish(30);
+            case 33:
             case "end":
               return _context4.stop();
           }
-        }, _callee4, this, [[10, 15], [21,, 27, 30]]);
+        }, _callee4, this, [[13, 18], [24,, 30, 33]]);
       }));
       function loadInvoiceOpenData(_x4, _x5) {
         return _loadInvoiceOpenData.apply(this, arguments);

package/dist/solution/UnifiedBookingSales/index.js

@@ -1937,29 +1937,36 @@ export var UnifiedBookingSalesImpl = /*#__PURE__*/function (_BookingTicket) {
               cachedData = this.store.openData.getOpenData();
               lastFetchedAt = this.store.openData.getLastFetchedAt();
               if (!(!params.force && this.openDataTarget === target && cachedData && lastFetchedAt && Date.now() - lastFetchedAt < OPEN_DATA_CACHE_TTL)) {
-                _context11.next = 11;
+                _context11.next = 14;
                 break;
               }
+              if (!(typeof this.store.openData.ensureInvoiceTemplateSettings === 'function')) {
+                _context11.next = 13;
+                break;
+              }
+              _context11.next = 13;
+              return this.store.openData.ensureInvoiceTemplateSettings(target);
+            case 13:
               return _context11.abrupt("return", cachedData);
-            case 11:
+            case 14:
               if (!this.loadOpenDataInFlight) {
-                _context11.next = 19;
+                _context11.next = 22;
                 break;
               }
               if (!(this.loadOpenDataInFlightTarget === target)) {
-                _context11.next = 16;
+                _context11.next = 19;
                 break;
               }
-              _context11.next = 15;
-              return this.loadOpenDataInFlight;
-            case 15:
-              return _context11.abrupt("return", _context11.sent);
-            case 16:
               _context11.next = 18;
               return this.loadOpenDataInFlight;
             case 18:
-              return _context11.abrupt("return", this.loadOpenData(params));
+              return _context11.abrupt("return", _context11.sent);
             case 19:
+              _context11.next = 21;
+              return this.loadOpenDataInFlight;
+            case 21:
+              return _context11.abrupt("return", this.loadOpenData(params));
+            case 22:
               this.loadOpenDataInFlightTarget = target;
               request = this.store.openData.fetchOpenData({
                 scope: 'board',
@@ -1967,10 +1974,10 @@ export var UnifiedBookingSalesImpl = /*#__PURE__*/function (_BookingTicket) {
                 section_code: [].concat(OPEN_DATA_SECTION_CODES)
               });
               this.loadOpenDataInFlight = request;
-              _context11.prev = 22;
-              _context11.next = 25;
+              _context11.prev = 25;
+              _context11.next = 28;
               return request;
-            case 25:
+            case 28:
               openData = _context11.sent;
               if (this.loadOpenDataInFlight === request) {
                 this.openDataTarget = target;
@@ -1979,18 +1986,18 @@ export var UnifiedBookingSalesImpl = /*#__PURE__*/function (_BookingTicket) {
                 this.otherParams.channel = channel;
               }
               return _context11.abrupt("return", openData);
-            case 28:
-              _context11.prev = 28;
+            case 31:
+              _context11.prev = 31;
               if (this.loadOpenDataInFlight === request) {
                 this.loadOpenDataInFlight = null;
                 this.loadOpenDataInFlightTarget = null;
               }
-              return _context11.finish(28);
-            case 31:
+              return _context11.finish(31);
+            case 34:
             case "end":
               return _context11.stop();
           }
-        }, _callee11, this, [[22,, 28, 31]]);
+        }, _callee11, this, [[25,, 31, 34]]);
       }));
       function loadOpenData(_x7) {
         return _loadOpenData.apply(this, arguments);

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

@@ -1,46 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-Object.defineProperty(exports, "BUY_X_GET_Y_FREE_STRATEGY", {
-  enumerable: true,
-  get: function () {
-    return _examples.BUY_X_GET_Y_FREE_STRATEGY;
-  }
-});
-Object.defineProperty(exports, "ITEM_REWARD_STRATEGY", {
-  enumerable: true,
-  get: function () {
-    return _examples.ITEM_REWARD_STRATEGY;
-  }
-});
-Object.defineProperty(exports, "PromotionAdapter", {
-  enumerable: true,
-  get: function () {
-    return _adapter.PromotionAdapter;
-  }
-});
-Object.defineProperty(exports, "PromotionEvaluator", {
-  enumerable: true,
-  get: function () {
-    return _evaluator.PromotionEvaluator;
-  }
-});
-Object.defineProperty(exports, "X_ITEMS_FOR_Y_PRICE_STRATEGY", {
-  enumerable: true,
-  get: function () {
-    return _examples.X_ITEMS_FOR_Y_PRICE_STRATEGY;
-  }
-});
-Object.defineProperty(exports, "default", {
-  enumerable: true,
-  get: function () {
-    return _adapter.default;
-  }
-});
-var _evaluator = require("./evaluator");
-var _adapter = _interopRequireWildcard(require("./adapter"));
-var _examples = require("./examples");
-function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
-function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+"use strict";

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

@@ -3,7 +3,7 @@ import { BaseModule } from '../BaseModule';
 import type { ScheduleModule } from '../Schedule';
 import type { OpenDataConfig, OpenDataFetchParams, OpenDataAvailabilityResult, InvoiceLayoutConfig, InvoiceTemplateSettings } from './types';
 export * from './types';
-export { computeAvailability, getDefaultInvoiceLayoutConfig, getDefaultInvoiceTemplateSettings, normalizeInvoiceLayoutConfig, normalizeInvoiceTemplateSettings, normalizeRawInvoiceTemplateSettings, resolveInvoiceReceiptLocales, } from './utils';
+export { computeAvailability, getDefaultInvoiceLayoutConfig, getDefaultInvoiceTemplateSettings, normalizeInvoiceLayoutConfig, normalizeInvoiceLayoutFromTemplateSettings, normalizeInvoiceTemplateSettings, normalizeRawInvoiceTemplateSettings, resolveInvoiceReceiptLocales, } from './utils';
 export declare class OpenDataModule extends BaseModule implements Module {
     protected defaultName: string;
     protected defaultVersion: string;
@@ -16,6 +16,9 @@ export declare class OpenDataModule extends BaseModule implements Module {
     private fatherModule;
     private otherParams;
     private fetchRevision;
+    private invoiceTemplateCacheRevision;
+    private invoiceTemplateDocumentCache;
+    private invoiceTemplateDocumentInFlight;
     constructor(name?: string, version?: string);
     initialize(core: PisellCore, options: ModuleOptions): Promise<void>;
     /**
@@ -29,6 +32,12 @@ export declare class OpenDataModule extends BaseModule implements Module {
     getOpenData(): OpenDataConfig | null;
     getInvoiceLayoutConfig(): InvoiceLayoutConfig;
     getInvoiceTemplateSettings(): InvoiceTemplateSettings;
+    ensureInvoiceTemplateSettings(target: string): Promise<InvoiceTemplateSettings>;
+    private commitInvoiceTemplateSettings;
+    private resolveInvoiceTemplateSettings;
+    private buildInvoiceTemplateCacheKey;
+    private fetchInvoiceTemplateDocument;
+    private logInvoiceTemplateDocumentFallback;
     getLastFetchedAt(): number | null;
     /** 清除内存与 sessionStorage 镜像中的 OpenData，供宿主切店时调用。 */
     clearCache(): void;

package/lib/modules/OpenData/index.js

@@ -9,6 +9,7 @@ var _exportNames = {
   getDefaultInvoiceLayoutConfig: true,
   getDefaultInvoiceTemplateSettings: true,
   normalizeInvoiceLayoutConfig: true,
+  normalizeInvoiceLayoutFromTemplateSettings: true,
   normalizeInvoiceTemplateSettings: true,
   normalizeRawInvoiceTemplateSettings: true,
   resolveInvoiceReceiptLocales: true
@@ -38,6 +39,12 @@ Object.defineProperty(exports, "normalizeInvoiceLayoutConfig", {
     return _utils.normalizeInvoiceLayoutConfig;
   }
 });
+Object.defineProperty(exports, "normalizeInvoiceLayoutFromTemplateSettings", {
+  enumerable: true,
+  get: function () {
+    return _utils.normalizeInvoiceLayoutFromTemplateSettings;
+  }
+});
 Object.defineProperty(exports, "normalizeInvoiceTemplateSettings", {
   enumerable: true,
   get: function () {
@@ -70,6 +77,25 @@ Object.keys(_types).forEach(function (key) {
     }
   });
 });
+function isRecord(value) {
+  return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+function resolveInvoiceDocumentId(value) {
+  if (typeof value === 'number') {
+    return Number.isSafeInteger(value) && value > 0 ? String(value) : null;
+  }
+  if (typeof value !== 'string') return null;
+  const normalized = value.trim();
+  if (!/^\d+$/.test(normalized)) return null;
+  const numericId = Number(normalized);
+  return Number.isSafeInteger(numericId) && numericId > 0 ? String(numericId) : null;
+}
+function isLegacyInvoiceTemplate(value) {
+  if (typeof value !== 'string' || value.trim().length === 0) return false;
+  const normalized = value.trim();
+  const numericLike = /^[+-]?(?:\d+\.?\d*|\.\d+)(?:e[+-]?\d+)?$/i;
+  return !numericLike.test(normalized);
+}
 class OpenDataModule extends _BaseModule.BaseModule {
   defaultName = 'openData';
   defaultVersion = '1.0.0';
@@ -82,6 +108,9 @@ class OpenDataModule extends _BaseModule.BaseModule {
   fatherModule;
   otherParams = {};
   fetchRevision = 0;
+  invoiceTemplateCacheRevision = 0;
+  invoiceTemplateDocumentCache = new Map();
+  invoiceTemplateDocumentInFlight = new Map();
   constructor(name, version) {
     super(name, version);
   }
@@ -90,6 +119,12 @@ class OpenDataModule extends _BaseModule.BaseModule {
     this.store = options.store;
     this.store.data = options.initialState?.data ?? null;
     this.store.lastFetchedAt = options.initialState?.lastFetchedAt ?? null;
+    // Document 解析结果只在当前模块实例内复用。页面刷新后即使恢复了原始
+    // OpenData，也必须重新查询一次 NocoBase，以取得当前模板内容。
+    this.store.invoiceTemplateSettings = null;
+    this.store.invoiceTemplateTarget = null;
+    this.store.invoiceTemplateDocumentId = null;
+    this.store.invoiceTemplateCacheKey = null;
     this.otherParams = options.otherParams || {};
     if (this.otherParams.cacheId) {
       this.openCache = this.otherParams.openCache ?? false;
@@ -139,10 +174,12 @@ class OpenDataModule extends _BaseModule.BaseModule {
       throw new Error(response?.message || '获取 OpenData 配置失败');
     }
     const data = response?.data || {};
+    const resolvedInvoiceTemplate = await this.resolveInvoiceTemplateSettings(data, params.target);
     // clearCache() 或后续请求发生后，旧响应不得复活已失效的 target 配置。
     if (fetchRevision === this.fetchRevision) {
       this.store.data = data;
       this.store.lastFetchedAt = Date.now();
+      this.commitInvoiceTemplateSettings(params.target, resolvedInvoiceTemplate);
     }
     return data;
   }
@@ -150,10 +187,126 @@ class OpenDataModule extends _BaseModule.BaseModule {
     return this.store.data;
   }
   getInvoiceLayoutConfig() {
-    return (0, _utils.normalizeInvoiceLayoutConfig)(this.store.data);
+    return (0, _utils.normalizeInvoiceLayoutFromTemplateSettings)(this.getInvoiceTemplateSettings());
   }
   getInvoiceTemplateSettings() {
-    return (0, _utils.normalizeInvoiceTemplateSettings)(this.store.data);
+    if (isRecord(this.store.invoiceTemplateSettings)) {
+      const documentId = resolveInvoiceDocumentId(this.store.data?.['documents.invoice_template']);
+      if (documentId) {
+        const target = this.store.invoiceTemplateTarget;
+        if (!target || this.store.invoiceTemplateCacheKey !== this.buildInvoiceTemplateCacheKey(target, documentId)) {
+          return (0, _utils.getDefaultInvoiceTemplateSettings)();
+        }
+      }
+      return (0, _utils.normalizeRawInvoiceTemplateSettings)(this.store.invoiceTemplateSettings);
+    }
+    if (isLegacyInvoiceTemplate(this.store.data?.['documents.invoice_template'])) {
+      return (0, _utils.normalizeInvoiceTemplateSettings)(this.store.data);
+    }
+    return (0, _utils.getDefaultInvoiceTemplateSettings)();
+  }
+  async ensureInvoiceTemplateSettings(target) {
+    const normalizedTarget = String(target || '').trim();
+    const config = this.store.data;
+    if (!normalizedTarget || !config) {
+      return (0, _utils.getDefaultInvoiceTemplateSettings)();
+    }
+    const fetchRevision = this.fetchRevision;
+    const resolved = await this.resolveInvoiceTemplateSettings(config, normalizedTarget);
+    if (fetchRevision !== this.fetchRevision || this.store.data !== config) {
+      return (0, _utils.getDefaultInvoiceTemplateSettings)();
+    }
+    this.commitInvoiceTemplateSettings(normalizedTarget, resolved);
+    return (0, _utils.normalizeRawInvoiceTemplateSettings)(resolved.settings);
+  }
+  commitInvoiceTemplateSettings(target, resolved) {
+    this.store.invoiceTemplateSettings = (0, _utils.normalizeRawInvoiceTemplateSettings)(resolved.settings);
+    this.store.invoiceTemplateTarget = target;
+    this.store.invoiceTemplateDocumentId = resolved.documentId;
+    this.store.invoiceTemplateCacheKey = resolved.cacheKey;
+  }
+  async resolveInvoiceTemplateSettings(config, target) {
+    const rawTemplate = config['documents.invoice_template'];
+    const documentId = resolveInvoiceDocumentId(rawTemplate);
+    if (!documentId) {
+      return {
+        settings: isLegacyInvoiceTemplate(rawTemplate) ? (0, _utils.normalizeInvoiceTemplateSettings)(config) : (0, _utils.getDefaultInvoiceTemplateSettings)(),
+        documentId: null,
+        cacheKey: null
+      };
+    }
+    const cacheKey = this.buildInvoiceTemplateCacheKey(target, documentId);
+    if (this.store.invoiceTemplateTarget === target && this.store.invoiceTemplateDocumentId === documentId && this.store.invoiceTemplateCacheKey === cacheKey && isRecord(this.store.invoiceTemplateSettings)) {
+      return {
+        settings: (0, _utils.normalizeRawInvoiceTemplateSettings)(this.store.invoiceTemplateSettings),
+        documentId,
+        cacheKey
+      };
+    }
+    const cachedSettings = this.invoiceTemplateDocumentCache.get(cacheKey);
+    if (cachedSettings) {
+      return {
+        settings: (0, _utils.normalizeRawInvoiceTemplateSettings)(cachedSettings),
+        documentId,
+        cacheKey
+      };
+    }
+    let request = this.invoiceTemplateDocumentInFlight.get(cacheKey);
+    if (!request) {
+      const cacheRevision = this.invoiceTemplateCacheRevision;
+      request = this.fetchInvoiceTemplateDocument(documentId).catch(error => {
+        this.logInvoiceTemplateDocumentFallback(error, target, documentId);
+        return (0, _utils.getDefaultInvoiceTemplateSettings)();
+      }).then(settings => {
+        const normalized = (0, _utils.normalizeRawInvoiceTemplateSettings)(settings);
+        if (cacheRevision === this.invoiceTemplateCacheRevision) {
+          this.invoiceTemplateDocumentCache.set(cacheKey, normalized);
+        }
+        return normalized;
+      }).finally(() => {
+        if (this.invoiceTemplateDocumentInFlight.get(cacheKey) === request) {
+          this.invoiceTemplateDocumentInFlight.delete(cacheKey);
+        }
+      });
+      this.invoiceTemplateDocumentInFlight.set(cacheKey, request);
+    }
+    return {
+      settings: await request,
+      documentId,
+      cacheKey
+    };
+  }
+  buildInvoiceTemplateCacheKey(target, documentId) {
+    const getData = this.appPlugin?.getData?.();
+    return JSON.stringify([getData?.('tenant_id') ?? null, getData?.('shop_id') ?? null, target, documentId]);
+  }
+  async fetchInvoiceTemplateDocument(documentId) {
+    const response = await this.request.get(`/document:get?filterByTk=${encodeURIComponent(documentId)}`, {}, {
+      isNocobase: true,
+      prefix: false,
+      headers: {
+        'x-data-source': 'pisell2'
+      },
+      customToast: () => {}
+    });
+    const document = response?.data;
+    if (!document || resolveInvoiceDocumentId(document.id) !== documentId) {
+      throw new Error(`Invoice Document ${documentId} 返回的 ID 不匹配`);
+    }
+    if (document.deleted_at !== null && document.deleted_at !== undefined) {
+      throw new Error(`Invoice Document ${documentId} 已被删除`);
+    }
+    if (!isRecord(document.data) || !isRecord(document.data.template_settings)) {
+      throw new Error(`Invoice Document ${documentId} 缺少 template_settings`);
+    }
+    return (0, _utils.normalizeRawInvoiceTemplateSettings)(document.data.template_settings);
+  }
+  logInvoiceTemplateDocumentFallback(error, target, documentId) {
+    console.warn('[OpenDataModule] Invoice Document 加载失败，使用 DEFAULT', {
+      target,
+      documentId,
+      message: error instanceof Error ? error.message : String(error)
+    });
   }
   getLastFetchedAt() {
     return this.store.lastFetchedAt ?? null;
@@ -162,8 +315,15 @@ class OpenDataModule extends _BaseModule.BaseModule {
   /** 清除内存与 sessionStorage 镜像中的 OpenData，供宿主切店时调用。 */
   clearCache() {
     this.fetchRevision += 1;
+    this.invoiceTemplateCacheRevision += 1;
+    this.invoiceTemplateDocumentCache.clear();
+    this.invoiceTemplateDocumentInFlight.clear();
     this.store.data = null;
     this.store.lastFetchedAt = null;
+    this.store.invoiceTemplateSettings = null;
+    this.store.invoiceTemplateTarget = null;
+    this.store.invoiceTemplateDocumentId = null;
+    this.store.invoiceTemplateCacheKey = null;
   }
   checkAvailability(scheduleModule) {
     const scheduleList = scheduleModule ? scheduleModule?.getScheduleListByIds(this.store.data?.['availability.operating_hours'] || []) : undefined;

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

@@ -32,6 +32,15 @@ export interface InvoiceTemplateSettings {
     modules: InvoiceTemplateModuleConfig[];
     [key: string]: unknown;
 }
+export interface InvoiceDocumentResponse {
+    data?: {
+        id?: number | string;
+        deleted_at?: string | null;
+        data?: {
+            template_settings?: unknown;
+        };
+    };
+}
 export type RawInvoiceEditConfig = string | {
     language?: unknown;
     modules?: unknown;
@@ -79,7 +88,7 @@ export interface OpenDataConfig {
         label: string;
         value: number;
     }>;
-    'documents.invoice_template'?: string;
+    'documents.invoice_template'?: string | number;
     'documents.invoice_edit'?: RawInvoiceEditConfig;
     /** @deprecated 仅保留旧调用方的类型兼容，Invoice 读取逻辑不再消费该字段。 */
     'documents.invoice'?: RawInvoiceLayoutConfig;
@@ -92,6 +101,10 @@ export interface OpenDataConfig {
 export interface OpenDataState {
     data: OpenDataConfig | null;
     lastFetchedAt: number | null;
+    invoiceTemplateSettings?: InvoiceTemplateSettings | null;
+    invoiceTemplateTarget?: string | null;
+    invoiceTemplateDocumentId?: string | null;
+    invoiceTemplateCacheKey?: string | null;
 }
 export interface OpenDataFetchParams {
     scope: string;