FPSMS-backend/docs/user-guides/MTMS_工單提料報工上架_使用說明.md

# MTMS 使用說明：工單提料／報工／上架

> 本手冊依目前前端畫面與繁中文案整理，**按鈕／選單名稱以畫面上「」內文字為準**。  
> 適用範圍：放單之後的「工單提料」「工單生產流程」「上架掃碼」（品檢／上架）。  
> 建單與排程請先看《MTMS 排程與工單 使用說明》；BOM 請看《MTMS BOM 使用說明》。  
> **「一附」章節**使用本機資料庫 `fpsmsdb` 的真實例子（查詢當下快照）。  
> 產生日期：依原始碼現況（若畫面改版，請以實際 UI 為準）。

---

## 這份手冊怎麼用

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

建議閱讀順序：

1. **放單**（「搜索工單/ 建立工單」）  
2. **提料**（「工單提料」）  
3. **對料 → 工序 → 完成工單**（「工單生產流程」）  
4. **品檢 → 上架**（「品檢」＋「上架掃碼」）  

---

## 一、整體流程

```text
【/jo】「規劃中」──「放單」──►「待處理」／「提料中」
        ↓
【/jodetail】「工單提料」──「查看詳情」──► 掃碼提料 ──「提交」／「提交所有已掃描項目」
        ↓
【/productionProcess】「工單生產流程」
        ├─（可選）「工單對料」→ 二次掃碼 →「確認所有提料」
        ├─「查看詳情」→ 各工序「開始」／「訂單完成」或「已完成」(Just Pass)
        ↓
        「完成工單」（確認：「確認要完成此工單嗎？」）
        ↓
        「品檢」→「確定品檢結果」（可列印／下載 QR）
        ↓
【/putAway】「上架掃碼」：掃貨品 QR → 掃倉庫 QR →「確定及上架貨物」
        ↓
「已上架工單」；工單「已完成」
```

---

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

> 狀態中文：`pending`→「待處理」、`packaging`/`picking`→「提料中」、`processing`→「生產中」、`storing`→「待品檢入倉」、`completed`→「已完成」。

### 例 A：適合練提料（2026-07-29）

| 「工單編號」 | 「狀態」 | 成品 | 「需求數量」 | 建議下一步 |
|--------------|----------|------|--------------|------------|
| JO-260729-038 | 待處理 | PP2277 烚意粉 | 51 | 「工單提料」開單掃碼 |
| JO-260729-008 | 提料中 | PP2257 咖哩汁箱料粉 | 1 | 繼續提交提料 |
| JO-260729-013 | 提料中 | PP1043 豆豉汁(2磅/包) | 309 | 繼續提交提料 |
| JO-260729-044 | 提料中 | PP2383 辣椒菜脯 | 265 | 繼續提交提料 |
| JO-260729-034 | 生產中 | PP2302 酸甜蘿蔔粒箱料粉 | 1 | 「工單生產流程」做工序／完成工單 |

**怎麼練：**

1. 「搜索工單/ 建立工單」→「預計生產日期」**2026-07-29** →「搜索」。  
2. 「狀態」篩「待處理」找 JO-260729-038，或直接到「工單提料」找同日卡片。  
3. 「生產中」單到「工單生產流程」練「查看詳情」／「完成工單」（完成會改資料，請用測試庫）。

### 例 B：狀態與畫面入口對照

| 「狀態」 | 常用入口 |
|----------|----------|
| 待處理／提料中 | 「工單提料」 |
| 生產中 | 「工單生產流程」→「工藝流程」 |
| 待品檢／待品檢入倉 | 「工單生產流程」→「品檢」或「待QC上架工單」 |
| 已完成 | 「已上架工單」／工單搜索「已完成」 |

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

```sql
SELECT jo.code, jo.status, i.code, i.name, jo.reqQty
FROM job_order jo
LEFT JOIN bom b ON b.id = jo.bomId
LEFT JOIN items i ON i.id = b.itemId
WHERE jo.deleted = 0 AND DATE(jo.planStart) = '2026-07-29'
  AND jo.status IN ('pending','packaging','processing','storing')
ORDER BY jo.status, jo.code
LIMIT 20;
```

---

## 二、放單（前置，在「搜索工單/ 建立工單」）

1. 側欄「管理工單」→「搜索工單/ 建立工單」（`/jo`）。  
2. 找到「規劃中」工單 →「放單」或「放單 (N)」。  
3. 放單後狀態變「待處理」／「提料中」，即可去「工單提料」。  
4. 詳情內可見庫存摘要字樣如「可提料項目數量：」「未能提料項目數量：」。

> 亦可在生產流程詳情內對仍屬規劃中的單按「放單」。

---

## 三、工單提料（`/jodetail`）

### 3.1 入口與分頁

- 側欄「管理工單」→ **「工單提料」**；頁標題「工單提料」。

| Tab | 文案 |
|-----|------|
| 0 | 「工單提料詳情」 |
| 1 | 「已完成工單記錄」 |
| 2 | 「物料提料狀態」 |
| 3 | 「膠茜數目使用數量」 |

### 3.2 「工單提料詳情」列表

- 品類：「全部」「飲料」「箱料粉」「其他」  
- 樓層：「2F」「3F」「4F」「沒有批號」等  
- 卡片常見：「工單」「批號」「提料單」「物品名稱」「需求數量」、狀態 Chip  
- 點 **「查看詳情」** 進入掃碼提料

### 3.3 掃碼提料步驟

1. 點「開始掃碼」（可「停止掃碼」）。  
2. 掃描物料／批號 QR；必要時開「批號QR碼掃描」或「手動輸入」→「提交」。  
3. 畫面上應出現「QR碼驗證成功。」／「驗證成功！」；進度見「掃碼結果」「提交數量」。  
4. 單行「提交」或一次「提交所有已掃描項目」（進行中「提交中...」）。  
5. 完成後「返回列表」。

### 3.4 「已完成工單記錄」

- 「查看詳情」「打印版頭紙」（2F／3F／4F）、「打印數量」「打印機」  
- 「對料狀態」：「對料待處理」／「對料已完成」  
- 提示語例：「工單已完成提料和對料」

### 3.5 提料常見錯誤

| 提示 | 處理 |
|------|------|
| 「此批次已拒收，請掃描另一個批次。」 | 換批 |
| 「掃描的批次已被其他用戶完全提料。請掃描其他批次。」 | 換可用批 |
| 「物品數量不足」／數量大於需求／可用量 | 改「提交數量」 |
| 「請先選擇打印機」 | 列印版頭紙前先選機 |

---

## 四、工單生產流程（`/productionProcess`）

### 4.1 入口與頂層分頁

- 側欄「管理工單」→ **「工單生產流程」**。

| Tab | 文案 |
|-----|------|
| 0 | 「工藝流程」 |
| 1 | 「待QC上架工單」 |
| 2 | 「已上架工單」 |
| 3–6 | 各類「儀表板 - …」 |

### 4.2 「工藝流程」卡片動作

| 按鈕 | 用途 |
|------|------|
| 「查看詳情」 | 進工序／BOM／對料等 |
| 「工單對料」 | 提料完成後二次掃批號確認 |
| 「完成工單」 | 整張 JO 完工（確認：「確認要完成此工單嗎？」；權限常限 ADMIN） |
| 「品檢」 | 開品檢 Modal（條件滿足且有入庫行時才出現） |

詳情內 Tabs：「工單信息」「BOM 材料」「工藝流程」「工藝明細」「工單對料」；另有「返回列表」「取消工單」「刪除工單」等。

### 4.3 工單對料（二次掃）

1. 點「工單對料」。  
2. 對已提料批再掃「批號QR碼掃描」（或「手動輸入」）。  
3. 「驗證成功！」後，全部核對完點 **「確認所有提料」**。  
4. 「返回列表」可能解除指派，勿中途亂退。

### 4.4 工序報工（單步）

1. 「查看詳情」→「工藝流程」／「工藝明細」。  
2. 待處理工序點 **「開始」** → Dialog「掃描操作員和設備」。  
3. 「開始掃碼」：先操作員／員工，再設備 →「提交並開始」。  
4. 執行中可「暫停」／「繼續」（「暫停原因」）；結束該步用 **「訂單完成」**（填「工序產出」「不良品」「損耗」）。  
5. 若允許略過執行：按鈕「已完成」(Just Pass)，確認「確認要通過此工序嗎？」。

> **勿混淆：** 工序「訂單完成」＝結束**一步**；卡片「完成工單」＝結束**整張工單**。

### 4.5 品檢

1. 條件滿足後點「品檢」。  
2. Modal 常見 Tab：「處理來貨及品檢」／「來貨及品檢詳情」。  
3. 填結果後 **「確定品檢結果」**。  
4. 可「打印機」「列印數量」「列印」「下載QR碼」（供之後上架掃碼）。  
5. 校驗例：「請決定品檢結果」「有未完成品檢項目」「請輸入不合格數量」「請輸入到期日！」。

亦可從 Tab「待QC上架工單」或提醒鈴深連結進入。

---

## 五、上架掃碼（`/putAway`）

### 5.1 入口

- 側欄「倉庫管理」→ **「上架掃碼」**；頁標題「上架」。

### 5.2 兩段掃碼

1. 待機：「等待掃瞄中，請掃瞄貨品二維碼開始上架程序」。  
2. 掃**貨品／來貨行** QR → 開 Modal。  
3. 填「是次上架數量」；再掃**倉庫** QR（「掃瞄倉庫二維碼」／「請掃瞄倉庫二維碼」）。  
4. 點 **「確定及上架貨物」**。  
5. 可在「是次上架記錄」核對。

失敗：「讀取不成功，請重新掃瞄」；數量：「上架數量不得大於 …」「最小為1」等。

入庫行狀態語意：「待上架」→「已部分上架」→「已上架」。完成後可在「已上架工單」看到。

---

## 六、狀態對照（操作頁為準）

| 代碼 | 畫面 |
|------|------|
| planning | 「規劃中」 |
| pending | 「待處理」 |
| packaging / picking | 「提料中」 |
| processing | 「生產中」 |
| pendingQC | 「待品檢」 |
| storing | 「待品檢入倉」 |
| completed | 「已完成」 |
| cancelled | 「已取消」 |

工序行：「待處理」→「進行中」→（可「已暫停」）→「完成」／「已完成」(Pass)。

---

## 七、常見問題速查

| 情況 | 建議 |
|------|------|
| 提料頁找不到單 | 確認已「放單」；日期／樓層／品類篩選是否過窄 |
| 對料按鈕灰／沒有 | 提料單未完成、已指派他人、或對料已完成 |
| 「完成工單」按不到 | 權限或工序未齊；確認提示「確認要完成此工單嗎？」 |
| 沒有「品檢」按鈕 | 尚未完成工單／無 stock-in 行 |
| 上架掃不到 | 先品檢並列印／下載 QR；或用 `?stockInLineId=` 深連結 |
| 掃碼驗證失敗 | 換批、確認未拒收、確認單位／可用量 |

---

## 八、路徑速查

| 畫面 | 路徑 |
|------|------|
| 搜索／放單 | `/jo` |
| 工單提料 | `/jodetail` |
| 工單生產流程 | `/productionProcess` |
| 上架掃碼 | `/putAway` |