feat: improve operations admin

docs/routes.md

@@ -35,13 +35,13 @@ T-501 已落地 `/signup`、`/login`、`/logout` 与最小 `/dashboard`。T-502
 | 管理项 | 对应模型 | 运营能做什么 |
 | --- | --- | --- |
 | 注册用户 | User | 查看/禁用注册用户；查看其钱包点数余额 |
-| 点数钱包 | UserWallet | T-201 先只读查看余额；手工调整点数留到 T-401，必须经计费层写流水，不直接改字段 |
+| 点数钱包 | UserWallet | 查看余额；通过专用“手工调点”入口填写点数变动和原因，经计费层锁钱包并写 `adjust` 流水；余额字段本身只读 |
 | API Key | ApiKey | 查看 / 吊销用户的 Key（只显示 prefix 和 hash 摘要，不回显明文） |
 | 计费规则 | PricingRule | 配置「操作类型 × 能力别名（+ 可选分辨率）→ 点数单价」 |
 | 汇率 | ExchangeRate | 配置金额→点数汇率 |
-| 充值订单 | RechargeOrder | 检索订单、查看状态/金额/入账点数/支付流水号 |
-| 点数流水 | PointsLedger | 检索充值/消费/调整/冲正流水（只读，对账用） |
-| 调用记录 | CallRecord | 按账号/时间/状态检索调用、查看别名/实际模型/消耗/错误（只读） |
+| 充值订单 | RechargeOrder | 检索订单、查看状态/金额/入账点数/支付流水号（只读） |
+| 点数流水 | PointsLedger | 按账号、类型、时间检索充值/消费/调整/冲正流水（只读，对账用） |
+| 调用记录 | CallRecord | 按账号、API Key、时间、状态检索调用，查看别名/实际模型/消耗/错误（只读） |
 | 模型配置 | AiModel | 维护上游模型（url/model/api_key[加密脱敏]/api_type/capabilities/timeout） |
 | 能力别名 | ModelAlias | 维护对外别名 → 具体模型的映射；换供应商在此改指向 |
 | 配置审计 | AiConfigAuditLog | 只读查看 AiModel / ModelAlias / 密钥变更：谁、何时、改了什么 |
@@ -52,7 +52,7 @@ T-501 已落地 `/signup`、`/login`、`/logout` 与最小 `/dashboard`。T-502
 
 - 用户自助注册；API Key 由用户在用户端自助生成（服务端生成、哈希存储、明文只显示一次），运营侧只能查看 prefix / 吊销，不回显明文。
 - 禁用用户或吊销 Key 后，相关调用返回 403；无效、缺失或不存在的 Key 返回 401。
-- 手工调整点数必须经计费层方法（写 `PointsLedger`、锁 `UserWallet`），不允许直接编辑 `points_balance` 字段。
+- T-401 已实现运营手工调点：后台从 `UserWallet` 进入专用表单，必须填写非 0 点数变动和原因；服务层 `adjust_wallet_points()` 在事务内锁 `UserWallet`、拒绝扣成负数，并写 `PointsLedger(change_type=adjust)`；不允许直接编辑 `points_balance` 字段。
 
 ### 模型与别名管理