一、问题临期管理为什么总是错过处置窗口早上 7 点仓库里有一批原料还剩 9 天到期。库管知道生产计划不知道采购以为还能正常消耗销售没有提前准备渠道。等信息走到负责人面前选择只剩下低价处理或报损。把它当成技术问题拆开是四件事数据批次、效期、库存状态散落在 ERP、WMS、Excel、人工台账口径不一致规则不同品类/仓库/客户的预警阈值与允许动作不同协同发现风险之后谁决策、谁执行、谁回填结果没有闭环评估AI 说省 20 万很容易核实实际处置效果很难。二、方案一条完整的业务闭环ERP / WMS / JSON 批次数据 ↓ 临期扫描与红 / 橙 / 黄分级 ↓ AI 处置建议 允许动作校验 节省估算 ↓ 企业微信推送 → 人工批准 / 稍后 / 改方案 ↓ 处置工单 → 完成回执 → 已核实节省 → 月度报告系统不绕过人自动处置库存AI 辅助判断授权人员保留决定权建议超出允许动作空间时标记为需人工复核。三、技术实现要点工程边界实现领域逻辑客户可配置的临期阈值分级允许/禁用动作约束异常建议人工复核模型接入Offline / Claude / KIMI / OpenAI-compatible 本地模型统一边界决策闭环建议、批准、改方案、工单、完成回执、实际节省分别留痕可靠性幂等、防重放、持久任务队列、有界并发、超时、重试、部分失败隔离数据层SQLite单节点试用/ PostgreSQL共享持久化、多实例安全Bearer/OIDC、RBAC、租户隔离、只追加安全审计、请求限流可观测性结构化日志、Prometheus 指标、correlation ID、OpenTelemetryERP 边界统一BatchRepositorySAP Business One Service Layer 适配器 离线契约测试质量反馈用已完成工单的核实结果评估估算偏差而不是用模型自信度当效果几个容易被低估的点幂等与防重放企业微信回调会重试工单不能重复创建允许动作校验模型可能建议折价清仓但该批货合同规定只能退货 —— 建议必须被规则拦下并给出理由估算偏差回流用实际处置量 × 实际单价反向校正模型估算才谈得上可信度。四、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/离线样本。五、食品企业怎么验证它建议路径从 ERP/WMS 导出30~100 行脱敏批次数据批次号、物料、生产日期、到期日、库存量、单位、仓库转成data/batches/customerA.json结构先跑 Offline 模式让仓库、生产/销售、品控一起检查有没有漏报哪些建议不允许库存口径对不对规则确认后再验证云端模型或本地 OpenAI-compatible 模型的建议质量最后接企业微信测试群与 ERP/WMS只读接口首期不要开放库存写权限。六、边界说明重要仓库中的截图、客户 A/B 数据与 ROI 报告均为离线演示样本用于展示流程不代表已完成真实客户生产验收真实价值需在共建 PoC 中通过客户数据核实。SAP Business One 适配器需真实厂商沙箱在线验收用友、金蝶、自研 WMS 需要按客户接口实现适配器。七、项目信息GitHubhttps://github.com/apaqyang/Shelf-Life-Copilot协议AGPL-3.0-or-later关键词食品行业数字化、临期管理、保质期预警、ERP 集成、WMS、企业 AI 应用、大模型应用、私有化部署、FastAPI