FPSMS-backend/docs/user-guides/MTMS_送貨訂單與出貨_使用說明.md

# MTMS 使用說明：送貨訂單 → 放單 → 成品出倉

> 本手冊依目前前端畫面與繁中文案整理，**按鈕／選單名稱以畫面上「」內文字為準**。  
> 適用範圍：側欄「送貨訂單」、倉庫「成品出倉」（撳單／掃碼出倉／列印標籤）、加單與車線-X。  
> **「一附」章節**使用本機資料庫 `fpsmsdb` 的真實例子（查詢當下快照）。  
> 產生日期：依原始碼現況（若畫面改版，請以實際 UI 為準）。

---

## 這份手冊怎麼用

| 符號 | 意思 |
|------|------|
| 「……」 | 畫面上看得到的按鈕、選單、標題 |
| → | 下一步操作 |

**角色分工（白話）：**

| 角色動作 | 主要畫面 |
|----------|----------|
| 看單、放單、加單、補貨 | 「送貨訂單」`/do` |
| 撳單、掃碼提貨、列印 DN／標籤 | 「成品出倉」`/doworkbench` |
| 調整提料順序等（ADMIN） | 「成品出倉管理」 |

> **「放單」≠「撳單」**：放單＝由送貨訂單產生提料票；撳單＝倉庫領取該票開始出倉。

建議閱讀順序：送貨訂單篩選 → 放單 → 撳單 → 掃碼出倉 → 填箱數列印。

---

## 一、整體流程

```text
【送貨訂單 /do】篩選「2/F」「4/F」「車線-X」「加單」
    ↓ 「批量放單」或詳情「放單」
【產生提料單／提票】狀態進入待撳單
    ↓
【成品出倉 /doworkbench】「撳單/提料單詳情」
    ↓ 選日期／批量|單量／樓層票 → 點車線「確認分配」
【掃碼提料】「開始QR掃描」→「提交所有已掃描項目」
    ↓
【成品提貨記錄】輸入「箱數」→「列印送貨單標籤」等
    ↓
【查看提貨情況】核對「已完成」
```

---

## 一附、本地資料庫實例

> DO「來貨狀態」：`pending`→「待處理」、`receiving`→「接收中」、`completed`→「已完成」。  
> 提票在「查看提貨情況」：`pending`→「待撳單」、`released`→「提貨中」、`completed`→「已完成」。

### 例 A：待放單／待出貨的送貨訂單（2026-07-30）

本機「預計送貨日期」**2026-07-30** 仍有多張「待處理」，例如：

| 「門店訂單編號」 | 「來貨狀態」 | 店鋪 |
|------------------|--------------|------|
| TOUR03PO26070304 | 待處理 | UR03 |
| TOCF28PO26070199 | 待處理 | CF28 |
| TOCF28PO26070200 | 待處理 | CF28 |
| TOCF02PO26070176 | 待處理 | CF02 |
| TOCF18PO26070194 | 待處理 | CF18 |

**怎麼練：**

1. 「送貨訂單」→ 選樓層分頁 →「預計送貨日期」填 **2026-07-30** → 搜索。  
2. 找上表編號點「詳情」看行項與「庫存可用」。  
3. 測試庫才建議真的「放單」／「批量放單」（會產生提料票）。

### 例 B：近一週 DO 狀態量級（本機 2026-07-28～08-05）

| 「來貨狀態」 | 約筆數 | 使用者常做 |
|--------------|--------|------------|
| 待處理 | 1,425 | 篩選後「批量放單」 |
| 已完成 | 1,059 | 查歷史／補貨原單 |
| 接收中 | 96 | 出倉進行中對應 |

### 例 C：提料票（撳單前「待撳單」風格樣本）

本機較早提票例（`do_pick_order`，狀態 pending≈待撳／待處理）：

| 「提票號碼」 | 車線資訊 | 店鋪 | 「需求日期」 | 放單類型 |
|--------------|----------|------|--------------|----------|
| TI-S-20260504-4F-001 | P06B_Sat_區1_港島東 | MC49 | 2026-05-04 | single（單量） |
| TI-S-20260504-2F-001 | 車線-F1 | MC49 | 2026-05-04 | single |
| TI-S-20260504-2F-001 | 車線-X | HP65 | 2026-05-04 | single |
| TI-S-20260505-4F-002 | P06B_Tue_區5_九龍中 | HP15 | 2026-05-05 | single |

**怎麼練：**「成品出倉」→「撳單/提料單詳情」→ 日期選對應「是日／翌日…」；或「成品提貨記錄（全部）」用「提票號碼」搜索。注意「車線-X」會獨立分組。

### 自行查核用 SQL（選用）

```sql
SELECT d.code, d.status, DATE(d.estimatedArrivalDate) AS eta, s.code AS shop
FROM delivery_order d
LEFT JOIN shop s ON s.id = d.shopId
WHERE d.deleted = 0 AND DATE(d.estimatedArrivalDate) = '2026-07-30'
ORDER BY d.id DESC
LIMIT 20;

SELECT ticket_no, TruckLanceCode, ticket_status, ShopCode,
       DATE(RequiredDeliveryDate) AS req_date, release_type
FROM do_pick_order
WHERE deleted = 0 AND RequiredDeliveryDate >= '2026-05-01'
ORDER BY id DESC
LIMIT 20;
```

---

## 二、送貨訂單（`/do`）

### 2.1 入口與分頁

- 側欄 **「送貨訂單」**。

| 分頁 | 用途 |
|------|------|
| 「2/F」「4/F」 | 依樓層票別看／放單 |
| 「車線-X」 | 無匹配車線或歸入 X 的訂單 |
| 「加單」 | isExtra 加單；批量放單可合併 |
| 「補貨」 | 已完成原單補到目標單 |

### 2.2 搜索欄

- 「門店訂單編號」「店鋪名稱」「車線號碼」「預計送貨日期」「來貨狀態」  
- 狀態選項：「待處理」「接收中」「已完成」（及「全部」）  
- 注意：「已填寫車線號碼時，請一併選擇預計送貨日期後再搜索。」／「需選擇預計送貨日期」

### 2.3 結果表常見欄

「詳情」「門店訂單編號」「店鋪名稱」「供應商名稱」「車線號碼」「訂單日期」「預計送貨日期」「來貨狀態」。

### 2.4 詳情頁（`/do/edit?id=`）

- 標題：「編輯送貨訂單詳情」  
- 動作：「放單」「提料單分配」「分配2/F」「分配4/F」「放單2/F」「放單4/F」「返回」  
- 行表：「商品編號」「貨品名稱」「數量」「庫存可用」「庫存狀態」  
- 單張成功提示：「送貨訂單放單成功！提料單已建立。」

---

## 三、放單詳解

### 3.1 批量放單（常用）

1. 在「送貨訂單」搜出目標日／樓層的列，勾選需要的店（可取消勾選排除）。  
2. 點 **「批量放單」**。  
3. 對話框顯示「已選擇店舖數量: N」；「確認」執行。  
4. **「加單」分頁**額外選項：  
   - 「確認合併放單」（合併同車線 → TI-M- 合併票；文案含「合併同車線送貨訂單（TI-M- 合併票）」）  
   - 「確認不放合併放單」  
5. 成功：「已完成批量放單」。

Workbench 路徑按鈕亦可能顯示為「批量放單」（鍵名 Workbench Batch Release）。

### 3.2 單張放單

詳情頁「放單」，或先「分配2/F／4/F」再「放單2/F／4/F」。

### 3.3 放單前／失敗常見提示

| 提示 | 處理 |
|------|------|
| 「沒有選擇送貨訂單進行批量放單…」 | 先勾選列 |
| 「車線可用性警告」「問題送貨訂單」 | 核對目標日是否有車線；或走「車線-X」 |
| 「放單提料單失敗，請稍後再試。」 | 稍後重試；查該店是否已放過 |

---

## 四、成品出倉（`/doworkbench`）— 主路徑

### 4.1 入口

- 「倉庫管理」→ **「成品出倉」**（現行主選單指向 `/doworkbench`）。  
- 舊頁 `/finishedGood` 標題同為「成品出倉」，一般以 Workbench 為準。

### 4.2 頁頂打印機

- 「A4 打印機」「標籤打印機」「列印全部草稿 (N)」  
- 未選機：「請先選擇打印機」／「請先選擇標籤打印機」

### 4.3 分頁一覽

| tab | 標籤 |
|-----|------|
| 0 | 「撳單/提料單詳情」 |
| 1 | 「加單」（徽章：當日未完成加單票數） |
| 2 | 「成品提貨記錄」 |
| 3 | 「成品提貨記錄（全部）」 |
| 4 | 「查看提貨情況」 |
| 5 | 「成品出倉出箱數量」 |
| 6 | 「送貨路線摘要」 |

---

## 五、撳單（領票）

### 5.1 條件列

- 「請選擇日期」：「是日」「翌日」「後日」  
- 「放單類型」：「批量」「單量」  
- 「票別（樓層）」：「2/F 票」「4/F 票」  

### 5.2 車線面板

1. 車線按鈕顯示「(未撳數/總單數)」、裝載序／出發時間等。  
2. 點車線 →「確認分配」（含「位置」「車線號碼」「裝載順序」「出發時間」「所需日期」「可用訂單」）→「確認」。  
3. 成功後進入提料明細掃碼。  
4. 無單時：「該樓層未有需處理訂單」／「此樓層沒有可用的提料單」。  
5. 「未完成提料單」可搜商店／車線／送貨單編號再「選擇」。  
6. **限制：**「請先完成目前的提料單，再提取下一張」。

### 5.3 「車線-X」

- DO 與出倉皆有獨立「車線-X」區塊；無匹配車線時顯示「車線-X」。  
- 「以前」：今日前未完成的車線-X。  
- 出箱儀表會統計「車線-X 出箱數」。

---

## 六、掃碼出倉（提料執行）

1. 在已撳單的明細中看「所有提料單批號」「進度」。  
2. 「開始QR掃描」／「停止QR掃描」；「掃描結果」正確時「二維碼驗證成功。」  
3. 可「改數」「提交數量」；問題回報含不良／遺失等。  
4. 「提交所有已掃描項目」；可選「列印空白頁數標籤」。  
5. 無掃碼可直接完成的列可用「已完成」(Just Completed)。  
6. 全部完成後通常導向「成品提貨記錄」（帶提票號）。

### 掃碼常見錯誤

| 提示 | 處理 |
|------|------|
| 「二維碼不符合當前訂單中的任何貨品。」 | 確認掃的是本票貨品 |
| 「此批號不可用…」「此批次尚未上架」 | 換批或先完成上架 |
| 「此批號單位不符…」「此批號已提貨…」 | 換批 |
| 「掃描批號已過期…」 | 換未過期批 |
| 「此批次貨品已被其他送貨單留起…」 | 換批或協調留貨 |
| 換批雙掃說明 | 依畫面再掃一次確認 |

---

## 七、加單專章

### 7.1 在「送貨訂單」

- 開「加單」分頁搜索與「批量放單」。  
- 合併選項見 §3.1（TI-M- 合併票）。

### 7.2 在「成品出倉」

1. Tab「加單」；進入前確認：「進入加單檢視？」  
2. 說明：「加單檢視會依選定日期，將 isExtra 票依店鋪與車線顯示。」  
3. 「目前是加單票，顯示與操作已切換為加單模式。」／「離開加單檢視」「返回一般指派分頁」。  
4. 「合併加單提料單」：僅「未分配」且同店鋪、樓層（2/F、4/F 或車線-X）、車線、出發時間可合併。  
5. 類型顯示可能為「合拼單」「加單」「批量」「單量」。

---

## 八、補貨（「送貨訂單」→「補貨」）

1. 「補貨填表」「對單」→「待提交列表」→「提交」／「清空」。  
2. 「送貨單號末四位」「原送貨單」「目標送貨單」「補貨數量」「原出貨數」「車線」。  
3. 無車線時畫面可能顯示「車線-X」。  
4. 「補貨進度追蹤」：待處理／處理中／已完成。  
5. 限制例：「只有已送貨（completed）的送貨單可作為原送貨單。」「補貨數量必須大於零」。

---

## 九、箱數與列印

### 9.1 草稿／空白

- 「列印全部草稿 (N)」→ 確認「確認列印全部草稿？（總數量：N份）」→「成功列印」。  
- 提料中：「列印空白頁數標籤」→「請輸入要列印的標籤數量：」。

### 9.2 完成後正式列印（「成品提貨記錄」）

1. 「查看詳情」或列表動作。  
2. 「列印提料單」「列印送貨單標籤」「列印提料單和送貨單標籤」「補印標籤」。  
3. 彈窗「請輸入總箱數」，欄位「箱數」（≥1）。  
4. 成功：「成功列印」。

### 9.3 補印

- 「補印送貨單標籤」：「起始箱號」「結束箱號」「總箱數」  
- 校驗：起始≥1、結束≥起始、結束≤總箱數等。

### 9.4 送貨路線摘要

- Tab「送貨路線摘要」→ 選「車線」→「下載報告 (PDF)」。  
- 若未執完：「此車線仍有 N 張訂單未執拾。是否仍要列印 / 下載送貨路線摘要？」

### 9.5 出箱數量

- Tab「成品出倉出箱數量」：按日「2/F 出箱數」「4/F 出箱數」「車線-X 出箱數」「總出箱數」（來自完成時填的箱數）。

---

## 十、查看提貨情況與管理動作

### 10.1 查詢

- 「目標日期」「重新載入」「樓層」「狀態」（「待撳單」「提貨中」「已完成」）。  
- 欄含貨車／車線／裝載順序／提票號碼／負責員工／訂單項目數量等。

### 10.2 管理（常需 ADMIN）

| 動作 | 意義（畫面說明意涵） |
|------|----------------------|
| 「撤銷領取」 | 清空負責人，單據回待分配，他人可再領 |
| 「強制完成提貨單」 | 標完成並歸檔，不改已揀數量；適用已全部提交但系統未結案 |

未授權：「僅管理員（ADMIN 權限）可使用」。

---

## 十一、狀態對照（避免搞混三套名稱）

### 11.1 送貨訂單「來貨狀態」

| 鍵 | 畫面 |
|----|------|
| pending | 「待處理」 |
| receiving | 「接收中」 |
| completed | 「已完成」 |
| （部分流程）released / picking | 「已放單」／「提料中」 |

### 11.2 「查看提貨情況」提票狀態

| 鍵 | 畫面 | 白話 |
|----|------|------|
| pending | 「待撳單」 | 已放單、尚未領取 |
| released | 「提貨中」 | 已撳單／出倉中 |
| completed | 「已完成」 | 提貨完成 |

### 11.3 提料單通用（pickOrder）

「待處理」「已放單」「提料中」「已完成」——與上表用詞接近但場景不同；操作時以**目前所在分頁**的 Chip 文案為準。

---

## 十二、成品出倉管理（ADMIN）

- 「倉庫管理」→「成品出倉管理」（`/finishedGood/management`）。  
- 「提料順序」：上移／下移／置頂／置底、「新增物品」「儲存」「重新載入」。  
- 「出貨倉位」「入貨倉位」等主檔維護。

---

## 十三、路徑速查

| 畫面 | 路徑 |
|------|------|
| 送貨訂單 | `/do` |
| DO 詳情／放單 | `/do/edit?id=` |
| 成品出倉（主） | `/doworkbench` |
| 成品出倉管理 | `/finishedGood/management` |
| 舊成品出倉 | `/finishedGood`（附錄對照用） |

---

## 十四、常見問題速查

| 情況 | 建議 |
|------|------|
| 批量放單後倉庫看不到票 | 核對日期「是日／翌日」、樓層票別、批量／單量、是否加單檢視 |
| 車線按鈕 0 單 | 換日期／樓層；查「車線-X」「未完成提料單」 |
| 掃碼一直失敗 | 批號是否上架、是否被留貨／過期／單位不符 |
| 印不出標籤 | 先選 A4／標籤打印機；完成後記得填「箱數」 |
| 加單與正單混在一起 | 明確進／出「加單」檢視；合併規則要同店同線同時段 |
| 畫面突然英文 | 少數錯誤字串尚未進 zh，以實機為準並回報補譯 |