liufumingren
|
e080bcbb76
|
feat(order): 商品明细增加操作列,按行展开 SN 码列表
- 详情抽屉的「商品明细」新增操作列:「SN码(N)」按钮点击展开该行的序列号列表(SN / 运单号 / 回传时间),再点收起
- 明细行与 el-table 展开箭头共用同一份展开状态;不再单独放一张独立的序列号表格
- 序列号按行号匹配,缺行号时按商品编码兜底
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-14 00:39:48 +08:00 |
|
liufumingren
|
d4128c4eee
|
fix(order): 修正手工单推送仓库的「未绑定系统商品」误判
- 推送前校验改为「能否解析到系统商品」:product_id / combo_product_id / 历史手工单 item_id(与商品编码一致)/ 无平台溯源时编码命中商品库
- 平台未绑定明细(带店铺商品 / 平台快照 / 平台商品ID)仍然拦截并提示先在「店铺商品」绑定
- 建单 / 改单写库时把历史手工单误存在 item_id 里的系统商品ID 迁到 product_id,并补 item_type / parse_status
- 推送报文 itemId 优先用仓库映射(warehouse_products.wms_item_id),避免把系统商品ID 当 WMS 商品ID 下发
- 手工单表单改用 product_id 记录所选系统商品(item_id 仅沿用历史数据)
- 新增 orderPushItems 与推送报文 itemId 单测
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-13 23:17:21 +08:00 |
|
liufumingren
|
61309c430f
|
feat(order): 留存 WMS 回传的 SN 列表并支持按 SN 反查订单
- 新增 order_sn_codes 关联表(order_id = order_index.id,一行一个 SN,唯一键兜底去重)
- deliveryorder.confirm 解析 orderLines[].snList / 包裹内商品 snList,幂等写入(仅委外中/已配送的订单)
- 订单列表新增 sn_codes 多值筛选(逗号/换行分隔,最多 200 个,精确匹配反查)
- 订单详情返回 sn_codes;订单导出支持「序列号」筛选
- 前端订单页新增「序列号」批量筛选与详情序列号明细
- 补充 WMS 回传报文说明与 lib 单测
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-13 22:42:57 +08:00 |
|
liufumingren
|
69c272d260
|
feat(dgj): 1688 淘宝分销单(thyny)换算成淘宝取号
生产实测:1688 单的 `OutChannel=thyny`(密文淘宝分销单,订单号形如 5127404439433014429)
没有进渠道映射表,落库成了「其他(OTHER)」,取号时匹配不到菜鸟模板
(2 单:dgj-10000290937711 等)。业务确认 thyny 就是淘宝分销渠道。
- DISTRIBUTE_CHANNEL_PLATFORM 增加 thyny → TB
- 单测:密文 thyny → TB / 淘宝;未识别渠道改用 chaoshibianli → OTHER(thyny 已有映射)
- 文档 §4.2 换算表、§4.2.6「已确认的渠道映射」、.github/copilot-instructions.md 同步
存量:这 2 单重新拉单即从 OTHER 变成淘宝,可用 YUNDA(TB → 12362952 菜鸟韵达一联4)取号。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-09 20:16:53 +08:00 |
|
liufumingren
|
9a0f826d1b
|
feat(dgj): 我的店铺支持同步商品与拉取订单(按 ShopId / SelectShopId 归属)
- listProducts:my_shop 用 SelectShopId=ShopId + SelectPlatformType,域名按 PlatformType 推导;缺 ShopId 明确报错
- listOrders:my_shop 用 LogicOrder.ShopId(Contract=in)过滤,本地按 row.ShopId 校验归属,不再带 UpFxUserId
- 订单 CreateTime 上界补 .999,对齐平台「待打订单」页抓包
- resolveTemplateTargets 按来源分支:自营店直接用 PlatformType 作为模板接口 platformType
- orderSyncTask 查询店铺补 external_source,避免按商家口径误拉
- 前端:我的店铺不展示/不刷新「所在区」,拉单提示按来源说明;ShopItem 增加 external_source
- 测试:补 ShopId 过滤报文、时间窗上界、buildProductForm 归属口径;文档同步 4.2.1.1
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-09 03:06:53 +08:00 |
|
liufumingren
|
c27ea5a789
|
feat(shop): 店管家接入「我的店铺」第二来源,支持拉取店铺并绑定货主
- 平台层新增 listShopSources() / resolveShopScope() 契约,来源由平台实现声明,控制器与前端不写死
- 店管家实现 my_shop 来源:POST /partner/LoadMyShopList 店铺列表(授权状态、平台、名称过滤)并归一化
- 新增 GET /api/external-print-accounts/:id/shop-sources;店铺列表接口支持 ?source=
- 店铺创建支持 source,写入 shops.external_source;编码 dgj-{账号ID}-{来源}-{ShopId},默认来源不加来源段
- 新增迁移 shops.external_source(默认 agent);刷新所在区只处理默认来源,避免自营店被误判解绑而自动禁用
- my_shop 的拉单/拉商品暂时明确拒绝,防止按账号 FxUserId 拉到上游其它数据(下一步接入)
- 前端「店铺列表」弹窗支持来源切换,展示平台、授权状态与服务到期时间
- 补充单元测试与文档(店管家取号-旧系统提取 §4.2.1.1)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-09 02:42:24 +08:00 |
|
liufumingren
|
ccf021c422
|
docs: 记项目记忆:分销单明文/密文规则 + 新增渠道处理步骤
- 新增 .github/copilot-instructions.md(项目记忆,AI 助手每次会话都会读到):
基本约定(测试/发布/提交规范、生产只读排查)、店管家分销单明文 vs 密文规则、
新增下游渠道的处理步骤、常见排查入口(取号/明细匹配/发货回传)
- 店管家取号-旧系统提取.md 新增 §4.2.6「新增下游分销渠道怎么加(明文/密文)」:
判定依据(TagValue 是否 _plaintext、extField7 是否含 outPlatformOrderNo)、
改哪里(DISTRIBUTE_CHANNEL_PLATFORM / isPlaintextDistributeChannel)、
模板唯一性检查(platform_code + custom_code)、单测与文档同步、实测佐证
背景:明文分销单(douyin_plaintext 等)在店管家没有原单信息,抖店/快手面单会被拒
(ErrCode=15002),已统一按淘宝(菜鸟)出号;后续新增渠道按这套流程处理。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-08 19:28:37 +08:00 |
|
liufumingren
|
6587e9b937
|
feat(dgj): 1688 明文分销单一律按淘宝出号
渠道标签成对出现:密文 `douyin`/`kuaishou`(订单带原单号,能用抖店/快手电子面单);
明文 `*_plaintext`(店管家侧没有原单信息,`Order.ExtraJson.extField7` 为空,
抖店/快手面单会被平台拒绝:ErrCode=15002「非抖店订单,无法使用抖音电子面单取号打印」)。
实测佐证:
- 店管家 UI 对明文单的打印弹窗默认模板是「【菜鸟】国内邮政小包一联3」(13873834),
正是我们库里 TB 平台下的模板,`LoadWaybillAccountDetailInfo` 也用 expressCode=POSTB
- 1688 单用菜鸟(TB)面单在生产成功过 11+ 单;TB + custom_code=YUNDA 唯一命中 12362952,不会撞多模板
改动:
- 新增 isPlaintextDistributeChannel(`*_plaintext` 结尾)
- normalizeOrder 的 1688 换算:明文 → TB;密文走 DISTRIBUTE_CHANNEL_PLATFORM
(douyin→DYXD、kuaishou→KS);未映射的非明文渠道仍 → OTHER;无渠道 → TB
- 渠道原值仍留痕在 extend_props.distribute_channel(如 douyin_plaintext)
- 单测:douyin_plaintext/kuaishou_plaintext/thyny_plaintext → TB,thyny → OTHER(12 例)
- 文档 §4.2 换算表与 §4.4.1 同步说明「明文单为什么按淘宝出」
存量:生产仅 2 张明文单,待审核单重新拉单即变淘宝(另一张已作废)。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-08 19:20:57 +08:00 |
|
liufumingren
|
e1f49451c0
|
fix(dgj): 取号失败透出平台 ErrCode/ErrMsg,取号报文构造可对照
取号失败时用户只看到「店管家取号失败:平台返回取号失败」——平台把逐单错误放在
`Data.WaybillCode[n].ErrCode / ErrMsg`(实测 15002「非抖店订单,无法使用抖音电子面单
取号打印…」),我们只读了 `ErrorMsg` / `Message`,真实原因被吞掉。
- 新增 describeWaybillError:按 ErrMsg → ErrorMsg → Message → OrderInfo/Order 兜底,
并附上 ErrCode;「未返回运单号」分支也带上平台原因
- 把 ExpressPrint 的 Orders[i] 报文构造抽成纯函数 buildExpressPrintOrder /
buildExpressPrintOrders(expressPrint 内部改为调用),并挂到 DgjService 静态方法上:
取号记录只有平台回显、没有请求体,出问题时要能把「我们实际发的报文」打出来对照
(对比过成功/失败两单:结构完全一致,只有业务值不同)
- 单测:dgjWaybillError(4 例)+ dgjExpressPrintPayload(5 例:字段映射、明细口径、
收件人、多包裹 Index、当前运单号)
- 文档补 §4.4.1:1688 分销单用抖音面单的前置条件(extField7 里要有 outPlatformOrderNo,
明文渠道单没有就报 15002,只能在店管家侧重新授权/建线下单)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-08 19:05:30 +08:00 |
|
liufumingren
|
8ae6733e97
|
feat(dgj): 1688 快手分销单换算成快手(KS)取号
生产 `external_print_express_interfaces` 里快手(KS)有 2 个启用中的面单模板,
把 `kuaishou` 加进渠道映射表即可让快手分销单正常取号(之前落 OTHER,
取号直接报「平台OTHER(其他)暂无面单模板」)。
- DISTRIBUTE_CHANNEL_PLATFORM 增加 kuaishou → KS
- 单测补 1 例:OutChannel=kuaishou → KS / 快手,原始平台仍留痕 1688
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-08 18:49:15 +08:00 |
|
liufumingren
|
8dbb0b59a5
|
fix(dgj): 1688 抖音分销单的渠道值带明文后缀被误判为「其他」
店管家对同一分销渠道会给成对的标签值(明文/密文两套写法),实测同一条抖音
分销单出现 `douyin` 与 `douyin_plaintext` 两种;平台换算用的是全等比较
`distributeChannel === 'douyin'`,于是 `douyin_plaintext` 落到「未知渠道」分支,
平台被换算成 OTHER,取号报「平台OTHER(其他)暂无面单模板」。
生产实测(Alibaba 70 单):douyin 56 单正确;douyin_plaintext 2 单被误判
(dgj-10000289308857、dgj-10000288822218,取号记录里都是无模板失败)。
- 新增 normalizeDistributeChannel:按 `_` 取主名(douyin_plaintext → douyin),
chaoshibianli_plaintext / thyny_plaintext 同理;标签原值仍原样留痕
- 渠道→平台改用显式映射表 DISTRIBUTE_CHANNEL_PLATFORM(douyin → DYXD)
- ExtField1 兜底:仅 1688 分销单、且没有 OutChannel 标签时用它识别渠道
(其它平台的 ExtField1 是哈希,实测快手单为 cb82842eb4b1a919,已排除)
- 单测补 4 例:明文后缀、ExtField1 兜底、无渠道仍按淘宝、其它平台哈希不误判
存量订单无需 SQL:待审核单重新拉一次单即按新口径更新平台字段。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-08 18:47:34 +08:00 |
|
liufumingren
|
20147fb391
|
fix(shop-product): 1688 单靠店管家规格编码匹配店铺商品
1688(Alibaba)订单的 SubOrders[].SkuId 被店管家塞成了商品标题,
平台规格ID 这条路永远匹配不到店铺商品(旧系统 Dianguanjia.php 的 get_sku_bind
只按 SkuId 严格等值,同样匹配不上)。规格的真实唯一键是店管家规格编码:
商品库 Skus[].SkuCode(如 10000446302877)= 订单 PtProductInfo.SkuCode,
抖店/拼多多的 SubOrders[].SkuCode 也是这个值,跨平台通用。
- shop_products 增列 outer_sku_code(迁移 20261109100000),商品同步时写入
Skus[].SkuCode,并加入 upsert 字段
- 订单明细归一化增补 outer_sku_code(PtProductInfo.SkuCode 优先,退 SkuCode),
随 platform_snapshot 落库;历史明细由 resolveItemSkuCode 回落到 raw.PtProductInfo.SkuCode
- 匹配口径改为「平台规格ID → 店管家规格编码 → (仅当完全无规格信息)商品ID 兜底」,
带了规格信息却都没命中时不退化成按商品ID取一条,避免绑错规格
- 拉单逐条匹配、明细解析、商品同步后批量重匹配三处共用 shopProductScopes/createShopProductMatcher
- 实测店铺 19 同步 1438 行后 rematched=44,1688 明细全部指向正确规格
(10000446302877→420ml*1瓶+排骨梳、…878→99ML黑色、…881→420ML)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-08 18:01:24 +08:00 |
|
liufumingren
|
62df580393
|
feat(product): 商品增加「订单唯一赠品」,明细解析整单只落一行
赠品类商品在平台上会随购买数量重复出现(数量 3 就是 3 件),也可能同时出现在多个组合里
(两份组合、不同组合都含同一赠品)。业务上赠品每单只送一份,需要按商品维度收敛。
- 迁移 add-unique-gift-to-products:products.is_order_unique_gift TINYINT 默认 0 + 索引
(已在本机执行)
- 模型/契约/列表接口:字段透传;列表支持 is_order_unique_gift=1/0 筛选
- 明细解析:rebuildOrderItems 展开成最小单位后调用 collapseUniqueGifts
→ collapseUniqueGiftRows 收敛:同一赠品只保留第一行、数量固定 1
(多数量 / 同一组合多份 / 不同组合都含该赠品,均只落一行);重复重建不会涨回数量
- 系统商品页:新增「订单唯一赠品」开关(带说明)、列表「唯一赠品」标记、筛选下拉;
导出(exportDefs.product)同步加筛选与列
- 单测:orderItemUniqueGift.test.js(纯函数 5 例)+ orderItemUniqueGiftRebuild.test.js
(真实库事务内验证两条明细数量 3 → 1 行数量 1,跑完回滚)
- 顺带修 model/product.js 里重复定义的 brand_name(eslint no-dupe-keys,两行内容相同)
- 文档 §6.1.1 补「组合拆分 + 订单唯一赠品」口径
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-08 11:28:18 +08:00 |
|
liufumingren
|
28adc28ea6
|
feat(shop-product): 店铺商品支持按平台商品ID / 规格ID 筛选
排查「某件商品/某个规格拉没拉全、绑定到哪」时只能靠关键词模糊搜,容易漏(关键词只匹配标题/商家编码/商品ID)。
- 后端 shopProduct.index:新增 outer_item_ids / outer_sku_ids 多值精确筛选(IN),
与 outer_codes 同口径(英文逗号分隔);keyword 增加 outer_sku_id 模糊匹配,
与导出关键词口径对齐
- 前端店铺商品页:搜索栏加「商品ID」「规格ID」两个多值输入;
重置/查询/导出条件同步带上
- 导出(exportDefs.shop_product):补 outer_item_ids / outer_sku_ids 筛选与 whereIn,
导出抽屉里同样能按 ID 过滤
验证:真实库按 outer_item_id=3835275595751752044、outer_sku_id IN (…) 命中 2 行;
vue-tsc / eslint / vite build 通过;test/app 139 passing(request_log 既有失败)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-08 11:04:30 +08:00 |
|
liufumingren
|
a06807ad7a
|
fix(shop-product): 列表只回 3 个规格时用 /Product/LoadSkuList 补全
平台 `/Product/LoadList` 返回的商品 `Skus` 固定只给 3 条(与 `SkuCount` 无关),
分销商品 3773823319627923739 声明 6 个规格、实际只下发 3 个,导致库里缺规格、
订单明细也匹配不到。商品页打开规格列表走的是另一个接口,实测可用:
POST /Product/LoadSkuList ProductCode=<商品行的 ProductCode>&ProductType=all&IsHideDelSku=false…
→ Data 为「数字键对象」,含全部 6 个规格(与列表的 Skus[] 同结构)
- 新增 dgj.fetchProductSkuList:按 ProductCode 拉全量规格
- 新增 dgj.repairProductSkus:只对 SkuCount > Skus.length 的商品补一次,
成功就地覆盖 product.Skus,失败只 warn(保留列表下发的部分)
- fetchAreaSnapshot 在快照确定后调用补全(分区 dbname 与查商品时一致)
- 单测 dgjRepairSkus.test.js 3 例(补全 / 不需要补 / 失败保留原样)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 23:24:35 +08:00 |
|
liufumingren
|
b63204d9fe
|
fix(shop-product): 识别规格没拉全的商品,避免误判下架
平台 `SkuCount` 与实际下发的 `Skus` 会不一致:线上商品 3773823319627923739
`SkuCount=6`,`/Product/LoadList` 只回 3 个规格(分销/多来源商品常见),
库里有 4 行(含一个平台已不再返回的规格)。此前整份快照 verified 后,
那些「平台没返回」的规格会被当成平台已下架,直接删除或标下架,绑定关系跟着丢。
- dgj.listProducts:逐个商品比较 `SkuCount` 与实际下发的规格数,
不一致就记入 `incompleteProducts: [{outer_item_id, expected, got}]` 并 warn 留痕
- controller.saveShopProducts:`incompleteProducts` 里的商品不参与「平台已下架」判定
(既不删除也不标下架),其余商品行为不变
- 同步商品接口返回 incomplete / incomplete_products;contract 补
externalPrintShopProductIncompleteItem
- 单测 dgjProductSkuCoverage.test.js 2 例(识别不全 / 一致时不标记)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 23:14:48 +08:00 |
|
liufumingren
|
5d3025cb2f
|
perf(dgj): 商品分页也按平台上限 500 拉,减少请求次数
平台分页上限为 500(订单列表一直是 500),商品列表此前用 200,商品多的店铺要多翻一倍页数。
- PRODUCT_PAGE_SIZE 200 → 500(实测 pageSize=500 正常返回,未被拒绝)
- fetchOrdersByIds 的 PageSize 封顶 ORDER_PAGE_SIZE(原 Math.max(50, ids.length) 在 id 多时可能超过 500)
- 正确性兜底不变:分页按 PageIndex 递增,平台若自行封顶也不会漏页,
fetchAreaSnapshot 仍用「去重商品数 = Total」校验完整性
- 文档「请求量控制」表补两条分页口径
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 22:58:36 +08:00 |
|
liufumingren
|
e22dcf2ead
|
fix(send): 逐单形态的「存在不是待发货的商品」也按已同步
上一版只覆盖了整包 `Success:false + Message` 的形态,线上这条提示其实走的是**逐单**分支:
`{"Success":true,"Data":{"Orders":[{"IsSuccess":false,"ErrorMessage":"存在不是待发货的商品,发货失败;"}]}}`,
而逐单幂等正则要求「不是待发货状态」,少了「状态」两字没命中,于是照旧抛错重试。
用户看到的 `店管家发货同步失败:: 存在不是待发货…` 里的双冒号就是逐单分支 + 平台未回 LogicOrderId 造成的。
- 抽出 SEND_ALREADY_DONE_PATTERN(不是待发货 / 已发货 / 已取消 / 已关闭),整包与逐单共用
- 逐单失败且平台未回 LogicOrderId 时不再拼「: 」前缀,避免出现「失败:: xxx」
- 单测补 2 例(逐单幂等 / 无单号时不出现双冒号),共 5 例
- 文档补两种形态的报文明细
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 22:56:20 +08:00 |
|
liufumingren
|
1b36e34f61
|
feat(send): 平台回「存在不是待发货的商品」时按已同步处理
dbname 修正后,同一批单平台改回业务提示 `存在不是待发货的商品,发货失败;`。
这类说明该单平台侧已经不在待发货(已发货/已取消),再重试也没意义,应直接按「已同步」。
- dgj.sendOrders:单包裹发送时整包 Success=false 且 Message 命中
「不是待发货 / 已发货 / 已取消 / 已关闭」→ 记 info 日志并直接返回(不发异常);
多包裹场景不套用(分不清是哪一单),仍按失败抛出
- 与原有「逐单 IsSuccess=false + 不是待发货状态」幂等口径保持一致
- 单测 dgjSendIdempotent.test.js 3 例(整包幂等 / 逐单幂等 / 其它整包失败仍抛错)
- 文档 §2.1 补整包幂等口径,§2.1.2 补「修正后返回变成业务提示」
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 22:52:44 +08:00 |
|
liufumingren
|
3b1c13492c
|
fix(send): 发货回传用取号记录的分区,别用模板记录的 dbname
线上「意洁」整批回传失败固定报 `店管家发货同步失败:12;ErrorCode=500`。对同一单、同一
fxdd 域名、同一模板只改 dbname 做对照(该单平台侧已发货,正确报文只会回「不是待发货」):
- dbname=y/2wUDWCZOk=(模板记录 external_print_express_interfaces.dbname)→ 12 / ErrorCode=500
- dbname=''(host 默认区) → 「存在不是待发货的商品」(业务类,正常)
- dbname=dzh93a8…(取号记录 dbname) → 同上,正常
根因:resolveTarget 把模板记录的 dbname 当成订单分区去发 OnlineSend / 回读订单行,
而那个值是「模板接口」的区(同账号所有模板相同),平台在错的区里解析 Orders → 抛 500,
Message 只回一串数字,看起来像报文缺字段(连带 §9f067c1 的实时行重试也拿不到行)。
- resolveTarget:dbname 改取 waybill_fetch_records.dbname(取号就在那一区成功),无取号记录时 ''
- 模板同步/查询仍用模板记录的 dbname,两者不混用
- recordFailure:报文类失败的备注里附平台原始返回(先 500 字内),订单页即可看到真实返回
- 报文类失败但回读不到实时订单行时,备注里明确写出来(原来静默按首次错误落库)
- 单测 externalSendDbname.test.js 2 例;文档补 §2.1.2(对照表 + 口径表)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 22:48:33 +08:00 |
|
liufumingren
|
956793ba66
|
fix(print-data): 换打印参数前必须做模板校验,补上 RequestBatchNumber 批次号
WMS「韵达」面单换打印数据时平台抛空引用(未将对象引用设置到对象的实例)。实测对照
(同一账号、同一 fxdd 域名、真实面单)定位到根因:RequestBatchNumber 由
DateNow + DayPrintBatchNumber 拼成,取号流程会先调 CheckTemplateAvaliable 拿这两个值,
而换打印参数时传的是 checkData: {},批次号退化成 1/1/,平台解析时抛空引用
(偶尔表现成「成功」但 documents 为空、WaybillCode 为 null)。
- dgj.fetchPrintParams:先 checkTemplateAvailable 再把 check.Data 作为 checkData 提交;
平台「成功」但没有任何 params 时按失败抛出,交给上层回退
- 去掉上一版尝试的 Orders[0][CaiNiaoAuthInfoId] 注入(实测加不加结果一样,不是根因)
- 保留 LoadPrintData 兜底(PrintHistory/LoadPrintData,按 printHistoryId 只读、不消耗面单):
订单已离开待发货、或平台仍未返回打印数据时用它拿到当时打印的 params(可能过期,标 params_expired)
- 单测 dgjFetchPrintParams.test.js 3 例(必须带批次号 / 空数据按失败 / 带平台原因)
- 文档更正:不是域名或菜鸟授权网点问题,是批次号,并附实测对照表
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 22:35:37 +08:00 |
|
liufumingren
|
37de11c309
|
fix(print-data): 菜鸟系面单换打印参数空引用时回退按打印记录取
WMS「韵达」面单换打印数据时平台回「拉取打印参数失败:未将对象引用设置到对象的实例。」,
这是 ExpressPrint 复用路径上的平台内部空引用,多发生在菜鸟系面单(韵达/申通/中通…)。
- dgj.expressPrint:Orders[0] 补 CaiNiaoAuthInfoId(菜鸟面单按模板授权网点取打印数据,缺了平台会空引用)
- dgj.fetchPrintParams:支持传入 caiNiaoAuthInfoId 注入订单行;平台空引用时在错误里补一句排查提示
- waybillPrintData.fetchGroup:复用取号拉参数失败后回退
POST /PrintHistory/LoadPrintData(按 printHistoryId 只读、不消耗面单),
用 Data[].PrintDataJson 里的 contents[].params + templateURL 兜住,返回标 source=print_history;
两条都失败才报错(带原原因)。成功路径仍优先 ExpressPrint(抖店签名要重新签发)
- 单测 waybillPrintDataFetch.test.js 4 例(成功不走回退 / 空引用回退 / 都失败 / PrintDataJson 解析)
- 文档补充双路径与踩坑记录
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 22:29:11 +08:00 |
|
liufumingren
|
4501ca3922
|
fix(send): 批量重试也节流并给出续跑提示
「同步异常」是 3 次失败后自动落的状态,定时任务只捞「待同步/待重试」,不会自愈,
要靠配送异常视图的「重试同步外部发货」人工重排。重试原本是一次性把所有单顺序打完、
没有间隔也没有上限,异常单多时容易把平台打成高频访问。
- externalSendSync.retry:逐单之间留 EXTERNAL_SEND_INTERVAL_MS(默认 300ms,与定时任务一致);
单次立刻同步上限 limit(默认 200),超出部分重置为「待同步」交给定时任务续跑,不会丢
- 返回值补 synced / remaining
- 前端重试提示带上「本次同步 N 条」与续跑说明
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 22:10:58 +08:00 |
|
liufumingren
|
349f7f2949
|
feat(pull): 「新增 0、更新 N」时说明这些单为什么不在待审核
拉单结果只报「新增 0 / 更新 N」,用户会以为「拉到 8 单却没落库」。
实际是拉单按平台单号(老表 orders.order_no = 平台code-平台单号)去重:
已在系统里的单只刷新平台状态与收件人,不会重复新增,也不会把已审核过的单退回待审核。
- externalPrintOrder.buildRefreshHint:created=0 且 updated>0 时给出说明
(已在「待推送 / 配送 / 历史」,或因平台侧已发货被自动作废,可按平台单号搜索)
- 接进 syncOrders 的 hint 链(零单/补查/兜底都不命中时才用)
- 单测补 1 例(含「有新增不提示」「0 更新不提示」)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 22:08:31 +08:00 |
|
liufumingren
|
9f067c1b58
|
fix(send): 发货回传遇平台 500 时改用实时订单行重发
线上「意洁」全部订单发货回传失败,文案只有 `店管家发货同步失败:12;ErrorCode=500`。
用同一账号对平台做对照实验(真实订单)确认:同一个单用**平台实时订单行**发送
`IsSuccess:true`;用本地快照行但清空 `SubOrders` 则回
`{"Success":false,"ErrorCode":"500","Message":"服务器繁忙,请稍会儿再试."}`。
即 500 是「平台没解析订单报文」,与订单业务状态无关。
- 新增 lib/platformError.isPayloadRejected:ErrorCode>=500 / 服务器繁忙 / 系统异常 /
Message 只有一串数字 → 报文类失败;业务类(不是待发货、都没打印、风控拦截、请先勾选)与限流不算
- resolveSendRow:本地快照拼出的行若 SubOrders 为空则不使用,改回读平台实时订单行(warn 留痕)
- syncOrder:命中报文类失败时用 forceRemote 回读订单行重发一次,成功即置「已同步」
- recordFailure:把平台原始返回写进日志,便于下次直接定位缺了哪个字段
- 单测 platformError.test.js;文档补 §2.1.1(对照实验表 + 兜底三步)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 22:04:37 +08:00 |
|
liufumingren
|
b7da68a40c
|
feat(shop-product): 移除「按商品ID拉取」,统一走同步商品 + 自动重匹配
按商品ID单品补拉会绕开分区声明与 SelectAgentId 过滤,容易把同一账号下别的商家的
同款商品写进本店铺(线上已确认拉错过别家商品),且与订单明细匹配口径
(店铺 + 平台商品ID + 平台规格ID)不是同一套数据来源。改为只保留全量快照同步。
- 前端店铺商品页:去掉「按商品ID拉取」按钮与弹窗,删除 pullExternalPrintShopProducts
及 PullShopProducts* 类型
- 后端:删除 controller/externalPrintAccount.pullShopProducts + findSavedShopProducts、
MAX_PULL_PRODUCT_ITEMS、路由 POST …/shops/:shopId/pull-products
- 平台层:删除 dgj.listProductsByIds 与 base.listProductsByIds 约定
- contract:删除 pullShopProducts* / externalPrintShopProductPull* 定义
- 文档 §4.2.5 补移除原因与替代做法(同步商品后自动重匹配,接口返回 rematched)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 21:45:50 +08:00 |
|
liufumingren
|
176e0c0f97
|
fix(order): 明细解析只认本单店铺,防跨店铺串号
线上出现「订单明细绑到了别家店铺的商品」:旧解析接口(`POST /api/order-items/{id}/parse`
与 `POST /api/orders/{id}/parse-items`)匹配店铺商品时只按 `principal_id + 平台商品ID +
规格ID` 查,同一个平台商品被多个店铺采集时(同款分销、多店铺同源)会命中别家店铺的行,
把别家的规格与绑定关系套到本单上,出库会发错货。
- 新增 lib/shopProductMatch.shopProductScope:匹配条件的唯一口径 —— 有店铺信息时只认本店铺,
只有无店铺信息的手工明细才退回主体范围;拉单(externalPrintOrder)与重解析共用它
- 解析逻辑下沉到 service/orderItemParse(`findShopProduct` / `isStaleShopProduct` /
`resolveItem` / `parseOrderItems`)。原来 order.js 里用的 `ctx.controller.orderItem`
在 Egg 里并不存在(controller 只挂到 app.controller),该接口一直是 500
- 失效关联自愈:明细指向别家店铺或已被删除的店铺商品时,重解析会连带清空
product_id/combo_product_id/item_type,不再沿用错误的系统商品;批量解析不再跳过这类脏数据
- 单测补 shopProductScope 4 例(本店铺 / 手工退回主体 / 空规格 / 缺商品ID)
实测(真实库,插入即回滚):shop 18 有、shop 19 没有时解析结果 shop_product_id=null、
product_id 同时被清空;补上 shop 19 的商品后命中 shop_product_id=1077、parse_status=1。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 21:38:03 +08:00 |
|
liufumingren
|
c73cc826d7
|
fix(order): 商品同步/补拉后自动重匹配未采集的订单明细
问题:拉单早于商品入库(新店铺第一次拉单,或商品是事后才补拉的)时,明细会停在
shop_product_id=null(parse_msg「未采集到该店铺商品」),之后商品补齐也不会自动
变化 —— 订单页一直显示未绑定,还被「仅已绑定」过滤掉,看起来像「有商品却匹配不上」。
另外「重新解析」旧接口只回写 order_items,改不动订单页读的状态明细表。
- 新增 lib/shopProductMatch:把「店铺 + 平台商品ID + 平台规格ID」等值匹配抽成纯函数,
明细带规格ID时必须精确命中同规格,不退化按商品ID乱取(避免不同规格绑成一行)
- orderItemResolve.rematchUnboundItems:商品写入后在同一事务里补匹配该店铺
shop_product_id 为空的明细,并重建命中订单(只动待审核/异常,已审核随审核锁定)
- saveShopProducts 调用它并返回 rematched;同步/单品补拉两个接口与前端提示都带上
- 文档补 §4.2.5:明细 → 店铺商品 → 系统商品的匹配口径、两种 parse_status=2 的区别
- 单测 shopProductMatch.test.js(精确命中 / 不退化 / 无规格取首行 / 空输入)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 21:30:29 +08:00 |
|
liufumingren
|
8e2419c870
|
feat(order): 待审核列表提示被隐藏的未绑定商品订单数
拉单提示「成功 9 单」但列表只显示 3 单,实际是明细商品未采集/未绑定的订单被
默认过滤(exclude_unbound=1)掉了,界面上看不到任何线索,容易误判为漏拉。
- service/orderStatus.list:exclude_unbound=1 时额外统计未过滤总数,返回 hiddenUnbound
- controller/orderStatus.index:输出 hidden_unbound
- contract.orderStatusPage:补 hidden_unbound 字段
- 前端 StatusPanel:工具栏显示「另有 N 单未显示」(hover 说明原因),点击即切到「含未绑定」
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 21:15:01 +08:00 |
|
liufumingren
|
d179cd3993
|
fix(pull): 一区(老分区)声明缺失时补扫 + 退化全量时提示可能漏单
用户报「抖音/抖店一区的 5 单拉不到」。按平台单号定位:5 单全部在
`fxdd.dgjapp.com(抖店-186,即一区)`,`ErpState=waitsellersend`、
`UpFxUserId=953516`、`ShopId=4500493`,新系统区/精选区里没有它们。
一区能拉到的前提是「待发货」过滤生效(`Contract` 必须是单个 `=`)。
- dgj.listOrders:把分区扫描抽成 scanArea;声明里没有老分区时不再直接跳过,
而是先挂起(deferredLegacy),新系统分区一单都没拉到时回头补扫老分区
(rescueHosts),命中会记 warn;确实有单时仍跳过并在 skippedLegacy 里列出
- externalPrintOrder:buildSupplementHint 兼容「补扫老分区」与「补查其它域名」两类;
新增 buildFallbackHint —— 有分区退化为「时间窗全量」时提示
「平台全量列表不含待发货单,可能漏拉,请检查后端版本(订单过滤 Contract 需为单个等号)」
- 单测:pullOrderHint.test.js 补 2 例(补扫老分区提示、退化兜底提示),
test/app/lib 75 passing
实测(本地库,同账号):只声明「抖店-二区」时 listOrders 仍能拿到
6931208417510390802 / 6931197358224080335 / 6931209886018010885 /
6919330748987944687 / 6931230754941796036 这 5 单(待处理 7 单)。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 21:03:14 +08:00 |
|
liufumingren
|
511f7abf94
|
fix(dgj): 补齐 listOrders 的 scanHost 定义,并补快手 key / 菜鸟 templateURL 打印字段
1) 修正 F47D8CC 的漏提:那次只提交了「补查其它域名」的调用侧
(`for (const host of hosts) await scanHost(host);`),把 `const scanHost = async host => {`
的定义留在了工作区,HEAD 上 `listOrders` 会 ReferenceError。本次一并补齐,HEAD 与工作区一致。
2) 面单打印字段按平台口径区分(WMS 侧联调结论):
- 快手(KS):printinfo = encryptedData,encryptprintinfo / key = 逐单密钥(原口径不变)
- 菜鸟系(TB / TM / TGC / 1688):平台 printInfo 为空,菜鸟打印只认整包 JSON
`{ encryptedData, signature, ver, templateURL }`,按该形态回拼 printinfo;
templateURL 取 `contents[0].templateURL`
- 其它平台:printinfo 原样用平台下发数据
- `extractDocumentContents` 增加 template_url 字段(缺失时为空串)
3) 单测:printPlatformDgj.test.js 覆盖 template_url 解析与淘宝/快手/其它平台三种口径,
test/app/lib 73 passing;eslint 干净
4) 文档:WMS-OMS-取号对接.md 追加 WMS 侧核实记录(快手 printinfo 未落库的报文缺字段结论、
打印数据形态兼容、菜鸟 templateURL 模板要求与对账表)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 20:33:33 +08:00 |
|
liufumingren
|
f47d8ccdec
|
fix(pull): 声明分区过期时补查其它域名 + 商家ID失效按名称重绑
用户现象:意洁点「拉取订单」0 单,但店管家 UI(精选-二区)有单;「同步商品」
同样 0 条,而「按商品ID补拉」能拿到 —— 说明不是没有数据,是**全量拉取只查了店铺
声明的域名/分区声明**(external_data.DbAreas)里那几块,声明过期就永远拉不到。
- dgj.listOrders:声明域名一单都没拉到(且没有平台已发货登记)时,补查账号其它域名
(FALLBACK_PRODUCT_HOSTS 里未声明的),命中记入 supplementHosts 并 warn;
「按商品ID补拉」本来就是这个兜底策略,现在全量拉取也一致
- dgj.listProducts:声明域名一个商品都没有时同样补查其它域名
- externalPrintOrder:新增 buildSupplementHint —— 靠补查才拉到单时提示
「店铺声明的分区 X 没拉到单,已自动补查 Y 并拉到 N 单;建议刷新店铺所在区/商家」
- shopAreaSync:商家ID在平台已不存在时,先按店铺名称在商家列表里找**唯一**候选并
重新绑定(rebound,写 warn 日志);同名多候选/已被别的店铺占用/无名称时不猜,
保持原有「标记已解绑并自动禁用」逻辑
→ 修掉「重新授权/换绑后商家ID变了,店铺被当成已解绑而禁用,拉单一律 0」
验证:
- 单测 shopAreaSync.test.js(唯一命中 / 同名多候选 / 已占用 / 空名称)、
pullOrderHint.test.js 补 3 例(补查提示与边界),test/app/lib 73 passing
- 真实库:把意洁店铺的 extId 改坏后 refreshAccount → 按名称重绑回 3966847、
FxUserId 恢复 953516、状态未被禁用;再刷新 5 个店铺 missing/disabled 均为空;
声明域名只保留 toutiao 时应能靠补查把抖店 6 单拉回来(已单测覆盖提示口径)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 19:40:33 +08:00 |
|
liufumingren
|
e0c718af8e
|
fix(waybill): 快手取号补齐 key 与加密面单字段
- dgj: 抽取 contents[0].key;快手单 printinfo 取 encryptedData、encryptprintinfo 取逐单密钥(对齐菠萝派口径)
- waybillGet: deliveryorder.getwaybill 响应新增 key 字段并透传给 WMS
- 探测脚本输出 encryptprintinfo/key 长度;补充单测
- 更新 WMS-OMS 取号对接文档的快手字段说明
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 19:05:36 +08:00 |
|
liufumingren
|
b22730fdcb
|
fix(pull): 订单查询 ErpState 过滤用单个等号,修抖店订单拉不到
用户抓包(fxdd.dgjapp.com/NewOrder/List,dbname 空)返回 6 单抖店待发货,
oms 拉取却是 0 单。逐个参数复刻后定位到 Filter 操作符写错:
- 平台订单页发的是 `Filters[1][Contract]=%3D`(即单个 `=`)
- OMS 发的是 `Contract: '=='`,抖店老分区(dzh93a8yur84Y3Yln2ha9RbPovVMhBTc)
直接回 `Success=false`「服务器繁忙,请稍会儿再试」
- 该错误被 `isFilterUnsupportedError` 当成「分区不支持过滤」→ 退化时间窗全量拉取
- 而平台**全量列表不返回待发货单**(实测 30 天 698/710 行全是 sended/success/close),
于是 6 单待发货怎么都拉不到,且被记成「拉取成功 0 单」
修复与验证:
- `fetchOrderPage` 的 ErpState 过滤改为 `Contract: '='`(与浏览器一致);
实测三个分区均生效:抖店-186 → 6 单、精选平台四区 → 6 单、新系统区 → 0 单;
`UpFxUserId` 的 `in` 过滤同样正常
- 修后 shop 19 一次拉单:18 单待处理(DYXD 12 / TB 4 / PDD 2),
其中 6 单 `875172835889885066` 等真抖店单已落 order_status_pending
- 退化兜底分支补 warn:平台全量列表不含待发货单,命中兜底时要能看出可能漏单
- 单测 `dgjOrderQuery.test.js`:断言过滤条件为 `CreateTime:between | ErpState:= | UpFxUserId:in`
- 文档更正 4.2.1 节:抓包是 `Contract=`,并记录本次踩坑与三分区对照表
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 19:02:19 +08:00 |
|
liufumingren
|
61a9587851
|
feat(pull): 拉单 0 单时给出「商家对不上」的排查提示
抖音平台订单拉不到排查结论:平台侧数据本身能拉到(意洁的 1688→抖店分销单
11-07 16:27 已入库 6 单 DYXD),问题出在「店铺声明的商家 FxUserId 与平台不一致」时
只回 0 单、看不出原因。本次让这种情况自己说话:
- dgj.listOrders:全量兜底扫描时记录平台实际出现的商家(UpFxUserId → 单量/店铺名),
返回 merchantSeen / otherMerchants
- externalPrintOrder:新增 buildZeroOrderHint —— 0 单且本店商家没出现过时,
输出「近 N 天没有出现 FxUserId=xxx(分区…),实际出现的是 意洁(953516,450 单)…」,
并提示刷新店铺所在区/商家
- 自动拉取的 last_order_sync_msg、手动拉取响应 hint / 前端提示都带上该说明
- 单测 pullOrderHint.test.js(2 例:有提示/无误报,含分区去重)
排查记录(本地账号 1 实测):
- 意洁(953516):15 天待处理 10 单 = DYXD 6 + TB 3 + PDD 1,抖音分销单正常
- 抖店分区(fxdd) 近 90 天 1099+154 单全部已发货/关闭,0 条待发货 → 平台侧确实没得拉
- 两家「奇迹商贸」店铺绑的商家 1921984 / 1844767 在全部分区 90 天内 0 单;
平台上真正有单的奇迹商贸商家是 401499 → 需要在 OMS 重新同步店铺
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 18:44:02 +08:00 |
|
liufumingren
|
673bd0bef3
|
docs(wms): 补菜鸟打印数据三段核查记录(printinfo 落库/形态兼容/templateURL)
记录 WMS 侧 2026-11-07 17:40 ~ 18:15 的三轮核查与修复:
1. OMS 淘宝(菜鸟)printinfo 落库不一致
- 生产对照菠萝派菜鸟:signature / encryptprintinfo / ver 一致,仅 printinfo 为空
- 影响:WMS 菜鸟主面单只从 printinfo 取,为空会退化为模板兜底,打印结果不一致
- WMS 侧新增 buildOmsCainiaoPrintinfo 回拼;自测 18 例通过;需随 WMS 发布生效
2. 打印数据格式不对
- printinfo 形态兼容(字符串/对象、encryptedData/encryptprintinfo 两种命名)
3. 菜鸟 templateURL 模板要求
- 模板 ID 与接口配置逐一对账一致(申通 288948 / 韵达 288658 / 中通 300336 / 京东 776130)
- printer_data_builder.js 模板地址改三级来源并告警兜底;回归 122 例通过
- 建议(不阻塞)OMS 在 deliveryorder.getwaybill 补 template_url
顺手去掉文末多余的 wms/ 占位行。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 18:18:14 +08:00 |
|
liufumingren
|
c1d3e17188
|
fix(shop-product): 平台规格ID 统一取 SkuId,重新拉取时就地覆盖
店铺商品落库时 outer_sku_id 早期取 SpecId、后来取 SkuId,两种口径混在一张表里;
而订单明细侧的规格ID 一直是 SkuId(resolveOrderSkuId 优先 SkuId),
两边不一致会导致订单明细匹配不到店铺商品。
- dgj.normalizeProduct:平台规格ID 统一取 SKU.SkuId,不再使用 SpecId
(SkuId 缺失时仍退化为店管家内部 ID,保持历史行为)
- saveShopProducts:新增 planShopProductRekey —— 老行按「平台商品ID + 规格名」唯一命中时
就地改写 outer_sku_id,而不是插入新行;否则老行会因为旧键不在快照里被判「平台已下架」
而删除/下架,绑定关系和订单溯源都会丢。同名规格不唯一、目标键已占用时不动,交给常规 upsert
- 先改键再 upsert,created/updated 统计与下架判定都按改键后的键计算
- 同步/补拉响应新增 rekeyed(校正行数),前端同步提示展示「校正规格ID N」
- 测试:shopProductRekey.test.js(4 例:SkuId 优先 / 就地改键 / 不猜同名 / 键未变);
真实库验证:把某行改成 `SPEC_xxx` 后重新同步 → id 不变、值被覆盖、行数不变(41 → 41)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 17:56:42 +08:00 |
|
liufumingren
|
9e1c476a55
|
perf(dgj): 平台请求节流 + 限流退避重试
线上取号/发货遇到服务商级限流:
`isv.request-limited 请求太频繁…配置限流QPS:600, 当前访问QPS:687`。
QPS 额度是整个 ISV 共享的,单靠降我们的并发压不住,所以两手都做:
削自己峰值 + 被限流时退避重试而不是直接判失败。
- dgj.request():所有平台调用的唯一出口,统一排队,相邻请求至少间隔
DGJ_REQUEST_INTERVAL_MS(默认 100ms,单进程约 10 请求/秒)
- postPlatformForm():命中 isv.request-limited / 请求太频繁 / 访问QPS 时
指数退避重试(DGJ_RATE_LIMIT_RETRY 默认 3 次、DGJ_RATE_LIMIT_BACKOFF_MS 默认 1000ms),
仍限流则抛「店管家接口限流:…已自动退避重试 N 次仍被限流,请稍后重试」并保留原始返回
- waybillGet:批量取号并发 4 → 2(WAYBILL_CONCURRENCY 可调),
每单 3 次平台调用(回读订单 + 模板校验 + ExpressPrint),并发越大突发越猛
- externalSendSync.recordFailure:平台限流不算这单的错,
保持「待重试」且不累加 external_send_times,避免批量重试时一批单被打成「异常」
- 单测 dgjRateLimit.test.js(4 例):限流识别、退避后成功、重试耗尽报错、全局间隔生效
- 文档:请求量控制一节补 QPS 限流口径与全部节流开关
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 09:46:45 +08:00 |
|
liufumingren
|
da468f6cb2
|
fix(send): 取号记录必须与本单运单号匹配,不再取最近一条
上一版按「最近一次成功取号记录」取快递编码与面单标识,但同一单可能取过多次号
(每次分配新号,本地库里 dgj-10000267890142_1 就有 4 条不同运单号的记录)。
随便取一条会让发货模板(快递)和 WaybillCodes 面单标识与真正发出的运单号错位,
甚至把别的运单号发到平台。
- externalSendSync.findLatestFetchRecord:按配送单的运单号
(express_codes / express_code)逐条匹配取号记录的 waybill_code / waybill_codes,
主运单优先;运单号对不上返回 null 并 warn,报文宁可不带面单标识也不拿别人的;
订单号 LIKE 前缀匹配转义下划线,避免 `..._1` 误匹配 `..._10`
- dgjSendRow:新增 parseOrderWaybills / parseFetchWaybills;
pickWaybillFromFetchRecord(raw, waybills) 只取与订单运单号一致的那张;
buildSendRow 的 WaybillCodes 只保留本单运单号,LastWaybillCode 以本单运单号为准
- 单测:dgjSendRow 补 3 例(按号选面单 / 对不上不回填 / 运单号清单解析),
externalSendTemplate 补 3 例(按号挑记录 / 无匹配返回 null / 多包裹主运单优先)
- 文档补匹配口径与实测表
真实库实测:配送单运单 772085332374413 → 记录 #14;改成 772085215446719 → 记录 #13
(不再取最新那条);改成不存在的号 → null + warn。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 09:22:16 +08:00 |
|
liufumingren
|
8a38b7a1f3
|
fix(send): 发货模板按运单实际快递定位,修抖音风控拦截
线上报 `10000280844951: 风控拦截#CONSIGN_RISK_CONTROL_BLOCK#NOT_MATCH_SEGMENT_CHANNEL#
此运单号非抖音的运单号`。
根因:发货模板取的是「账号 + 平台」下 id 最小的那条快递接口(抖音小店第一条是中通),
而运单是申通。店管家把 TemplateId / ExpressCompanyId / ExpressCompanyCode 透传给平台,
抖音按模板的电子面单渠道校验运单号,运单不在该渠道号池里就判风控。
- externalSendSync.resolveTarget:运单快递取最近一次成功取号记录的 express_code
(兜底配送表 logistics_code;注意 express_code 列存的是运单号),
再用与取号同口径的 resolveByCode 定位模板;未绑定时按模板自带快递编码匹配,
仍无命中才退回第一条并打 warn
- externalSendSync.resolveSendRow:取号记录只查一次,供模板与报文复用;
WaybillCodes 为空时打 warn(平台校验渠道依赖该字段)
- dgjSendRow.buildSendRow:面单 ExpressCpCode 优先取号记录的快递编码,模板编码只做兜底
- dgj.sendOrders:风控/渠道类失败追加处理提示(需用对应平台+该快递的电子面单模板重新取号)
- 单测:新增 externalSendTemplate.test.js(4 例);dgjSendRow.test.js 补「快递编码不被模板覆盖」
本地库真实数据验证:快手单 dgj-10000267890142_1 运单 772085332374413 属申通,
旧逻辑命中模板 #17/YUNDA,修正后命中 #29/STO;抖音四张模板按快递分别命中
(STO→10776786、ZTO→13987231、YUNDA→12360764、POSTB→12712711)。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 09:13:58 +08:00 |
|
liufumingren
|
9826de2ad1
|
feat(ui): 标题改为天豹云OMS订单管理系统,登录页作为首页
- 浏览器标题、侧边栏 logo、登录页品牌名统一为「天豹云OMS订单管理系统」
- 登录页底部新增备案号(可点击跳转工信部核验)与版权信息;窄屏/极矮屏改为
常规流排布,避免页脚压在登录卡片上
- 路由调整:根路径 / 直接渲染登录页(首页即登录),/login 重定向到 /;
登录成功后进仪表盘 /dashboard,已登录访问 / 或 /login 同样回仪表盘
- 退出登录、401 失效统一回到首页(登录页)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 08:51:53 +08:00 |
|
liufumingren
|
6facd9c6f3
|
perf(log): 日志表按天分区,只保留 10 天
callback_logs / api_outbound_logs / request_logs 只增不减,DELETE 只标记删除、
磁盘不还。改为按 TO_DAYS(created_at) 做天分区,用 DROP PARTITION 物理删除。
- 迁移 20261107080000:三张日志表主键改为 (id, created_at)(MySQL 要求分区键
包含在主键里),分区布局 p_old + 最近 10 天 + 未来 2 天 + pmax
- 新增 logRetention service:补未来分区(REORGANIZE pmax)→ DROP 过期分区;
表若未分区则退化为分批 DELETE + OPTIMIZE 兜底
- 新增每日任务 purgeApiLogs(03:30):clean_request_logs 改为 disable,
避免两条清理逻辑抢同一张表
- 保留天数默认 10 天,可用 LOG_RETENTION_DAYS 覆盖
- 文档补分区口径、为什么要 DROP PARTITION、上线注意
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 08:43:16 +08:00 |
|
liufumingren
|
1d29e03ba2
|
feat(log): 对外回调日志可查询
外部系统调用 OMS /openapi 的请求与返回一直有写 callback_logs,
但没有任何查询入口,WMS 侧排查「回调有没有到、报了什么」只能翻服务器日志。
- 新增 GET /api/callback-logs:按主体隔离,支持仓库/接口配置/方法/app_key/
结果/IP/关键词/时间范围过滤 + 分页
- 补 contract schema(callbackLogItem / callbackLogPage / callbackLogListResponse)
- 外部接口页新增「回调日志」tab:展开可看请求参数、请求报文、返回报文、
异常信息、来源IP 与 app_key,并支持按当前仓库导出
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 08:43:14 +08:00 |
|
liufumingren
|
8b4fe94bbf
|
feat(external-api): 配置列表不再展示「基础地址」,按日志核对即可
接口调用日志里已有「请求地址」列,配置列表再放一列基础地址是重复信息:
- 配置列表去掉「基础地址」列
- 弹窗本来就已隐藏该字段,保存时按接口类型预设写入
- 导出的「接口地址」列保留(对账/归档用)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 08:34:08 +08:00 |
|
liufumingren
|
cd7a621aff
|
feat(external-api): 弹窗不再展示「基础地址」,按接口类型自动写入
接口类型已经能带出地址,表单里再放一个只读又改不了的输入框是噪音:
- 弹窗去掉「基础地址」输入项;保存时用类型预设值写入(老配置保留库里的现有值)
- 列表与导出仍保留「基础地址」列,方便核对实际使用地址
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 08:29:05 +08:00 |
|
liufumingren
|
6b320a94b2
|
feat(external-api): 接口类型改为下拉「天豹云WMS」,选中自动带出基础地址
- 接口类型从只读文案改成下拉,选项为「天豹云WMS」(值仍为 qimen,服务端照旧固定写入)
- 选中后自动填基础地址 https://qimen.wms.gztbyc.com/openapi,不用手填;
已手工改过的地址不会被覆盖
- 新增配置时默认就是天豹云WMS + 对应基础地址
- 列表「接口类型」列按类型显示中文;导出同口径(qimen → 天豹云WMS)
- contract / api 注释同步改成「天豹云WMS(类奇门JSON接口)」
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 08:25:57 +08:00 |
|
liufumingren
|
2b60136443
|
feat(order): 筛选栏把「平台单号」提到默认行,与「订单号」互换位置
- 默认筛选行第一位改为「平台单号」(批量查询,最常用),订单号收进「展开」区
- 展开区顺序:订单号 → 来源订单号 → 店铺 → 收货人 → …
- 配送异常视图隐藏「外部发货」下拉(该视图固定筛 2,3,避免误以为是可改的筛选)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 08:22:38 +08:00 |
|
liufumingren
|
bc2aa988ae
|
perf(delivery): 配送表补回传相关索引,导出补回传状态与失败原因列
明确口径:发货回传失败**不转表**——进了配送说明仓库已打包发货,是既成事实,
必须在配送表可见/可导出,只在表内标记 external_send_status,由「配送异常」视图处理。
- 迁移 20261107060000:加 `idx_delivery_send_scan (external_send_status, external_send_at)`,
覆盖定时任务 `status IN (0,2) AND times < 3 ORDER BY external_send_at`;
列表筛选沿用已有的 `(principal_id, external_send_status)`,EXPLAIN 确认两条都命中索引
- 订单导出补三列:回传平台状态(中文)、回传重试次数、回传失败原因
- 文档记录「不转表 + 索引 + 归档」的口径
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 08:21:35 +08:00 |
|
liufumingren
|
91e90cc7e2
|
feat(order): 新增「配送异常」视图,回传平台失败可看原因并重试
订单页左侧「配送」下面新增「配送异常」tab:
- 数据 = 配送表 + external_send_status IN (2 待重试, 3 同步异常),不用再进配送页自己筛
- 新增「回传失败原因」列(红色 + tooltip 全文),状态列保留「第 N 次」
- 行内「重试」按钮(单条重试),批量重试仍走原 resend_external
- tab 上带红色数量徽标(待重试 + 同步异常),重试后自动刷新
- 导出:配送异常视图导出时按 2,3 过滤;导出面板新增「回传平台状态」多选
后端导出补充 external_send_status 过滤(与列表接口同口径)。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 08:18:34 +08:00 |
|
liufumingren
|
498543b9d7
|
perf(external-send): 控制回传平台的请求量,避免被判刷单
全部回读订单行在批量场景会被平台当成高频访问,补齐三处节流:
- syncPending:同批相邻两单之间留 EXTERNAL_SEND_INTERVAL_MS(默认 300ms)
- resolveTraceId:按账号缓存,批量内只调一次 getUserInfo(原来每单一次)
- dgj.resolveTraceId():实例级缓存 5 分钟的 traceId,
取号(fetchWaybillNo)与重打(waybillPrintData)改用它,批量取号不再逐单 getUserInfo
配合上一版的「快照拼报文」,发货每单只有 1 次 POST,不再回读订单行。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 08:14:12 +08:00 |
|