From cad00877d3d59ec3372589943e621b4c62040621 Mon Sep 17 00:00:00 2001 From: QiuSW <105186638@qq.com> Date: Mon, 3 Aug 2026 14:37:09 +0800 Subject: [PATCH] docs(tasks): plan web table prototype revision --- docs/tasks/T-005.md | 60 ++++++++++++++++++++++++++++++++++++++++++--- 1 file changed, 57 insertions(+), 3 deletions(-) diff --git a/docs/tasks/T-005.md b/docs/tasks/T-005.md index 000cd1f..f72ce92 100644 --- a/docs/tasks/T-005.md +++ b/docs/tasks/T-005.md @@ -5,12 +5,21 @@ phase: 0 deps: [] status: DOING created: 2026-08-03 -context_ref: dfe3d56 -work_branch: task/t-005-web-prototype +context_ref: b10a300 +work_branch: task/t-005-web-table-revision needs_device: false needs_human_review: true write_paths: - docs/tasks/T-005.md + - docs/02-requirements.md + - docs/04-architecture.md + - docs/06-tasks.md + - docs/07-user-stories.md + - docs/08-interaction-checklist.md + - docs/api.md + - docs/routes.md + - docs/current-state.md + - docs/design/README.md - docs/design/web-login.html - docs/design/web-task-create.html - docs/design/web-task-workbench.html @@ -26,6 +35,14 @@ web 端尚无生产代码。若直接实现 SSR 页面,登录、建单、三 本任务是第一阶段原型:确认流程和信息架构,不证明拼多多 App 里能读取哪些字段。T-103 真机取证若改变字段,生产页面开工前必须先同步 IX 与原型。 +### 2026-08-03 人工评审修订 + +第一轮三泳道卡片不符合采购人员熟悉的数据工作台习惯。人工评审已确认改成传统表格: +列表内完成批量选择、建单和筛选,任务详情用路由驱动的右侧抽屉保留列表现场。该变化还 +确认了“创建”和“开始试选”是两个动作:新任务先保存为 `DRAFT`,只有管理员勾选后才进入 +`PENDING` 第一趟试选队列。原型与需求、状态机、管理端接口必须同步,不能只在 HTML 中发明 +一个后端不存在的按钮。 + ## 关联需求与交互 - 功能:F-001、F-004、F-007、F-008、F-009、F-010、F-011、F-013、F-017 @@ -48,6 +65,23 @@ web 端尚无生产代码。若直接实现 SSR 页面,登录、建单、三 `AUTHORIZED/ORDERING`、围栏后 `ORDERING`、`RECONCILIATION_REQUIRED`、 `WAITING_PAYMENT`、`NEEDS_MANUAL` 与终态。每种业务状态只有一个主动作。 +### 第二轮修订方案 + +1. 把 `web-task-workbench.html` 整页重新生成为传统数据表,不在旧三泳道卡片上增量修补。 +2. 表格列固定为:选择、标题、颜色、尺码、价格上限、数量、采购结果、状态、创建时间; + 不设置操作列。标题打开拼多多商品假链接,任务编号打开内部详情。 +3. 表格上方第一行放“导入”“创建”:导入为有原因说明的禁用占位;创建打开模态表单, + 保存后生成 `DRAFT` 假任务并按创建时间倒序插到第一行。 +4. 第二行默认显示标题关键词、筛选、清除;勾选可开始的 `DRAFT` 后切换为上下文批量栏, + 统一执行“开始试选”。动作只模拟 `DRAFT → PENDING`,固定说明不会创建订单或付款。 +5. 双击行的非控件区域,或聚焦行后按 Enter,打开右侧详情抽屉;复选框、标题外链、任务 + 编号链接不误触发行双击。原型用 `#/tasks/{id}` 演示生产路由 `/tasks/{id}`,关闭抽屉恢复 + 原筛选、选择和滚动现场;直接访问详情仍由完整页兜底。 +6. “采购结果”只由结构化假数据在展示层拼成“阶段:颜色 | 尺码 | 单价 | 数量”,不把 + 拼接字符串定义成存储字段;待开始 / 执行中显示 `—`,避免把试选结果误写成已下单。 +7. 同步需求、用户故事、交互清单、路由、架构状态机、管理端 API 与路线图:MVP 只增加 + “批量开始第一趟试选”,批量排序、暂停 / 继续和人工接管仍留在 V2。 + ### 视觉与交互基线 - 冷静、紧凑的运营工作台;系统无衬线字体,优先 `Segoe UI`。主操作用蓝色,红色仅用于 @@ -78,17 +112,37 @@ web 端尚无生产代码。若直接实现 SSR 页面,登录、建单、三 - 运行:`python scripts/validate_agent_context.py`、`git diff --check`,并用浏览器逐页检查 accessibility snapshot、控制台与网络请求。 - 完成自动验证后任务保持 `DOING`,等待人确认布局、信息层级、主动作和安全文案。 +- 第二轮表格中没有操作列;默认按创建时间倒序,新建任务保存后成为第一行。 +- 导入按钮不可操作且说明尚未实现;创建表单校验错误保留输入,成功后关闭弹窗并刷新表格。 +- 只有 `DRAFT` 可勾选开始;批量栏明确是“开始试选”,不得使用可能被理解为直接下单的 + “开始采购”。全选只覆盖当前筛选结果中的可开始任务。 +- 标题外链在新标签打开;双击行和 Enter 打开详情抽屉;关闭、Esc、浏览器返回均恢复原行 + 焦点,直接打开详情链接仍有完整页兜底。 +- 采购结果的颜色、尺码、单价、数量保持结构化来源,金额显示两位小数;页面仅负责用 `|` + 格式化展示。 ## 边界 -- 只修改 frontmatter `write_paths` 所列文件,不改共享路线图、需求、IX、API 或生产目录。 +- 只修改 frontmatter `write_paths` 所列文件;第二轮允许同步共享产品文档,但不修改生产目录。 - 不实现 Go、SSR、数据库、真实鉴权、CSRF 或 HTTP 调用。 - 不发明拼多多页面字段、选择器、App 版本或真机结论;截图区域只用明显的假数据占位。 - 不实现 Excel、ERP、图搜、多候选对照台、自动订单回读或自动付款。 - 原型代码不得复制到生产实现。 +- 导入仍是禁用占位,不实现 Excel;批量能力只到“开始第一趟试选”,不实现顺序编排、 + 暂停 / 继续、运行中接管或多设备调度。 +- 本任务不触及真机页面判据,不创建订单,不执行下单或付款动作。 ## 执行记录 +### 2026-08-03 · 第二轮人工评审修订计划 + +- 人工评审已确认:工作台改为传统表格;创建改为列表内模态表单;去掉操作列;标题链接 + 打开拼多多商品页;双击行打开路由化详情抽屉;关闭后保留列表现场。 +- 为保证批量“开始试选”不是无后端语义的装饰按钮,本轮把新任务初始态明确为 `DRAFT`, + 统一开始后进入 `PENDING`。该动作只放入第一趟试选队列,不签发授权、不创建订单、不付款。 +- 本轮沿用 T-005:它已经是 `DOING` 且独占 Web 原型文件;另建重叠任务会违反单任务单写入者 + 约束。任务继续保持 `DOING`,完成自动验证后等待第二轮人工确认。 + ### 2026-08-03 · 第一阶段原型实现 - 任务状态保持 `DOING`:自动检查已完成,但 `needs_human_review: true`,未进行人工设计确认。