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

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

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

---

這份手冊怎麼用

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

建議閱讀順序：

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

---

一、整體流程

【/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（選用）

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