42 lines
3.1 KiB
Markdown
42 lines
3.1 KiB
Markdown
# 租赁账户的应用工作台
|
||
|
||
入口: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及真实浏览器联调。
|
||
|
||
验收:空列表引导、创建失败保留输入、创建后打开详情、取消轮换不签发、重复点击防重、一次性密钥确认、跨用户详情拒绝、窄屏布局。构建及隔离测试不替代真实登录浏览器联调。
|
||
|
||
## 本次验证
|
||
|
||
- 页面及 API 文件 ESLint 通过,Vue 模板独立编译通过。
|
||
- staging 全量构建成功;其他页面存在 3 项导出缺失及资源体积警告。
|
||
- JDK8 后端 Rental*Test 共 55 项通过(0 失败),包含新增应用详情隔离测试。
|
||
- 尚未连接实际 MySQL 或登录 PROXY_ACCOUNT 浏览器验收。
|