06-vendor.md 2.4 KB

用户使用场景 · 商品服务商(Vendor)

来源:AGENTS.md(商城 dan/danshop 独立 Spring Boot,端口 8888)、API_REFERENCE.md(/api/product/*、/api/product/order、/api/admin/ecom-supplier/*、/api/service-role)、黑盒方案 S-01~S-03。 关联用例:test-cases/vendor.md(TC-S-01~TC-S-03)。

说明:商城为独立服务(dan/danshop,端口 8888),商品/订单与 C 端 cfc-backend 通过商品/订单接口协同;服务商入驻走统一服务角色申请或管理端供应商管理。


场景 S-1:服务商入驻申请与审核

用户故事:作为供应商,我想提交资质入驻,通过运营审核后卖货。

  • 角色:商品服务商
  • 前置条件:资质材料/联系方式/服务品类就绪。
  • 主流程
    1. 提交入驻申请(资质/联系/品类)→ 进入运营审核队列。
    2. 运营审核通过 → 获得供应商身份。
  • 异常/边界:资质缺失 → 驳回并说明;重复申请幂等。
  • 关联需求/设计:ServiceRoleApplicationController /api/service-role(统一服务角色申请 + 管理端审批);或 AdminEcomSupplierController /api/admin/ecom-supplier/*。
  • 关联用例:TC-S-01

场景 S-2:商品管理

用户故事:作为供应商,我想上架商品并管控库存,让其在商城可见。

  • 角色:商品服务商
  • 前置条件:已审核通过。
  • 主流程
    1. 新增商品(名称/价格/库存/分类)→ 商品在商城可见。
    2. 库存/价格变更即时生效。
  • 异常/边界:入库存单字段校验错误 → 400 提示;价格为负/库存为负拦截;下架商品不可购买。
  • 关联需求/设计:ProductController /api/product、AdminProductController /api/admin/product。
  • 关联用例:TC-S-02

场景 S-3:订单处理(发货 / 核销)

用户故事:作为供应商,我想处理客户订单并发货/核销,让客户看到物流或核销码。

  • 角色:商品服务商
  • 前置条件:已有客户下单。
  • 主流程
    1. 查看新订单 → 发货 / 核销。
    2. 订单状态正确流转,客户可见物流 / 核销码。
  • 异常/边界:重复发货幂等;核销码校验防冒用;退款/售后按业务规则。
  • 关联需求/设计:ProductOrderController /api/product/order;商城订单流。
  • 关联用例:TC-S-03