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

5.8 KiB

供应商与租赁账户:首页及接口权限

角色编码严格区分大小写:供应商为 PROXY_SUPPLIER,购买资源的租赁账户为 PROXY_ACCOUNT。登录后的 /index 根据角色展示首页,同时拥有两种角色时可切换;其他用户保留支付首页。菜单入口分别为 /rental/supplier、/rental/account-home。

安装 SQL

先执行 rent_menu.sql,再执行 rent_role_permissions.sql。后者包含角色、首页菜单、细分按钮权限和 sys_role_menu 关联插入,可重复执行,不给任何用户自动绑定角色。请通过若依用户管理分配角色,重新登录以刷新权限。

脚本保留原角色状态、已有授权及用户绑定,不自动恢复停用/软删除角色。已有角色若含运营或历史通用注册权限,应通过角色管理复核,插入脚本不会删除原授权。脚本末尾提供实际授权查询。

角色权限及对应接口

权限 接口 供应商 租赁账户
rent:supplier:home 供应商首页菜单(无独立HTTP统计接口) 是 否
rent:account:home 租赁账户首页菜单(无独立HTTP统计接口) 否 是
rent:portal:view GET /rental/mine/{resource}?page=1 是 是
rent:node:create POST /rental/register/node 是 否
rent:wallet:create POST /rental/register/wallet 是 否
rent:wallet:bind POST /rental/wallet/{id}/challenge、prove、policy 是 否
rent:app:create POST /rental/register/app 否 是
rent:account:open POST /rental/account/open 是 是
rent:credential:issue POST /rental/credential/issue、/credential/{id}/revoke 是 是
rent:order:create POST /rental/order、/order/{id}/cancel 否 是

查询权限覆盖本人关联记录,仍由服务端检查归属;供应节点和应用凭证也只能操作本人主体。角色首页按业务侧重点展示不同标签,查询返回分页实际记录,不把最近50条伪装成全量统计。

供应商首页包含节点、钱包、任务、履约订单、收入账户、流水、结算记录及凭证。本人资金账户页按所选网络展示单个账户详情,不再展示账户列表;没有账户时引导创建。供应商可主动开通账户,派单时仍会自动创建或复用,不需要商户应用。租赁账户首页包含套餐、订单、应用、账户、流水、退款记录及凭证。

一个供应商在同一网络对应一个账户,主网和测试网独立,不能合并余额。开户接口从登录态取得用户ID,以 user_id + network 唯一约束和幂等插入避免重复创建。页面默认主网,可切换NILE;加载失败时提示重试,不将请求失败误判为没有账户。运营全体账户管理页继续保留列表。

已有部署需执行 供应商开户增量授权,或重新执行更新后的 rent_role_permissions.sql,再重新登录;未获开户权限时页面提示联系管理员。新授权仅能开通本人零余额账户,不能设置余额或为他人开户。

两个角色均不授予 rent:manage:*、rent:account:topup、rent:refund:create、rent:refund:approve、rent:settlement:create、rent:settlement:approve、rent:package:edit。充值审核、退款申请/审批、结算申请/审批及付款由独立运营财务角色处理。外部商户API与Agent WSS分别使用APP/NODE HMAC凭证,不使用若依菜单权限替代协议认证。

旧 rent:portal:register 保留兼容既有运营配置;新角色脚本不授予此宽权限,前端根据细分权限显示创建按钮。未执行本脚本或未获 rent:portal:view 时,首页提示联系管理员,不调用支付统计接口。

本次验证

供应商通过旧 system/rentNode/index 菜单进入时,页面自动使用本人节点视图,提供“注册供应节点”;运营仍使用全体审核列表。注册填写最长100字符节点名称,调用 POST /rental/register/node,后端生成节点编号、绑定当前登录用户并设为PENDING。审核通过后再绑定钱包、签发NODE凭证并连接Agent。无 rent:node:create(或兼容注册权限)时显示授权提示;可重新执行 rent_role_permissions.sql 补齐角色授权并重新登录,无需新增业务接口或修改表结构。

供应商本人资金账户详情新增“Agent API 凭证”区域:选择本人供应节点,生成或轮换NODE凭证。复用 POST /rental/credential/issue,要求 rent:credential:issue,服务端继续校验节点归属;不在 rent_account 增加Secret字段。凭证属于节点,不随资金账户网络切换。无节点时引导先注册节点,无权限时提示管理员授权。

生成前提示旧凭证转为VERIFY_ONLY;生成后弹窗仅本次展示API_KEY/API_SECRET,支持分别复制及复制包含节点ID、编号的本地Agent配置,关闭确认后清空组件内存。Secret不写浏览器持久存储,不支持历史查看;轮换时用户需保留旧凭证到本机RENT_OLD_KEYS。复制使用浏览器安全剪贴板,不支持时提示手动复制。

JDK8下租赁业务23项测试通过;新增2项权限测试从真实控制器注解读取并执行SpEL,验证应用、节点、钱包创建权限隔离及旧权限兼容。新页面ESLint通过,生产构建通过。构建仍提示其他模块既有的3处API导出缺失、Browserslist数据过旧及资源体积警告,未将其扩大为本次修改范围。

未对真实数据库执行权限SQL,未绑定实际用户角色,尚需部署环境验证登录后的菜单及页面操作。数据库权限更新后应重新登录,避免使用旧会话权限。