docs: 完成任务 #19 归档
@@ -1,42 +1,68 @@
|
||||
# 19 UI原型确认与文字修改双门禁
|
||||
|
||||
- 类型:需求 / 缺陷 / 重构
|
||||
- 所属 Epic:#
|
||||
- 所属 MVP / 版本:#
|
||||
- 状态:待验收 / 已完成
|
||||
- 类型:流程文档
|
||||
- 状态:待验收
|
||||
- 日期:2026-08-17
|
||||
- Gitea 工单:https://git.ilapage.cn/OPC/dev_harness/issues/19
|
||||
- Wiki 页面:Task-19-UI原型确认与文字修改双门禁
|
||||
- Wiki revision:见本地镜像头
|
||||
- 本地镜像:按 #14 规则不自动导出
|
||||
|
||||
## 背景与目标
|
||||
|
||||
<!-- 原来有什么问题,这次达到什么结果。 -->
|
||||
把界面决策前置,减少 Agent 在正式代码上的反复修改和 Token 消耗;同时避免给后端任务、小范围调整和纯显示文案制作无意义的高保真原型。
|
||||
|
||||
## 最终方案
|
||||
|
||||
<!-- 说明实际实现。与建单方案不同之处必须写清原因。 -->
|
||||
- 建立“是否需要工单”和“需要什么设计证据”两个独立门禁。
|
||||
- 纯显示文案只有同时满足语义、流程、权限、状态、接口、高风险文字、国际化、程序标识符、布局和可访问性等全部豁免条件时,才免工单、免原型。
|
||||
- 代码组件名、类名、变量、国际化键、API 字段和数据库字段不属于显示文案。
|
||||
- 新页面、独立用户功能、重大交互或导航变化必须先用 Quant-UX 或其他合适工具制作原型,并经用户确认后才能编写生产代码。
|
||||
- 小范围 UI 使用标注截图或低保真图;新组件记录状态和边界;非 UI 需求使用架构、API、数据、状态或流程设计。
|
||||
- 恢复既有确认行为的 Bug 可以复用原设计、截图、复现步骤或已有验收证据。
|
||||
- 原型关键变化必须更新并重新确认。
|
||||
- 工单模板固定记录修改类型、证据、版本、状态、确认人和覆盖范围。
|
||||
|
||||
## 修改文件
|
||||
|
||||
- `<文件>`:<改动说明>
|
||||
- `AGENTS.md`:增加显示文案豁免和设计证据门禁。
|
||||
- `.gitea/issue_template/task.md`:增加“设计与原型门禁”字段。
|
||||
- `docs/01-workflow.md`:导出双门禁执行流程。
|
||||
- `docs/09-product-requirements-overview.md`:导出原型门禁、记录要求和判断表。
|
||||
- `dev_scripts/check_harness.py`:检查 Agent 规则、工单字段和 Wiki 章节。
|
||||
- `tests/test_harness_docs.py`:增加双门禁测试。
|
||||
|
||||
## 验收结果
|
||||
|
||||
| 验收标准 | 结果 |
|
||||
|---|---|
|
||||
| | 通过 / 未通过 |
|
||||
| 显示文案豁免条件明确 | 通过 |
|
||||
| 完整独立 UI 需求先确认原型再编码 | 通过 |
|
||||
| 小范围 UI、非 UI 和恢复 Bug 有替代证据 | 通过 |
|
||||
| 原型证据字段完整 | 通过 |
|
||||
| 关键变化要求重新确认 | 通过 |
|
||||
| 工单模板包含设计与原型门禁 | 通过 |
|
||||
| AGENTS、工作流和需求总览一致 | 通过 |
|
||||
| 未创建空原型或工具集成 | 通过 |
|
||||
| 工单保持待验收 | 通过 |
|
||||
|
||||
## 测试
|
||||
|
||||
- 执行命令:`<命令>`
|
||||
- 结果:
|
||||
- **未验证部分**:<!-- 必填;没有就写“无”。 -->
|
||||
- `python dev_scripts/check_harness.py --strict`:通过。
|
||||
- `python -m unittest discover -s tests -v`:37项全部通过。
|
||||
- `python dev_scripts/sync_wiki_docs.py --check`:14个核心页面全部一致。
|
||||
- `git diff --check`:通过。
|
||||
- 人工场景:纯显示文案、新独立页面、后端接口和恢复既有行为 Bug 均有明确门禁和停止条件。
|
||||
- **未验证部分**:本任务只更新流程规则,没有实际 UI 需求,因此未创建或审核 Quant-UX 原型。
|
||||
|
||||
## Wiki 证据
|
||||
|
||||
- Development-Workflow revision:`3fa437209777476101dc709444c4fe7a0015b76a`
|
||||
- Product-Requirements-Overview revision:`27456313cad2c28e311d7581a472f76d920b67fe`
|
||||
|
||||
## 遗留问题
|
||||
|
||||
<!-- 没有就删除本节。 -->
|
||||
无。#11、#16、#18 仍按各自工单保持待验收。
|
||||
|
||||
## 相关提交
|
||||
|
||||
- `<提交哈希>` <提交说明>
|
||||
- `6435579` docs: require confirmed prototypes for major UI work (#19)
|
||||
Reference in New Issue
Block a user