阶段 5 账户计费进度记录

2026-07-01

创建阶段 5 计划文档、扩展 Prisma 充值订单和短信计费记录模型后执行：
- cd api && npm run prisma:generate：通过。
- cd api && npm run build：通过。
实现 Billing 账务动作 API 后执行：
- cd api && npm run prisma:generate：通过。
- cd api && npm run build：通过。
- API health 冒烟：GET http://127.0.0.1:3101/api/health 返回 {"status":"ok","service":"cmpp-platform-api",...}。
阶段 5 完整验证：
- npm run verify:phase5：通过。
- BullMQ 本轮端到端 TPS：543.91，满足 500 条/秒验证线。
- Prisma Client 生成成功。
- API 构建成功。
- 前端构建成功，仍有 Vite chunk 大小告警，不阻塞。

Prisma 账户计费模型补强：
- RechargeOrder
- SmsBillingRecord
Billing 账务动作：
- 套餐购买/人工充值：创建 RechargeOrder 并写入 AccountTransaction。
- 企业人工充值入口：新增运营端 manual-recharges API，人工充值记录与套餐充值记录分层查询。
- 发送费用预估：按 70/67 字规则计算计费条数、总条数和金额。
- 账户校验：检查余额+授信额度和套餐余量。
- 冻结：写入 frozen 流水。
- 扣费：写入 charged 流水。
- 解冻：写入 released 流水。
- 退费：写入 refunded 流水。
- 调整：写入 adjusted 流水。
- 短信计费记录：创建和查询 SmsBillingRecord。
运营端接口：
- GET/POST /api/admin/billing/recharges
- GET/POST /api/admin/billing/manual-recharges
- POST /api/admin/billing/estimate
- POST /api/admin/billing/check
- POST /api/admin/billing/freeze
- POST /api/admin/billing/charge
- POST /api/admin/billing/release
- POST /api/admin/billing/refund
- POST /api/admin/billing/adjust
- GET/POST /api/admin/billing/sms-billing-records
客户端接口：
- GET/POST /api/client/billing/orders
- POST /api/client/billing/estimate

验收项	状态	说明
Prisma Client 生成成功	已完成	`npm run prisma:generate` 通过。
API 构建成功	已完成	`npm run build` 在 `api` 下通过。
套餐、充值记录、账务流水、计费规则 API 存在	已完成	已有套餐、充值订单、账户、流水、规则接口。
费用预估 API 存在	已完成	`POST /api/admin/billing/estimate` 与 `POST /api/client/billing/estimate` 已实现。
账户校验 API 存在	已完成	`POST /api/admin/billing/check` 已实现。
冻结、扣费、解冻、退费 API 存在	已完成	`freeze/charge/release/refund` 已实现。
短信计费记录 API 存在	已完成	`sms-billing-records` 查询和创建已实现。
阶段完整验证	已完成	`npm run verify:phase5` 通过。

阶段 5 已完成。第一版可以进入阶段 6 风控与审核。