后台“资金流水

docs/api.md

@@ -51,12 +51,19 @@ API 规划以 [项目计划](project-plan.md) 第 10 章为准。
 - `POST /api/admin/auth/logout`
 - `GET /api/admin/me`
 - `GET /api/admin/dashboard`
+- `GET /api/admin/users`
+- `POST /api/admin/users/{id}/freeze`
+- `POST /api/admin/users/{id}/unfreeze`
+- `GET /api/admin/orders`
+- `GET /api/admin/orders/{id}`
+- `GET /api/admin/orders/{id}/handoff-records`
 - `GET /api/admin/listings/pending`
 - `POST /api/admin/listings/{id}/approve`
 - `POST /api/admin/listings/{id}/reject`
 - `GET /api/admin/disputes`
 - `POST /api/admin/disputes/{id}/arbitrate`
+- `GET /api/admin/wallet/ledger`
 - `GET /api/admin/system-configs`
 - `PUT /api/admin/system-configs/{key}`
 
-说明：`/api/admin/*` 当前是开发态 mock 后台接口，只要求登录，后续接入后台管理员账号、RBAC 和 Casbin 权限后再收紧访问控制。
+说明：`GET /api/admin/wallet/ledger` 支持按 `user_id`、`order_id`、`biz_type` 和 `limit` 查询最近资金流水。`/api/admin/*` 当前已使用独立后台登录，后续接入 RBAC 和 Casbin 权限后再按角色收紧访问控制。

docs/business-rules.md

@@ -64,6 +64,8 @@
 - 取消待交接订单时释放租客冻结金额。
 - 订单完成时释放租客冻结金额，给号主生成租金入账流水，并给租客生成押金退回流水。
 - 每笔流水记录 `balance_after`，用于后续对账。
+- 后台资金流水接口为 `/api/admin/wallet/ledger`，前端页面为 `/admin/wallet-ledger`。
+- 后台可按用户、订单和业务类型查看最近流水，用于客服核对押金、租金、释放和结算记录。
 - 后续接入真实支付后，需要把模拟冻结替换为支付成功后的真实冻结。
 
 ## 开发态站内信
@@ -111,3 +113,18 @@
 - 当前统计用户数、实名用户数、商品数、上架数、订单数、租赁中订单、今日订单、今日钱包流水。
 - 待处理事项包括待审核商品、待仲裁申诉、待交接订单和待归还确认订单。
 - 最近订单和最近申诉用于运营快速定位问题，后续接入后台订单管理和商品审核后再跳转到对应详情页。
+
+## 开发态用户管理
+
+- 用户管理接口为 `/api/admin/users`，前端页面为 `/admin/users`。
+- 后台可查看用户手机号、实名状态、风险状态、信用分、订单数、发布数和申诉数。
+- 冻结用户会将 `users.status` 改为 `frozen`，`risk_status` 改为 `frozen`，被冻结用户不能继续登录。
+- 解冻用户会将 `users.status` 改为 `active`，`risk_status` 改为 `normal`。
+- 冻结和解冻都会写入 `audit_logs`，记录管理员、用户、前后状态和原因。
+
+## 开发态订单管理
+
+- 订单管理接口为 `/api/admin/orders`，前端页面为 `/admin/orders`。
+- 后台可查看全量订单、租客、号主、订单状态、交接状态、结算状态、租金和押金。
+- 订单详情页 `/admin/orders/:id` 展示订单状态、双方用户、租期、交接记录和账号资产快照。
+- 当前后台订单管理先做只读能力，后续再补后台关闭订单、标记异常和客服介入操作。