• 日期: 2026-08-05
• QuickPoint (前端): 2347db0，相对 origin/main 领先 18 个提交
• QuoteGo (后端): 2ceb742，相对 origin/main 领先 14 个提交

本次为一次覆盖订单物流追踪、客户分组、库存管理升级的大版本更新，前后端同步发布，请前后端一起部署。

✨ 重点新增功能 (Highlights)

1. 订单运单追踪 (Order Tracking)

前后端新增完整的订单运单追踪能力：

• 后端 QuoteGo：shipment_tracker 新增 listrules 接口，支持通过订单反向查询运单号。
• 前端 QuickPoint：
  • 新增运单追踪面板 TrackingFormPanel / TrackingTimelinePanel，支持录入、展示运单时间线。
  • 新增可搜索物流商下拉组件 CarrierCombobox，内置 kuaidi100 物流商数据 (data/kuaidi100Carriers.ts，3000+ 条)。
  • 优化订单展示，集成运单号与物流状态。

2. 客户分组管理 (Customer Groups)

前后端联动支持客户分组，便于运营按组管理客户：

• 后端 QuoteGo：新增 pkg/api/customer_groups.go，提供分组列表 / 创建 / 更新 / 删除 / 排序 / 客户关联 6 类接口。
• 前端 QuickPoint：
  • 新增客户分组对话框 CustomerGroupDialog（创建、编辑、删除）。
  • 新增分组筛选组件 GroupFilterPills，客户选择器支持分组过滤。

3. 库存管理升级 (Inventory)

这是本次更新体量最大的模块（前后端约 5000 行新增）：

• 库存备注：新增 InventoryNotesModal + 后端 inventory_notes.go，支持批量查询库存备注和数量。
• 库存日志统计：后端新增 inventory_logs_stats.go 聚合接口，按变更类型统计；前端新增 inventoryLogsStatsUtils 展示，并合并支付锁定与已发货行优化统计口径。
• 组合商品配方：新增库存配方编辑器 InventoryRecipeEditor，支持一个商品关联多个库存并设置数量；后端 inventory_mapping_rules.go 同步支持配方映射。
• 二次抽检：已入库采购支持二次抽检，后端新增 QC2 标记接口 (inventory_purchase.go)。
• 采购编辑历史：采购记录支持查看编辑历史，后端序列化操作人并解析显示名。

4. 订单高级搜索增强

• 多国家过滤：订单高级搜索支持国家多选筛选（前后端同步实现，含测试）。

5. 其他增强

• 库存不足提醒邮件：邮件模板 reminder_digest.html 与 reminder_email.go 增强，库存不足时展示具体商品、当前库存与阈值详情。
• 无物流特殊物流商：物流商管理支持"无物流"特殊选项及备注。

🐛 重要 Bug Fix / 体验修复

模块	修复内容	端
采购记录抽屉	所有视图计数排除已取消采购，避免统计口径偏差	QuickPoint
账单模块	已上传付款凭证和已采购的账单，撤销按钮禁用，防止误操作造成数据不一致	QuickPoint
客户组对话框	创建按钮增加加载状态，防止重复提交	QuickPoint
库存对账	重构 finalizeOrderLockDetails → reconcileOrderInventory，统一出账与订单确认两条路径的库存对账逻辑，保证幂等一致	QuoteGo

🧱 数据库 Schema 变更 (需执行迁移)

• customer_groups 新建（客户分组）
• inventory_notes 新建（库存备注）
• shipment_tracker 更新（运单规则）
• MappingRules 更新（组合商品配方）
• InventoryPurchases 更新（二次抽检 QC2 字段）

⚠️ 部署注意

1. 后端迁移脚本执行顺序：1800000003 → 1800000005。
2. 前端需同步更新 useUIStore.ts 文案资源（中英文已同步维护）。
3. 本次前后端功能强关联（分组、追踪、库存统计），建议同版本一起发布。