docs: complete t-402 mvp acceptance

2026-07-03 17:23:59 +08:00
parent 79605449ef
commit 3fdb25945b
10 changed files with 88 additions and 17 deletions
@@ -34,7 +34,7 @@
 | 点数计费与扣减 | 按「操作类型+能力别名+分辨率」算点数，余额足够则扣点放行，不足则报错 | P0 |
 | 余额查询 API | 查询当前用户点数余额 | P0 |
 | 调用记录 | 每次调用落库：用户、Key、时间、操作、模型、消耗点数、成功/失败、错误 | P0 |
-| 点数流水 | 每次点数变动（充值/消费/运营调整）落库，可对账 | P0 |
+| 点数流水 | 每次点数变动（充值/消费/退款/运营调整）落库，可对账 | P0 |
 | 运营后台 | django-admin 管理用户、点数、计费规则、充值订单、流水、调用记录 | P0 |

 ### 后续迭代
@@ -66,9 +66,9 @@
 - **点数计费与扣减**：调用前按规则算出点数 N；余额 ≥ N 才放行并精确扣 N；余额 < N 返回点数不足错误码且不调上游。并发同时多次调用，最终扣点总额正确，**不出现超扣或扣成负数**。
 - **余额查询 API**：返回的余额等于该账号点数流水累加结果。
 - **充值转点数**：模拟一次支付系统回调（含订单号、金额、签名），验签通过后按汇率加点；**同一订单号重复回调只入账一次**（幂等）；验签失败不入账。
- **调用记录 / 点数流水**：每次成功/失败调用、每次充值/调整都各生成一条记录，字段完整、可在后台检索。
+- **调用记录 / 点数流水**：每次成功/失败调用、每次充值/退款/调整都各生成一条记录，字段完整、可在后台检索。
 - **用户注册/登录**：新用户能自助注册（邮箱验证）、登录；注册后点数为 0（不送免费点数）。
- **API Key 自助管理**：登录用户能生成 API Key（明文只显示一次，库内存哈希）、能删除；删除后该 Key 调用返回 401。
+- **API Key 自助管理**：登录用户能生成 API Key（明文只显示一次，库内存哈希）、能删除；删除落库为吊销，吊销后该 Key 调用返回 403，缺失/无效/不存在 Key 返回 401。
 - **扫码充值**：用户端发起充值→展示二维码→（mock 或真实）支付成功回调后点数按汇率到账，充值记录与流水各一条；同一订单号重复回调只入账一次。
 - **个人中心**：剩余点数 = 点数流水累加；充值总额、充值记录、消费记录与实际一致。
 - **运营后台**：运营能登录 django-admin，管理用户与点数（手工调点带原因写流水）、配置计费规则、检索并查看充值订单/流水/调用记录。