用户使用场景 · 商品服务商(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-11)。
说明:商城为独立服务(dan/danshop,端口 8888),商品/订单与 C 端 cfc-backend 通过商品/订单接口协同;服务商入驻走统一服务角色申请或管理端供应商管理。
场景 S-1:服务商入驻申请与审核
用户故事:作为供应商,我想提交资质入驻,通过运营审核后卖货。
- 角色:商品服务商
- 前置条件:资质材料/联系方式/服务品类就绪。
- 主流程
- 提交入驻申请(资质/联系/品类)→ 进入运营审核队列。
- 运营审核通过 → 获得供应商身份。
- 异常/边界:资质缺失 → 驳回并说明;重复申请幂等。
- 关联需求/设计:
ServiceRoleApplicationController /api/service-role(统一服务角色申请 + 管理端审批);或 AdminEcomSupplierController /api/admin/ecom-supplier/*。
- 关联用例:TC-S-01
场景 S-2:商品管理
用户故事:作为供应商,我想上架商品并管控库存,让其在商城可见。
- 角色:商品服务商
- 前置条件:已审核通过。
- 主流程
- 新增商品(名称/价格/库存/分类)→ 商品在商城可见。
- 库存/价格变更即时生效。
- 异常/边界:入库存单字段校验错误 → 400 提示;价格为负/库存为负拦截;下架商品不可购买。
- 关联需求/设计:
ProductController /api/product、AdminProductController /api/admin/product。
- 关联用例:TC-S-02
场景 S-3:订单处理(发货 / 核销)
用户故事:作为供应商,我想处理客户订单并发货/核销,让客户看到物流或核销码。
- 角色:商品服务商
- 前置条件:已有客户下单。
- 主流程
- 查看新订单 → 发货 / 核销。
- 订单状态正确流转,客户可见物流 / 核销码。
- 异常/边界:重复发货幂等;核销码校验防冒用;退款/售后按业务规则。
- 关联需求/设计:
ProductOrderController /api/product/order;商城订单流。
- 关联用例:TC-S-03
场景 S-4:订单核销(到店 / 线下核销)
用户故事:作为供应商,我想核销线下订单,以便完成到店履约。
- 角色:商品服务商
- 前置条件:订单已支付且支持到店核销;客户出示核销码。
- 主流程
- 扫码/输入核销码 → 校验订单与核销码匹配。
- 核销成功 → 订单状态更新为已完成/已核销。
- 异常/边界:核销码已被使用 → 重复核销幂等拒绝;核销码过期 → 提示重新获取;核销码与订单不匹配 → 拒绝并提示。
- 关联需求/设计:
ProductOrderController;核销码校验。
- 关联用例:TC-S-04
场景 S-5:库存管理(调整 / 同步)
用户故事:作为供应商,我想调整库存并同步商城,以便保障供应不超卖。
- 角色:商品服务商
- 前置条件:已有商品。
- 主流程
- 调整库存(入库/出库/盘点)→ 同步商城库存。
- 下单时库存扣减联动。
- 异常/边界:负库存拦截;并发下单不超卖(库存原子扣减);库存同步失败重试。
- 关联需求/设计:库存服务;
/api/product/stock。
- 关联用例:TC-S-05
场景 S-6:售后 / 退款处理
用户故事:作为供应商,我想处理客户退换货与退款,以便完成售后闭环。
- 角色:商品服务商
- 前置条件:客户已申请售后。
- 主流程
- 查看售后单 → 审核 → 同意退款 / 拒绝。
- 同意后走退款流程,订单状态更新。
- 异常/边界:重复退款拦截;已发货退款规则(运费/折扣)按业务;退款金额校验。
- 关联需求/设计:售后服务;
/api/product/refund。
- 关联用例:TC-S-06
场景 S-7:营销活动报名(供应商侧)
用户故事:作为供应商,我想报名平台营销活动,以便商品打标引流。
- 角色:商品服务商
- 前置条件:平台已发布活动。
- 主流程
- 报名活动 → 提交参与商品。
- 活动上线后商品带活动标。
- 异常/边界:活动已结束/未开始不可报名;活动名额满拒;商品资质不符驳回。
- 关联需求/设计:活动管理;
/api/admin/activity。
- 关联用例:TC-S-07
场景 S-8:对账 / 结算
用户故事:作为供应商,我想核对账单并按账期结算,以便掌握经营收入。
- 角色:商品服务商
- 前置条件:已完成订单;账期到。
- 主流程
- 查看账单(订单/退款/佣金)→ 对账。
- 账期结算 → 收益到账。
- 异常/边界:账期未到不可结算;对账不平有异常标记;结算失败可重试。
- 关联需求/设计:结算服务;
/api/admin/settlement。
- 关联用例:TC-S-08
场景 S-9:报告解析服务接入(对接解析中台)
用户故事:作为检测服务商,我想对接平台报告解析中台,以便提供报告解析能力。
- 角色:商品服务商(检测/服务类)
- 前置条件:具备解析资质;通过平台接入审核。
- 主流程
- 接入解析中台 → 注册报告类型(如
gut_flora)。
- 自测解析样例 → 验证通过上线。
- 异常/边界:跨商户数据隔离(不可解析他商户报告);鉴权失败拒;类型未注册不可解析。
- 关联需求/设计:报告解析中台
/api/admin/report-parser/*;服务商集成。
- 关联用例:TC-S-09
场景 S-10:营养 / 食谱数据供给
用户故事:作为营养服务商,我想上架食谱数据并同步平台,以便支撑饮食推荐。
- 角色:商品服务商(营养/膳食类)
- 前置条件:具备营养数据合规资质。
- 主流程
- 上架食谱数据(食材/营养/禁忌)→ 同步平台食谱库。
- 平台饮食推荐可引用。
- 异常/边界:数据合规校验(无伪科学/治疗宣称);格式校验失败拒;同步失败重试。
- 关联需求/设计:食谱库;
/api/diet/recommend。
- 关联用例:TC-S-10
场景 S-11:数据导出合规(授权使用)
用户故事:作为服务商,我想在授权范围内取数,以便合规使用脱敏数据。
- 角色:商品服务商
- 前置条件:具备平台授权(授权范围/期限)。
- 主流程
- 申请取数授权 → 平台审批。
- 授权内导出脱敏数据。
- 异常/边界:越授权取数拒;敏感字段脱敏;导出频次限制。
- 关联需求/设计:合规;
/api/admin/export。
- 关联用例:TC-S-11