From 430056508e5d0de6f112396769c6214dfb83d32e Mon Sep 17 00:00:00 2001 From: ila Date: Fri, 7 Aug 2026 16:36:26 +0800 Subject: [PATCH] docs: import wiki at afc651f75a3a --- T-202.-.md | 103 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 103 insertions(+) create mode 100644 T-202.-.md diff --git a/T-202.-.md b/T-202.-.md new file mode 100644 index 0000000..ae5e128 --- /dev/null +++ b/T-202.-.md @@ -0,0 +1,103 @@ + +> 同步来源：[`docs/tasks/T-202.md`](/chengma/mroubao/src/commit/afc651f75a3abc2676bb13aa8a80f6aa6a25a72e/docs/tasks/T-202.md) · commit `afc651f75a3a` + +--- +id: T-202 +title: 生成并确认 P0 Web/App 低保真原型 +phase: 2 +deps: + - T-104 +status: DONE +created: 2026-07-25 +context_ref: ab21219a07630b705f3eb681d32b97d9ab49188b +work_branch: main +write_paths: + - docs/design/** + - docs/08-interaction-checklist.md + - docs/routes.md + - docs/current-state.md + - docs/00-ai-start-here.md + - docs/tasks/T-202.md + - progress.md +--- + +## 问题 / 背景 + +Android 已验证到人工确认点，Go-Gin 后端骨架也已建立，但管理 Web 与采购 App 的 +P0 页面还没有经过人工确认。若直接实现正式 UI，页面区块、控件集合、状态反馈和 +主要动作可能在开发期间反复变化，并增加 T-203、T-204 和 T-206 的返工。 + +## 关联需求与交互 + +- 功能：F-001 至 F-007。 +- 用户故事：US-001 至 US-007。 +- 交互：IX-001 至 IX-008。 +- 页面：管理 Web 4 条 P0 路由；Android 7 个 P0 逻辑目的地。 +- 架构/API：`docs/routes.md`、`docs/api.md`、`docs/04-architecture.md`。 + +## 方案 + +1. 在 `docs/design/` 生成零构建依赖、可独立打开的 HTML 原型，使用完全脱敏的假数据。 +2. 管理 Web 覆盖登录、任务列表、新建任务和任务详情；Android 覆盖登录、任务主页、 + 任务预览、执行、候选确认、结果和设置。 +3. 原型提供可点击的主要命令和状态切换，用于确认区块、控件、文案和安全边界，不连接 + API、不读取本地私有样本，也不作为正式 UI 代码复用。 +4. 使用 Playwright 在桌面和手机视口验证页面可打开、关键交互可触发、无水平溢出或 + 明显遮挡。 +5. 用户实际查看并明确确认后，才把本任务改为 `DONE`、同步 IX 原型链接并提交 Git。 + +## 验收要点 + +- [x] 4 个管理 Web P0 路由均有可独立打开的原型页面。 +- [x] 7 个 Android P0 逻辑目的地均在手机尺寸原型中可到达。 +- [x] IX-001 至 IX-008 的正常路径、关键异常和主要命令可被确认。 +- [x] 所有页面固定显示“仅供确认”的原型标记，且不含真实订单、账号、图片或路径。 +- [x] 任务执行页没有虚假百分比；安全错误不提供自动继续。 +- [x] 候选确认页明确展示 `order_submitted=false` 对应的人类文案。 +- [x] 桌面和移动视口无水平溢出、控件遮挡或不可达主要操作。 +- [x] 用户已人工确认页面区块、控件集合、文案和主要动作。 + +## 边界 + +- 不实现正式 Web 框架、Compose/Fragment 页面或任何 API 对接。 +- 不修改 Android 自动化、VLM、后端业务表、鉴权或任务接口。 +- 不使用真实商品、订单、店铺、账号、设备标识、token 或生产 URL。 +- 不在人工确认前标记完成或提交 Git。 + +## 执行记录 + +### 2026-07-25：任务开始 + +- 基于提交 `ab21219` 开始。 +- 已核对 `docs/routes.md` 的 4 个管理 Web 路由、7 个 Android 目的地，以及 + IX-001 至 IX-008 的正常、异常与可访问性要求。 +- 当前先生成原型和自动化验证；人工确认是完成本任务的硬门禁。 + +### 2026-07-25：原型生成与自动验收 + +- 生成 `docs/design/index.html`、4 个管理 Web 页面和 7 个 Android 页面；每个实际 + 页面均可通过 `file://` 独立打开，CSS/JS 全内联且没有外部依赖。 +- Web 覆盖登录、任务创建、列表/详情、加载/空/失败/权限、取消二次确认、证据失败 + 和“验证完成，未提交订单”；Android 覆盖登录绑定、手动领取、预览、执行、安全 + 停止、人工结论、终态、待同步和设备设置。 +- 需求审计确认 11 个逻辑页面均已覆盖，并发现 `docs/02-requirements.md` 的 F-001 + 至 F-003 单任务验收引用存在 3 处历史编号错误；该文件不在本任务写入边界，本次 + 不越界修改。 +- 静态审计：12 个 HTML 均只有 1 个固定原型标记、1 个内联 style、0 个外部 script、 + 0 个 HTTP URL，未命中本机绝对路径、生产地址、令牌、密钥或私有样本关键词。 +- Playwright 依次以 1440×900、390×844、360×800 打开 12 个页面，共 36 个 + 页面/视口组合：文档横向溢出 0、console error 0、page error 0、外部请求 0； + Android 可见按钮、链接、输入、选择和文本域小于 44px 的数量为 0。 +- Playwright 交互验证通过：Web 首错焦点、通用登录错误、数量默认 1、未提交离开 + 和取消二次确认默认焦点；App 缺权限/已有任务/租约释放、安全错误无自动继续、 + 停止确认默认焦点、超预算禁用接受、无候选动作约束、人员结论回传、结果待同步及 + 活跃任务禁止退出。 +- 实际截图复核索引、管理详情、候选确认、安全错误和设备设置；修复任务详情成功态 + 被 CSS 错误显示取消命令与证据错误占位的问题，复核后两者均不可见。 + +### 2026-07-26：人工确认与完成 + +- 用户在对话中明确回复“确认 T-202 原型”，确认当前页面区块、控件集合、文案和 + 主要动作可作为后续正式 UI 的实现输入。 +- 最后一项人工门禁已满足，任务状态改为 `DONE`；后续显著改变布局或控件集合时， + 必须按 `docs/design/README.md` 重新生成整页并再次确认。