Clone
3
Task-37-MVP-2-API-Key页面原型
ila edited this page 2026-08-24 11:48:00 +08:00
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.

37 MVP-2 API Key 页面原型

  • 类型:UI 原型设计
  • 所属 Epic:#3
  • 所属 MVP / 版本:#35 / MVP-2
  • 状态:已完成
  • 日期:2026-08-24
  • Gitea 工单:#37
  • Wiki 页面:Task-37-MVP-2-API-Key页面原型

背景与目标

为现有受控用户和管理员提供可审阅的 API Key 生命周期页面,确认一次性显示、不可恢复撤销、权限边界与异常状态后再进入生产实现。

最终方案

单一离线 HTML 入口在用户端与管理端之间切换。用户端覆盖列表、OpenAPI 快速入口、创建、可选到期、一次性显示/复制、撤销和加载/空/错误/无权限/限流状态;管理端覆盖元数据筛选、详情、脱敏审计摘要、撤销和加载/空/错误/无权限状态。管理员页面从不显示完整 Key,示例内容均为不可用的虚构数据。

修改文件

  • prototypes/37/v1/index.html:交互原型和响应式状态。
  • prototypes/37/v1/icons.min.js:版本目录内的相对 Lucide 图标资源。
  • docs/09-product-requirements-overview.md:原型路径、状态和审核门禁索引。

验收结果

验收标准 结果
用户端、管理端、一次性显示、撤销与关键状态可切换 通过
管理端只显示元数据并提供详情/脱敏审计摘要 通过
HTML 相对资源、唯一 id、脚本语法和差异格式 通过
375/768/1024/1440 浏览器截图及真实交互 未验证:浏览器连接不可用
用户明确确认 v1 通过(2026-08-24)

测试

  • 执行命令:内联 JavaScript 提取后 node --check -。
  • 结果:通过。
  • 执行命令:Python HTMLParser 检查唯一 id 和相对资源。
  • 结果:35 个唯一 id、1 个本地资源引用,全部通过。
  • 执行命令:git diff --check、python dev_scripts/harness.py check --strict。
  • 结果:通过。
  • 未验证部分:当前浏览器运行环境无可用实例,未生成多视口截图,也未把真实浏览器交互写成通过;未改生产前端或后端。

遗留问题

用户已确认 prototypes/37/v1/index.html。浏览器可用时仍可补测多视口;页面结构、权限或流程若变化则新建 v2,不能覆盖已确认 v1。

相关提交

  • 875f5b0 docs: 完成 MVP-2 技术设计与原型 (#36 #37)

人工验收

  • 验收人:用户
  • 验收时间:2026-08-24
  • 结果:#37 v1 原型验收通过。自动多视口截图在制作阶段未执行,历史验证结果保持不变。