主用例说明：插件上架与销售

背景概述

PowerX Marketplace 作为插件分发与商业化的主阵地，需要提供标准化的上架与销售流程。Vendor 在完成开发后，必须经历资产校验、定价策略配置、权益包组合、试用/促销设置、合规审核及上架后运营监控。缺乏系统支撑将导致插件信息展示不全、定价混乱、交易履约无法追踪，最终削弱生态活力。本主用例梳理插件从提交流程、销售策略设定到上架后交易闭环的关键环节，确保 Marketplace 供给侧和需求侧都能获得可信、透明、可运营的商业体验。

目标与价值

• 标准化交付：建立统一的上架提交流程，确保插件能力、定价、文档在上线前准备充分。
• 商业灵活性：支持订阅、按量计费、一次性购买等多种定价与权益组合，满足差异化销售策略。
• 营销拉新：提供试用、优惠券、捆绑销售等促销手段，助力 Vendor 快速触达目标客户。
• 合规可信：对插件描述、定价与合同条款进行审核，防止虚假宣传与违规收费。
• 闭环运营：沉淀交易数据、评价反馈与售后指标，为持续优化插件质量与销售策略提供依据。

参与角色

• Vendor 产品经理：准备上架资料、设定定价与促销策略、提交审核。
• Vendor 商务/运营：配置销售区域、渠道政策、合同模板与客服信息。
• Marketplace 内容审核员：审查插件功能描述、素材、定价策略与合规要求。
• Marketplace 商务经理：审核商业条款、分润比例、独占协议等内容。
• Marketplace 运营平台：提供提交流程、素材托管、价格校验、展示页生成、交易追踪与数据分析。
• 终端企业用户：浏览、试用、购买插件并提供反馈。

主场景 User Story

作为 Vendor 产品经理，我希望 在 Marketplace 内按标准流程提交插件上架申请、配置销售与促销策略并通过审核，从而 让插件快速触达目标客户并实现可持续的商业收益。

子场景详解

子场景 A：插件上架资料准备与提交流程

• 角色与触发：Vendor 产品经理完成测试，准备上线 Marketplace。
• 主要流程：
  1. 在 Vendor 控制台选择“提交上架”，填写插件版本、功能概述、能力清单、依赖要求与支持语言。
  2. 上传展示素材（Logo、截图、视频演示、案例白皮书）、用户指南、服务协议与 SLA。
  3. 配置适用租户类型、行业标签、可用区域与兼容宿主版本范围。
  4. 提交申请后系统生成工单，进入内容与商业审核队列。
• 成功标准：资料完整、格式校验通过、自动化扫描（病毒、隐私敏感词）合格，状态转为“待审核”。
• 异常与风控：缺失关键字段需阻断提交；敏感词或违规内容触发人工复核；素材版权风险需 Vendor 提供授权证明。
• 指标建议：一次提交通过率、资料补充耗时、素材合规命中率。

子场景 B：定价、权益与促销策略配置

• 角色与触发：Vendor 商务/运营在提交时配置商业策略。
• 主要流程：
  1. 选择计费模式（订阅、按量、混合）并设置基础价格、最低购买量、计费周期与货币。
  2. 定义权益包（基础版、专业版、企业版等），绑定功能列表、账号数、SLA 等内容。
  3. 配置试用期、优惠券、限时折扣、捆绑套餐等促销手段以及适用租户范围。
  4. 配置合同条款与分润比例，生成对外展示与内部 settlement 配置。
• 成功标准：价格符合 Marketplace 规则（如最小定价、阶梯价格上限），权益映射清晰，促销策略通过校验，状态进入“待审核”。
• 异常与风控：定价与已上线版本冲突时需提示调整；促销规则互斥需阻断；试用涉及敏感数据需额外授权确认。
• 指标建议：定价配置一次通过率、促销策略生效率、权益版本复用率。

子场景 C：审核、上线与展示配置

• 角色与触发：Marketplace 审核员收到提交申请。
• 主要流程：
  1. 内容审核员检查功能描述、素材、案例是否真实准确，必要时请求补充信息或线下演示。
  2. 商务经理复核定价策略、分润协议、促销政策与合同条款，确认符合 Marketplace 商业政策。
  3. 合规团队校验产品合规声明、数据处理协议、隐私条款等，确保无违规风险。
  4. 审核通过后，系统生成 Marketplace 展示页，配置搜索标签、推荐位、行业专题位等曝光策略。
  5. 设置自动上架时间（即刻/定时），同步通知 Vendor 并推送给关注的企业用户。
• 成功标准：审核结论明确，所有素材与商业策略已锁定；展示页生成成功，状态变为“已上架”。
• 异常与风控：审核驳回需携带原因与整改建议；定时上架失败需自动回滚到“待上架”；展示页生成异常需触发预警与人工处理。
• 指标建议：审核平均耗时、一次通过率、驳回整改完成率、定时上架成功率。

子场景 D：上架后销售运营与反馈闭环

• 角色与触发：插件成功上线，需要持续运营与监控销售表现。
• 主要流程：
  1. Marketplace 展示页开放试用、购买入口，支持多渠道支付与企业合同下单。
  2. 系统实时统计浏览、试用、转化、订单、退款、评分等数据，生成销售分析报表。
  3. 支持运营人员设置推荐位、发送营销邮件、在行业专题投放 Banner，以提升曝光。
  4. 收集用户评价与售后工单，自动反馈给 Vendor 产品团队，必要时触发版本迭代或下架处理。
• 成功标准：交易流程闭环（下单、支付、交付凭证、发票）；销售数据准确；用户反馈可追踪并闭环处理。
• 异常与风控：支付失败需提供重试与人工协助；评分异常波动触发风控核查；重大缺陷需支持紧急下架与用户赔付策略。
• 指标建议：转化率、续订率、退款率、评分均值、重大缺陷处理 SLA。

功能边界 & 非目标场景

• 不涉及插件本身的开发与测试流程，相关内容请参阅“插件开发与调试”主用例。
• 计费执行、分润结算细节另见“计费与结算”主用例；本用例关注上架与销售策略配置。
• 不覆盖线下大客户定制化合同谈判，此类场景由 Marketplace 商务团队线下执行。
• 用户侧的安装部署体验详见“插件安装与启停”主用例。

依赖与接口

• Vendor 控制台：提供上架提交流程、资料管理与进度追踪能力。
• 素材管理服务：存储并分发插件展示素材，支持版权校验与版本管理。
• 计费与产品配置平台：支持价格、权益、促销策略的配置校验与同步。
• 合规/审核系统：用于内容、商业与合规审核流程协同，提供审批流和证据留痕。
• Marketplace 展示与搜索服务：生成详情页、检索标签、推荐位与曝光数据。
• 交易与支付系统：处理试用转正、下单、支付、退款、发票开具等流程。
• 数据分析与反馈平台：沉淀销售指标、用户反馈、评价数据并提供看板与 API。

验收要点

1. 插件上架流程需覆盖资料提交、价格策略、审核、展示配置与上架通知的全链路，支持状态追踪。
2. 定价、促销、权益配置需具备完整的规则校验与版本化记录，可追溯历史变更。
3. 审核决策需包含处理人、时间、结论与证据，驳回需附整改说明并支持重新提交。
4. 展示页生成需在审核通过后 30 分钟内完成，且支持搜索、分类、推荐等曝光策略配置。
5. 上架后的交易数据、评分反馈需实时同步给 Vendor，并提供异常告警与快速下架机制。
6. 流程需与 Marketplace 风控策略联动，对异常交易、恶意退款等行为提供告警与处置。

场景级测试用例示例

测试准备：搭建 Marketplace 测试环境 mp-staging-02，包含沙箱支付、计费配置、搜索推荐与邮件通知服务。准备插件包样本 plugin-crm-pro.vpkg、展示素材、定价配置模板与促销策略样本。开启审核流程的自动化回归开关。

用例 A-1：资料齐全的上架申请提交（正向）

• 前置条件：Vendor 账号具有上架权限，插件包通过安全扫描。
• 操作步骤：
  1. 登录 Vendor 控制台，填写上架表单并上传 plugin-crm-pro.vpkg 及所有展示素材。
  2. 提交申请并查看状态。
• 预期结果：
  • 状态显示为“Pending Review”，系统校验通过。
  • 资料预览页展示所有字段，自动化扫描结果为通过。
  • 通知邮件/消息发送给提交人。

用例 A-2：缺失 SLA 文档被阻断（逆向）

• 前置条件：测试场景中移除 SLA 附件。
• 操作步骤：
  1. 提交上架申请。
• 预期结果：
  • 系统提示“SLA 文档缺失”，阻断提交。
  • 表单定位到缺失字段并保留已填写内容。
  • 审核队列不产生工单。

用例 B-1：多权益包定价配置成功（正向）

• 前置条件：已上传资料，进入定价配置页面。
• 操作步骤：
  1. 创建“基础版”“专业版”权益包，设置价格、账号数与 SLA。
  2. 启用 14 天试用与 10% 首购折扣。
  3. 提交配置。
• 预期结果：
  • 配置校验通过，状态更新为“Pricing Ready”。
  • 价格策略在预览页正确展示，促销策略已生效。
  • 版本化记录保存此次配置。

用例 B-2：促销规则冲突阻断（逆向）

• 前置条件：尝试同时启用“永久折扣”与“限时折扣”且冲突。
• 操作步骤：
  1. 保存配置。
• 预期结果：
  • 系统提示“促销策略冲突”，阻止提交。
  • 错误消息包含冲突规则详情，需调整后才能继续。

用例 C-1：审核通过并定时上架（正向）

• 前置条件：审核员可登录后台，定时上架时间设置为 T+1 小时。
• 操作步骤：
  1. 内容审核员通过审核，商务经理确认定价，合规审核完成。
  2. 等待定时时间。
• 预期结果：
  • 审核日志记录完整，状态转为“Scheduled”。
  • 到达定时时间后，插件状态变为“Live”。
  • 展示页可访问，包含搜索标签、推荐位配置。
  • Vendor 收到上架通知，关注的企业用户收到推荐消息。

用例 C-2：审核驳回流程（逆向）

• 前置条件：内容审核员发现描述夸大。
• 操作步骤：
  1. 驳回申请并填写整改意见。
• 预期结果：
  • 状态更新为“Need Revision”，驳回原因在 Vendor 控制台可见。
  • 通知发送给 Vendor，要求补充真实案例。
  • Vendor 可在修改后重新提交，保留历史记录。

用例 D-1：上架后首单交易成功（正向）

• 前置条件：插件已上线，企业测试租户具备支付能力。
• 操作步骤：
  1. 企业用户浏览插件详情页，发起购买并完成支付。
  2. 查看 Vendor 控制台与 Marketplace 订单中心。
• 预期结果：
  • 订单状态为“Completed”，生成电子发票。
  • Vendor 控制台显示新增订单与收益数据。
  • 销售分析看板更新试用-转化指标。

用例 D-2：评分异常触发预警（逆向）

• 前置条件：模拟多条低分评价或退款。
• 操作步骤：
  1. 连续提交 5 条低于 2 星的评价并发起退款申请。
• 预期结果：
  • 风控系统触发“评分异常”告警，状态标记为“Risk Observed”。
  • Marketplace 运营收到通知，系统建议临时降权或下架。
  • Vendor 控制台显示需响应的售后任务。