主用例说明：计费与结算

背景概述

PowerX Marketplace 面向多租户交付插件与智能体能力，需要在统一平台内完成计费、收款、分润与财税合规。生态中存在订阅、按量、混合套餐等多样化计费模式，同时还涉及资源型增值服务、支持服务包与插件内购。缺乏集中治理会造成费用统计不一致、账单难以核对、Vendor 分润延迟以及税务风险。本主用例聚焦 Marketplace 计费链路的标准化，覆盖产品定价、使用量采集、账单生成、回款与对账、Vendor 结算到异常风控的全流程，确保企业用户与 Vendor 都能获得透明可信的商业体验。

目标与价值

• 统一计费模型：支持订阅、按量、混合及一次性收费等模型，并提供阶梯、超额、溢价等规则配置。
• 精准账单生成：按租户、插件、权益版本与时间周期生成可追溯账单，提供明细与校验凭据。
• 高效回款与分润：打通在线支付、合同收款、余额抵扣等渠道，并实现 Vendor 分润自动结算。
• 财税合规：关联税率、发票、合同、结算单据，满足不同地区的合规要求。
• 风控与争议处理：识别异常用量、欠费风险与账单争议，提供限流、催缴、仲裁与豁免策略。

参与角色

• Marketplace 产品经理：规划计费模型、权益组合、结算规则与风控策略。
• Marketplace 财务/结算专员：核对账单、处理回款、发票开具与 Vendor 分润。
• Marketplace 风控/合规：监控欠费、欺诈、税务风险并制定处理策略。
• Vendor 财务与商务：配置定价策略、查看结算报表、对账并提出争议。
• 企业租户财务：验收账单、发起付款、申请发票与记录成本。
• 计量与日志服务：采集插件调用、资源消耗等原始指标。
• 支付网关与合同收款系统：处理在线支付、企业转账、对公托收等回款渠道。

主场景 User Story

作为 Marketplace 财务负责人，我希望 基于统一的计费模型自动生成准确账单并完成 Vendor 分润结算，从而 确保平台收入透明、Vendor 按时回款且满足财税合规。

子场景详解

子场景 A：计费模型与权益策略配置

• 角色与触发：Marketplace 产品经理针对新插件或权益调整计费策略。
• 主要流程：
  1. 选择计费模型（订阅、按量、混合、一次性）并定义计费周期、货币、税率与汇率策略。
  2. 配置阶梯定价、超额加价、最低消费与封顶规则，绑定权益包（基础版/专业版/企业版等）。
  3. 定义增值服务（专属支持、算力扩展、数据额度）与插件内购项目的计价方式。
  4. 提交后触发规则校验（冲突、上下限、地区限制），通过即生效并同步至计量与账单系统。
• 成功标准：计费规则通过校验，版本化记录更新，通知相关 Vendor 与内部财务。
• 异常与风控：存在互斥策略、超出监管价限、税率缺失时阻断；需要审批的变更进入审核流。
• 指标建议：定价变更一次通过率、规则冲突率、权益版本复用率。

子场景 B：计量采集与账单生成

• 角色与触发：计量服务按周期（小时/天/月）汇总插件使用数据。
• 主要流程：
  1. 采集插件调用次数、API 耗时、数据传输量、席位数等指标，与租户、插件版本、区域关联。
  2. 将指标落盘到计量仓库，并进行去重、异常剔除、缺失补偿处理。
  3. 依据计费模型计算周期费用，生成账单草稿，包括明细条目、折扣、税金、优惠券使用、滞纳金等。
  4. 推送账单草稿给企业租户财务与 Vendor 预览，支持核对与备注。
• 成功标准：账单生成准确、可追溯；草稿可在线核验并支持导出；异常会自动标记待复核。
• 异常与风控：计量缺失触发补采；用量异常激增触发风控；账单计算失败需回滚并告警。
• 指标建议：账单生成成功率、计量数据完整率、异常账单复核时长。

子场景 C：回款、发票与催缴

• 角色与触发：账单确认后进入收款流程。
• 主要流程：
  1. 企业租户选择支付方式（在线支付、对公转账、余额抵扣、合同后付），系统生成支付指引。
  2. 支付成功后更新账单状态，生成收据、电子发票或发票申请单，并推送至财务系统。
  3. 对逾期账单触发催缴策略（邮件、短信、销售跟进、限流策略），必要时暂停部分能力。
  4. 支持租户发起账单争议或退款申请，进入客服/财务协同处理。
• 成功标准：回款状态实时更新，发票记录完整，催缴流程可配置，争议有处理 SLA。
• 异常与风控：支付失败需支持重试与人工协助；逾期超过阈值自动执行限流或降级；争议成立时支持部分减免或调账。
• 指标建议：回款周期、逾期率、催缴成功率、争议处理时长。

子场景 D：Vendor 分润结算与对账

• 角色与触发：账期结束后，为 Vendor 出具结算单并完成付款。
• 主要流程：
  1. 根据合同约定与促销策略计算 Vendor 应得收入、平台佣金、税费等。
  2. 生成结算单、对账明细与收入分析，支持 Vendor 在线确认或发起异议。
  3. 对接财务支付流程，执行打款或开具收入发票，记录凭证。
  4. 同步结算结果至 Vendor 控制台与内部收入系统，沉淀审计日志。
• 成功标准：结算数据准确、可追踪，Vendor 在 SLA 内收到款项，异常有闭环处理。
• 异常与风控：Vendor 异常退款、欺诈行为需扣减或冻结结算；结算失败需重试并发送预警。
• 指标建议：结算周期、Vendor 满意度、争议率、对账差异率。

子场景 E：异常监控与争议治理

• 角色与触发：风控系统监控欠费、异常用量与争议事件。
• 主要流程：
  1. 构建欠费风险模型，识别连续逾期、疑似刷量等行为，自动触发策略（限流、冻结、人工复核）。
  2. 记录租户或 Vendor 发起的争议，分类（计量、定价、合同、税务），分派给对应团队处理。
  3. 输出争议处理结论（调账、豁免、驳回），同步账单与结算状态。
  4. 沉淀争议案例与风控策略回放，优化规则与监控指标。
• 成功标准：异常事件处理有 SLA，策略执行有日志可追溯，争议闭环率高。
• 异常与风控：策略误伤需支持快速解除；风控模型误报率纳入监控。
• 指标建议：欠费预警准确率、争议闭环率、误报率、风控策略响应时长。

功能边界 & 非目标场景

• 不涉及插件功能内的自定义收费逻辑，需通过 API 回传到 Marketplace 计量系统。
• 不覆盖第三方 PSP 的合规接入流程，相关内容由支付团队负责。
• 对于线下大型合同定制计费，只提供导入接口与对账支持，不负责合同谈判。
• 税务申报、财务总账处理归属企业财务系统，仅提供数据对接与凭证。

依赖与接口

• 计量采集服务：收集插件调用、资源用量、增值服务指标。
• 计费规则引擎：执行定价策略、优惠、税率与分润计算。
• 账单与结算服务：生成账单、结算单、凭证并管理生命周期。
• 支付与收款系统：支持在线支付、对公转账、余额抵扣、退款处理。
• 发票与税务系统：处理电子发票、专票申请、税率配置与归档。
• 风控引擎：监控欠费、欺诈、异常用量，提供策略执行接口。
• Vendor 控制台：展示结算数据、争议进度与账单明细。
• 审计与日志服务：记录计费规则变更、账单生成、结算与风控决策的操作痕迹。

验收要点

1. 计费模型需可配置、版本化并支持回滚，规则冲突可被识别与阻断。
2. 账单生成应提供详细明细、税费、优惠、汇率换算等数据，并支持租户核验反馈。
3. 回款、发票、催缴与争议流程需有全链路状态追踪与 SLA 监控。
4. Vendor 结算应与租户回款联动，确保分润计算准确并可追溯。
5. 风控策略触发需记录证据，支持人工复核与策略调整。
6. 所有关键操作应保留审计日志，满足财税与合规审计要求。

场景级测试用例示例

测试准备：搭建 Marketplace 计费沙箱环境 mp-billing-stg01，包含计量采集、计费引擎、账单服务、支付网关（沙箱模式）、发票系统与风控引擎。准备测试租户 tenant-alpha、Vendor vendor-saas-co、插件版本 px-erp-pro，并导入标准计费策略模板与风控策略。

用例 A-1：阶梯订阅计费策略配置成功（正向）

• 前置条件：拥有计费策略管理权限。
• 操作步骤：
  1. 在计费后台创建“专业版”订阅策略，设置基础价 999 元/月、10 席位包含、超出每席位 80 元。
  2. 配置溢价规则：跨区域部署加收 15%。
  3. 提交并发布策略。
• 预期结果：
  • 策略校验通过，状态为“Active”。
  • 版本记录生成并通知计量与账单服务。
  • Vendor 控制台显示最新策略摘要。

用例 A-2：冲突策略被阻断（逆向）

• 前置条件：已有同名权益包有效。
• 操作步骤：
  1. 创建同名权益包但设置与现有策略冲突的最低消费与阶梯价格。
  2. 保存策略。
• 预期结果：
  • 系统提示“与现有策略 px-erp-pro-professional 冲突”，阻断发布。
  • 提供冲突字段详情并保留草稿供调整。

用例 B-1：按量账单生成（正向）

• 前置条件：计量数据已按小时汇总。
• 操作步骤：
  1. 触发月账单生成任务。
  2. 在账单中心查看 tenant-alpha 当月账单。
• 预期结果：
  • 账单状态为“Draft”，包含调用量、席位数、增值服务费用。
  • 明细支持导出 CSV，税率、折扣、汇率换算正确。
  • 无异常标记。

用例 B-2：计量缺失触发复核（逆向）

• 前置条件：模拟计量数据缺失 2 小时。
• 操作步骤：
  1. 生成账单。
• 预期结果：
  • 账单状态标记为“Pending Review”，异常详情提示缺失时间段。
  • 触发补采任务并通知计量团队。

用例 C-1：账单支付与发票开具（正向）

• 前置条件：账单已确认，支付方式选在线支付。
• 操作步骤：
  1. 在企业租户后台点击“立即支付”，完成沙箱支付。
  2. 申请电子发票。
• 预期结果：
  • 账单状态更新为“Paid”，生成收据。
  • 发票下载链接可用，发票信息正确。
  • 通知发送给租户财务与 Marketplace 财务。

用例 C-2：逾期催缴与限流（逆向）

• 前置条件：账单逾期 15 天未支付。
• 操作步骤：
  1. 触发催缴任务并观察插件调用。
• 预期结果：
  • 系统发送催缴邮件、短信并生成客服跟进任务。
  • 插件调用被限流至 30%，控制台提示欠费原因。
  • 风控日志记录策略执行。

用例 D-1：Vendor 结算打款（正向）

• 前置条件：账期结束，租户账单均已回款。
• 操作步骤：
  1. 生成 vendor-saas-co 结算单并提交支付。
• 预期结果：
  • 结算单状态变为“Paying”→“Completed”。
  • 结算明细可下载，包含分润计算、税费、异常调整。
  • Vendor 控制台显示入账记录。

用例 D-2：Vendor 结算争议（逆向）

• 前置条件：Vendor 提出某租户费用应豁免。
• 操作步骤：
  1. Vendor 控制台发起争议，附上凭证。
• 预期结果：
  • 结算单状态更新为“Dispute”。
  • 财务与风控收到通知，处理结果同步（调账或驳回）。
  • 全流程有审计日志。

用例 E-1：欠费风控策略验证（正向）

• 前置条件：风控策略设置欠费阈值 7 天。
• 操作步骤：
  1. 模拟租户连续逾期 8 天。
• 预期结果：
  • 风控系统标记风险等级为“High”，自动执行限流并生成工单。
  • Marketplace 财务收到催缴提醒，租户后台展示欠费告警。

用例 E-2：风控误报解除（逆向）

• 前置条件：风控策略误判为高风险。
• 操作步骤：
  1. 财务人员在风控面板中执行“解除限制”。
• 预期结果：
  • 限流即时解除，系统记录操作原因。
  • 风控模型训练集标记该案例用于优化。
  • 租户控制台提示已恢复服务。