5.0 KiB
供应商与租赁账户首页看板
两个角色首页只展示统计、图表和监控,不再嵌入节点/套餐操作列表,不新增内部菜单。业务管理统一使用框架菜单。供应商使用绿色点缀,租赁账户使用蓝色点缀;窄屏自动单列布局,图表跟随框架侧栏和窗口尺寸变化。
查询与隔离
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或真实广播。