jason
/
FPSMS-backend
2
0
Atdalīts 0
Kods Problēmas 0 Izmaiņu pieprasījumi 0 Laidieni 0 Vikivietne Aktivitāte
Nevar pievienot vairāk kā 25 tēmas Tēmai ir jāsākas ar burtu vai ciparu, tā var saturēt domu zīmes ('-') un var būt līdz 35 simboliem gara.
1155 Revīzijas
7 Atzari
913 MiB
 
 
 
 
 
Koks: 6e2722f1e8
Atzari Tagi
${ item.name }
Izveidot atzaru ${ searchTerm }
no '6e2722f1e8'
${ noResults }
FPSMS-backend/docs/user-guides/MTMS_BOM_使用說明.md

9.7 KiB
Neapstrādāts Vainot Vēsture

MTMS 使用說明：BOM（匯入／啟停／應用）

本手冊依目前前端畫面與繁中文案整理，按鈕／選單名稱以畫面上「」內文字為準。
適用範圍：側欄「設定」下的 BOM 相關頁、建立工單時選 BOM、排程「自動生成工單」。
「一附」章節使用本機資料庫 fpsmsdb 的真實例子（查詢當下快照）；其他環境請改條件再對。
產生日期：依原始碼現況（若畫面改版，請以實際 UI 為準）。

這份手冊怎麼用

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

建議閱讀順序：

  1. 先匯入／啟用 BOM（「設定」→「匯入 BOM」）
  2. 再檢查單位問題（ADMIN：「BOM / 物料單位問題」）
  3. 再建工單／排程產單（選 active BOM）

一、整體流程（BOM 從主檔到工單）

【匯入 BOM】Excel 上傳並檢查 →「確認匯入」
    ↓
【BOM 明細】確認「啟用」／必要時「停用」
    ↓（選做）「BOM 權重得分」調整加權
    ↓（ADMIN）「BOM / 物料單位問題」巡檢
    ↓
【建工單】「建立工單」選「BOM」
  或【排程】「自動生成工單」（僅含具 BOM 的物料）

一附、本地資料庫實例（方便對照畫面）

以下數字來自本機 fpsmsdb 查詢結果。不同環境／日期資料會不同。
BOM 狀態：active→「啟用」、inactive→「停用」。本機約有 214 筆啟用、3 筆停用。

例 A：啟用中的成品 BOM（適合在「BOM 明細」搜索）

「物品編號」 「物品名稱」 「BOM 狀態」 約材料筆數
PP2167 牛丼 啟用 10
PP2277 烚意粉 啟用 3
PP2390 熱情香果醬 啟用 4
PP1224 柚子蒜蓉汁 啟用 5
PP1136 白粥 啟用 9
PP0259 牛肉水(2KG/包) 啟用 0（無材料列，排程／提料前宜先確認）

怎麼練：

  1. 「設定」→「匯入 BOM」→ Tab「BOM 明細」。
  2. 「物品編號」填 PP2167 →「搜索」。
  3. 載入後看「基本資訊」「材料清單」「製程與設備」；「BOM 狀態」應為「啟用」。

例 B：材料清單長什麼樣（PP2167 牛丼）

「物品編號」 「物品名稱」 約「基本數量」
MA0471 日式超薄肥牛 272.16
FA0164 洋蔥絲 145.15
GI3236 清水 60.00
PP2214 丼飯汁(2磅/包) 41.73
MG1507 江泉牌燒肉汁(1.8L/支) 9.00
MG1299 李錦記特選老抽(8L/桶) 8.00
MG0302 佛手牌味粉(10lb/罐) 4.54
MG0239 韓國雪白幼砂糖(30kg/包) 4.54

例 C：用 BOM 建工單（接《排程與工單》手冊）

本機 2026-07-29 手動工單多掛在 active BOM 上，例如：

「工單編號」 「狀態」 成品 BOM 「需求數量」
JO-260729-038 待處理 PP2277 烚意粉 51
JO-260729-044 提料中 PP2383 辣椒菜脯 265

怎麼練：「搜索工單/ 建立工單」→「建立工單」→「BOM」下拉選 PP2277（僅顯示啟用中的 BOM）。

自行查核用 SQL（選用）

SELECT b.code, i.name, b.status,
       (SELECT COUNT(*) FROM bom_material bm
        WHERE bm.bomId = b.id AND IFNULL(bm.deleted,0)=0) AS mats
FROM bom b
JOIN items i ON i.id = b.itemId
WHERE b.deleted = 0 AND b.code = 'PP2167';

SELECT i.code, i.name, bm.qty
FROM bom_material bm
JOIN items i ON i.id = bm.itemId
JOIN bom b ON b.id = bm.bomId
WHERE b.code = 'PP2167' AND IFNULL(bm.deleted,0)=0;

二、匯入 BOM（「設定」→「匯入 BOM」）

2.1 入口

  • 側欄 「設定」 → 「匯入 BOM」（路徑通常為 /settings/importBom）
  • 頁內標題可能顯示英文 Import BOM；側欄與 Tab 以繁中「匯入 BOM」為準。

2.2 兩個分頁

Tab 用途
「匯入 BOM」 上傳 Excel、檢查、確認寫入
「BOM 明細」 查已有 BOM、啟用／停用

2.3 操作步驟：上傳並匯入

  1. 開 Tab 「匯入 BOM」。
  2. 「選擇 BOM Excel 檔案」 →「選擇檔案」或「選擇資料夾」（可多選 .xlsx）。
  3. 確認「已選 N 個檔案」後，點 「上傳並檢查」。
    • 進行中：「上傳與檢查中…」、進度「已檢查 x / y 個檔案…」。
  4. 檢視結果：
    • 「正確 BOM 列表（可匯入）」
    • 「問題 BOM 列表」
  5. 必要時勾選類型相關選項（如「飲料」「箱料粉」等）或用「搜索檔名」篩選。
  6. 確認無誤後點 「確認匯入」。
  7. 成功提示類似 「匯入完成」；亦可先「下載檢查結果 Excel」留底。
  8. 若要重來：點「返回重選檔案」。

2.4 常見錯誤（匯入）

畫面提示 建議處理
「請至少選擇一個 .xlsx 檔案」 先選檔再上傳
「上傳或檢查失敗，請稍後再試。」／伺服器 500 檢查網路／檔案格式後重試
檔名重複相關提示（_2、_3…） 依提示整理檔名後重傳
「匯入失敗，請查看主控台。」 記下失敗檔，修正 Excel 後只重傳問題檔

三、BOM 明細：查詢與啟停

3.1 搜索

  1. Tab 「BOM 明細」。
  2. 「物品編號」／「物品名稱」→「搜索」／「重置」。
  3. 多筆時：「找到多筆 BOM，請選擇一筆載入明細」（按鈕上會標「成品｜半成品」「啟用｜停用」）。

3.2 可改什麼

區塊 說明
「BOM 狀態」 「啟用」／「停用」→「儲存狀態」
「基本資訊」 產出數量、類型、過敏原、色深／浮沉／濃淡、時段、複雜度、基礎得分等（多為檢視）
「材料清單」 物品編號／名稱、基本／庫存／銷售數量與單位
「製程與設備」 製程檢視

注意： 完整欄位線上「編輯／儲存」目前前端關閉（SHOW_BOM_FULL_EDIT = false）。日常維護以 Excel 匯入 與 啟用／停用 為主。

3.3 何時「停用」

  • 配方作廢、暫不允許再建工單時，將「BOM 狀態」改「停用」並「儲存狀態」。
  • 「建立工單」的 BOM 下拉只列出啟用項目；停用後新單選不到該 BOM。

四、BOM 權重得分

4.1 入口

  • 「設定」→ 「BOM 權重得分」（/settings/bomWeighting）

4.2 分頁

Tab 用途
「BOM 加權」 調整各評分項目的「權重」（總和須＝1）
「BOM得分」 查看各貨品「基礎得分」

4.3 操作

  1. 「BOM 加權」→「編輯」→改「權重」→「儲存」。
  2. 校驗失敗時：「權重必須為數字」或「權重總和必須等於 1（目前總和: x）」。
  3. 成功：「更新成功（已重新計算 N 筆 BOM 基礎分）」。
  4. 到「BOM得分」核對「貨品編號」「物品名稱」「基礎得分」。

五、BOM／物料單位問題（ADMIN）

5.1 入口

  • 「設定」→ 「BOM / 物料單位問題」（僅 ADMIN；/settings/masterDataIssues）
  • 頁標題常顯示：「BOM/貨品單位問題」

5.2 操作

  1. Tab「BOM」或「貨品」。
  2. 「搜索」「類型」（「全部」「BOM 總表」「BOM 原材料」）。
  3. 「重新檢查」更新清單；「複製清單」方便貼到表單／郵件。
  4. 點列開詳情：「問題」「應為」「實際」→「關閉」。

5.3 常見問題文案（節錄）

  • 「BOM 編號為空」「BOM 名稱為空」
  • 「BOM 產出單位與成品銷售單位不一致」
  • 「BOM 原料銷售／基本／庫存單位與貨品主檔不一致」
  • 「BOM 編號與關聯貨品不一致」

側欄紅點例：BOM N 筆 · 貨品 M 筆。空狀態：「目前沒有問題。」

六、應用：建立工單時選 BOM

6.1 手動建立

  1. 「管理工單」→「搜索工單/ 建立工單」→「建立工單」。
  2. 「BOM」（必填）選成品／半成品；同名時可能標「（成品）」「（半成品）」。
  3. 「標準生產數」×「批數」＝「需求數量」（單位來自 BOM 產出 UOM）。
  4. 「預計生產日期」等填妥 →「建立」。
  5. 成功常提示「成功更新資料」。未選 BOM 時可能出現「請選擇 BOM」／Bom required!。

6.2 排程自動生成

  1. 「排程」→「生產排程」→「詳細」。
  2. 「自動生成工單」（僅處理具 BOM 的物料；說明文案類似「選擇日期範圍（僅含具 BOM 的物料…）」）。
  3. 舊細排頁另有「生成工單」「查看 BOM」（材料表含「編號」「名稱」「可用數量」「需求數量」）。

詳見《MTMS 排程與工單 使用說明》。

七、權限與路徑速查

畫面 路徑 備註
匯入 BOM /settings/importBom 「設定」下
BOM 權重得分 /settings/bomWeighting
BOM／物料單位問題 /settings/masterDataIssues ADMIN
建立工單 /jo 選 active BOM
排程產單 /ps 需 BOM

八、常見問題速查

情況 建議
建工單下拉找不到某成品 到「BOM 明細」確認是否「啟用」；或尚未匯入
排程產單跳過某物料 該物料可能無 BOM／不在排期 BOM 範圍
單位對不上、品檢／提料異常 ADMIN 開「BOM / 物料單位問題」對照主檔後修正 Excel 再匯入
權重儲存失敗 確認各權重為數字且總和＝1