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

增加Quant-UX原型本地HTML审核快照 #21

New Issue
Closed
opened 2026-08-17 14:49:15 +08:00 by ila · 0 comments
ila commented 2026-08-17 14:49:15 +08:00
Owner
Copy Link
Copy Source

基本信息

  • 类型：单元任务
  • 状态：已完成
  • 所属 Epic：无
  • 所属 MVP / 版本：无

依赖与并行

  • 前置工单：#19
  • 是否允许与前置工单并行：否
  • 原因：本任务扩展 #19 已完成的 UI 原型门禁；#19 已验收关闭。

原始需求

  • 来源：用户与 Agent 对话
  • 提出时间：2026-08-17
  • 关键原话或脱敏摘要：“用quantux生成原型设计图后再导出到本地html文件，因为线上的原型很不好浏览”；用户确认按建议建工单并实施。

要解决什么

当前规则要求重大 UI 需求先制作并确认 Quant-UX 等原型，只笼统允许在 Git 保存 HTML 快照，没有规定审核前必须生成本地可浏览 HTML、目录结构、事实来源边界和重新导出条件。

做什么 / 不做什么

做

  • 规定新页面、独立用户功能、重大交互或导航原型在审核前生成本地可浏览 HTML 快照。
  • 约定路径 prototypes/<工单号>/<版本>/index.html，资源使用相对路径。
  • 区分 Quant-UX 等可编辑设计源、Git HTML 审核快照、Wiki/工单索引三类事实来源。
  • 工单记录设计源链接、HTML 路径、版本、状态、确认人和覆盖范围。
  • 关键变化后使用新版本目录重新导出并重新确认，不覆盖已确认版本。
  • 规定纯显示文案、小范围 UI、非 UI 需求不强制 HTML 导出。
  • 增加脱敏、凭据、生产数据和导出完整性检查。
  • 更新 AGENTS、Development-Workflow、Product-Requirements-Overview、单元任务模板、Harness 检查和测试。

不做

  • 不创建空 prototypes/ 目录、示例原型或占位 HTML。
  • 不新增 Quant-UX 集成、导出脚本或第三方依赖。
  • 不把 HTML 原型放入 Wiki 镜像目录 docs/。
  • 不修改产品 UI。

已确认方案

Quant-UX 或等效工具保留可编辑设计源；待审核版本生成本地可浏览 HTML，提交到 prototypes/<工单号>/<版本>/，用户优先审核该快照。Wiki 和工单只保存索引与确认记录。关键变更创建新版本快照并重新确认。

文档影响

  • 更新其他 Wiki：Development-Workflow、Product-Requirements-Overview
  • 更新仓库规则：AGENTS.md
  • 更新工单模板和 Harness 检查

交付文档影响

  • 无交付文档影响，原因：HTML 原型是内部设计审核证据，不是客户交付文档。

设计与原型门禁

  • 修改类型：流程规则
  • 所需设计证据：用户已确认的 HTML 原型审核流程
  • 无需 UI 原型原因：本任务不修改产品界面。

验收标准

  • 重大 UI 原型在用户审核前需要本地可浏览 HTML 快照。
  • 快照路径和版本规则明确，资源使用相对路径。
  • 可编辑设计源、Git HTML 快照、Wiki/工单索引边界明确。
  • 工单模板记录设计源和本地 HTML 路径。
  • 关键变化创建新版本、重新导出和重新确认，不覆盖已确认版本。
  • 纯文字、小范围 UI 和非 UI 需求不被强制导出 HTML。
  • 明确脱敏、凭据、生产数据和浏览完整性检查。
  • 未创建空原型目录、示例 HTML、导出脚本或依赖。
  • Wiki 回读、镜像、严格检查和单元测试通过。
  • 提交推送并建立在线任务归档。
  • 工单保持待验收。

验证方式

  • python dev_scripts/check_harness.py --strict
  • python -m unittest discover -s tests -v
  • python dev_scripts/sync_wiki_docs.py --check
  • git diff --check
  • 人工代入：重大 UI、纯文字、小范围 UI、关键原型变更四种场景。

风险和回退

  • 风险：把 HTML 快照误认为可编辑设计源；通过事实来源边界区分。
  • 风险：每个小改动都生成快照；仅强制重大 UI 门禁。
  • 风险：覆盖已确认版本导致证据漂移；新版本使用独立目录。
  • 风险：导出物泄露数据；提交前脱敏并检查凭据和生产数据。
  • 回退：移除本次 HTML 快照规则和模板字段，不影响产品代码或数据。

实施与验证证据

  • 实现提交：51a7c8b；Wiki revision 同步提交：6f941e1；待验收镜像提交：56d1bc6，均已推送到 origin/main。
  • Development-Workflow revision：de2246483928433173f67cfe88a8473af874f0d0。
  • Product-Requirements-Overview revision：bcfdcf8ed2068f4c80beb1f494e48b4f395f2450。
  • Task-21 归档 revision：ff606baef69c814d869f1c6dca537011aa5fd8d2；按 #14 规则仅保留在线 Wiki。
  • python dev_scripts/check_harness.py --strict：通过。
  • python -m unittest discover -s tests -v：40 项全部通过。
  • python dev_scripts/sync_wiki_docs.py --check：14 个核心页面一致。
  • git diff --check：通过。
  • 人工代入重大 UI、纯文字、小范围 UI 和关键原型变更：均有明确导出要求或豁免边界。
  • 未验证：没有实际产品 UI，未创建或导出 Quant-UX 原型，也未验证具体 Quant-UX 项目的导出兼容性。

当前状态：已完成。工单保持开启，等待用户明确验收。

验收关闭记录

  • 用户确认：通过验收 #21
  • 验收日期：2026-08-17
  • Product-Requirements-Overview revision：a81830c1b5ef57b2cb68bf4a1afe7b89ee5b927f
  • Task-21 最终归档 revision：de39de8a776374d6e83c901cf94f35bec1e61e38
  • 验收归档镜像提交：cdf83fd
  • 父工单：无，无需同步 MVP 或 Epic
## 基本信息 - 类型：单元任务 - 状态：已完成 - 所属 Epic：无 - 所属 MVP / 版本：无 ## 依赖与并行 - 前置工单：#19 - 是否允许与前置工单并行：否 - 原因：本任务扩展 #19 已完成的 UI 原型门禁；#19 已验收关闭。 ## 原始需求 - 来源：用户与 Agent 对话 - 提出时间：2026-08-17 - 关键原话或脱敏摘要：“用quantux生成原型设计图后再导出到本地html文件，因为线上的原型很不好浏览”；用户确认按建议建工单并实施。 ## 要解决什么 当前规则要求重大 UI 需求先制作并确认 Quant-UX 等原型，只笼统允许在 Git 保存 HTML 快照，没有规定审核前必须生成本地可浏览 HTML、目录结构、事实来源边界和重新导出条件。 ## 做什么 / 不做什么 ### 做 - 规定新页面、独立用户功能、重大交互或导航原型在审核前生成本地可浏览 HTML 快照。 - 约定路径 `prototypes/<工单号>/<版本>/index.html`，资源使用相对路径。 - 区分 Quant-UX 等可编辑设计源、Git HTML 审核快照、Wiki/工单索引三类事实来源。 - 工单记录设计源链接、HTML 路径、版本、状态、确认人和覆盖范围。 - 关键变化后使用新版本目录重新导出并重新确认，不覆盖已确认版本。 - 规定纯显示文案、小范围 UI、非 UI 需求不强制 HTML 导出。 - 增加脱敏、凭据、生产数据和导出完整性检查。 - 更新 AGENTS、Development-Workflow、Product-Requirements-Overview、单元任务模板、Harness 检查和测试。 ### 不做 - 不创建空 `prototypes/` 目录、示例原型或占位 HTML。 - 不新增 Quant-UX 集成、导出脚本或第三方依赖。 - 不把 HTML 原型放入 Wiki 镜像目录 `docs/`。 - 不修改产品 UI。 ## 已确认方案 Quant-UX 或等效工具保留可编辑设计源；待审核版本生成本地可浏览 HTML，提交到 `prototypes/<工单号>/<版本>/`，用户优先审核该快照。Wiki 和工单只保存索引与确认记录。关键变更创建新版本快照并重新确认。 ## 文档影响 - [x] 更新其他 Wiki：Development-Workflow、Product-Requirements-Overview - [x] 更新仓库规则：AGENTS.md - [x] 更新工单模板和 Harness 检查 ## 交付文档影响 - [x] 无交付文档影响，原因：HTML 原型是内部设计审核证据，不是客户交付文档。 ## 设计与原型门禁 - 修改类型：流程规则 - 所需设计证据：用户已确认的 HTML 原型审核流程 - 无需 UI 原型原因：本任务不修改产品界面。 ## 验收标准 - [x] 重大 UI 原型在用户审核前需要本地可浏览 HTML 快照。 - [x] 快照路径和版本规则明确，资源使用相对路径。 - [x] 可编辑设计源、Git HTML 快照、Wiki/工单索引边界明确。 - [x] 工单模板记录设计源和本地 HTML 路径。 - [x] 关键变化创建新版本、重新导出和重新确认，不覆盖已确认版本。 - [x] 纯文字、小范围 UI 和非 UI 需求不被强制导出 HTML。 - [x] 明确脱敏、凭据、生产数据和浏览完整性检查。 - [x] 未创建空原型目录、示例 HTML、导出脚本或依赖。 - [x] Wiki 回读、镜像、严格检查和单元测试通过。 - [x] 提交推送并建立在线任务归档。 - [x] 工单保持待验收。 ## 验证方式 - `python dev_scripts/check_harness.py --strict` - `python -m unittest discover -s tests -v` - `python dev_scripts/sync_wiki_docs.py --check` - `git diff --check` - 人工代入：重大 UI、纯文字、小范围 UI、关键原型变更四种场景。 ## 风险和回退 - 风险：把 HTML 快照误认为可编辑设计源；通过事实来源边界区分。 - 风险：每个小改动都生成快照；仅强制重大 UI 门禁。 - 风险：覆盖已确认版本导致证据漂移；新版本使用独立目录。 - 风险：导出物泄露数据；提交前脱敏并检查凭据和生产数据。 - 回退：移除本次 HTML 快照规则和模板字段，不影响产品代码或数据。 ## 实施与验证证据 - 实现提交：`51a7c8b`；Wiki revision 同步提交：`6f941e1`；待验收镜像提交：`56d1bc6`，均已推送到 `origin/main`。 - Development-Workflow revision：`de2246483928433173f67cfe88a8473af874f0d0`。 - Product-Requirements-Overview revision：`bcfdcf8ed2068f4c80beb1f494e48b4f395f2450`。 - Task-21 归档 revision：`ff606baef69c814d869f1c6dca537011aa5fd8d2`；按 #14 规则仅保留在线 Wiki。 - `python dev_scripts/check_harness.py --strict`：通过。 - `python -m unittest discover -s tests -v`：40 项全部通过。 - `python dev_scripts/sync_wiki_docs.py --check`：14 个核心页面一致。 - `git diff --check`：通过。 - 人工代入重大 UI、纯文字、小范围 UI 和关键原型变更：均有明确导出要求或豁免边界。 - 未验证：没有实际产品 UI，未创建或导出 Quant-UX 原型，也未验证具体 Quant-UX 项目的导出兼容性。 当前状态：已完成。工单保持开启，等待用户明确验收。 ## 验收关闭记录 - 用户确认：通过验收 #21 - 验收日期：2026-08-17 - Product-Requirements-Overview revision：`a81830c1b5ef57b2cb68bf4a1afe7b89ee5b927f` - Task-21 最终归档 revision：`de39de8a776374d6e83c901cf94f35bec1e61e38` - 验收归档镜像提交：`cdf83fd` - 父工单：无，无需同步 MVP 或 Epic
ila closed this issue 2026-08-17 15:24:30 +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/dev_harness#21