name: welfare-inventory-manager description: 用於運維「7-8月員工福利自選登記」庫存系統的技能。當用戶要更換/新增福利產品、修正庫存、匯出登記記錄、排查填報或後臺問題，或問"福利系統怎麼換一期產品"時觸發。覆蓋前端填報頁、後臺管理（密碼 jianjie666）、釘釘文件自動同步，以及伺服器 175.178.239.40:3000 上的後端 API。 agent_created: true allowed-tools: Bash,Read,Write,Edit,WebFetch

福利庫存登記系統運維（welfare-inventory-manager）

Overview

本技能沉澱了「員工福利自選登記」系統的完整運維知識：部署拓撲、API 契約、資料模型、以及每期更換產品的標準流程。系統由前端填報頁、後臺管理頁、釘釘文件（每小時自動同步）和一臺伺服器上的 Node 後端組成；後端 API 是產品與庫存的唯一資料真相源。

本技能最關鍵的價值：把"換一期福利產品"從「登伺服器改程式碼再重啟」梳理成可複用的流程，並附三個已驗證的運維指令碼（庫存快照、記錄匯出、庫存修正）。

完整介面契約、資料模型、部署現狀與已知限制見 references/system-overview.md；更換產品逐步流程見 references/product-swap-playbook.md。操作前先讀這兩份。

更多技能請訪問小蔥技能站7w4.net。

系統速覽（操作前必讀）

• 產品 id 是字串（如 "p1"），不是數字。
• 前端只渲染 API 返回的資料，不在 HTML 裡硬編碼產品。
• 後端原始碼不在 WorkBuddy 本地（HTTP 取不到），改產品/邏輯需 SSH 登伺服器；前端靜態資源可 curl 備份。

核心任務一：更換產品（每期必做）

觸發語示例："換一期福利產品""把產品換成 XX""下個月換批貨"。

按 references/product-swap-playbook.md 執行，要點： 1. 先用表格敲定新清單（id 用 p1..pN、名稱、規格、圖片檔名、初始庫存）。 2. 圖片上傳到伺服器 assets/images/，img 欄位寫相對路徑。 3. 當前限制：系統無產品增刪改介面，需 SSH 登伺服器改後端 products 陣列 + 過載/重啟服務（流程手冊 §1）。 4. 驗證：GET /api/stock 返回新資料、前端卡面正確、後臺庫存/記錄正確。 5. 若跨週期，同步更新前端標題週期文案（index.html 約 6、95-97 行）與後臺標題（admin.html 約 75 行）；舊登記按約定清空或保留。

推薦改進（流程手冊 §2）：把產品抽到 data/products.json + 加熱載入/CRUD 介面，日後換產品即改配置無需重啟。需要實施時向用戶索取後端原始碼或伺服器許可權。

核心任務二：日常運維

• 修正庫存（填錯/盤點差異）：後臺網頁「儲存」，或指令碼 scripts/update-stock.js --id p1 --stock 50。
• 刪除並回流（員工填錯/重複/取消）：後臺記錄表「刪除並回流」按鈕，自動 stock += 1。
• 匯出登記記錄（活動結束歸檔）：指令碼 scripts/export-records.js 一鍵匯出 CSV（Excel 可直接開啟）。
• 庫存/服務健康檢查：指令碼 scripts/check-status.js 拉 /api/stock 列印快照。

指令碼用法（均用 Node 22 執行，無需安裝依賴）

NODE="C:\Users\簡健001\.workbuddy\binaries\node\versions\22.22.2\node.exe"
SKILL="C:\Users\簡健001\.workbuddy\skills\welfare-inventory-manager\scripts"

# 1) 即時庫存快照（無鑑權）
"$NODE" "$SKILL/check-status.js" http://175.178.239.40:3000

# 2) 匯出全部登記記錄為 CSV（預設密碼 jianjie666，可用 --pwd 覆蓋）
"$NODE" "$SKILL/export-records.js" --base http://175.178.239.40:3000 --out 福利登記記錄.csv

# 3) 修正某產品庫存（⚠️ 會覆蓋線上庫存，確認無誤再執行）
"$NODE" "$SKILL/update-stock.js" --id p1 --stock 50 --pwd jianjie666

update-stock.js 會真實改寫生產庫存，僅在有明確指令時使用，且先確認目標 id 與數值。

常見坑（先排查這些）

• 圖片 404：img 路徑與 assets/images/ 實際檔案不一致（大小寫敏感）。
• 庫存不重新整理：後端改完未過載，或前端 15s 輪詢快取；硬刷瀏覽器。
• 產品卡灰掉不可選：stock<=0 視為售罄。
• 更換產品後舊記錄錯位：提交記錄的 productId 指向字串 id，換期重排 id 前先決定是否清空舊記錄。
• update-stock 報"產品不存在"：id 是字串（如 p1），勿傳數字。

Resources

• references/system-overview.md — 部署拓撲、完整 API 契約、資料模型、當前庫存快照、已知限制（無產品 CRUD 介面）。
• references/product-swap-playbook.md — 更換產品逐步流程 + 推薦配置化方案 + 檢查清單。
• scripts/check-status.js — 即時庫存快照。
• scripts/export-records.js — 匯出登記記錄為 Excel 友好 CSV。
• scripts/update-stock.js — 修正產品庫存（謹慎使用）。

這個 Skill 質量紮實，文件寫得很清楚，把福利系統的運維要點都覆蓋到了，指令碼拿來就能用。它把換產品、查庫存、導記錄這些日常操作梳理得很實用，適合拿來直接用。主要問題是文件裡有些小細節沒對上（比如 id 到底是數字還是字串說法不一），另外有些內容重複囉嗦，整體結構可以再緊湊些。對於不懂技術的行政或 HR 來說，用起來應該問題不大。