merge(receipt): 合併遠端共享分支的排序改動

逐側比對保留濾除空值與排序兩側改動，未採單側覆蓋

.ai/history/release-notes.md

@@ -2,9 +2,33 @@
 
 推送遠端版本分支前，於本檔追加一節，不覆寫既有節次。每節至少包含：版本分支名與推送日期、更新項清單、影響範圍、可直接對外公告的短文。
 
-## 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` 的匯出端點參數；匯出端點與主分支的例外參數調整落在同一行，併入主分支時需逐側比對（不可盲目採用單側）；不涉及後端同步
+- 公告短文：本版新增列印序號自動遞增，並將匯出服務切換至獨立域名，出單列印與匯出更穩定。
+
+## 7.2.0.4 追加（未新增版本號｜推送日期：2026-10-16）
+
+- 版本分支名：7.2.0.4（沿用既有版本號，追加需求直接併入；不切新版本分支）
+- 更新項清單：
+  - 新增倉庫標籤設定，可依倉庫查詢標籤名稱與顏色
+- 影響範圍：`src/modules/warehouse-label.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

@@ -9,5 +9,5 @@ export const APP_NAME = "game-admin";
 /** 目前對外公告的版本號 */
 export const APP_VERSION = "2.0.0.0";
 
-/** 匯出服務端點（示範例外直進主分支的參數配置） */
-export const EXPORT_ENDPOINT = "https://api.example.com/export";
+/** 匯出服務端點（版本分支改用獨立匯出域名） */
+export const EXPORT_ENDPOINT = "https://export.example.com/api";

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-batch-print.ts

@@ -0,0 +1,20 @@
+/**
+ * 票據批量列印模組（沙盤推演示意）
+ * 由第二開發者在共享功能分支 feature/receipt-batch-print 上開發
+ */
+
+/** 單筆批量列印工作 */
+export interface BatchPrintJob {
+  /** 使用的票據模板識別碼 */
+  templateId: string;
+  /** 目標倉庫識別碼 */
+  warehouseId: string;
+}
+
+/**
+ * 建立批量列印工作清單
+ * @param templateId - 票據模板識別碼
+ * @param warehouseIds - 目標倉庫識別碼清單
+ * @returns 逐倉庫展開的列印工作（先濾除空倉庫代碼，再依倉庫代碼排序）
+ */
+export const createBatchJobs = (templateId: string, warehouseIds: string[]): BatchPrintJob[] => warehouseIds.filter((id) => id !== "").sort().map((id) => ({ templateId, warehouseId: id }));

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;

src/modules/warehouse-label.ts

@@ -0,0 +1,17 @@
+/**
+ * 倉庫標籤模組（沙盤推演示意）
+ * 屬於 7.2.0.4 版本驗收後追加的需求，不新開版本號
+ */
+
+/** 倉庫標籤設定 */
+export interface WarehouseLabel {
+  /** 倉庫識別碼 */
+  warehouseId: string;
+  /** 標籤顯示名稱 */
+  label: string;
+  /** 標籤顏色代碼，如 #4a9eea */
+  color: string;
+}
+
+/** 依倉庫查詢標籤設定 */
+export const getLabel = (warehouseId: string): WarehouseLabel | null => null;