# 阶段 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 进度文档记录验证结果。