lislgosms/docs/phase-5-billing-plan.md

阶段 5 账户计费实施计划

目标

实现发送前可判断是否可发，发送后可对账的账户计费基础闭环：套餐配置、充值套餐、企业账户、余额或套餐余量、充值记录、账单流水、发送预估费用、冻结、扣费、退费、解冻、短信记录与账务流水关联。

阶段 5 不实现完整发送链路；发送记录正式关联会在阶段 7 发送链路落地时接入。本阶段先提供 relatedType/relatedId 关联能力和费用预估/账务动作 API。

实施步骤

1. Prisma 模型补强

   • RechargeOrder
   • SmsBillingRecord
   • 扩展账务流水关联字段。

2. Billing 服务动作

   • 套餐购买/人工充值。
   • 发送费用预估。
   • 账户可用额度检查。
   • 冻结、扣费、解冻、退费。
   • 账务流水关联任务、短信记录或人工单据。

3. API

   • 客户端充值套餐、充值订单、账单流水、费用预估。
   • 运营端充值记录、账务流水、套餐配置、计费规则、人工充值和账务调整。

4. 验证

   • cd api && npm run prisma:generate
   • cd api && npm run build
   • API health 冒烟
   • npm run verify:phase4

验收标准

• Prisma Client 生成成功。
• API 构建成功。
• 套餐、充值记录、账务流水、计费规则 API 存在。
• 费用预估、冻结、扣费、解冻、退费 API 存在。
• 阶段 5 进度文档记录验证结果。