22 lines
1.8 KiB
Markdown
22 lines
1.8 KiB
Markdown
# 地址管理统计与商户只读详情
|
||
|
||
管理员和商户地址列表提供总地址、启用地址、USDT/TRX余额及可用能量、带宽汇总。统计使用数据库最新快照,不表示查询时刻的链上余额;用户可在钱包详情点击“刷新链上数据”更新对应快照。
|
||
|
||
## 管理端统计接口
|
||
|
||
- 管理员:`GET /system/address/statistics`,权限 `system:address:list`。
|
||
- 商户:`GET /system/address/user/statistics`,权限 `system:address:user-list`,服务端强制使用当前用户ID。
|
||
- 入参复用地址列表的筛选字段,包括 `token`、`status`、`appId`、`userId`、`walletUserName`。商户传入的 `userId` 不生效。
|
||
- 响应 `data`:`total`、`enabled`、`usdtBalance`、`trxBalance`、`energy`、`bandwidth`。余额和资源合计返回字符串以保留精度。
|
||
- 列表和统计共享 SQL 条件,排除软删除记录,并保持既有的已分配钱包范围(`wallet_user_name is not null`),不包含未分配地址池。
|
||
|
||
## 操作与权限
|
||
|
||
两个列表移除修改、删除按钮及对应页面处理方法;已有新增入口和管理员导出保留。此页面调整不移除其他内部模块使用的服务方法,也不删除历史记录。
|
||
|
||
商户详情继续展示余额、账户、质押和代理信息,仅保留链上快照刷新操作,不显示资源估算、转账、质押、取消质押、代理、取消代理和广播。
|
||
|
||
上述资金及资源操作接口和估算接口要求独立 `system:address:operate` 权限;普通商户 `system:address:user-query` 不再授权这些接口。管理员操作角色如需执行,必须已有该权限。链上查询和代理详情继续允许查看权限,并执行钱包归属校验。
|
||
|
||
无需数据库结构或菜单迁移脚本。部署需同步更新前后端。
|