Release Notes (2026-10-18 ~ 2026-10-20)

✨ 重点 Feature

品牌统一为 QuickPoint（QuoteGo / QuotePilot / droppilot 联动）

产品名称由 QuotePilot 统一改为 QuickPoint，前端、后端与商家端同时生效。

• 界面中的名称全部更新：浏览器标题、登录与激活页面、侧边栏、欢迎语、邮件主题与签名、报价单水印、账单页脚、服务条款与隐私政策。
• 访问地址改为 quickpoint.now，数据服务地址改为 pb.quickpoint.now；商家端（Shopify 内嵌应用）中的帮助与政策链接同步指向新地址。
• 商家 AI 助理的配置说明改用新的服务名称与接入地址。已接入的助理仍可使用旧版令牌继续访问，不需要立即改动。
• 「扫码入库」手机端应用的名称更新为「QuickPoint 扫码入库」。

品牌名称

QuickPoint　（原 QuotePilot）

QuickPoint - Professional Dropshipping Platform

报价单底部水印：Generated by QuickPoint

账单页脚：Powered by QuickPoint.now Billing System

物流报价复核周期与过期提醒（QuoteGo / QuotePilot 联动）

线上物流价格由人工维护，长期不核对容易过期。本版为每条线路增加了「复核」与「报价有效期」两种状态判定，并在超过期限时主动提示。

• 线路编辑弹窗新增「报价有效期至」：留空表示长期有效；填写后到期的线路会被标记为「已过期」。
• 启用中的线路超过组织设定的复核周期未复核，标记为「待复核」；线路行同时显示「最后复核 N 天前」，从未复核的显示「从未复核」。
• 物流配置页顶部汇总当前「待复核 N / 已过期 N」，全部正常时显示「全部新鲜」。渠道行也会显示该渠道下的待复核与已过期数量。
• 「待复核」标记本身可点击：点击后二次确认即可刷新复核时间，标记消失；渠道行的「待复核 N」可一次确认该渠道下全部待复核线路。
• 「已过期」需处理根因：点击标记直接打开线路编辑，修改价格或有效期后才会解除。
• 在报价与订单中为目的地选择已过期线路时，会先弹出确认「该线路报价已过期，确认仍要选用？」；线路下拉中同样展示「待复核 / 已过期」标记。
• 复核周期在 系统设置 → 其他 中配置，可填 1~365 天，默认 30 天。
• 「待处理提醒」新增「物流」页签，提示待复核与已过期线路数量；每日提醒邮件也会包含这一条。上线后无需等到次日，提醒会按当前线路状态立即生成。

物流配置 — 报价复核与有效期

待复核 3 已过期 1　请核对价格后点「待复核」标记确认

线路	状态	最后复核
美国专线	待复核	最后复核 45 天前
欧洲专线	已过期	最后复核 12 天前
日本专线	正常	最后复核 3 天前

报价有效期至：2026-10-31　留空表示长期有效

系统设置 → 其他 — 物流复核周期

物流复核周期

启用线路超过该天数未被复核，将标记为「待复核」并触发提醒。

30 天

可填 1~365 的整数天，仅所有者可修改。

报价单支持停用线路沿用上次报价，保存前统一确认（QuotePilot）

线路被停用或删除后，历史报价单不再丢行，也不会因为没法重新报价而无法保存。

• 打开历史报价单时，原线路已停用的目的地沿用上次保存的报价：单价、数量与总价都按快照保留，并在该行标出「线路已停用 · 沿用上次报价」。
• 这类价格在界面上只读，不随采购成本、重量、利润率或数量的修改而变化；重新选择一条可用线路后恢复实时计算。
• 保存报价单时，把原先分散的提示合并为一个「保存前请确认」弹窗，按「数据为 0」「价格沿用上次报价」「覆盖已有报价单」分组列出，带产品的条目可点击定位到对应产品；确认后一次保存，不再连续弹窗。
• 新建报价单不继承上一张单的停用线路价格，必须重新选择可用线路。
• 报价页顶部的「线路不可用」提示横幅显示问题总数（如「共 3 项」），默认展开，可一键收起；收起后仅保留标题与数量。

报价计算 — 停用线路沿用上次报价

US 美国　线路已停用 · 沿用上次报价

物流线路：云途 · 美国专线（已停用）

单价 $8.50　数量 2　总价 $17.00

单价、数量与总价沿用上次保存的报价，不随成本、重量、利润、数量修改而更新；重新选择线路后恢复实时计算。

保存报价单 — 保存前请确认

以下提示不会阻止保存，确认后将按当前设置继续保存。

数据为 0 (1)

无线充电套装 A：利润 为 0

价格沿用上次报价 (1)

无线充电套装 A → 美国（US）：线路已停用，单价、数量与总价沿用上次保存的报价，不会随本次修改更新

覆盖已有报价单 (1)

单号 Q-20261020-001 已存在，保存后将覆盖原报价单。

取消　继续保存

报价计算 — 线路不可用提示

以下目的地线路不可用，请检查：共 3 项　收起

展开后逐条列出「产品 / 目的地 / 不可用原因」，点击条目可定位到对应产品。

🚀 其他 Feature

提醒改为组织内共享，并按模块权限显示（QuoteGo / QuotePilot 联动）

• 提醒不再只发给被指派的个人：同一组织内，拥有对应模块权限的成员都能看到相关提醒。
• 「待处理提醒」只显示当前用户有权限的页签；所有者始终看到全部页签。默认打开第一个有权限且有内容的页签，权限被收回后自动切换到可用页签。

待处理提醒 — 物流

账单 (0)库存 (0)工单 (1)物流 (1)

物流报价待复核

有 3 条线路待复核、1 条报价已过期，请尽快确认价格是否仍然有效。

去处理

成员只看到自己有权限的页签；所有者看到全部。

🐛 重大 Bug Fix

Shopify 订单同步长时间卡住，超期订单误报「可能已被删除」

• 修复网络异常时 Shopify 读取请求没有超时、同步任务长时间无响应并占满同步处理能力的问题。现在单次读取有明确超时，失败会正常结束并给出原因。
• 创建超过 60 天的订单，Shopify 不再开放读取。系统不再尝试读取这类历史订单的更新（此前这些更新会持续堆积、拖慢正常订单同步）。
• 手动同步单笔订单失败时，直接显示具体原因：「该订单创建已超过 60 天，Shopify 不再对其开放读取，无法同步」，不再只显示笼统的「同步失败」，也不会误报为「可能已被删除」。
• 店铺同步失败同样优先显示具体原因，并保留已同步进度。

订单列表 — 同步失败提示

同步失败　该订单创建已超过 60 天，Shopify 不再对其开放读取，无法同步

店铺同步失败时会展示后端返回的具体原因；有部分进度时同时展示已同步数量。

万邦欧盟运单补充产品识别码

• 万邦自 2026-10-23 起对欧盟运单强制校验「非标准化制造商产品识别码」。本版打单时按商家 SKU 补充该识别码；SKU 为空时回退使用变体编号，避免欧盟订单因缺少该信息被拒单。
• 该识别码与原有的商品编码取同一值；标准化编码（如 GTIN/EAN）系统没有数据来源，因此留空不填。

♻️ 重构 / 移除

• 品牌内部命名统一：代码注释、文档与配置示例中的 QuotePilot 统一改为 QuickPoint；旧版商家 AI 助理接入凭证仍可使用，已接入方不受影响。
• 提醒可见范围变更：由「指派给个人」改为「组织内按模块权限共享」，原有的个人提醒会归并到所属组织。
• 报价单保存确认合并：原先「数据为 0」与「覆盖已有报价单」两个连续弹窗合并为一次分组确认。
• 默认应用地址变更：邮件与通知中的默认链接由 quotepilot.cc 改为 quickpoint.now。

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

本版共 4 个迁移脚本，按时间戳顺序执行，命令：./quotepilot migrate

• 2026101501_shipping_route_freshness_fields.js：物流线路新增「最后复核时间」「复核人」「报价有效期至」三个字段；存量线路以最后修改时间作为复核起点回填，避免升级后全部被判为从未复核。
• 2026101502_remindertasks_logistics_enum.js：提醒分类新增「物流报价待复核」，提醒来源新增「物流」。
• 2026101503_reminder_tasks_org_visibility.js：提醒由「指派给个人」改为「组织可见」；按组织回填归属，无法归属的孤儿提醒会被删除，并按「组织 + 分类 + 来源」去重（优先保留未处理、其次保留最近更新的一条）。
• 2026101503_seed_org_logistics_review_cycle.js：为所有组织的「物流复核周期」写入默认值 30 天（仅补齐缺失项，不覆盖已有设置）。

⚠️ 部署注意

1. 需执行数据库迁移并重启后端：部署前运行 ./quotepilot migrate，完成后重启后端。迁移会改写提醒的归属与去重，无法归属到组织的旧提醒会被删除，建议在业务低峰期执行。
2. 前后端需同版本发布：物流复核与过期提醒、提醒按模块过滤、报价单沿用停用线路价格、保存前统一确认均为前后端联动功能。旧前端配新后端时，物流「待复核」标记与「物流」提醒页签不可用。
3. 品牌更名需先准备好新域名：系统邮件与通知的默认链接已改为 quickpoint.now，数据服务地址改为 pb.quickpoint.now。上线前需确认新域名解析、证书与反向代理可用，否则邮件链接、商家端帮助链接与 AI 助理接入地址会打不开。
4. 商家端（Shopify 应用）地址同步：商家端部署地址改为 merchant.quickpoint.now，Shopify 应用配置中的入口地址需要一并更新；环境变量支持新名 QUICKPOINT_URL，同时兼容旧的 QUOTEPILOT_URL。
5. 万邦欧盟运单时间点：万邦自 2026-10-23 起强制校验产品识别码，请在生效前完成本版发布，并确认欧盟订单商品的 SKU 已填写（缺省时回退变体编号）。
6. 提醒可见范围变化：成员看到的提醒范围由「指派给自己」变为「所属组织内自己有权模块的提醒」，请提前告知运营。
7. 物流复核默认 30 天：升级后所有组织的复核周期为 30 天，存量线路从最后修改时间起算；如组织需要更短或更长周期，请在 系统设置 → 其他 中调整。
8. Shopify 历史订单读取限制：应用未申请更长的历史订单读取权限时，创建超过 60 天的订单无法同步；如业务需要，请为应用补充该权限后重新授权。

---

本版涉及的提交（技术信息）

• QuoteGo（13 commits，head a47dd1b）：a47dd1b Merge branch 'main_final2'、7caf9e5 Merge branch 'main_final'、d3c4bfa 万邦欧盟运单补充 NS-PID 并回退商品标识、59580bf webhook 查询前跳过超出 60 天可见窗口的订单事件、9277d3e 为 Shopify GraphQL 调用增加硬超时并区分超窗订单、e1bbc00 Merge branch 'main_final_migrate_to_quickpoint' into main_final2、66f9efa Merge branch 'main_final_logistics_fresh_org_reminder' into main_final、2c5d8da Merge branch 'main_final_logistics_freshness' into main_final、005b74f 提醒可见性改按组织隔离并由后端按模块过滤、8c295a8 新增物流配置新鲜度检测与复核提醒功能、46d4c85 注释中 QuotePilot 统一更名为 QuickPoint、9a2b02a Merge branch 'main_final' into main_final_migrate_to_quickpoint、a6c24f1 更名 QuickPoint 并兼容旧版 Agent Token
• QuotePilot（13 commits，head a6fe980）：a6fe980 Merge branch 'main_final2'、c3f1c3d Merge branch 'main_final'、f80a94b 支持停用线路沿用快照价并统一保存确认、6b9d292 线路不可用横幅支持折叠并显示问题数量、4bd8431 订单同步失败时展示后端具体错误原因、0ea3703 Merge branch 'main_final_migrate_to_quickpoint' into main_final2、5c4436f Merge branch 'main_final_logistics_fresh_org_reminder' into main_final、2af7a8b Merge branch 'main_final_logistics_freshness' into main_final、31ab8ca 按用户模块权限过滤提醒来源与 Tab 展示、033dd0f 新增线路复核周期与报价过期提醒、d4c3d56 将 QuotePilot 统一重命名为 QuickPoint、a46c9a8 Merge branch 'main_final' into main_final_migrate_to_quickpoint、38d92d5 将 QuotePilot 全面重命名为 QuickPoint
• droppilot（2 commits，head 59e7461）：59e7461 Merge branch 'main_final' into main_final_migrate_to_quickpoint、ef99c40 品牌由 QuotePilot 迁移至 QuickPoint