Files
usdt/docs/rental/app-workbench.md
T

4.1 KiB
Raw Blame History

租赁账户的应用工作台

入口:PROXY_ACCOUNT → 租赁应用(system/rentApp/user/index)。

  1. 无应用时显示创建引导;有应用时显示卡片列表及分页。
  2. 创建时填写名称及可选 HTTPS 默认回调地址,创建成功自动进入详情。
  3. 详情展示应用 ID、状态、默认回调、创建时间和凭证版本。
  4. 点击创建/轮换凭证,确认影响后,服务端为当前 APP 签发凭证;无需手工填写主体编号。
  5. API Secret 仅在成功响应的弹窗中展示一次,默认隐藏;确认安全保存后关闭,立即清除内存引用,不写缓存或日志。

签发会使旧 ACTIVE 凭证变为 VERIFY_ONLY,新请求须切换到新凭证。签发失败不自动重试,避免多次轮换。

接口与权限

接口 权限 说明
GET /rental/mine/app rent:portal:view 本人应用分页
POST /rental/register/app rent:app:create 或旧 rent:portal:register 归属取当前登录用户
GET /rental/app/{id} rent:portal:view 按当前用户校验应用归属,凭证显式选列,不返回 Secret
POST /rental/credential/issue rent:credential:issue owner_type 固定 APP,owner_id 为当前应用;后端再次校验归属

现有 sql/rent_role_permissions.sql 授予 PROXY_ACCOUNT 创建、查看、签发及删除权限,无新增表结构。已部署环境执行 sql/rent_app_remove_permission.sql 增量授权删除权限,执行后重新登录。

删除与时间显示(2026-10-25)

  • 应用详情时间统一返回 UTC 毫秒时间戳,页面按浏览器本地时区显示。前端兼容 ISO 与旧 UTC 日期文本;无效值显示 —,不会再显示全零时间。
  • 详情底部提供删除按钮和二次确认。DELETE /rental/app/{id} 需要 rent:app:remove(兼容旧 rent:portal:register)。
  • 删除只允许本人应用;任何状态订单及任何状态 APP 凭证(包括已过期、已吊销及 VERIFY_ONLY)均阻止删除,不自动清理关联。
  • 订单下的任务、退款、流水、回调等通过禁止删除有订单应用而受到保护。审计日志独立保留,并记录删除操作,不作为业务依赖阻止空应用删除。
  • 删除、下单、凭证签发共享应用行锁,先检查后删除在同一事务完成。旧生成器单个及批量删除入口同步复用此规则,整批失败回滚。

本轮验证:JDK8 Rental*Test 56项通过;ESLint、Vue模板编译、node tests/rental-app-time.mjs 时间回归通过。未执行数据库授权SQL及真实浏览器联调。

Secret 展示与凭证删除

  • 一次性 Secret 保持只读密码框,使用独立“显示/隐藏”按钮;修复 Element UI readonly 导致内置显隐按钮被隐藏的问题。每次签发重置为隐藏,关闭清空。
  • 凭证列表提供删除与二次确认,DELETE /rental/credential/{id} 复用 rent:credential:issue,无新增权限 SQL。
  • 仅允许本人 APP 凭证删除;有关联任务、回调或未过期 nonce 时拒绝。由于订单不记录请求凭证版本,有任何应用订单(包括已取消历史订单)也拒绝删除,应保留历史凭证、按需吊销。
  • 节点凭证禁止删除,继续使用吊销,避免丢失历史任务验签依据。旧生成器凭证删除入口同样复用业务校验。
  • 删除不清理审计,也不恢复原先已转 VERIFY_ONLY 的其他版本;删除后若无 ACTIVE 凭证,需主动重新签发。

本轮验证:后端 Rental*Test 57项通过,前端 ESLint 与模板编译通过;未进行实际登录浏览器验收。

验收:空列表引导、创建失败保留输入、创建后打开详情、取消轮换不签发、重复点击防重、一次性密钥确认、跨用户详情拒绝、窄屏布局。构建及隔离测试不替代真实登录浏览器联调。

本次验证

  • 页面及 API 文件 ESLint 通过,Vue 模板独立编译通过。
  • staging 全量构建成功;其他页面存在 3 项导出缺失及资源体积警告。
  • JDK8 后端 Rental*Test 共 55 项通过(0 失败),包含新增应用详情隔离测试。
  • 尚未连接实际 MySQL 或登录 PROXY_ACCOUNT 浏览器验收。