企业官网建设流程全解析

一、问题：临期管理为什么总是错过处置窗口

早上 7 点，仓库里有一批原料还剩 9 天到期。库管知道，生产计划不知道；采购以为还能正常消耗，
销售没有提前准备渠道。等信息走到负责人面前，选择只剩下低价处理或报损。

把它当成技术问题拆开，是四件事：

1. 数据：批次、效期、库存状态散落在 ERP、WMS、Excel、人工台账，口径不一致；
2. 规则：不同品类/仓库/客户的预警阈值与允许动作不同；
3. 协同：发现风险之后谁决策、谁执行、谁回填结果，没有闭环；
4. 评估：AI 说"省 20 万"很容易，核实实际处置效果很难。

二、方案：一条完整的业务闭环

ERP / WMS / JSON 批次数据 ↓ 临期扫描与红 / 橙 / 黄分级 ↓ AI 处置建议 + 允许动作校验 + 节省估算 ↓ 企业微信推送 → 人工批准 / 稍后 / 改方案 ↓ 处置工单 → 完成回执 → 已核实节省 → 月度报告

系统不绕过人自动处置库存：AI 辅助判断，授权人员保留决定权；建议超出允许动作空间时，
标记为"需人工复核"。

三、技术实现要点

几个容易被低估的点：

• 幂等与防重放：企业微信回调会重试，工单不能重复创建；
• 允许动作校验：模型可能建议"折价清仓"，但该批货合同规定只能退货 —— 建议必须被规则拦下并给出理由；
• 估算偏差回流：用"实际处置量 × 实际单价"反向校正模型估算，才谈得上可信度。

四、5 分钟本地跑通（不需要任何账号）

gitclone https://github.com/apaqyang/Shelf-Life-Copilot.gitcdShelf-Life-Copilotdockercompose up

另开终端执行离线临期扫描：

dockercomposeexecapp uv run python-msrc.cli\--customercustomerA--today2026-05-26\--provideroffline --render-cards

生成企微卡片样本与月度 PDF 报告：

dockercomposeexecappmakedemodockercomposeexecappmakereport

建议先读：docs/QUICKSTART.md（食品厂 IT 视角）、docs/ARCHITECTURE.md（分层与设计决策）、
docs/demo_samples/（离线样本）。

五、食品企业怎么验证它（建议路径）

1. 从 ERP/WMS 导出30~100 行脱敏批次数据（批次号、物料、生产日期、到期日、库存量、单位、仓库）；
2. 转成data/batches/customerA.json结构，先跑 Offline 模式；
3. 让仓库、生产/销售、品控一起检查：有没有漏报？哪些建议不允许？库存口径对不对？
4. 规则确认后，再验证云端模型或本地 OpenAI-compatible 模型的建议质量；
5. 最后接企业微信测试群与 ERP/WMS只读接口，首期不要开放库存写权限。

六、边界说明（重要）

仓库中的截图、客户 A/B 数据与 ROI 报告均为离线演示样本，用于展示流程，
不代表已完成真实客户生产验收；真实价值需在共建 PoC 中通过客户数据核实。
SAP Business One 适配器需真实厂商沙箱在线验收；用友、金蝶、自研 WMS 需要按客户接口实现适配器。

七、项目信息

• GitHub：https://github.com/apaqyang/Shelf-Life-Copilot
• 协议：AGPL-3.0-or-later
• 关键词：食品行业数字化、临期管理、保质期预警、ERP 集成、WMS、企业 AI 应用、大模型应用、私有化部署、FastAPI