cmroubao/docs/tasks/T-202.md

id, title, phase, deps, status, created, context_ref, work_branch, write_paths

id	title	phase	deps	status	created	context_ref	work_branch	write_paths
T-202	生成并确认 P0 Web/App 低保真原型	2	T-104	DONE	2026-07-25	ab21219a07	main	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。

验收要点

• 4 个管理 Web P0 路由均有可独立打开的原型页面。
• 7 个 Android P0 逻辑目的地均在手机尺寸原型中可到达。
• IX-001 至 IX-008 的正常路径、关键异常和主要命令可被确认。
• 所有页面固定显示“仅供确认”的原型标记，且不含真实订单、账号、图片或路径。
• 任务执行页没有虚假百分比；安全错误不提供自动继续。
• 候选确认页明确展示 order_submitted=false 对应的人类文案。
• 桌面和移动视口无水平溢出、控件遮挡或不可达主要操作。
• 用户已人工确认页面区块、控件集合、文案和主要动作。

边界

• 不实现正式 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 重新生成整页并再次确认。