主用例说明：管理实体商品（Physical Goods）

背景概述

PowerX 电商平台需要为企业提供完整的实体商品管理能力，涵盖从商品入库、SKU 变体管理、内容上架、库存监控到订单履约的全生命周期。随着多渠道销售、促销活动频繁、供应链复杂化，平台必须在保证库存准确性的同时，实现商品信息的快速更新、库存风险的主动预警以及订单履约的灵活调度。本主用例聚焦"实体商品"管理全链路，覆盖仓库入库、运营上架、库存监控、购物车实时计算与订单拆分发货五大核心场景，确保商品信息准确、库存可控、履约高效。

目标与价值

• 商品信息统一管理：支持多规格 SKU 创建、多媒体内容管理与定时上架，降低运营操作复杂度。
• 库存精准可控：提供实时库存计算、安全阈值预警与自动补货提醒，降低缺货与积压风险。
• 实时购物体验：购物车与商品详情页实时计算库存、预计发货时间与配送可达性，提升转化率。
• 灵活履约能力：支持订单拆分、多批次发货与物流信息同步，优化用户收货体验。
• 多渠道协同：统一商品模型支持多渠道同步销售，避免库存数据不一致。

参与角色

• 仓库管理员：负责商品入库、库存录入、SKU 创建与盘点工作。
• 运营人员：负责商品信息完善、内容上架、促销活动配置与商品生命周期管理。
• 采购部门：负责根据库存预警进行补货决策与供应商协调。
• 企业终端客户：在商城浏览商品、加入购物车并完成购买。
• 客服与售后：处理库存相关咨询、订单发货进度查询与售后问题。
• 系统自动化任务：负责定时上架、价格更新、库存预警与订单履约调度。

主场景 User Story

作为 电商运营团队，我希望 统一管理实体商品的 SKU、库存与内容，实现从入库到履约的全链路自动化，从而 在降低人工操作成本的同时，提升库存准确性并优化客户购物与收货体验。

子场景详解

子场景 A：仓库管理员录入新商品并创建 SKU 变体

• 角色与触发：仓库收到新到货的电子产品，需要在系统中创建商品档案并标注库存。
• 主要流程：
  1. 仓库管理员在"商品管理"中选择"新建商品"，录入基础信息（名称、品类、品牌、描述）。
  2. 系统根据商品特性提示创建 SKU 变体，管理员为不同颜色（如黑/白）、容量（如 128GB/256GB）组合创建独立 SKU。
  3. 为每个 SKU 录入初始库存数量、安全库存阈值与存放库位。
  4. 系统生成 SKU 编码、条形码并可打印标签，完成后更新仓库库存台账。
• 成功标准：SKU 创建成功并生成唯一编码；库存数据准确无误；可导出标签用于贴标；商品进入"已入库待上架"状态。
• 异常与风控：重复 SKU 编码需自动检测并提示；库存数量为负数时拒绝保存；批量入库支持 CSV 导入并提供错误报告。
• 指标建议：SKU 创建平均耗时、库存录入准确率、重复商品率、标签打印成功率。

子场景 B：运营人员上传商品内容并定时上架

• 角色与触发：节日临近，运营人员需要完善商品详情页内容并设置定时上架。
• 主要流程：
  1. 运营人员进入商品编辑页，上传主图、多角度图集与短视频，设置首图与轮播顺序。
  2. 编辑商品详情描述、富文本内容与规格参数表，支持多语言内容（可选）。
  3. 配置价格策略、促销活动参与规则与渠道分发范围。
  4. 设置"定时上架"时间，系统在该时间自动将商品从"仓库"状态切换至"已上架"。
• 成功标准：商品详情页完整展示所有上传内容；定时上架在设定时间准确执行；上架后商品在商城前端可见。
• 异常与风控：图片/视频上传失败需支持重试并记录失败原因；定时任务失败时发送告警给运营人员；内容未审核通过的商品禁止上架。
• 指标建议：内容上传成功率、定时上架准确率、前端展示完整率、内容审核通过率。

子场景 C：库存安全阈值预警与补货通知

• 角色与触发：商品销售良好，库存逐步减少，系统监测到库存低于安全阈值。
• 主要流程：
  1. 系统每日定时扫描所有 SKU 的库存数量，对比安全库存阈值。
  2. 当库存量≤安全阈值时，自动生成"补货预警"通知，推送给采购部门与相关运营人员。
  3. 预警通知包含：当前库存、可售数量、近期日均销量、预计售罄天数、建议采购数量。
  4. 采购人员在系统中确认补货计划，系统记录处理状态并跟踪到货时间。
• 成功标准：库存低于阈值后 30 分钟内生成预警通知；通知准确包含关键信息；补货状态可追踪。
• 异常与风控：预警规则未命中但实际库存为 0 时触发紧急告警；多次预警未处理升级为高级别告警；与采购系统集成失败时记录并重试。
• 指标建议：预警及时率、补货响应时间、缺货率、预警准确率。

子场景 D：购物车实时计算库存与预计发货时间

• 角色与触发：客户浏览商品详情页，将心仪商品加入购物车，系统需要实时反馈库存与配送信息。
• 主要流程：
  1. 客户点击"加入购物车"，系统实时查询该 SKU 的可用库存数量。
  2. 根据库存数量、配送地址、仓库位置计算预计发货时间（如"有货，预计今日发货"或"库存紧张，预计 3-5 天发货"）。
  3. 购物车显示库存状态：充足/紧张/缺货，同时提示最大可购买数量。
  4. 当多个商品组合购买时，系统计算整体配送时效并给出合理预期。
• 成功标准：库存查询响应时间<500ms；预计发货时间计算准确；购物车准确显示库存状态。
• 异常与风控：库存查询失败时提示"库存加载中"并提供刷新机制；超卖保护：库存为 0 时立即提示并禁止加入购物车。
• 指标建议：库存查询响应时间、库存准确率、超卖事件数、购物车转化率。

子场景 E：订单拆分与多批次发货物流同步

• 角色与触发：客户下单后，部分商品缺货，系统需要自动拆分订单并分批发货。
• 主要流程：
  1. 订单生成后，系统检查每个 SKU 的可用库存，标记缺货商品并生成补货任务。
  2. 将订单拆分为多个子订单：有货商品立即生成拣货任务，缺货商品进入"待补货"状态。
  3. 有货批次正常发货，系统获取物流单号并推送物流信息给客户；缺货商品到货后自动生成第二批发货任务。
  4. 客户收到第一批货后，可在订单详情页查看完整物流轨迹，包括"已发货"、"部分发货"、"全部发货完成"等状态。
• 成功标准：订单拆分准确率 100%；物流信息实时同步；客户可清晰查看发货批次与进度。
• 异常与风控：拆分失败触发人工处理流程；物流单号获取失败需重试并告警；客户可选择"等待全部到货后合并发货"。
• 指标建议：订单拆分准确率、首批发货及时率、物流信息同步及时率、客户投诉率。

功能边界 & 非目标场景

• 不涉及商品定价策略、优惠券计算等促销逻辑，详见"定价与促销"主用例。
• 不覆盖虚拟商品（数字产品、订阅）的生命周期管理。
• 不处理退款退货流程，详见"售后与客服"主用例。
• 不涉及渠道库存独立管理与渠道间库存调拨逻辑。

依赖与接口

• 商品信息管理系统：负责商品基础信息、SKU 变体、内容资产的管理与存储。
• 库存管理系统：提供实时库存查询、安全阈值配置、库存变动记录与预警机制。
• 内容管理系统：支持多媒体文件上传、转码、CDN 分发与富文本内容编辑。
• 调度任务系统：负责定时上架、内容审核、库存扫描与预警通知等定时任务。
• 订单履约系统：管理订单拆分逻辑、拣货任务生成、物流单号获取与轨迹同步。
• 通知与消息系统：向运营、采购、客户推送库存预警、上架提醒与发货通知。

验收要点

1. 支持多维度 SKU 创建（颜色、容量、套装等），每个 SKU 具备唯一编码、条形码与库存管理。
2. 商品内容支持多媒体上传、定时上架与渠道分发，上架时间误差<5 分钟。
3. 库存安全阈值预警在库存变动后 30 分钟内触发，预警准确率≥95%。
4. 购物车库存查询响应时间<500ms，预计发货时间计算准确率≥90%。
5. 订单拆分支持多批次发货，物流信息实时同步且无丢失。

场景级测试用例示例

测试准备：搭建沙箱环境，配置商品管理、库存管理、内容管理、订单履约系统。预置 1 名仓库管理员、1 名运营人员、5 名测试客户账号。准备测试数据：3 款电子产品，每款 2-3 个 SKU 变体。

用例 A-1：新建商品并创建 SKU 变体（正向）

• 前置条件：仓库已收到 iPhone 15 Pro 手机新品，包含黑/白/蓝三色，128GB/256GB/512GB 三容量。
• 操作步骤：
  1. 仓库管理员登录后台，选择"新建商品"，录入 iPhone 15 Pro 基础信息。
  2. 点击"添加 SKU 变体"，选择"颜色"+"容量"维度，创建 9 个组合（3×3）。
  3. 为每个 SKU 录入库存数量（如黑色 128GB: 50 台、安全库存: 10 台）。
  4. 打印 SKU 标签并完成保存。
• 预期结果：
  • 商品详情页显示 9 个 SKU 变体，每个 SKU 有唯一编码。
  • 库存数据保存成功，可在库存台账中查询。
  • 生成的条形码标签可用于后续入库扫描。
  • 商品状态为"已入库待上架"。

用例 A-2：重复 SKU 编码检测（逆向）

• 前置条件：系统中已存在 iPhone 15 Pro 128GB 黑色 SKU。
• 操作步骤：
  1. 仓库管理员尝试手动输入已存在的 SKU 编码。
• 预期结果：
  • 系统提示"SKU 编码已存在，请使用其他编码"。
  • 可选择"自动生成新编码"或重新输入。
  • 数据不会被保存，避免重复数据。

用例 B-1：商品内容上传与定时上架（正向）

• 前置条件：iPhone 15 Pro 商品已创建完成，等待上架。
• 操作步骤：
  1. 运营人员编辑商品详情，上传主图 1 张、细节图 5 张、产品视频 1 个。
  2. 编辑商品描述、参数表，选择参与"双 11 活动"。
  3. 设置定时上架时间为"2024-11-11 00:00:00"。
• 预期结果：
  • 图片/视频上传成功并显示缩略图。
  • 商品详情页可预览完整内容。
  • 定时任务在指定时间执行，商品状态变为"已上架"。
  • 商品在商城前端可见，可正常加入购物车。

用例 B-2：定时任务失败告警（逆向）

• 前置条件：已设置商品定时上架，但系统调度服务在该时间点出现故障。
• 操作步骤：
  1. 等待定时上架时间到达。
• 预期结果：
  • 定时任务执行失败，系统生成告警通知运营人员。
  • 告警包含失败原因、重试建议与手动上架入口。
  • 运营人员可手动触发上架或调整定时时间。

用例 C-1：库存预警生成与补货处理（正向）

• 前置条件：iPhone 15 Pro 128GB 黑色库存为 12 台，安全库存为 10 台。
• 操作步骤：
  1. 模拟客户下单 3 台该 SKU。
  2. 库存更新后，系统检测到库存 9 台低于安全库存阈值。
• 预期结果：
  • 30 分钟内生成补货预警通知，推送给采购部门。
  • 通知包含当前库存 9 台、日均销量 5 台、预计 2 天售罄、建议采购 30 台。
  • 采购人员确认补货计划，系统记录处理状态。
  • 补货到货后可更新库存数量，预警自动消除。

用例 C-2：连续预警未处理升级（逆向）

• 前置条件：某 SKU 库存连续 3 天低于安全库存，且未执行补货。
• 操作步骤：
  1. 系统每日扫描后生成 3 次预警，但采购人员未处理。
• 预期结果：
  • 第 3 次预警升级为"紧急预警"，推送给更高权限的管理员。
  • 预警邮件抄送部门负责人。
  • 系统提示手动介入处理或联系供应商。

用例 D-1：购物车库存实时计算（正向）

• 前置条件：iPhone 15 Pro 256GB 蓝色库存为 15 台，预计发货时间为 1-2 天。
• 操作步骤：
  1. 客户浏览商品详情页，点击"加入购物车"。
  2. 进入购物车查看库存状态与预计发货时间。
• 预期结果：
  • 页面显示"库存充足"、"预计 1-2 天发货"。
  • 实时库存查询响应时间<500ms。
  • 同一商品购买 16 台时，提示"库存不足，最多可购买 15 台"。

用例 D-2：库存耗尽禁止加入购物车（逆向）

• 前置条件：iPhone 15 Pro 512GB 白色库存为 0 台。
• 操作步骤：
  1. 客户尝试将该商品加入购物车。
• 预期结果：
  • 按钮变为"缺货"状态，无法点击。
  • 提示"商品暂时售罄，请关注到货通知"。
  • 可订阅到货提醒功能正常。

用例 E-1：订单自动拆分与分批发货（正向）

• 前置条件：客户下单包含 iPhone 15 Pro 两款商品，其中 128GB 黑色缺货，256GB 蓝色有库存 10 台。
• 操作步骤：
  1. 客户提交订单，包含 128GB 黑色 1 台、256GB 蓝色 2 台。
• 预期结果：
  • 系统检测到 128GB 黑色缺货，自动将订单拆分为两个子订单。
  • 有货的 256GB 蓝色 2 台立即生成拣货任务并发货。
  • 缺货商品生成补货任务，到货后自动生成第二批发货。
  • 订单详情页显示"部分发货"，包含两个物流单号与完整物流轨迹。

用例 E-2：客户选择合并发货（逆向）

• 前置条件：订单拆分后，客户希望等待全部商品到货后统一发货。
• 操作步骤：
  1. 客户在订单详情页点击"合并发货"。
• 预期结果：
  • 第二批发货任务取消，第一个子订单标记为"等待合并"。
  • 所有商品到货后，自动合并为一个包裹发货。
  • 客户收到通知："您的订单已合并，将在所有商品到齐后统一发货"。

用例 A-3：批量导入商品与 SKU（正向）

• 前置条件：仓库收到 50 款新商品，每款 2-3 个 SKU 变体。
• 操作步骤：
  1. 仓库管理员下载商品导入模板。
  2. 填写 CSV 文件：商品名称、品类、SKU 变体、库存数量、库位信息等。
  3. 通过"批量导入"功能上传 CSV 文件。
• 预期结果：
  • 系统解析 CSV 文件并显示导入预览。
  • 支持校验重复 SKU、必填字段验证、库存格式检查。
  • 导入成功后生成 50 个商品及对应 SKU 变体。
  • 错误报告显示失败记录及原因，成功率>95%。

用例 A-4：SKU 编码格式验证（逆向）

• 前置条件：SKU 编码规则为"PX-品类代码-YYYYMMDD-序号"。
• 操作步骤：
  1. 仓库管理员尝试输入"ABC123"格式的 SKU 编码。
  2. 或输入含特殊字符的 SKU 编码如"PX@电子产品#001"。
• 预期结果：
  • 系统拒绝保存并提示"SKU 编码格式不符合要求，应为 PX-品类代码-YYYYMMDD-序号"。
  • 提供格式示例与自动生成按钮。
  • 数据不会入库，避免后续编码冲突。

用例 B-3：商品内容审核流程（正向）

• 前置条件：运营人员完成商品内容上传，配置了敏感词审查。
• 操作步骤：
  1. 运营提交商品内容审核。
  2. 审核员在后台查看商品详情页、参数表。
  3. 审核通过后，商品可进入"待上架"状态。
• 预期结果：
  • 系统自动检测图片文字与描述中的敏感词。
  • 审核流程记录审核人员、时间与意见。
  • 审核未通过时返回修改建议，运营可重新提交。
  • 审核通过的记录进入审计日志。

用例 B-4：多媒体上传失败重试机制（逆向）

• 前置条件：商品视频文件较大（200MB），网络不稳定。
• 操作步骤：
  1. 运营人员上传视频文件，上传进度 80% 时网络中断。
• 预期结果：
  • 系统提示"上传失败，是否继续未完成的上传？"。
  • 点击"继续上传"后，从断点处继续传输。
  • 重试最多 3 次，超过后提示"上传失败，请检查网络后重试"。
  • 支持切换网络或压缩文件后重新上传。

用例 B-5：商品下架与重新上架（正向）

• 前置条件：iPhone 15 Pro 商品已正常销售中。
• 操作步骤：
  1. 运营人员在后台将商品状态改为"下架"。
  2. 设置下架原因为"产品升级，即将发布新版本"。
  3. 一周后重新编辑内容并上架。
• 预期结果：
  • 下架后商城前端不再展示该商品，已加入购物车的商品提示"商品已下架"。
  • 订单详情页显示下架状态，但不影响已购用户的售后权益。
  • 重新上架后商品恢复展示，价格与库存信息保持最新。

用例 C-3：跨仓库库存分配（正向）

• 前置条件：商品在北京仓、上海仓、广州仓均有库存。
• 操作步骤：
  1. 系统根据客户地址自动选择发货仓库。
  2. 北京客户下单，系统优先从北京仓发货；库存不足时自动补充其他仓库。
• 预期结果：
  • 库存分配算法考虑距离、库存量、运费成本等因素。
  • 多仓库存实时同步，避免超卖。
  • 拣货单显示从哪个仓库出库，物流单号关联正确仓库。

用例 C-4：预售商品库存处理（正向）

• 前置条件：iPhone 16 尚未到货，设置为预售模式，预计 30 天后发货。
• 操作步骤：
  1. 运营设置预售数量为 1000 台。
  2. 客户在商品详情页看到"预售，预计 30 天后发货"。
  3. 客户下单支付，系统预留预售名额但不影响实际库存。
• 预期结果：
  • 预售商品不占用实际库存，支持超卖至预售数量上限。
  • 到货后自动分配给预售订单，按下单顺序发货。
  • 预售期间可修改预计发货时间，通知已预购客户。

用例 C-5：库存盘点差异处理（正向）

• 前置条件：仓库需要进行季度盘点，账面库存与实物库存可能有差异。
• 操作步骤：
  1. 仓库人员使用扫码设备盘点 iPhone 15 Pro 各 SKU。
  2. 系统对比账面库存与实际盘点数量。
  3. 生成盘点差异报告，差异较大的商品进入复核流程。
• 预期结果：
  • 盘点差异自动分类为：盘盈、盘亏、损坏、丢失。
  • 差异超过 5% 的 SKU 自动生成调整单并推送给财务。
  • 调整记录写入库存流水，可追溯每次变动原因。
  • 盘点准确率统计，用于考核仓库管理水平。

用例 D-3：购物车商品被抢购并发（逆向）

• 前置条件：商品库存仅剩 1 台，A 用户和 B 用户同时将其加入购物车。
• 操作步骤：
  1. A 用户先加入购物车成功。
  2. 5 秒内 B 用户也尝试加入购物车。
  3. A 用户在购物车中等待 2 分钟后结算。
• 预期结果：
  • B 用户加入购物车时提示"该商品库存紧张，您是第 2 位加入购物车的用户"。
  • A 用户结算时，如果购物车中的商品已被其他人购买，提示"商品已被抢完，请重新选择"。
  • 购物车设置 15 分钟超时，超时后释放库存。

用例 D-4：多商品组合发货时效计算（正向）

• 前置条件：客户在购物车中添加了 3 款商品，分别位于不同仓库。
• 操作步骤：
  1. 商品 A 在北京仓有货（1-2 天发货）。
  2. 商品 B 在上海仓缺货（7-10 天发货）。
  3. 商品 C 在北京仓有货（1-2 天发货）。
• 预期结果：
  • 购物车显示"部分商品缺货，此订单需分批发货"。
  • 系统计算整体发货时效为"首批 1-2 天，第二批 7-10 天"。
  • 提示客户可选择"等待全部到齐后统一发货"或"立即发货，后续补发"。

用例 D-5：购物车库存实时刷新（正向）

• 前置条件：客户将商品加入购物车后，其他客户也在购买同款商品。
• 操作步骤：
  1. 客户甲将 iPhone 15 Pro 加入购物车，显示库存 10 台。
  2. 客户乙同时下单 8 台该商品。
  3. 5 分钟后客户甲查看购物车。
• 预期结果：
  • 购物车自动刷新库存信息，显示剩余 2 台。
  • 如果库存不足 2 台，提示"库存不足，最多只能购买 X 台"。
  • 提供"刷新库存"按钮，客户可主动获取最新库存。

用例 E-3：物流单号获取失败重试（逆向）

• 前置条件：拣货完成后，系统需要向物流商申请快递单号。
• 操作步骤：
  1. 拣货完成，系统调用物流商 API 获取单号。
  2. API 返回超时/错误码，物流服务不可用。
• 预期结果：
  • 系统自动重试 3 次，每次间隔 1 分钟。
  • 重试失败后生成工单通知物流专员处理。
  • 客户订单详情页提示"发货延迟，客服将主动联系您"。
  • 人工处理后可通过"手动录入单号"完成发货。

用例 E-4：订单部分退款后库存恢复（正向）

• 前置条件：订单已发货，客户申请部分商品退货。
• 操作步骤：
  1. 客户购买 iPhone 15 Pro + 充电器 + 保护壳，共 3 件商品。
  2. 收到货后，客户申请退货保护壳，其他商品保留。
  3. 售后审核通过，保护壳退回仓库。
• 预期结果：
  • 退款金额计算准确，只退保护壳费用。
  • 保护壳库存 +1，恢复可售状态。
  • 订单状态更新为"部分退货完成"，不影响其他商品。
  • 库存流水记录此次退货入库。

用例 F-1：商品多渠道同步（正向）

• 前置条件：企业在自营商城、淘宝、京东 3 个渠道销售同款商品。
• 操作步骤：
  1. 运营人员在后台修改商品描述和价格。
  2. 选择同步到"全部渠道"。
• 预期结果：
  • 系统调用各渠道 API，同步商品信息。
  • 同步成功/失败状态可见，支持单渠道重新同步。
  • 库存同步时避免重复扣减，按渠道库存池计算。
  • 渠道授权过期时同步失败并提示续期。

用例 F-2：渠道库存独立管理（逆向）

• 前置条件：淘宝渠道设置独立库存池，与自营商城库存分离。
• 操作步骤：
  1. 自营商城库存 5 台，淘宝渠道库存 10 台。
  2. 客户在自营商城下单 6 台。
• 预期结果：
  • 系统检测到自营渠道库存不足 6 台，拒绝下单。
  • 提示"自营商城库存不足 6 台，当前可售 5 台"，或建议"部分从淘宝渠道调拨"。
  • 不影响淘宝渠道的 10 台库存。
  • 支持跨渠道调拨功能（可选功能，需手动审批）。