福利库存管理系统

要解决的具体问题

在员工福利自选登记系统中，后端 API 是产品与库存的唯一数据真相源。前端只负责渲染返回的数据，不会在 HTML 里硬编码产品。然而系统目前缺少产品增删改接口，导致每次“换一期福利产品”时，运维人员必须 SSH 登录服务器，手动修改后端代码中的 products 数组并重载服务。这种“改代码再重启”的模式不仅操作繁琐，还容易因路径大小写、ID 类型或重载遗漏引发线上故障。

核心能力与关键步骤

本技能将这套高风险的运维逻辑沉淀为可复用的标准流程，配合部署拓扑与 API 契约，指导你安全地完成每期产品更换与日常维护。

• 更换产品流程：按 references/product-swap-playbook.md 执行。先确定新清单（id 用 p1..pN、名称、规格、图片文件名、初始库存）；将图片上传到 assets/images/，img 字段写相对路径；SSH 登服务器修改 products 数组并重启。验证时检查 GET /api/stock、前端卡面与后台数据。跨周期时需同步更新 index.html 与 admin.html 的标题文案。
• 日常运维脚本：

修正库存：运行 scripts/update-stock.js --id p1 --stock 50。
导出记录：使用 scripts/export-records.js 一键导出 Excel 友好的 CSV 归档。
* 健康检查：执行 scripts/check-status.js 拉取实时库存快照。

适用边界与注意点

• 数据真相源：后端 API 是唯一真相源，前端静态资源仅用于展示。
• ID 类型限制：产品 ID 是字符串（如 "p1"），不是数字。传数字会导致库存修正失败。
• 缓存与状态：前端存在 15 秒轮询缓存；若 stock 小于等于 0，产品卡会变灰不可选。
• 生产安全：update-stock.js 会真实改写生产库存，务必确认目标 id 与数值后再执行。