Release Notes (2026-05-13 ~ 2026-08-26)

覆盖仓库：QuoteGo / QuickPoint / droppilot（local main → origin/main） QuoteGo 121 commits（a7d9734）、QuickPoint 118 commits（8f86d5d）、droppilot 4 commits（880ecac）

✨ 重点 Feature（跨项目联动）

1. 运单管理（Waybill）全面升级

• 运单申请与面单打印：QuoteGo 31b3ae8 新增运单申请与面单打印功能并回写 Shopify；QuoteGo 193739f 自定义面单(png)、9c3fe34/e70b1c9 面单与拣货单 PDF 生成；QuickPoint e00d3c1 新增面单与拣货单 PDF 打印弹窗，0487739/ff6f074 打印标签图片与完成确认
• 包裹管理：QuoteGo 78b5a31 包裹拆分、6a29d67 批量获取包裹、11ce708 重置卡在 applying 状态的包裹；QuickPoint 7b7e3fd/a4164b2 订单拆分、dd18a19 多包裹浮层、50af85a 批量拉取包裹改为单次请求
• 运单去重：QuoteGo 6349a1a 跨 fulfillment 去重，同一订单仅保留一条运单追踪记录；QuoteGo 0465e4f 补传运单号时复用占位 tracker
• 发件人与报关：QuoteGo 54ab022 组织运单发件人配置接口；QuickPoint 0599671/35c8a7b 发件人表单校验；QuoteGo 2bbf93b/af7bb87 变体报关信息与批量操作接口，QuickPoint 13e07b5/509c5fc 报关信息管理与批量设置
• 物流轨迹：QuoteGo e43b23d 包裹物流轨迹查询接口（内存缓存）；QuickPoint 6e1d83b/99d5949 物流轨迹查询与弹窗展示
• Shopify 同步时序：QuoteGo 49a8808 发货重试机制、5b0061f 先同步 Shopify 成功再标记发货、c755710 面单打印后再同步；QuickPoint a637fad 先回写成功再标记发货并提示部分失败、c6e9a3e 履约错误信息提示
• 物流渠道与线路：QuoteGo c54e15a/0a484b0 打单运输方式下拉接口、9768f97/8506f3e routeCode 从物流配置解析；QuickPoint 76ae02b/ab236bc 运输方式下拉展示、3416e5a 渠道选择、88cf3dc 运输路线 ID 支持

2. 物流风险中心 v1.1

• 风险中心：QuoteGo 027b71d 物流风险中心 v1.1；QuickPoint d4fc6b7 风险订单/市场风险/自动化规则模块
• 性能优化：QuoteGo 7d6c6cf 索引+查询重构+物化缓存、522cc55 客户过滤改 EXISTS 子查询、6144e17 批量查询与索引优化
• AI 评估：QuoteGo e9bcc89 新增 AI 评估记录表及接口；QuickPoint ad467e7 AI 深度评估、28a029a 隐藏 AI 评估开关
• 预警管理：QuoteGo d5d349c 批量标记预警已解决、1668c3a 按规则类型筛选并 SLA 超时置顶、0e36ecd 待处理预警数量统计；QuickPoint e4ca78f 批量标记已解决、4340d29 预警列表筛选+SLA 标记、8ccc6a9 预警订单号点击打开订单详情浮层、0d1ade7 侧边栏待处理预警红点
• 17track 集成增强：QuoteGo 607eea5 物流状态对齐 17track 迁移、f392614 轨迹状态归一化、feb4579/419ca94 Webhook 签名校验与注册容错、76833c1 停滞推送模板
• 通知：QuoteGo a87dc88 新增钉钉加签密钥、移除 Slack webhook；QuickPoint 109226b 通知文案同步为「钉钉」

3. 新增物流供应商：华磊 / 软通宝（RTB）

• 华磊：QuoteGo 33f6e82 新增华磊供应商并统一轨迹查询为主动拉取；be60619 支持延迟出号补取跟踪单号；b918666 兼容单引号 JSON 与 data 数组响应；069a526 ack=false 时返回空轨迹；647d510 轨迹推送与事件去重
• 软通宝（RTB）：QuoteGo a69e146 新增软通宝 webhook 支持及相关字段；1dd4fd2 修正 webhook 路径并增强签名校验；0a6952e 改用 RTB_WEBHOOK_KEY 环境变量；e70b1c9 使用 rtb pdf 面单并移除 mock provider

4. 库存管理与采购记录增强

• 库存：QuoteGo 4dd80cd 确保订单库存抵扣、统一出账与预览逻辑；2e9d20b 库存自愈机制补算缺失库存状态；QuickPoint 74b9778/77839a7 库存商品创建与编辑、176f04f 统一库存状态字段、d54e44d 可用库存计算、fa2a1a8 缺货列、1a0dd65 销量驱动库存紧张提示与建议采购量、64b4b33 库存关联报价单
• 采购记录：QuickPoint 94fc8c0 付款凭证核验、db162f1 采购取消与编辑、8530a0a 采购来源标签、508904f 物流单号追加、777c878 删除物流单号、506729b 状态筛选与分页、124db4d 物流单号搜索与客户筛选

5. 订单发货与补发流程增强

• 人工发货：QuoteGo b8dd778 新增人工发货接口及库存状态重算；QuickPoint 557de24 待打单有货/缺货分组及人工标记发货
• 批量补发：QuoteGo 260477f 新增订单补发功能并保留旧运单号；QuickPoint d814b64 批量补发并展示补发历史
• 订单视图：QuickPoint 1446a53 新增待确认和全部订单视图、优化状态筛选；696b343 订单状态类型优化并新增物流状态；2d8b203 统一表格列结构，账单视图展示收货地址

6. 订单归档

• QuoteGo 88baece 新增历史订单自动归档与发票标记；QuoteGo ca805c6 级联归档 tracking_events 关联数据
• QuickPoint 302943c 归档账单隐藏订单明细并新增提示

7. 工单统计

• QuoteGo 01c0ec9 新增工单统计接口；QuickPoint 4aa3856 新增工单统计

8. 订单标签系统隔离

• QuoteGo 42da296 新增系统标签隔离，风险标签不可编辑删除；QuoteGo 8d61353 默认动作仅启用本地标签
• QuickPoint 5b0a865 支持风险/工单标签翻译并过滤系统标签

🚀 其他 Feature

QuoteGo

• 706e472：批量查询订单外部发货运单摘要接口
• 4693d5f：新增订单级超时未发货预警扫描；bc163f7 发货延迟默认阈值从 8 小时调整为 48 小时
• 5d9f6f2：聚合订单级风险快照，每个有效单号对应一条独立 tracker
• 8ce54b7/ae4934b/5d97835：自动处置按风险等级幂等去重并支持升级重发
• 6ad945a：预警列表承运商搜索；716fa48 客户 ID 筛选及店铺信息组装；9e75370 订单跟踪查询接口
• 1be1738：新增启发式地址验证逻辑及 Google API 深度验证支持；9d7e14c 地址异常预警与邮件通知
• 3bb5f7b：市场热力图缓存扩展，支持客户和承运商维度
• 81526c4/fbcb472：拣货单生成优化，变体图优先与品牌信息、多变体聚合
• dfd58e3/775a6fc：注册定时任务、优化预热逻辑与频率避免数据库挤占
• 0f7b5f9：风险评估支持组织规则配置；8ce54b7 按预警类型执行自动处置

QuickPoint

• d8bbee3/7d6bdc2：新增 VariantImage 统一变体图片展示并修复预览冒泡
• d4367df：工单详情新增订单详情浮层；87482f7 浮层点击外部关闭并自动夹紧至可视区域
• 6caec52：外部发货订单运单轨迹展示；c2fd091 物流状态锁定、禁止修改渠道；d241ffa 跳过运单状态检查
• 71745c6/4af6050：地址校验证据展示与国际化映射
• 7b97524：风险中心与自动化规则国际化全覆盖；afa8f8d 风险中心骨架屏加载态
• d4c5206：风险中心客户筛选及收件人信息展示；d232f08/3ecf878 承运商搜索；14b2c02/a58c564 热力图聚合维度与排序
• ca5dcd5/6ba0cf1：客户风险监控开关及开启时间记录、状态展示
• bdb8031：客户发货通知配置；87c7fbe 电话/手机输入校验优化
• 5607b0a：发票付款截止日期默认值；457f3ac 采购建议与物流追踪体验优化

droppilot

• 354a50d：订单侧边栏新增账单与物流状态双 Tab 切换

🐛 重大 Bug Fix

• QuoteGo ffd320f：修复 Ticket 订单多选关系匹配导致工单查询失败和重复建单
• QuoteGo feb4579/419ca94/fa56fbb/f392614：17track 系列修复
  • Webhook 签名算法、注册请求体及推送报文解析；乱序推送回退状态；事务提交后订阅未注册及 URL 双斜杠；轨迹状态归一化
• QuoteGo cb4b348：区分自动关闭与人工处置，避免预警无法重开
• QuoteGo ec91b9f：停滞时长基于末条事件而非 tracker.updated
• QuoteGo 3936f52：自动处置统计仅计入 source=auto 的动作
• QuoteGo 5e8e987：修复 alert_events IN 语法导致扫描失败，已解决预警不重复创建
• QuoteGo 7642258：修复系统动作解析与安抚邮件收件人逻辑
• QuoteGo 03d196f/QuotePilot 801e629：修复风险证据链侧栏数据展示
• QuickPoint 80f09ae：未选择物流渠道时不再回退默认最便宜路线
• QuickPoint 3b5eb08：修复订单动态翻译为下单时间、物流状态显示
• QuickPoint d96d660：CustomerSelect 新增 restoreLastSelected，避免风险中心重复请求
• QuickPoint dd5436b：修复风险详情侧栏加载状态逻辑
• QuickPoint 225129c：物流风险中心失败提示展示后端具体原因

♻️ 重构 / 移除

• 权限模型重构（跨项目联动）：
  • QuoteGo fdc33a3：移除 admin 角色并统一组织数据规则；QuoteGo 2c5f74a 移除修改成员角色接口
  • QuickPoint 067ee10：权限模型重构为模块级访问控制；QuickPoint a0d6b27 成员角色改为只读展示
• 移除 Slack webhook、迁移到钉钉：QuoteGo a87dc88
• 风险中心：QuoteGo b4051fc 移除废弃通知渠道配置；QuickPoint 5545c78 移除通知设置面板；QuickPoint 95b5298 移除 AI 建议动作执行；QuickPoint 962c52e 禁用邮件和工单动作并清理历史残留配置；QuickPoint eb690f3 异常规则仅保留严重关键词配置
• QuoteGo b1cb545：移除无报关重量时的重量估算兜底
• QuoteGo 9803192：移除 hsCode 字段及相关逻辑
• QuickPoint 1d409a5：移除待填报关相关逻辑及状态筛选
• QuickPoint 4257b50：移除库存同步变体功能
• droppilot 880ecac：删除按账单计算利润 Tab 及相关代码

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

运单 / 订单

• 新建 order_packages（包裹）、reshipments（补发）、VariantCustoms（变体报关）、org_shipper_config（发件人配置）
• Orders 新增双路线状态字段、选定物流路线、拆分、人工发货/库存状态字段；新增 tracking_number_uploaded_at
• shipping_route_code：运输方式/路线代码
• 新增订单列表计数索引、清理死索引（性能优化）

风险中心

• 新建 alert_events、tracking_events、ai_assessments、risk_automation_rules、风险中心缓存表
• shipment_tracker 新增 tracking_number_uploaded_at、移除风险快照冗余字段
• customers 新增风险监控开关
• 钉钉加签密钥字段、移除 Slack webhook 字段；移除废弃通知渠道配置（shipment_alert_settings 删除）
• 物流状态对齐 17track 迁移脚本；热力图缓存增加维度字段

其他

• order_tags 新增系统标签隔离字段
• 权限：角色/模块表调整，统一组织数据规则

⚠️ 部署注意

1. 后端迁移脚本共 50 个，按时间戳顺序执行（1780001002 → 1820000000）。
2. 软通宝（RTB）需在环境中配置 RTB_WEBHOOK_KEY 密钥后方可接收 webhook。
3. 本次前后端功能强关联（运单、风险中心、库存、权限），建议同版本一起发布。
4. 权限模型重构（移除 admin 角色、模块级访问控制）影响组织数据可见性，发布后需复核各角色权限配置。
5. 前端 i18n 文案已同步维护，useUIStore.ts 中英文版本一致。