ylrz_saas_his_scrm/docs/SaaS计费模块产品文档-业务简版.md

SaaS计费模块产品文档（业务简版）

1. 这套模块解决什么问题

一句话：
平台可以统一配置收费规则，系统按租户实际使用自动计费，租户可随时查看自己的费用明细。

---

2. 角色分工

2.1 平台总账号

可以做：

1. 配置计费方案（单价、阶梯、收费项）；
2. 绑定租户使用哪个方案；
3. 查看所有租户费用明细；
4. 生成账单。

2.2 租户账号

可以做：

1. 查看自己的费用明细；
2. 查看钱包余额；
3. 发起充值（按授权开放）。

---

3. 计费项说明（业务口径）

当前支持：

1. 流量计费（FLOW）
2. 通话计费（CALL_OUT / CALL_IN）
3. AI 外呼附加计费（AI_CALL）
4. SOP Token 计费（TOKEN_SOP）
5. AI 回复 Token 计费（TOKEN_AI_REPLY）
6. 加微计费（ADD_WECHAT）
7. 开户费（OPEN_ACCOUNT_AI / OPEN_ACCOUNT_NON_AI）

---

4. 核心计费规则

4.1 预付费 vs 后付费

• 预付费：计费后立即从钱包扣款；
• 后付费：先记费用，后续按账单结算。

4.2 流量阶梯

• 预付费租户按累计预存金额匹配阶梯单价；
• 后付费租户按后付费单价计费。

4.3 通话规则

• 外呼/呼入按分钟计费；
• 不足 1 分钟按 1 分钟计算；
• 若为 AI 外呼，则在通话费基础上增加 AI 附加费用。

4.4 Token 规则

• 例如配置“10万 Token = 1元”；
• 计费时按 token 用量折算金额。

4.5 幂等规则

• 同一个事件ID只计费一次；
• 重复上报不会重复扣费。

---

5. 业务流程（简版）

5.1 平台配置流程

1. 创建方案；
2. 录入收费项；
3. 录入流量阶梯；
4. 发布方案；
5. 绑定到租户。

5.2 日常计费流程

1. 业务系统上报“用量事件”；
2. 系统按租户方案计算金额；
3. 写入费用明细；
4. 预付费则自动扣钱包。

5.3 出账流程

1. 按时间区间汇总未出账明细；
2. 生成账单；
3. 明细标记已入账。

---

6. 页面说明

6.1 总账号页面

• 页面：费用明细（总账号）
• 功能：查看全租户明细，可按租户筛选。

6.2 租户页面

• 页面：费用明细（我的）
• 功能：仅查看本租户费用明细。

---

7. 数据安全口径

1. 租户页面不允许手工指定租户ID；
2. 系统按登录身份自动识别所属租户；
3. 总账号和租户账号权限分离，避免越权查看。

---

8. 上线验收清单（业务侧）

1. 平台可完成方案配置与发布；
2. 租户绑定后可正常计费；
3. 同一事件重复上报不重复计费；
4. 预付费租户会正确扣减余额；
5. 总账号可查看全部租户明细；
6. 租户仅能查看自己明细；
7. 账单可按区间正常生成。

---

9. 常见问题（FAQ）

Q1：为什么租户看不到别的租户数据？

因为系统按登录身份自动绑定租户，接口层不接受手工传入租户ID。

Q2：重复上报会重复扣费吗？

不会。事件ID幂等，重复事件会被识别并忽略。

Q3：后付费租户会立即扣钱包吗？

不会。后付费只记明细，后续通过账单结算。

Q4：价格调整会影响历史数据吗？

不会。历史明细按发生时绑定的方案版本计算并固化。