Files
usdt/docs/rental/role-dashboard.md
T

49 lines
5.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 供应商与租赁账户首页看板
两个角色首页只展示统计、图表和监控,不再嵌入节点/套餐操作列表,不新增内部菜单。业务管理统一使用框架菜单。供应商使用绿色点缀,租赁账户使用蓝色点缀;窄屏自动单列布局,图表跟随框架侧栏和窗口尺寸变化。
## 查询与隔离
`GET /rental/dashboard/{persona}?network=NILE&days=14`,persona仅允许supplier/account;days仅支持7、14、30,network仅支持NILE/MAINNET。复用rent:portal:view权限,不需要新增菜单授权。user_id始终来自当前登录会话,客户端不能指定他人身份;管理员也仅展示本人数据。persona仅切换本人供应/租赁视角,不授予操作权限。
服务使用只读REPEATABLE_READ事务聚合,不调用TRON、不创建账户、不调整业务状态。图表统计全部匹配记录,不使用通用列表的50条分页结果。没有业务数据时展示0和空图,没有订单时成功率展示“—”;未开户显示“未开通”,不会自动开户。
## 时间与网络
统计窗口为UTC今天及此前days-1天,截止本次查询时刻。前端明确标注UTC,日期零补齐。网络筛选隔离订单、账本、余额、钱包、任务及回调;应用和节点本身没有network字段,按本人跨网络展示并明确标注。
“核心区间订单/状态分布/订单趋势/资源租赁量”按订单创建日及当前状态聚合,因此历史订单核验后曲线可能变化。“净应收/净消费”按实际账本记账日统计,与订单创建日口径不同。余额、监控、最近订单均为当前状态,不受日期筛选限制;最近订单最多6条,节点健康最多8条且离线优先。
## 供应商
| 区域 | 口径 |
| --- | --- |
| 区间履约订单 | supplier_user_id等于当前登录用户,所选网络的已分配订单 |
| 区间成功率 | 当前SUCCESS数量/区间全部订单,含处理中/失败/取消的分母 |
| 净应收及趋势 | 本人所选网络账本SUPPLIER_EARN、SUPPLIER_FEE、REVERSAL的delta_supplier_pending合计,扣手续费及冲正,不把SETTLE转出当收入 |
| 待结算及余额 | 当前rent_account余额快照,与区间净应收不同 |
| 在线节点 | connection_status=ONLINE且heartbeat_expires_at晚于查询时刻;在线与审核/接单状态分别展示 |
| 有效快照资源 | 所选网络、ACTIVE且已验证钱包、快照未过期、快照区块不低于最小屏障,按资源启用开关分别汇总max(0,available) |
| 资源监控 | 非有效快照钱包、UNKNOWN任务、SUCCESS到期未DONE回收、履约或回收MANUAL_REVIEW订单 |
| 结算处理中 | PENDING、APPROVED、PAYING、UNKNOWN结算单数量 |
有效快照资源包含节点可能已离线的钱包,表示可信投影中的资源,不等于当前可调度容量;最终执行仍检查心跳、资源保留、额度和链上状态。能量Energy与带宽bytes绝不相加。
## 租赁账户
订单仅沿rent_order.app_id→rent_app.user_id归属查询,不与同用户供应商订单混合。净消费为CHARGE的-delta_frozen减REFUND的delta_available,不包含HOLD/RELEASE;退款来自早期订单时本期净消费可能为负。金额统一BigDecimal,响应返回6位十进制字符串,卡片按字符串展示;图表坐标使用近似数值,不用于账务计算。
当前租赁中为SUCCESS且服务未到期、回收未DONE;处理中为WAITING/EXECUTING/VERIFYING。人工核对包含履约或回收MANUAL_REVIEW。回调沿本人应用订单归属,DEAD为重试耗尽,PENDING/SENDING为待确认。应用启用状态、有效APP凭证数量、当前套餐网络和上架状态均单独展示,绝不返回Secret或签名。套餐绑定属于另一个网络时提示网络不匹配,不冒充可用套餐。
## 刷新与部署
默认每30秒刷新,可关闭并手动刷新。隐藏页面或离开缓存标签时暂停轮询,重新显示时刷新;网络/天数/角色切换使旧响应失效,防止串图。刷新失败保留上次成功数据及其更新时间,并展示错误提示;切换筛选失败不显示旧筛选数据。
不需要新增业务表或修改字段。全量初始化SQL已包含供应商订单、账户记账日期的索引;旧库可在维护窗口执行`sql/rent_dashboard_indexes.sql`增加两个只读看板索引,脚本可重复执行。未自动执行生产数据库DDL。
## 验证记录
JDK8下68项租赁测试通过,新增看板用例覆盖用户/角色/网络隔离、全量聚合、日期补齐、账务口径、心跳有效期、过期快照、资源非负、跨期退款负消费及历史监控告警。前端ESLint、Vue模板/CSS解析及staging完整构建通过,原有无关模块导出与包体积警告保留。
当前组件使用合成数据在Chrome渲染,供应商与租赁账户1440px桌面、租赁账户390px移动视口均通过三图渲染和无横向溢出检查,已人工查看预览;这不等同实际账号/数据库联调。未执行项目数据库DDL、RPC或真实广播。