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