# 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：价格调整会影响历史数据吗？

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