SCM 项目功能说明

用途：给新同事、运营、采购、测试和业务负责人快速了解系统功能。

本文尽量用业务语言说明“这个模块做什么”，不展开代码实现细节。

1. 系统一句话说明

SCM 预警中心是一套围绕库存、销量、采购、调拨和生命周期数据搭建的补货与供应链协同系统。

它主要解决三类问题：

• 哪些 SKU 需要备货、建议生产多少、是否需要立刻发 FBA。
• 当前数据是否可信，销量、库存、采购和同步状态能否核对。
• 采购合同、生产单、报价、图片搜索、智能补货等跟单和运营工作能否在同一套系统里协同。

2. 主要页面入口

3. 核心业务模块

3.1 备货预警

备货预警是系统最核心的页面。

它会把库存、销量、采购未入库、本地可调拨、AWD、库龄、生命周期等数据综合起来，生成 SKU 级备货卡片。

主要功能：

• 查看 SKU 是否需要备货。
• 查看建议生产数量、当前可用供给、30 天销量、覆盖天数。
• 查看本地可调拨、采购未入库、FBA 在途等辅助信息。
• 打开 SKU 备货详情，查看商品图片、仓库、FBA 库存、日均销量、预警原因和生命周期设置。
• 设置产品生命周期，例如新品方案、在售方案、停售方案。
• 批量选择 SKU，导出备货数据。
• 识别需要立刻发 FBA 的短期周转建议。

注意事项：

• 页面展示的是后端预计算后的结果，不是每次打开页面实时重新计算。
• 采购未入库会参与长期建议生产，但不参与短期本地发出建议。
• 90 天以上库龄库存只做提示展示，不再从可用供给中扣减。

3.2 SKU 备货详情

SKU 备货详情用于解释一张备货卡片为什么给出当前建议。

主要功能：

• 展示商品主图、SKU、MSKU、ASIN、品类和站点。
• 展示建议生产、目标库存、当前可用供给、覆盖天数、目标天数和预警等级。
• 展示商品生命周期设置，并区分“当前在售站点”和“生命周期配置记录”。
• 展示仓库、FBA 库存、供给、日均销量、预警理由。
• 展示 EU/UK 合盘结果，帮助理解 EU 和 UK 共用供给时的拆分逻辑。
• 支持鼠标悬停查看商品图片放大效果。

这个页面适合排查“为什么这个 SKU 需要备货”。

3.3 销量核对

销量核对用于排查销量口径是否一致。

主要功能：

• 按 SKU、MSKU、ASIN 或商品信息搜索。
• 对比备货卡片中的销量快照值和本地销量明细重算值。
• 查看销量来源、时间窗口和差异。
• 帮助判断是同步数据问题、销量源口径问题，还是备货批次未刷新。

这个页面适合运营、测试和开发一起确认“销量为什么不对”。

3.4 数据看板

数据看板分为老板总览和运营详细数据。

老板总览主要回答：

• 今天有哪些高风险区域。
• 哪些 SKU 最需要关注。
• 当前同步状态是否正常。
• 需备货 SKU、高库存、停售异常等核心数字是多少。

运营详细数据主要回答：

• 各区域、各维度的风险分布。
• 重点指标的明细和趋势。
• 同步和数据状态是否有异常。

这个模块适合会议、巡检和管理层快速看风险。

3.5 Amazon 独立库存核验

Amazon 模块用于接入 Amazon SP-API，独立拉取库存和 Listing 数据。

主要功能：

• 管理 Amazon 店铺配置和授权信息。
• 拉取 FBA 可售、预留、在途等库存数据。
• 拉取 Listing 数据。
• 生成独立的 Amazon 备货核验结果。
• 和积加数据并行展示，用来核验数据，不影响现有积加备货链路。

当前定位：

• 首期只做库存和 Listing。
• 不做销量、订单、PII 和 RDT。
• Amazon 结果写入独立表，不混入积加备货正式结果。

3.6 智能补货

智能补货是独立于正式备货模块的试验和发布管控模块。

主要功能：

• 查看智能补货运行记录。
• 对比正式备货结果和智能补货预测结果。
• 做离线 Benchmark 和效果评估。
• 管理需求驱动、商品关系、主数据质量。
• 通过发布门禁、审批预检、审批申请、发布审计来控制是否进入正式试点。
• 支持 dry run、apply 和 rollback 的受控发布链路。

当前定位：

• 先作为独立模块验证效果。
• 默认不直接替换正式备货建议。
• 需要经过审批和门禁后，才允许小范围试点发布。

3.7 采购合同与跟单工作台

采购合同模块用于跟单和采购协同。

主要功能：

• 导入生产单 Excel，解析生产单号、商品明细、包装说明等信息。
• 管理生产单列表和详情。
• 管理人工报价，按 SKU 查询或覆盖价格。
• 管理采购合同模板。
• 新建、编辑、复制、作废采购合同。
• 将生产单明细导入合同。
• 上传合同或生产单相关图片。
• 导出合同文件。

这个模块的目标是减少手工复制粘贴，让生产单、报价和采购合同形成可追溯链路。

3.8 图片搜索

图片搜索用于统一管理和检索商品图片资料。

主要功能：

• 按图片、关键词、SKU、分类等条件查询商品资料。
• 支持图片文本信息、结构化字段和向量检索的混合搜索。
• 支持维护图片或商品资料的分类标签。
• 支持批量更新分类信息。

这个模块适合找图、核对商品图片和维护商品资料。

3.9 用户、店铺和权限

权限模块用于控制谁能看哪些数据、操作哪些页面。

主要功能：

• 登录和退出。
• 管理用户账号、角色和显示名。
• 管理用户可见的店铺范围。
• 按角色控制页面访问，例如管理员、跟单角色。
• 按店铺范围裁剪业务数据。

常见角色：

• `admin`：可以进入系统设置、智能补货、操作日志等管理页面。
• `merchandiser`：可以进入采购合同、生产单、报价等跟单模块。

3.10 系统设置与操作日志

系统设置用于维护影响全局运行的配置。

主要功能：

• 配置积加 OpenAPI 信息。
• 配置备货参数和生命周期方案。
• 查看同步记录和近期运行状态。
• 查看用户操作日志。
• 排查谁在什么时候修改过关键配置。

这个模块适合管理员和开发排障时使用。

4. 后台支撑模块

4.1 数据同步

数据同步负责把外部系统数据拉到本地。

主要同步内容：

• 库存。
• 销量。
• 采购未入库。
• 本地可调拨。
• 库龄。
• 商品和站点相关信息。

同步结果会先进入本地快照层，再由备货预计算和其他页面使用。

4.2 备货预计算

备货预计算负责把同步数据加工成页面可用的备货结果。

它会处理：

• 销量窗口。
• 目标库存。
• 可用供给。
• 缺口。
• 建议生产。
• 短期发 FBA 建议。
• 生命周期停售清零。
• EU/UK 合盘和拆分。

预计算的好处是页面查询更快，也方便导出、筛选和追溯批次。

4.3 库存与供给聚合

这个模块负责把不同来源的供给数据整理成统一口径。

主要处理：

• FBA 可售、预留、在途。
• AWD 供给。
• 本地可调拨库存。
• 采购未入库。
• planned inbound。
• 90 天以上库龄库存。
• 店铺、区域、EU/UK 共享池等维度。

它决定了备货卡片里的“当前可用供给”到底怎么算。

4.4 生命周期管理

生命周期管理决定 SKU 使用哪套补货策略。

生命周期包括：

• 新品方案。
• 在售方案。
• 停售方案。

核心规则：

• 新品和在售可以配置不同目标天数。
• 停售会强制停止自动补货。
• 生命周期按 SKU + 站点保存。
• 当前在售站点和生命周期配置记录是两类信息，页面会分开展示。

4.5 日志与审计

日志用于追踪关键操作。

常见记录：

• 用户登录和配置修改。
• 生命周期修改。
• 同步任务状态。
• 智能补货发布审批和 apply / rollback。
• 合同、报价、生产单相关操作。

5. 模块之间的关系

可以把系统理解成四层：

1. 数据来源层：积加 OpenAPI、Amazon SP-API、人工导入的生产单和报价。
2. 本地数据层：快照、同步记录、库存聚合、生命周期、合同和图片资料。
3. 计算与管控层：备货预计算、销量核对、智能补货评估、发布审批。
4. 页面使用层：备货卡片、详情弹窗、数据看板、合同工作台、图片搜索、系统管理。

简单说：

• 同步负责拿数据。
• 聚合负责统一口径。
• 预计算负责生成建议。
• 页面负责让运营、采购和管理者看懂并处理。

6. 常见使用路径

6.1 运营查看缺货

1. 打开“备货”。
2. 按预警等级、生命周期、组别、店铺筛选。
3. 查看建议生产和当前可用供给。
4. 打开 SKU 详情核对预警理由。
5. 必要时导出数据或调整生命周期。

6.2 排查销量不一致

1. 打开“销量核对”。
2. 搜索 SKU 或 MSKU。
3. 对比卡片快照值和即时重算值。
4. 如果差异明显，继续检查同步时间和销量源配置。

6.3 管理者看风险

1. 打开“数据看板”。
2. 先看老板总览里的高风险区域和重点 SKU。
3. 再进入详细数据查看区域、店铺和指标分布。

6.4 跟单生成采购合同

1. 导入生产单。
2. 维护或导入人工报价。
3. 新建采购合同。
4. 从生产单导入明细。
5. 补充图片、包装说明和签章信息。
6. 保存并导出合同。

6.5 验证智能补货

1. 查看智能补货运行记录。
2. 进入影子对比，比较正式结果和智能结果。
3. 查看评估和 Benchmark。
4. 通过发布门禁和审批流程控制试点发布。
5. 必要时回滚。

7. 新人阅读建议

如果只想快速理解业务，建议按下面顺序看：

1. 本文档。
2. `docs/project-module-index.md`，了解关键文件在哪。
3. `docs/replenishment-calculation-formula.md`，理解备货公式。
4. `docs/eu-uk-replenishment-caliber.md`，理解 EU/UK 合盘口径。
5. `docs/runbooks/troubleshooting.md`，查历史问题和排障经验。