QuickPoint Docs

Appearance

Release Notes (2026-08-24 ~ 2026-09-04) ​

覆盖仓库：QuoteGo / QuickPoint / droppilot（local main → origin/main） QuoteGo 37 commits（bf2beb3）、QuickPoint 27 commits（c581cbb）、droppilot 1 commit（f333ea4）

✨ 重点 Feature（跨项目联动） ​

1. 物流打单渠道体系重构（物流商配置化） ​

  • 凭据全局化：QuoteGo 2a45cfa/bfa497d 打单 Provider 从「全局 env 单例」重构为「物流商绑定 + 按渠道路由」，凭据收口到 CarrierConfig 集合（按组织隔离，多个渠道可复用同一物流商凭据）；1830000001 迁移移除 LogisticsChannel.credentials
  • 凭据管理接口：QuoteGo pkg/api/logistics_batch.go 新增 /api/logistics/carrier-config/save|delete，凭据变更后自动清除 Provider 实例缓存即时生效
  • 前端配置面板：QuickPoint b0bc152 新增物流商配置面板统一管理凭据、f16b0e8 支持凭据配置与连接测试；655c94d 渠道与线路新增物流商及路线代码徽标
  • 物流商注册表：QuoteGo 142706a 新增 waybill_carriers.yaml 注册表（生产）与 waybill_carriers_dev.yaml（开发环境），新增物流商只需改配置文件重启服务生效
  • 面单与性能：QuoteGo 34304f4 PDF 未铺满自动裁剪拉伸、71fd80d 产品图缩放为 96px PNG 并复用缓存

2. 物流自动选渠道规则 ​

  • 规则集合：QuoteGo 53d8c6b 新建 LogisticsAutoRule 集合（RQB 条件 + 候选线路）；b8b9c39 新增批量排序接口及测试
  • 规则面板：QuickPoint a87262f 自动选渠道规则管理与推荐应用、f3eca5d 重构为物流规则面板并新增条件构建器、9d4ab6b 已选线路摘要与启停开关
  • 渠道来源标识：QuoteGo 5cdfaae/bc2576d 订单新增渠道来源标识并移除打单报价快照回退；QuickPoint 2cd934b 展示规则/手动徽标
  • 批量设置与筛选：QuoteGo d4baaab 按物流渠道 routeId 过滤订单；QuickPoint c581cbb 批量设置物流渠道并抽取共用选择组件、89f20d2 订单筛选新增物流渠道并简化打印向导为确认步
  • 落库与修复：QuickPoint 690c9f9 申请运单前先落库规则推荐渠道并处理失败、635f50b 修复自动规则重复 sort 导致拖拽失效并新增批量排序

3. 面单打印向导与拣货汇总 ​

  • QuoteGo cdac5d5 新增拣货汇总页并跨包裹聚合数量
  • QuickPoint a21b8e4 新增三维筛选打印向导并支持包裹级打印；4c402c2 物流 Tab 屏蔽跨页全选且渠道仅用已固化值、0770304 未选择渠道时不回退默认路线

4. 风险中心：手工修改收货地址 ​

  • QuoteGo 7ad6e32 新增手工修改收货地址并防 Shopify 同步覆盖（Orders.address_edited_at 字段，非空时增量同步跳过 shippingAddress）
  • QuickPoint b645ba5 风险中心新增地址异常未发货订单修改收货地址功能

5. 订单搁置语义统一 ​

  • QuoteGo 9b1527b 搁置语义统一为订单级 billing_on_hold，shipping_on_hold 保留但废弃；1822000000 迁移合并历史 shipping 搁置数据
  • QuickPoint 115f404 统一搁置逻辑为订单级并支持待确认批量搁置

6. 变体批量报关 ​

  • QuoteGo 2e74dff 支持按指定变体批量设置报关字段
  • QuickPoint 44e65a9 支持勾选变体后批量设置报关字段

7. 库存每日消耗趋势 ​

  • QuoteGo 1fd6184 新增库存商品每日消耗趋势查询接口
  • QuickPoint e56bc2c 新增每日消耗趋势图表及趋势/日志页签切换

🚀 其他 Feature ​

QuoteGo

  • 800f0bf：新增按运单号查询订单接口，支持内部包裹与外部履约
  • bd9cabe：风险中心新增运单号返回并提升分页上限至 1000
  • f44b65b：软通宝实现运输方式列表接口获取并调整承运商配置
  • daff561：统一各打单商幂等单号生成逻辑
  • c258912：17Track webhook 成功处理新增日志跟踪
  • 85ed0f3/d9a520f：新增环境变量开关控制补货后缺货自动转有货、补货后自动刷新缺货待打单订单状态

QuickPoint

  • 6002e0a：订单新增运单号搜索功能
  • 2f8ce95：物流风控导出报告支持全量数据并新增运单号列
  • 0cb07f6：新增报价保存零值校验，工单列表改用订单号
  • 1eb9695：物流规则条件详情始终展示并微调文案
  • 7239225：订单搜索国家筛选独占一行铺满宽度

droppilot

  • 无新增功能（见下方重构/移除）

🐛 重大 Bug Fix ​

  • QuickPoint 635f50b：修复物流自动规则重复 sort 导致拖拽失效，并新增批量排序
  • QuickPoint 690c9f9：申请运单前先落库规则推荐渠道并处理失败，避免渠道丢失
  • QuoteGo 00b96ea：区分跟踪号生成状态，避免云途误报「生成中」
  • QuoteGo a56ac46：清除数据库下载响应的写超时，避免大库传输被中断
  • QuoteGo f16d431：在途统计排除未订阅的占位 tracker
  • QuickPoint 4c402c2：面单物流 Tab 屏蔽跨页全选，渠道仅用已固化值
  • QuickPoint 0770304：未选择物流渠道时不再回退默认路线

♻️ 重构 / 移除 ​

  • droppilot f333ea4：移除商家端订单模块及侧边栏入口（订单业务回归 QuickPoint）
  • QuoteGo dea1a91：提取共享辅助函数，将华磊/软通宝实现迁移至 waybill/systems/ 子包；新增顺友（eebddec）、云途（829df46）、万邦（f41b1f1）打单渠道
  • QuoteGo 5cdfaae：移除打单报价快照回退逻辑
  • QuoteGo 9b1527b：shipping_on_hold 字段废弃（仅保留不写入）
  • QuickPoint f3eca5d：自动选渠道规则重构为物流规则面板
  • QuickPoint d2ace99：账单移除「更多」菜单改为常显操作按钮
  • QuickPoint 11fc0c8：高级筛选面板改为内联展开

🧱 数据库 Schema 变更（需执行迁移） ​

新建集合

  • LogisticsAutoRule（物流自动选渠道规则，RQB 条件 + 候选线路，org_id + sort 索引）— 1818000000
  • CarrierConfig（物流商凭据，按组织隔离，唯一索引 org_id+carrier；凭据仅经自定义接口读写）— 1830000001

Orders

  • 新增 address_edited_at（date，防同步覆盖标记）— 1787792909
  • 新增 selectedLogisticsRouteSource（text，渠道来源 manual/rule）— 1819000001
  • 数据迁移：历史 shipping_on_hold 合并进 billing_on_hold — 1822000000

LogisticsChannel

  • 新增 carrier（内置物流商编码）字段 — 1820000001
  • 移除 credentials 字段（凭据上收 CarrierConfig）— 1830000001

⚠️ 部署注意 ​

  1. 后端迁移脚本共 6 个，按时间戳顺序执行（1787792909 → 1830000001）。
  2. 物流商凭据需重新配置：本次将凭据从渠道迁移到 CarrierConfig，发布后需在 QuickPoint 物流商配置面板重新填写各物流商凭据（按组织隔离）。
  3. 新增云途（yunexpress）、顺友（sunyou）物流商，需在 waybill_carriers.yaml 注册表中启用并重启服务生效；生产与开发环境注册表分离（waybill_carriers_dev.yaml）。
  4. 可选环境变量 DISABLE_RESTOCK_AUTO_IN_STOCK 可关闭「补货后缺货自动转有货」。
  5. 本次前后端功能强关联（物流打单、自动选渠道规则、面单打印、风险中心地址修改），建议同版本一起发布；droppilot 仅移除订单模块，可独立发布。
  6. 前端 i18n 文案已同步维护，useUIStore.ts 中英文版本一致。

QuickPoint Docs

Copyright © 2026