From 8d9c3d47e084e6b0e6db013024c9f38aedd3d0a7 Mon Sep 17 00:00:00 2001 From: QiuSW <105186638@qq.com> Date: Sat, 19 Sep 2026 15:40:52 +0800 Subject: [PATCH] docs: define successful SYB order writeback query filter (#327) --- docs/03-business-rules-and-glossary.md | 10 ++++++++-- docs/08-agent-api-contract.md | 12 ++++++++++-- 2 files changed, 18 insertions(+), 4 deletions(-) diff --git a/docs/03-business-rules-and-glossary.md b/docs/03-business-rules-and-glossary.md index 50e8f31..4e26b0c 100644 --- a/docs/03-business-rules-and-glossary.md +++ b/docs/03-business-rules-and-glossary.md @@ -2,8 +2,8 @@ generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件) wiki_page: Business-Rules-and-Glossary wiki_url: https://git.ilapage.cn/OPC/goauto/wiki/Business-Rules-and-Glossary.- -wiki_revision: 975633525ff82f4be77b37b3d41f08aa05de6822 -synchronized_at: 2026-09-19T07:18:31Z +wiki_revision: b6df3e2d3d497827c9f3cc5b5ec859d5bda3c1f2 +synchronized_at: 2026-09-19T07:39:56Z # 业务规则与术语 @@ -656,3 +656,9 @@ Admin 复用未知结果处理弹窗增加金额输入，并为 live 已创建 SYB 回填与资料完整性独立：正式SYB任务已有单号且仍关联有效明细即可入队，不要求 order_created 状态、时间、金额、付款确认或地址后缀。只有订单号上传SYB；沿用同号成功、异号冲突不覆盖及既有在途防重复规则，不倒扫历史任务。历史补偿仍手动勾选，已成功或在途任务不可重复发起。 自动下单读取和Admin补录是后续目标来源；本单尚未删除插件或Agent我的订单回填，不能宣称上游地址后缀已取消或历史错误归属已修复。金额缺失不得自动采购，订单号唯一归属保护和永久不付款规则不变。 + +## 采购管理已回填 SYB 筛选（#327） + +实现368f2c2，2026-09-19，尚未发布。采购管理现有“状态”下拉框增加“已回填 SYB”，用户选择后点击原查询按钮，按PDD单号回填队列成功记录筛选；不是新的采购任务状态，也不表示物流回填成功或已付款。 + +筛选后仍展示原采购状态与独立SYB单号回填状态，已成功任务不因查询而允许重复回填。清空或重置恢复原列表，查询回到第一页，其他条件继续叠加。沿用既有下拉框、空/加载/失败状态及权限，不新增页面、审批、数据字段或外部动作。 diff --git a/docs/08-agent-api-contract.md b/docs/08-agent-api-contract.md index 04372a9..28f9ddf 100644 --- a/docs/08-agent-api-contract.md +++ b/docs/08-agent-api-contract.md @@ -2,8 +2,8 @@ generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件) wiki_page: Android-Agent-API-Contract wiki_url: https://git.ilapage.cn/OPC/goauto/wiki/Android-Agent-API-Contract.- -wiki_revision: e43e83af5442005139b3234963afd317609b44ac -synchronized_at: 2026-09-19T07:18:51Z +wiki_revision: 275caa306765440b0888dea701198d45481bfb40 +synchronized_at: 2026-09-19T07:40:19Z @@ -1391,3 +1391,11 @@ Android 仅人工“回填”扫描识别单节点“实付”标签，兼容实 人工确认/补录订单在同一事务中 ensureOrderWriteback；原 Agent order_created 与插件/Agent order-backfill 保持兼容。SYB 回填仅要求 live + syb_order + 非空订单号 + 有效关联 stock/detail；不检查任务状态、时间、金额、支付复核或地址后缀。列表批量读取有效关联，提交与 worker 校验相同目标范围。既有 pending/running/succeeded 不重复入队，conflict 不覆盖，unknown 保留原回读及租约规则。字段补全不恢复已失败队列，失败队列仍通过原“回填 SYB 单号”补偿操作处理。 仅回填单号，cost=0/created为空；金额、时间只存 Admin。旧物流 paid 候选流程不改，Android 与 Chrome 上传定位契约未改；今后停用插件和 Agent 回填须另行实施。本次无需数据库迁移；先发布新 Server 再发布发送金额字段的新 Web。 + +## Admin 采购列表已回填单号筛选（#327） + +实现368f2c2（2026-09-19），feat/327-syb-writeback-filter；测试和构建通过，未合并发布。 + +GET /api/admin/v1/purchase-tasks 的既有 status 参数新增查询专用值 syb_writeback_succeeded。该值按独立 purchase_order_writeback.status=succeeded 且 purchase_task_id 对应当前采购任务过滤，不查询旧物流 writeback_status，不新增或改写任务状态。原 status 合法值及其他参数行为保持不变。 + +匹配成功回填的历史任务，不额外要求当前采购状态为 order_created；返回的 task.status 仍为真实采购状态。无单号队列及 pending/running/failed/unknown/conflict 不命中。count及分页共用子查询过滤，可与 taskId、executionMode、taskType、sybProductId、shopeeOrderNo、pddOrderNo 组合；status为空恢复不限制状态。权限与返回信封不变，不写入数据、不触发采购或SYB请求。先发布Server再发布新增筛选值的Web，无数据库迁移或Android变更。