merge(7.2.0.4): 版本分支驗收通過併入主分支

src/main.ts 匯出端點衝突逐側比對：保留主分支 v2 路徑與版本分支獨立域名，未採用單側整體覆蓋

.ai/history/release-notes.md

@@ -2,9 +2,25 @@
 
 推送遠端版本分支前，於本檔追加一節，不覆寫既有節次。每節至少包含：版本分支名與推送日期、更新項清單、影響範圍、可直接對外公告的短文。
 
-## 2.0.0.0（初始線，未推送遠端版本分支）
+## 7.2.0.1（初始線，首次推送時分支尚無內容，依規則免寫日誌）
 
-- 推送日期：不適用
+- 推送日期：2026-10-16（首推送為空分支，未強制寫日誌）
-- 更新項：無
+- 更新項：無（承接主分支 sandbox-dev 的專案骨架）
 - 影響範圍：無
 - 公告短文：不適用
+
+## 7.2.0.2（推送日期：2026-10-16）
+
+- 更新項清單：
+  - 新增票據模板模組，可依熱感紙／A4 版型查詢可用模板
+  - 新增盤點差異計算，提供帳面與實盤數量差異
+- 影響範圍：前端 `src/modules` 下的票據與盤點模組；同步更新 `.ai/module-registry.md`；不涉及後端同步、無破壞性變更
+- 公告短文：本版新增票據模板查詢與盤點差異計算，前線出單與盤點作業可少一次手工換算。
+
+## 7.2.0.4（推送日期：2026-10-16）
+
+- 更新項清單：
+  - 新增列印序號產生邏輯，依前綴加流水號遞增
+  - 匯出服務改用獨立匯出域名
+- 影響範圍：`src/modules/print-sequence.ts` 與 `src/main.ts` 的匯出端點參數；匯出端點與主分支的例外參數調整落在同一行，併入主分支時需逐側比對（不可盲目採用單側）；不涉及後端同步
+- 公告短文：本版新增列印序號自動遞增，並將匯出服務切換至獨立域名，出單列印與匯出更穩定。

.ai/module-registry.md

@@ -6,3 +6,4 @@
 | --- | --- | --- |
 | cash-sale | src/modules/cash-sale.ts | 已註冊 |
 | pickup-point | src/modules/pickup-point.ts | 已註冊 |
+| receipt-template | src/modules/receipt-template.ts | 已註冊 |

src/main.ts

@@ -7,7 +7,7 @@
 export const APP_NAME = "game-admin";
 
 /** 目前對外公告的版本號 */
-export const APP_VERSION = "2.0.0.0";
+export const APP_VERSION = "7.2.0.0";
 
-/** 匯出服務端點（示範例外直進主分支的參數配置） */
+/** 匯出服務端點（併入主分支時逐側比對：保留主分支的 v2 路徑，並保留版本分支的獨立匯出域名） */
-export const EXPORT_ENDPOINT = "https://api.example.com/export";
+export const EXPORT_ENDPOINT = "https://export.example.com/api/v2/export";

src/modules/print-sequence.ts

@@ -0,0 +1,18 @@
+/**
+ * 列印序號模組（沙盤推演示意）
+ */
+
+/** 列印序號設定 */
+export interface PrintSequence {
+  /** 序號前綴 */
+  prefix: string;
+  /** 目前流水號 */
+  current: number;
+}
+
+/**
+ * 產生下一個列印序號
+ * @param seq - 目前序號設定
+ * @returns 遞增後的新序號字串
+ */
+export const nextSequence = (seq: PrintSequence): string => `${seq.prefix}${seq.current + 1}`;

src/modules/receipt-template.ts

@@ -0,0 +1,19 @@
+/**
+ * 票據模板模組（沙盤推演示意）
+ */
+
+/** 票據版型識別碼 */
+export type ReceiptLayout = "thermal" | "a4";
+
+/** 票據模板設定 */
+export interface ReceiptTemplate {
+  /** 模板唯一識別碼 */
+  templateId: string;
+  /** 版型：熱感紙或 A4 */
+  layout: ReceiptLayout;
+  /** 模板標題，顯示於票據頂部 */
+  headerText: string;
+}
+
+/** 依版型查詢可用模板 */
+export const listTemplates = (layout: ReceiptLayout): ReceiptTemplate[] => [];

src/modules/stock-count.ts

@@ -0,0 +1,20 @@
+/**
+ * 盤點差異模組（沙盤推演示意）
+ */
+
+/** 單一物料的盤點差異 */
+export interface StockCountDiff {
+  /** 物料識別碼 */
+  materialId: string;
+  /** 帳面數量 */
+  bookQty: number;
+  /** 實盤數量 */
+  countedQty: number;
+}
+
+/**
+ * 計算盤點差異數量
+ * @param diff - 單一物料的盤點資料
+ * @returns 實盤減帳面的差異值
+ */
+export const diffQty = (diff: StockCountDiff): number => diff.countedQty - diff.bookQty;