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

T53 补齐采购任务 Admin 列表与详情查询接口 #55

New Issue
Closed
opened 2026-08-20 23:24:32 +08:00 by ila · 2 comments
ila commented 2026-08-20 23:24:32 +08:00
Owner
Copy Link
Copy Source

原始需求摘要

执行 #35 Admin 采购任务页面时发现，已确认原型要求展示采购任务列表、详情、执行状态和人工处理入口，但 #34 当前只提供创建及状态写接口，没有列表和详情 GET 接口。前端无法在不伪造数据的情况下完成 #35。

提出时间：2026-08-20。来源：用户要求 #54 验收后继续采购 MVP 工单，以及 #35 实施前依赖核对。

类型与范围

  • 类型：服务端接口缺口
  • 交付单元：server、共享 API/Wiki
  • 前置依赖：#33、#34、#42、#54（均已验收）
  • 阻塞：#35
  • 不包含：采购任务创建入口（#44）、Admin 页面、Android 动作、修改地址、创建订单、支付、数据库迁移

方案

  • 增加 GET /api/admin/v1/purchase-tasks：
    • page / pageSize 分页；
    • taskId、status、executionMode、sybProductId、pddOrderNo 可选筛选；
    • 返回列表所需的任务快照、设备名称、订单/支付/物流/回填状态、错误和时间。
  • 增加 GET /api/admin/v1/purchase-tasks/{taskId}：
    • 返回完整只读任务详情和按 attemptNumber 排序的 attempt；
    • 不返回规则原文、设备 Token、PDD 凭据、完整收货地址、控件树或截图。
  • 继续沿用管理员/采购员角色门禁。
  • 查询只读取现有 purchase_task、purchase_task_attempt 和设备表，不新增表或迁移。
  • 返回明确 DTO，不直接序列化数据库模型中的隐藏/内部字段。

验收标准

  • 管理员和采购员可以分页查询并按上述字段筛选。
  • 列表返回 #35 页面所需的状态、快照、设备、订单、支付、物流和错误摘要。
  • 详情返回任务只读信息和 attempt 历史。
  • 普通角色返回 403；不存在任务返回 PURCHASE_TASK_NOT_FOUND。
  • 响应不包含规则原文、Token、凭据、完整地址、控件树或截图。
  • go test ./... 通过，共享 API Wiki-first 更新。

风险与文档影响

只读接口，不触发 Agent、不修改任务状态，不执行 PDD 或订单动作。需要更新 Android-Agent-API-Contract、Architecture-and-Code-Map、Delivery-Issues。

## 原始需求摘要 执行 #35 Admin 采购任务页面时发现，已确认原型要求展示采购任务列表、详情、执行状态和人工处理入口，但 #34 当前只提供创建及状态写接口，没有列表和详情 GET 接口。前端无法在不伪造数据的情况下完成 #35。 提出时间：2026-08-20。来源：用户要求 #54 验收后继续采购 MVP 工单，以及 #35 实施前依赖核对。 ## 类型与范围 - 类型：服务端接口缺口 - 交付单元：server、共享 API/Wiki - 前置依赖：#33、#34、#42、#54（均已验收） - 阻塞：#35 - 不包含：采购任务创建入口（#44）、Admin 页面、Android 动作、修改地址、创建订单、支付、数据库迁移 ## 方案 - 增加 GET /api/admin/v1/purchase-tasks： - page / pageSize 分页； - taskId、status、executionMode、sybProductId、pddOrderNo 可选筛选； - 返回列表所需的任务快照、设备名称、订单/支付/物流/回填状态、错误和时间。 - 增加 GET /api/admin/v1/purchase-tasks/{taskId}： - 返回完整只读任务详情和按 attemptNumber 排序的 attempt； - 不返回规则原文、设备 Token、PDD 凭据、完整收货地址、控件树或截图。 - 继续沿用管理员/采购员角色门禁。 - 查询只读取现有 purchase_task、purchase_task_attempt 和设备表，不新增表或迁移。 - 返回明确 DTO，不直接序列化数据库模型中的隐藏/内部字段。 ## 验收标准 - [ ] 管理员和采购员可以分页查询并按上述字段筛选。 - [ ] 列表返回 #35 页面所需的状态、快照、设备、订单、支付、物流和错误摘要。 - [ ] 详情返回任务只读信息和 attempt 历史。 - [ ] 普通角色返回 403；不存在任务返回 PURCHASE_TASK_NOT_FOUND。 - [ ] 响应不包含规则原文、Token、凭据、完整地址、控件树或截图。 - [ ] go test ./... 通过，共享 API Wiki-first 更新。 ## 风险与文档影响 只读接口，不触发 Agent、不修改任务状态，不执行 PDD 或订单动作。需要更新 Android-Agent-API-Contract、Architecture-and-Code-Map、Delivery-Issues。
ila commented 2026-08-20 23:32:14 +08:00
Author
Owner
Copy Link
Copy Source

已实施并推送 main：182ef39。新增 GET 采购任务列表和详情/attempt 查询，角色门禁与敏感字段边界已测试；go test ./... 和 Wiki sync --verify 通过。任务归档 revision：d364fe42c6f1703422b4bd14844d8a576f61bd17。工单保持打开等待验收；#35 可基于该只读契约继续开发。

已实施并推送 main：182ef39。新增 GET 采购任务列表和详情/attempt 查询，角色门禁与敏感字段边界已测试；go test ./... 和 Wiki sync --verify 通过。任务归档 revision：d364fe42c6f1703422b4bd14844d8a576f61bd17。工单保持打开等待验收；#35 可基于该只读契约继续开发。
ila commented 2026-08-21 09:45:23 +08:00
Author
Owner
Copy Link
Copy Source

用户已于 2026-08-21 明确验收通过。

  • 实现提交：182ef39
  • 验收文档提交：09083c8
  • 任务归档：Task-55-补齐采购任务-Admin-列表与详情查询接口
  • 归档 revision：b99bad9b0c1b06d9a99f6e3c7909b1b5a834defc

现关闭 #55。

用户已于 2026-08-21 明确验收通过。 - 实现提交：`182ef39` - 验收文档提交：`09083c8` - 任务归档：`Task-55-补齐采购任务-Admin-列表与详情查询接口` - 归档 revision：`b99bad9b0c1b06d9a99f6e3c7909b1b5a834defc` 现关闭 #55。
ila closed this issue 2026-08-21 09:45:25 +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/goauto#55