feat: complete cmpp platform phases 0-5

2026-07-01 13:22:04 +08:00
parent 824a8b334f
commit ee926fea04
86 changed files with 10490 additions and 14 deletions
@@ -0,0 +1,39 @@
+# 阶段 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 进度文档记录验证结果。