Files

T

ouzhou 0e42e96ddb docs(admin): 补充管理后台 API 与数据库文档 (#12 )

新增 admin 模块接口文档(auth login/me、admins CRUD、audit-logs、feedback 处理、stats 概览、user coins/detail/status、wallet 流水、withdraw 对账/刷新/列表) + admin_user/admin_audit_log 两张表文档，更新 api/database README 索引。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

---------

Co-authored-by: OuYingJun1024 <1034284404@qq.com>
Reviewed-on: #12
Co-authored-by: ouzhou <ouzhou@wonderable.ai>
Co-committed-by: ouzhou <ouzhou@wonderable.ai>

2026-06-06 15:58:23 +08:00

2.2 KiB

Raw Blame History

GET /admin/api/users/{user_id} — 用户 360 详情

所属:Admin·用户组（前缀 /admin/api/users） | 鉴权:Bearer admin_token（角色:任意已登录管理员,无 require_role） | ← 返回 API 索引

入参

路径:user_id(int)

出参

响应 200:AdminUserOverview(基础资料 + 钱包余额 + 各项 count;历史明细走各自分页接口)

字段	类型	说明
`user`	AdminUserListItem	用户基础资料,字段见下
`coin_balance`	int	当前金币余额(个数);无金币账户时为 0
`cash_balance_cents`	int	当前现金余额(分);无账户时为 0
`total_coin_earned`	int	累计获得金币(个数);无账户时为 0
`comparison_total`	int	比价记录总数
`comparison_success`	int	比价成功数(`status=success`)
`withdraw_total`	int	提现单总数
`withdraw_success_cents`	int	提现成功累计金额(分,`status=success` 之和)
`feedback_total`	int	反馈总数

AdminUserListItem(user 字段)

字段	类型	说明
`id`	int	用户 id
`phone`	string	手机号
`nickname`	string \| null	昵称,可空
`register_channel`	string	注册渠道
`status`	string	用户状态:`active` / `disabled` / `deleted`
`wechat_openid`	string \| null	微信 openid,可空
`created_at`	datetime	注册时间(UTC)
`last_login_at`	datetime	上次登录时间(UTC)

错误码

401 未带/无效/过期 admin token、管理员被禁用(头带 WWW-Authenticate: Bearer)
404 用户不存在(detail: "用户不存在")
422 user_id 非整数

说明

金币三项(coin_balance / cash_balance_cents / total_coin_earned)读 coin_account;从未发生金币动作(账户不存在)时统一返回 0。
各 count 为聚合数,明细历史走带 user_id 过滤的分页接口(金币流水 / 现金流水 / 提现 / 比价 / 反馈)。
关联用户表 user;金币账户 coin_account;提现单 withdraw_order;比价记录 comparison_record;反馈 feedback。

2.2 KiB Raw Blame History Unescape Escape

GET /admin/api/users/{user_id} — 用户 360 详情

入参

出参

错误码

说明

2.2 KiB

Raw Blame History