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

design: 制作 MVP-1 用户端增强原型 #18

New Issue
Closed
opened 2026-08-21 14:29:50 +08:00 by ila · 2 comments
ila commented 2026-08-21 14:29:50 +08:00
Owner
Copy Link
Copy Source

基本信息

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

依赖与并行

  • 前置工单：#16
  • 是否允许与前置工单并行：否
  • 原因：原型必须使用已确认的 Prompt、图片角色和历史游标契约。

子项目影响

  • 仅影响的子项目 / 交付单元：portal/web 设计证据
  • 是否跨子项目：否
  • 是否修改共享接口或契约：否；只消费已确认技术设计
  • 各子项目需要执行的验证：HTML 快照主要流程、四视口、键盘和异常状态检查

原始需求

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

要解决什么

在 MVP-0 portal 基础上，为文生图、图片角色编辑、role_rule 覆盖、排序和生成历史无限滚动形成可浏览的交互原型，提前确认复杂输入与历史浏览在手机、平板和桌面的行为。

做什么 / 不做什么

  • 做：增加文生图模式；为每张输入图设计 role、note、顺序编辑；定义拖拽和上移/下移键盘等价操作；展示管理端默认→用户 role_rule→图片角色/备注的覆盖关系；设计历史无限滚动的加载、错误、重试和到底状态；覆盖 375/768/1024/1440。
  • 不做：不写生产 portal 代码；不改变既有认证、生成状态机和点数边界；不开放注册；不引入移动端历史抽屉或 MVP-2 能力；不使用真实用户数据或生成图片。

已确认方案

延续 MVP-0 已确认的 html/template + HTMX + Alpine + Tailwind 结构和视觉语言。图片项提供稳定尺寸、清晰角色/备注编辑与可访问排序；无限滚动失败时保留已有列表并允许重试，到底时明确结束；所有关键操作可键盘完成。完整 v1 快照由用户确认后才能拆生产实现工单。

预计修改文件：

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

需求变化记录

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

设计与原型门禁

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

文档影响

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

交付文档影响

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

验收标准

  • 文生图、图生图/编辑模式和输入边界清楚，不出现不可用入口。
  • 每图 role、note、顺序可编辑，拖拽具有上移/下移键盘等价操作。
  • role_rule 覆盖顺序和最终 Prompt 影响能够被用户理解和确认。
  • 历史无限滚动覆盖首次加载、增量加载、失败重试、空状态和到底状态，失败不清空已加载内容。
  • 375/768/1024/1440 无主区域横向滚动、遮挡和文字溢出，主要目标至少 44px，焦点与状态反馈可访问。
  • 快照资源使用相对路径，主要交互通过检查，用户明确确认 v1 后才允许拆生产实现工单。

验证方式

  • 本地浏览 prototypes/<本工单号>/v1/index.html。
  • 浏览器检查四视口、键盘排序、角色编辑、无限滚动的加载/错误/到底状态。
  • python dev_scripts/harness.py check --strict

风险和回退

  • 风险：复杂图片编辑挤压移动端空间或造成键盘不可用；无限滚动可能破坏历史定位和失败恢复。
  • 回退：v1 一经确认不原位覆盖；变化使用 v2 并重新确认。未确认版本不得作为生产依据。

实施与验证证据

  • 实现提交：ad7881b（已推送 origin/main）
  • 原型入口：prototypes/18/v1/index.html
  • 覆盖：文生图与图片编辑模式；用户 role_rule、每图 primary/reference/note/order；拖拽及上移/下移等价操作；最终 Prompt 覆盖解释；历史首次加载、增量加载、失败重试、空记录和到底状态。
  • 契约边界：图片编辑保留恰好一张主体图；图片顺序可调整；已加载历史在加载失败时保留；样例数据完全虚构，不含真实图片、用户数据或接口调用。
  • 验证：内联 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 7509e156eb74400f751931ceb9c02980b68aa46c，镜像随提交 ad7881b 更新。
  • 当前状态：v1 已确认、工单已完成；后续结构或流程变化必须创建新版本并重新确认。

验收关闭证据

  • 用户于 2026-08-21 明确回复：#18 验收通过。
  • 验收文档提交：6d62aea，已推送 origin/main。
  • 任务归档 revision：c766f5897e992d8053fcc22e41e3cae3c1be8a67。
  • 任务归档未导出到 docs/task/。
## 基本信息 - 类型：需求 - 所属 Epic：#3 - 所属 MVP / 版本：#19 - 阶段：已完成 ## 依赖与并行 - 前置工单：#16 - 是否允许与前置工单并行：否 - 原因：原型必须使用已确认的 Prompt、图片角色和历史游标契约。 ## 子项目影响 - 仅影响的子项目 / 交付单元：`portal/web` 设计证据 - 是否跨子项目：否 - 是否修改共享接口或契约：否；只消费已确认技术设计 - 各子项目需要执行的验证：HTML 快照主要流程、四视口、键盘和异常状态检查 ## 原始需求 - 来源：用户对话与已确认核心 Wiki - 提出时间：2026-08-21 - 关键原话或脱敏摘要：用户确认进入 MVP-1，并确认先制作用户端原型，原型验收后再建立生产实现工单。 ## 要解决什么 在 MVP-0 portal 基础上，为文生图、图片角色编辑、role_rule 覆盖、排序和生成历史无限滚动形成可浏览的交互原型，提前确认复杂输入与历史浏览在手机、平板和桌面的行为。 ## 做什么 / 不做什么 - 做：增加文生图模式；为每张输入图设计 role、note、顺序编辑；定义拖拽和上移/下移键盘等价操作；展示管理端默认→用户 role_rule→图片角色/备注的覆盖关系；设计历史无限滚动的加载、错误、重试和到底状态；覆盖 375/768/1024/1440。 - 不做：不写生产 portal 代码；不改变既有认证、生成状态机和点数边界；不开放注册；不引入移动端历史抽屉或 MVP-2 能力；不使用真实用户数据或生成图片。 ## 已确认方案 延续 MVP-0 已确认的 html/template + HTMX + Alpine + Tailwind 结构和视觉语言。图片项提供稳定尺寸、清晰角色/备注编辑与可访问排序；无限滚动失败时保留已有列表并允许重试，到底时明确结束；所有关键操作可键盘完成。完整 v1 快照由用户确认后才能拆生产实现工单。 预计修改文件： - `prototypes/<本工单号>/v1/index.html` - `prototypes/<本工单号>/v1/` 相对资源 - Gitea 工单设计证据索引 ## 需求变化记录 | 日期 | 变化内容 | 原因 | 用户确认 | |---|---|---|---| | 2026-08-21 | 将用户端 MVP-1 原型作为生产实现前置门禁 | 用户确认拆分方案 | 是 | ## 设计与原型门禁 - 修改类型：新页面或独立用户功能 / 重大交互 - 所需设计证据：已确认原型 - 可编辑设计源链接、版本或事实来源：Git HTML 交互稿，提交 `ad7881b` - 本地 HTML 审核快照路径和版本：`prototypes/18/v1/index.html`，v1 - 本地浏览方式和资源完整性检查：直接打开 `prototypes/18/v1/index.html`；资源均为版本目录内相对路径，静态检查通过 - 版本、revision 或确认日期：v1，2026-08-21，提交 `ad7881b` - 状态：已确认 - 确认人、确认时间和覆盖范围：用户于 2026-08-21 验收确认 v1；覆盖工单列出的文生图、图片编辑、role_rule、排序和历史状态 - 无需 UI 原型或无需任何原型的原因：不适用 ## 文档影响 - [ ] 不影响长期文档，原因： - [ ] 更新项目档案或本地开发与验证 - [ ] 更新架构与代码地图 - [ ] 更新业务规则与术语 - [ ] 更新常见修改或故障排查 - [x] 更新其他 Wiki 页面：Product-Requirements-Overview（记录 v1 草稿路径与待验收状态） ## 交付文档影响 - [x] 无交付文档影响，原因：仅设计证据，尚未交付操作能力 - [ ] 更新已有交付文档，受众与页面： - [ ] 新增交付文档，受众与页面： - [x] 需要目标岗位或客户代表验证：是；验证方式：用户浏览 HTML 原型并确认流程、状态和响应式覆盖 ## 验收标准 - [x] 文生图、图生图/编辑模式和输入边界清楚，不出现不可用入口。 - [x] 每图 role、note、顺序可编辑，拖拽具有上移/下移键盘等价操作。 - [x] role_rule 覆盖顺序和最终 Prompt 影响能够被用户理解和确认。 - [x] 历史无限滚动覆盖首次加载、增量加载、失败重试、空状态和到底状态，失败不清空已加载内容。 - [x] 375/768/1024/1440 无主区域横向滚动、遮挡和文字溢出，主要目标至少 44px，焦点与状态反馈可访问。 - [x] 快照资源使用相对路径，主要交互通过检查，用户明确确认 v1 后才允许拆生产实现工单。 ## 验证方式 - 本地浏览 `prototypes/<本工单号>/v1/index.html`。 - 浏览器检查四视口、键盘排序、角色编辑、无限滚动的加载/错误/到底状态。 - `python dev_scripts/harness.py check --strict` ## 风险和回退 - 风险：复杂图片编辑挤压移动端空间或造成键盘不可用；无限滚动可能破坏历史定位和失败恢复。 - 回退：v1 一经确认不原位覆盖；变化使用 v2 并重新确认。未确认版本不得作为生产依据。 ## 实施与验证证据 - 实现提交：`ad7881b`（已推送 `origin/main`） - 原型入口：`prototypes/18/v1/index.html` - 覆盖：文生图与图片编辑模式；用户 `role_rule`、每图 primary/reference/note/order；拖拽及上移/下移等价操作；最终 Prompt 覆盖解释；历史首次加载、增量加载、失败重试、空记录和到底状态。 - 契约边界：图片编辑保留恰好一张主体图；图片顺序可调整；已加载历史在加载失败时保留；样例数据完全虚构，不含真实图片、用户数据或接口调用。 - 验证：内联 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 `7509e156eb74400f751931ceb9c02980b68aa46c`，镜像随提交 `ad7881b` 更新。 - 当前状态：v1 已确认、工单已完成；后续结构或流程变化必须创建新版本并重新确认。 ## 验收关闭证据 - 用户于 2026-08-21 明确回复：#18 验收通过。 - 验收文档提交：`6d62aea`，已推送 `origin/main`。 - 任务归档 revision：`c766f5897e992d8053fcc22e41e3cae3c1be8a67`。 - 任务归档未导出到 `docs/task/`。
ila commented 2026-08-21 15:50:39 +08:00
Author
Owner
Copy Link
Copy Source

待验收归档

  • 实现提交：ad7881b，已推送 origin/main。
  • 任务归档：Task-18-制作-MVP-1-用户端增强原型
  • 归档 revision：2a0a89cfc2d6db93b8d232974052a917dbf36457
  • 核心需求 Wiki revision：7ab9ea6554dcf94e4d337a43aa28dc739d62cae8
  • docs/task/ 未导出；按规则仅在用户明确要求时导出任务归档。
  • 工单保持开启和“待验收”；真实浏览器截图、四视口回放、键盘排序回放和视觉检查需在人工验收时完成。
## 待验收归档 - 实现提交：`ad7881b`，已推送 `origin/main`。 - 任务归档：[Task-18-制作-MVP-1-用户端增强原型](https://git.ilapage.cn/OPC/chorus/wiki/Task-18-%E5%88%B6%E4%BD%9C-MVP-1-%E7%94%A8%E6%88%B7%E7%AB%AF%E5%A2%9E%E5%BC%BA%E5%8E%9F%E5%9E%8B.-) - 归档 revision：`2a0a89cfc2d6db93b8d232974052a917dbf36457` - 核心需求 Wiki revision：`7ab9ea6554dcf94e4d337a43aa28dc739d62cae8` - `docs/task/` 未导出；按规则仅在用户明确要求时导出任务归档。 - 工单保持开启和“待验收”；真实浏览器截图、四视口回放、键盘排序回放和视觉检查需在人工验收时完成。
ila closed this issue 2026-08-21 15:59:35 +08:00
ila commented 2026-08-21 16:02:18 +08:00
Author
Owner
Copy Link
Copy Source

最终状态同步

  • #18 已关闭；用户于 2026-08-21 明确验收通过。
  • 验收文档提交：6d62aea；MVP-1 进入待实施阶段的文档提交：17ea925，均已推送 origin/main。
  • 最终核心需求 Wiki revision：dc1791d3b3e306908bef9cb91f6f2f332c915c0c。
  • 任务归档 revision：c766f5897e992d8053fcc22e41e3cae3c1be8a67；docs/task/ 未导出。
  • #19 的技术设计与两份原型门禁均已完成，但生产实现单元工单尚未建立。
## 最终状态同步 - #18 已关闭；用户于 2026-08-21 明确验收通过。 - 验收文档提交：`6d62aea`；MVP-1 进入待实施阶段的文档提交：`17ea925`，均已推送 `origin/main`。 - 最终核心需求 Wiki revision：`dc1791d3b3e306908bef9cb91f6f2f332c915c0c`。 - 任务归档 revision：`c766f5897e992d8053fcc22e41e3cae3c1be8a67`；`docs/task/` 未导出。 - #19 的技术设计与两份原型门禁均已完成，但生产实现单元工单尚未建立。
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#18