OPC/chorus
2
0
Fork 0
Code Issues 11 Pull Requests Actions Packages Projects Releases Wiki Activity

design: 制作 MVP-1 管理端运营原型 #17

New Issue
Closed
opened 2026-08-21 14:29:49 +08:00 by ila · 1 comment
ila commented 2026-08-21 14:29:49 +08:00
Owner
Copy Link
Copy Source

基本信息

  • 类型：需求
  • 所属 Epic：#3
  • 所属 MVP / 版本：#19
  • 阶段：已完成

依赖与并行

  • 前置工单：#16
  • 是否允许与前置工单并行：否
  • 原因：原型必须使用已确认的数据、权限、状态和 API 边界。

子项目影响

  • 仅影响的子项目 / 交付单元：管理端设计证据；固定版本 go-admin/go-admin-ui
  • 是否跨子项目：否
  • 是否修改共享接口或契约：否；只消费已确认技术设计
  • 各子项目需要执行的验证：HTML 快照交互、响应式、权限和异常状态检查

原始需求

  • 来源：用户对话与已确认核心 Wiki
  • 提出时间：2026-08-21
  • 关键原话或脱敏摘要：用户确认进入 MVP-1，并确认先制作管理端原型，原型验收后再建立生产实现工单。

要解决什么

为固定 go-admin/go-admin-ui 技术基线下的 MVP-1 运营管理能力形成可浏览、可评审、可版本化的交互原型，明确标准 CRUD 与三个定制页面的操作、权限、状态和异常反馈。

做什么 / 不做什么

  • 做：代表性 CRUD 原型覆盖 providers、provider_models、prompt_templates、users；分别制作路由池编排、Provider 健康/连通性、生成记录详情；覆盖加载、空、错误、无权限、边界状态；API Key 仅写且不可回显；展示审计与冷却反馈；保存 prototypes/<工单号>/v1/index.html。
  • 不做：不写生产管理端代码；不调用真实 Provider；不展示明文密钥、真实用户输入或生产数据；不制作 MVP-2 的点数/API Key/openapi 页面。

已确认方案

严格复用锁定的 go-admin f065408...、go-admin-ui 67d393d... 和 Vue 3.5.41 + Element Plus 2.14.4 视觉与交互模式。标准 CRUD 用一个代表性原型覆盖同类页面，三个定制页分别完整覆盖主要状态。原型使用虚构脱敏数据和本地相对资源，用户确认前不得进入生产实现。

预计修改文件：

  • prototypes/<本工单号>/v1/index.html
  • prototypes/<本工单号>/v1/ 相对资源
  • Gitea 工单设计证据索引

需求变化记录

日期 变化内容 原因 用户确认
2026-08-21 将管理端原型作为 MVP-1 生产实现前置门禁 用户确认拆分方案 是

设计与原型门禁

  • 修改类型：新页面或独立用户功能 / 重大交互或导航
  • 所需设计证据：已确认原型
  • 可编辑设计源链接、版本或事实来源：Git HTML 交互稿，提交 2b1db13
  • 本地 HTML 审核快照路径和版本：prototypes/17/v1/index.html，v1
  • 本地浏览方式和资源完整性检查：直接打开 prototypes/17/v1/index.html；资源均为版本目录内相对路径，静态检查通过
  • 版本、revision 或确认日期：v1，2026-08-21，提交 2b1db13
  • 状态：已确认
  • 确认人、确认时间和覆盖范围：用户于 2026-08-21 验收确认 v1；覆盖工单列出的四类 CRUD、三个定制页和主要状态
  • 无需 UI 原型或无需任何原型的原因：不适用

文档影响

  • 不影响长期文档，原因：
  • 更新项目档案或本地开发与验证
  • 更新架构与代码地图
  • 更新业务规则与术语
  • 更新常见修改或故障排查
  • 更新其他 Wiki 页面：Product-Requirements-Overview（记录 v1 草稿路径与待验收状态）

交付文档影响

  • 无交付文档影响，原因：仅设计证据，尚未交付操作能力
  • 更新已有交付文档，受众与页面：
  • 新增交付文档，受众与页面：
  • 需要目标岗位或客户代表验证：是；验证方式：用户浏览 HTML 原型并确认覆盖范围

验收标准

  • 代表性 CRUD 与三个定制页均可从本地 HTML 入口访问。
  • Provider 密钥仅写不可回显，连通性测试明确为主动操作，并展示授权、审计、冷却和脱敏结果。
  • 加载、空、错误、无权限、边界状态完整，不包含真实凭据或生产数据。
  • 布局、组件和交互与锁定的 go-admin-ui 基线一致，常用操作支持键盘并有可访问名称。
  • 快照资源使用相对路径，入口和主要交互通过检查，用户明确确认 v1 后才允许拆生产实现工单。

验证方式

  • 本地浏览 prototypes/<本工单号>/v1/index.html。
  • 使用浏览器检查主要流程、权限和异常状态，并验证常用桌面宽度无重叠或文字溢出。
  • python dev_scripts/harness.py check --strict

风险和回退

  • 风险：脱离固定 go-admin-ui 组件与生成流程会增加生产实现成本；密钥和真实数据进入快照会泄露敏感信息。
  • 回退：v1 一经确认不原位覆盖；变化使用 v2 并重新确认。未确认版本不得作为生产依据。

实施与验证证据

  • 实现提交：2b1db13（已推送 origin/main）
  • 原型入口：prototypes/17/v1/index.html
  • 覆盖：providers、provider_models、prompt_templates、users 代表性 CRUD；路由池编排、Provider 健康/连通性、生成记录详情；加载、空、错误、无权限和边界状态。
  • 安全：仅使用虚构脱敏数据；API Key 只允许新值写入，已保存密钥仅显示 key_id/版本状态；无真实上游调用。
  • 验证：内联 JavaScript 语法、相对资源、页面/状态覆盖、图标映射、敏感字符串扫描、git diff --check 均通过；python dev_scripts/harness.py check --strict 通过；python -m unittest discover -s tests -v 共 42 项通过。
  • 未验证：Agent 当前会话没有可连接的浏览器实例，因此没有自动化截图或点击回放；用户已于 2026-08-21 明确验收通过。
  • 长期文档：Product-Requirements-Overview Wiki revision 9960fcd817cc474590232c80d6280487574eb8a9，镜像随提交 2b1db13 更新。
  • 当前状态：v1 已确认、工单已完成；后续结构或流程变化必须创建新版本并重新确认。

验收关闭证据

  • 用户于 2026-08-21 明确回复：#17 验收通过。
  • 验收文档提交：5c2cc8e，已推送 origin/main。
  • 任务归档 revision：92eb6164aa58b67c78b0e0620ea8f63996820611。
  • 任务归档未导出到 docs/task/。
## 基本信息 - 类型：需求 - 所属 Epic：#3 - 所属 MVP / 版本：#19 - 阶段：已完成 ## 依赖与并行 - 前置工单：#16 - 是否允许与前置工单并行：否 - 原因：原型必须使用已确认的数据、权限、状态和 API 边界。 ## 子项目影响 - 仅影响的子项目 / 交付单元：管理端设计证据；固定版本 go-admin/go-admin-ui - 是否跨子项目：否 - 是否修改共享接口或契约：否；只消费已确认技术设计 - 各子项目需要执行的验证：HTML 快照交互、响应式、权限和异常状态检查 ## 原始需求 - 来源：用户对话与已确认核心 Wiki - 提出时间：2026-08-21 - 关键原话或脱敏摘要：用户确认进入 MVP-1，并确认先制作管理端原型，原型验收后再建立生产实现工单。 ## 要解决什么 为固定 go-admin/go-admin-ui 技术基线下的 MVP-1 运营管理能力形成可浏览、可评审、可版本化的交互原型，明确标准 CRUD 与三个定制页面的操作、权限、状态和异常反馈。 ## 做什么 / 不做什么 - 做：代表性 CRUD 原型覆盖 providers、provider_models、prompt_templates、users；分别制作路由池编排、Provider 健康/连通性、生成记录详情；覆盖加载、空、错误、无权限、边界状态；API Key 仅写且不可回显；展示审计与冷却反馈；保存 `prototypes/<工单号>/v1/index.html`。 - 不做：不写生产管理端代码；不调用真实 Provider；不展示明文密钥、真实用户输入或生产数据；不制作 MVP-2 的点数/API Key/openapi 页面。 ## 已确认方案 严格复用锁定的 go-admin `f065408...`、go-admin-ui `67d393d...` 和 Vue 3.5.41 + Element Plus 2.14.4 视觉与交互模式。标准 CRUD 用一个代表性原型覆盖同类页面，三个定制页分别完整覆盖主要状态。原型使用虚构脱敏数据和本地相对资源，用户确认前不得进入生产实现。 预计修改文件： - `prototypes/<本工单号>/v1/index.html` - `prototypes/<本工单号>/v1/` 相对资源 - Gitea 工单设计证据索引 ## 需求变化记录 | 日期 | 变化内容 | 原因 | 用户确认 | |---|---|---|---| | 2026-08-21 | 将管理端原型作为 MVP-1 生产实现前置门禁 | 用户确认拆分方案 | 是 | ## 设计与原型门禁 - 修改类型：新页面或独立用户功能 / 重大交互或导航 - 所需设计证据：已确认原型 - 可编辑设计源链接、版本或事实来源：Git HTML 交互稿，提交 `2b1db13` - 本地 HTML 审核快照路径和版本：`prototypes/17/v1/index.html`，v1 - 本地浏览方式和资源完整性检查：直接打开 `prototypes/17/v1/index.html`；资源均为版本目录内相对路径，静态检查通过 - 版本、revision 或确认日期：v1，2026-08-21，提交 `2b1db13` - 状态：已确认 - 确认人、确认时间和覆盖范围：用户于 2026-08-21 验收确认 v1；覆盖工单列出的四类 CRUD、三个定制页和主要状态 - 无需 UI 原型或无需任何原型的原因：不适用 ## 文档影响 - [ ] 不影响长期文档，原因： - [ ] 更新项目档案或本地开发与验证 - [ ] 更新架构与代码地图 - [ ] 更新业务规则与术语 - [ ] 更新常见修改或故障排查 - [x] 更新其他 Wiki 页面：Product-Requirements-Overview（记录 v1 草稿路径与待验收状态） ## 交付文档影响 - [x] 无交付文档影响，原因：仅设计证据，尚未交付操作能力 - [ ] 更新已有交付文档，受众与页面： - [ ] 新增交付文档，受众与页面： - [x] 需要目标岗位或客户代表验证：是；验证方式：用户浏览 HTML 原型并确认覆盖范围 ## 验收标准 - [x] 代表性 CRUD 与三个定制页均可从本地 HTML 入口访问。 - [x] Provider 密钥仅写不可回显，连通性测试明确为主动操作，并展示授权、审计、冷却和脱敏结果。 - [x] 加载、空、错误、无权限、边界状态完整，不包含真实凭据或生产数据。 - [x] 布局、组件和交互与锁定的 go-admin-ui 基线一致，常用操作支持键盘并有可访问名称。 - [x] 快照资源使用相对路径，入口和主要交互通过检查，用户明确确认 v1 后才允许拆生产实现工单。 ## 验证方式 - 本地浏览 `prototypes/<本工单号>/v1/index.html`。 - 使用浏览器检查主要流程、权限和异常状态，并验证常用桌面宽度无重叠或文字溢出。 - `python dev_scripts/harness.py check --strict` ## 风险和回退 - 风险：脱离固定 go-admin-ui 组件与生成流程会增加生产实现成本；密钥和真实数据进入快照会泄露敏感信息。 - 回退：v1 一经确认不原位覆盖；变化使用 v2 并重新确认。未确认版本不得作为生产依据。 ## 实施与验证证据 - 实现提交：`2b1db13`（已推送 `origin/main`） - 原型入口：`prototypes/17/v1/index.html` - 覆盖：providers、provider_models、prompt_templates、users 代表性 CRUD；路由池编排、Provider 健康/连通性、生成记录详情；加载、空、错误、无权限和边界状态。 - 安全：仅使用虚构脱敏数据；API Key 只允许新值写入，已保存密钥仅显示 `key_id`/版本状态；无真实上游调用。 - 验证：内联 JavaScript 语法、相对资源、页面/状态覆盖、图标映射、敏感字符串扫描、`git diff --check` 均通过；`python dev_scripts/harness.py check --strict` 通过；`python -m unittest discover -s tests -v` 共 42 项通过。 - 未验证：Agent 当前会话没有可连接的浏览器实例，因此没有自动化截图或点击回放；用户已于 2026-08-21 明确验收通过。 - 长期文档：Product-Requirements-Overview Wiki revision `9960fcd817cc474590232c80d6280487574eb8a9`，镜像随提交 `2b1db13` 更新。 - 当前状态：v1 已确认、工单已完成；后续结构或流程变化必须创建新版本并重新确认。 ## 验收关闭证据 - 用户于 2026-08-21 明确回复：#17 验收通过。 - 验收文档提交：`5c2cc8e`，已推送 `origin/main`。 - 任务归档 revision：`92eb6164aa58b67c78b0e0620ea8f63996820611`。 - 任务归档未导出到 `docs/task/`。
ila commented 2026-08-21 15:22:05 +08:00
Author
Owner
Copy Link
Copy Source

待验收归档

  • 实现提交：2b1db13，已推送 origin/main。
  • 任务归档：Task-17-制作-MVP-1-管理端运营原型
  • 归档 revision：50a79c8d0a9e96b6c171df25958d0ec45826e93b
  • 核心需求 Wiki revision：31e7771f466dac3175c6d032ab598264eab04a73
  • docs/task/ 未导出；按规则仅在用户明确要求时导出任务归档。
  • 工单保持开启和“待验收”；浏览器截图、点击回放与多视口检查需在人工验收时完成。
## 待验收归档 - 实现提交：`2b1db13`，已推送 `origin/main`。 - 任务归档：[Task-17-制作-MVP-1-管理端运营原型](https://git.ilapage.cn/OPC/chorus/wiki/Task-17-%E5%88%B6%E4%BD%9C-MVP-1-%E7%AE%A1%E7%90%86%E7%AB%AF%E8%BF%90%E8%90%A5%E5%8E%9F%E5%9E%8B.-) - 归档 revision：`50a79c8d0a9e96b6c171df25958d0ec45826e93b` - 核心需求 Wiki revision：`31e7771f466dac3175c6d032ab598264eab04a73` - `docs/task/` 未导出；按规则仅在用户明确要求时导出任务归档。 - 工单保持开启和“待验收”；浏览器截图、点击回放与多视口检查需在人工验收时完成。
ila closed this issue 2026-08-21 15:30:23 +08:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
admin ila
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: OPC/chorus#17