计费与增长基建

计费域以产品 SPU/SKU、权益、订单、支付、账户、用量和结算为核心；增长域以邀请、活动、奖励和激活为核心。两者通过事件或 Feign 与 AI、支付和用户域协作。

一致性原则

• 账户流水是追加记录，余额由受控事务更新。
• 支付通知、奖励发放、用量上报和 MQ 消费必须幂等。
• 权益快照记录授予依据和版本，不能只依赖当前商品配置。
• 对账任务输出差异记录，人工处理也要有审计状态。

AI 用量与扣费边界

AI 运行时记录 provider、model、输入/输出 token、runId、tenantId、userId 和 BYOK 标志。平台模型调用走墨点冻结/结算，BYOK 不应误扣平台余额；工具、Embedding、存储和文件处理可以分别形成用量项。用量上报应携带唯一 usageId，重复消费只能得到同一结果。

账务服务不应依赖 SSE 是否成功：用户断开连接后，已完成的模型调用仍需按执行轨迹和最终状态结算。退款、取消和异常补偿通过事件或明确的补偿接口完成，并保留原始交易号、原因、操作者和时间。

发布前验证支付回调重复投递、权益发放重试、AI 用量重复上报、BYOK 分支、余额不足、退款后状态和对账差异。线上排障使用 orderNo/tradeNo/usageId/runId 串联 Pay、Billing、AI trace 和 MQ 消费日志。