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 |
|
liufumingren
|
bcca0075be
|
feat(external-send): 发货回传改用本地快照拼报文,不再回读平台订单行
拉单时已把平台整行存进 orders.external_data(实测 113 字段,含 PathFlowCode /
ShippingType / OrderTags / SubOrders[].OrderItemId 这些状态表没有的内部字段),
发货报文其实就是这一行,所以没必要再回读平台。
- 新增 lib/dgjSendRow.js#buildSendRow:快照(静态内部字段)
+ 状态表(收件人/平台单号/运单号,可能晚于快照更新)
+ 最近一次成功取号记录(WaybillCodeId / Pid / ExpressCpCode / CreateDate)
拼成订单行;PrintState/ExpressPrintTime 用取号记录覆盖(快照里恒为 0/空)
- externalSendSync.resolveSendRow:快照可用就不访问平台;缺快照(历史单)才回读兜底
- dgj 暴露 buildSendOrder 静态方法,供脚本/单测复用同一口径
实测(本地真实单 dgj-10000279877231):拼出的 Orders[0] 覆盖抓包全部 47 个关键字段
(163 个顶层键),面单块含 WaybillCodeId=10000298258339、Pid=ced304e7c1ffd618_0_1。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 08:12:54 +08:00 |
|
liufumingren
|
01ab1ccdab
|
fix(external-send): 发货回传改用 /NewOrder/OnlineSend 并按抓包补全报文
生产报错「店管家发货同步失败:请先勾选要发货的订单」= 平台没把提交的 Orders 当成有效选中项。
实测对比(2026-11-07):
- 空 Orders → 「当前选中的订单都不是待发货状态,已取消发货」
- 我们的旧报文 → 「请先勾选要发货的订单」
- 抓包页面真实请求:`POST /NewOrder/OnlineSend`(不是 OnlineSendBatch),
顶层带 TemplateId / ExpressCompanyId / ExcludeOrders / RequestBatchNumber,
Orders[0] 带整行模型(ShopId、PlatformTypeName、UpFxUserId≠FxUserId、OrderTags、
ShippingType 加密串、ExpressPrintTime、WaybillCodes、Items、OrderItemStrList 等)
改动:
- ONLINE_SEND_PATH 改为 /NewOrder/OnlineSend
- 新增 buildSendOrder:按抓包字段组装 Orders[i];再补 TemplateId/ExpressCompanyId 等顶层参数
- externalSendSync 把模板 ID / 快递公司ID / 快递编码传给 sendOrders
- 响应改为「整包 Success + Data.Orders[] 逐单结果」判定:
逐单 IsSuccess=false 时,除「不是待发货状态/已发货/已取消/已关闭」(幂等)外都算失败
实测:新报文被平台接受(整包 Success=true, ErrorCode=200),
测试单返回逐单 ErrorMessage「订单不是待发货状态,请检查」(该单 08:06 已在平台手工发货),
按幂等口径视为已同步。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 08:09:56 +08:00 |
|
liufumingren
|
c4943523b7
|
fix(external-send): 「请先勾选要发货的订单」补一句报文口径提示
实测对比(2026-11-07,只发空报文):
- 空 Orders → 「当前选中的订单都不是待发货状态,已取消发货」
- 我们的完整报文(6.5KB,Id/LogicOrderId/PathFlowCode/WaybillCode 齐全)→ 「请先勾选要发货的订单」
说明平台把我们提交的 Orders 当成「没有勾选」,属于报文口径问题,不是业务状态问题。
失败信息里补一句「平台未识别提交的订单报文,需核对 OnlineSendBatch 报文口径」,
避免和「没取号/没打印」混淆。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 08:05:14 +08:00 |
|
liufumingren
|
9cc301916e
|
fix(external-send): 发货同步失败给出完整原因,前端可看全文
现象:配送列表只显示「店管家发货同步失败:请先」,看不出到底缺什么。
- dgj.sendOrders:失败时拼上平台 ErrorCode、逐单错误(Data[].IsError/ErrMsg/Message),
并在订单没有运单号时补一句「N 单在店管家还没有运单号(可能未取号/未打印面单)」
- StatusPanel:同步失败原因加 tooltip,鼠标悬停可看完整文案(原来只有 CSS 省略号)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 08:01:42 +08:00 |
|
liufumingren
|
cf0d984224
|
fix(shop-product): 「待绑定」只统计待审核/异常的订单,避免绑定后数字清不掉
现象:店铺商品已绑定系统商品,列表仍显示「N 单待绑定」。
原因:「待处理订单数」把 order_status_items 里所有 parse_status=2 的订单都算进去了,
但绑定只对「待审核 / 异常」的订单重建明细(syncOrderItemsOf → rebuildOrderItems 的状态白名单),
已流转(待推送/委外中/配送/历史/作废)的明细不会跟着变 → 数字永远清不掉。
- attachUnboundOrderCount:只统计 current_status ∈ (pending, exception) 的订单
- 「有订单未绑定」筛选(列表 + 导出)同口径,保证筛选结果与徽标一致
- 抽出 editableOrderIdsSql 复用
本地验证:店铺商品 59 的未绑定单从 8 → 7(其中 1 单已作废);其余不变。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 07:57:23 +08:00 |
|
liufumingren
|
d5b4298c86
|
refactor(waybill): 更正语义——这不是「重打」,只是给需要 params 的平台拉打印数据
- dgj.reprintPrintData → fetchPrintParams;expressPrint 选项 reprint → reuseWaybill
(PrintMethod=Normal + IsIgnoreWaybillRepeat=true = 复用原运单号、只重新下发打印数据)
- 提示语与安全闸措辞改为「拉取打印参数 / 平台分配了面单」,不再叫重打
- 模板不返回 params 时明确提示:只有抖店面单需要 params,
淘宝/拼多多/京东/视频号等直接用取号返回的 printinfo 打单
- 文档同步:LoadPrintData 只回放历史签名;拉 params 走「复用原号重新下发」;
仅抖店需要 params;验收记录改为「拉取 params 未产生新面单(余额 5253→5253)」
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 07:52:23 +08:00 |
|
liufumingren
|
f7d070a2b4
|
docs(waybill): 记录重打验收结果
2026-11-07 线上验证:deliveryorder.getprintdata 重打未产生新面单,
返回原运单号 + 新鲜 params(timestamp = 请求时间),测试通过;
误分配的 2 张面单已由业务侧回收。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 07:46:28 +08:00 |
|
liufumingren
|
3b98a1c3dc
|
feat(waybill): getprintdata 改走「原单号打印」重签,拿到新鲜的 params
上一版用 PrintHistory/LoadPrintData,实测它只回放那次打印的签名(timestamp = 打印记录
CreateDate,换 FxPageType / IsRePrint / IsRefresh 都不重签),10 分钟后必过期。
实测出真正的重签方式(复用原运单号、不消耗面单):
ExpressPrint + PrintMethod=Normal + IsIgnoreWaybillRepeat=true
→ 返回的运单号与原来一致,params.timestamp = 当前时间。
- dgj.reprintPrintData:原单号打印并解析 documents[].contents[].params
- dgj.expressPrint 支持 reprint 选项(Normal + IsIgnoreWaybillRepeat=true)
- getprintdata 改为:回读平台订单行 → 原单号打印 → 返回新 params / template_url;
安全闸:若平台返回了新运单号(说明已消耗面单)直接判失败并 error 日志
- 仍逐张串行 + 300ms 间隔限流;参数归一化/定位逻辑不变
实测:请求 07:39:44 → params timestamp 2026-11-07 07:39:45,运单号 770357415909002 未变。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 07:40:30 +08:00 |
|
liufumingren
|
82ebe7e022
|
fix(waybill): 实测 LoadPrintData 只回放历史签名,返回 params_timestamp/params_expired
核实结论(2026-11-07,真实账号只读探测):
- Data[0].PrintDataJson、PrintHistoryData.PrintDataJson、PrinterJsonData 里的 params 完全一致,
timestamp 都等于该打印记录的 CreateDate(实测 05:52:50 / 06:43:36)
- 换 FxPageType=1/2、加 IsRePrint / IsRefresh 都返回同一个 timestamp/sign → 接口不会重签
- 所以「打印前换新 params」不成立;只有取号那一刻返回的 params 是新鲜的,10 分钟后必过期
- getprintdata 结果新增 params_timestamp / params_expired,message 里点明是历史签名与后续做法
- 文档更正:LoadPrintData 是回放、不是重签;重打需走 ExpressPrint「原单号打印」重签(待接入)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 07:31:55 +08:00 |
|
liufumingren
|
82879cdef5
|
feat(waybill): getprintdata 只回 params 串,并按 printHistoryId 逐个限流回源
- 返回精简:每单只给定位字段 + params(contents[].params,形如
access_token=…&app_key=…&method=logistics.getShopKey&…&sign=…)与 template_url;
不再回整包 print_data / printer_config / document
- 限流:平台该接口有限流,改为一次只带一个 printHistoryId,逐张串行并间隔 300ms;
单张失败不影响其它张,失败原因逐单返回
- params 为空时直接判失败(平台的打印数据里没有 params)
实测:{ printHistoryId: "10000078656212" } → params 为 access_token=uo7…
&method=logistics.getShopKey&…&sign=8849…,template_url 为申通 76x130 模板。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 06:56:20 +08:00 |
|
liufumingren
|
07a27a5bbd
|
perf(waybill): getprintdata 支持只传一个 printHistoryId,并按 id 定位避免全表扫描
- 只传 printHistoryId(单值/数组)时,用取号落库的 platform_host + dbname + account_id
直接回源 PrintHistory/LoadPrintData,WMS 不用知道域名与分区
- 记录定位改为 (waybill_code IN …) OR (print_history_ids LIKE '%"id":"…"%'),
避免直传 id 时按主体全表扫描
- 文档补最简用法
实测:{ printHistoryId: "10000078656212" } → 运单号 770357408441408、dbname y/2wUDWCZOk=、
print_data 7888 字符、documentID 770357408441408。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 06:53:07 +08:00 |
|
liufumingren
|
ccd007005a
|
feat(waybill): 取号响应回传 print_history_ids,由 WMS 自行落库
deliveryorder.getwaybill 的逐单结果新增:
- print_history_ids: [{ id, pid, waybill_code, batch_index }](每张面单一条,与 waybill_codes 对应)
- print_history_id: 第一张的 id(便捷值)
平台不会把 printHistoryId 放进面单数据(printinfo 里对应字段恒为 null),
只能从 Data.PrintHistoryIds[] 取,所以直接在响应里给到 WMS,便于其对账/查重。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 06:47:32 +08:00 |
|
liufumingren
|
f08d6c0fa7
|
docs(waybill): 说明 printHistoryId 只在响应顶层、不在面单数据里
实测确认:ExpressPrint 的 PrintDataJson.id 与 printDataJson.printHistoryIds 都是 null,
WaybillCode[] 里也没有该字段;printHistoryId 只出现在
- 取号:Data.PrintHistoryIds[].Id
- 回捞打印数据:Data[].ID(实测 10000078656212,number)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 06:45:55 +08:00 |
|
liufumingren
|
09587bc3e7
|
feat(waybill): 新增 deliveryorder.getprintdata,打印前按运单号换新 params
店管家面单打印数据(params)只有 10 分钟有效期,取号返回的 printinfo 存着不能用,
WMS 真正打印前必须换新的。新增对外方法:
method = deliveryorder.getprintdata
入参:{ caiNiaoAuthInfoIds: [6838859], waybillCodes: ["770357408441408"] }
也支持直传 { printHistoryIds: ["10000078656212"] }(命中即跳过查库)
出参:{ total, success, failed, expires_in: 600, results: [...] }
每单含 print_data / printer_config / document(documentID = 运单号)
实现:
- app/lib/waybillPrintData.js:按「店铺标识 + 运单号」查 waybill_fetch_records 定位打印记录,
同账号同分区合并成一次 PrintHistory/LoadPrintData(只读,不消耗面单)
- 取号记录补 platform_host(实际命中的订单域名):1688 分销单在 fxali、真实抖音单在 fxdd,
用被换算过的 source_platform_code 推域名会打错
- waybillGet 落 platform_host;迁移 20261107050000 加列
实测(只读):运单号 770357408441408 → 新 params 7888 字符,documentID 770357408441408,
printer 默认打印机;不存在的运单号返回「未找到该运单号的取号记录」。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 06:38:34 +08:00 |
|
liufumingren
|
9252763aba
|
feat(waybill): 取号记录补店铺标识与分区,新增回捞打印数据能力
抖店面单打印数据(params)只有 10 分钟有效期,WMS 真正打印前必须回平台换一次新的,
因此取号时要留下「定位用」的信息。
- waybill_fetch_records 新增 cai_niao_auth_info_id(=店铺唯一标识)与 dbname(取号命中的分区)
- 迁移 20261107040000 加列 + 运单号索引(principal_id + cai_niao_auth_info_id + waybill_code)
- dgj.fetchWaybillNo 回传实际命中的 dbname;waybillGet 落库并把 CaiNiaoAuthInfoId 写入留痕上下文
- dgj.loadPrintData:POST /PrintHistory/LoadPrintData(printHistoryIds[] + dbname),
解析 Data[].ID/ExpressWaybillCode/TemplateId/PrintDataJson,只读不消耗面单
实测(只读):打印记录 10000078656212 → 运单号 770357408441408,模板 10776786,
print_data 长度 7888。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 06:33:15 +08:00 |
|
liufumingren
|
7f8cff808b
|
feat(waybill): 取号时解析并留痕打印记录ID(PrintHistoryIds)
平台 ExpressPrint 响应里有 Data.PrintHistoryIds,元素 { Id, Pid, WaybillCode,
WaybillCodeChild, BatchIndex },其中 Id 即 printHistoryId:重打/作废/查打印记录
(PrintHistory/LoadPrintData)都按它回捞。之前只用了 WaybillCode/printinfo,
这块被丢掉了。
- dgj.fetchWaybillNo 解析为 [{ id, pid, waybill_code, batch_index }]
- waybillGet 写入 waybill_fetch_records.print_history_ids(JSON 数组,多包裹对齐)
- 仅本地留痕,不改回 WMS 的响应契约
- 迁移 20261107030000 加列;单测覆盖真实响应样例与多包裹/缺失字段
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 06:26:46 +08:00 |
|
liufumingren
|
c5bf929b3a
|
fix(waybill): 取号回读订单时按分区兜底,避免「未找到订单」
模板记录的分区可能与订单实际所在分区不同(店铺迁区/模板按账号同步),
只在模板分区里查会直接报「店管家未找到订单」,且把模板分区也带进报错便于定位。
- fetchWaybillNo:模板分区查不到时用 listProductAreas 逐个分区回读,命中即改写 dbname
- 分区回读异常(非法 dbname 等)不中断,继续下一个分区
- 找不到订单时在错误信息里带上域名 + 分区
实测:1688 抖音分销单 10000280844952 在 fxali/新系统区 命中;
传原始平台域名 + 故意用错分区仍能回读成功,不传原始平台则复现 fxdd「未找到订单」。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 05:49:58 +08:00 |
|
liufumingren
|
6ffe7cc889
|
fix(waybill): 1688 分销单换算后按原始平台回读订单(域名回退)
平台换算只用于「选对模板」,订单行仍留在店管家原始平台分区,域名必须按
extend_props.original_platform_code 推导,否则会用错域名被判「平台已查不到」。
- fetchWaybillNo:新增 originalPlatformCode,用原始平台算订单域名;waybillGet 从 extend_props 透传
- fetchRowsForVerify:拉单核对/自动作废按原始平台选域名,并给候选行补 extend_props
- checkPlatformFinished:审核前已发货校验按原始平台选域名
- externalSendSync.resolveTarget:发货回传 PlatformType 优先按原始平台
实测同一条 1688 分销单:fxali 命中(ErpState=waitsellersend),fxdd 查不到。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 05:44:57 +08:00 |
|
liufumingren
|
0e222789dd
|
feat(order): 1688 单按分销渠道换算电商平台(抖音小店/淘宝/其他)
店管家侧没有 Alibaba(1688)面单模板,1688 单实际要用下游渠道的电子面单,
按平台 1688 找模板必然取号失败。拉单落库时按硬规则换算(dgj.normalizeOrder):
| 原始平台 | 判定(Tags / OrderTags) | 落库平台 |
|---|---|---|
| 1688(PlatformType=Alibaba) | Tag=OutChannel 且 TagValue=douyin | 抖音小店 DYXD |
| 1688 | 有 OutChannel 但渠道未映射 | 其他 OTHER(渠道留痕,等后续映射) |
| 1688 | 无 OutChannel(非分销单) | 淘宝 TB |
| 其它平台 | —— | 原平台不变 |
- 原始报文完整保留:orders.external_data 仍存店管家整包(含 Tags),platform_type 保留 Alibaba
- 状态表 extend_props 增加 original_platform_code='1688' 与 distribute_channel=<渠道原值>,便于追溯
- 历史数据由迁移 20261107020000-convert-1688-orders-to-real-waybill-platform 按同一规则换算
(8 张状态表 + orders 镜像表,迁移不做反向)
- 新增单测覆盖:抖音分销→DYXD、非分销→TB、未知渠道→OTHER(并断言原始报文保留)、其它平台不受影响
- 文档 店管家取号-旧系统提取.md §4.2.1 补充规则表与留痕字段说明
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 05:40:37 +08:00 |
|
liufumingren
|
1e454d399c
|
fix(waybill): 快递接口缺失/未绑定的提示改为「原因在前」
WMS 会把失败原因写进订单操作日志并截断长文案,原来「未绑定到快递接口」在最前面、
真正原因(该平台暂无面单模板 / 没有该快递公司的模板)在末尾括号里,很容易被截掉,
运维看不出到底缺什么。改成:
- 平台无任何模板:`平台1688(阿里巴巴)暂无面单模板(账号xxx):请到 OMS 店铺管理→
外部打单平台→快递接口 点「从平台同步数据」,再为快递STO(申通快递)绑定`
- 有模板但缺该快递公司:`平台TB(淘宝)没有快递JD(京东物流)的面单模板(账号xxx):…`
- 有模板但该快递未绑定 / 重复绑定:同样把具体问题放在前面
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 05:40:29 +08:00 |
|
liufumingren
|
5f605b5412
|
fix(waybill): 取号失败时把平台错误信息返回给 WMS
- 新增 describePlatformFailure:把平台原始返回里可读的字段(ErrorCode / Message /
Data.ErrorMsg / 网点 BranchName)拼进逐单 message,不再只回一个「模板校验失败:2」;
不包含收件人信息,最长 500 字,与已有文案重复的字段自动跳过
- 同一个文案写入 waybill_fetch_records.error_message,raw_response 仍整包落库便于排查
- 实测:淘宝模板 + 1688 订单取号返回「店管家模板校验失败:2(网点:荔湾和平)」,
取号记录与返回 WMS 的信息一致(逐单 success/message 结构未变)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 01:18:29 +08:00 |
|
liufumingren
|
ba0d03414a
|
feat(order): 电商平台筛选可遍历实际平台,数据库店铺与手工单默认淘宝
- 订单筛选项新增 platforms:系统预设 ∪ 当前主体订单里实际出现过的编码(带数量,
未收录进预设的标记 preset=false),下拉按用量排序,店管家新增平台类型时不会「筛不到」
- 手工单默认 source_platform_code=TB(淘宝),新建/编辑弹窗新增「电商平台」下拉;
编辑改平台时按系统预设同步名称;外部打单平台拉取的订单该字段置灰不可改
- 数据库店铺拉单按店铺配置的平台落库(未配置时默认淘宝),待审核订单可见可筛
- 迁移 20261107010000:把「数据库店铺订单(extend_props.source=shop_database)」与
「手工单(extend_props.labels 含手工单)」里为空的电商平台回填为 TB/淘宝
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 01:18:21 +08:00 |
|
liufumingren
|
9a944be886
|
feat(order): 订单列表展示电商平台,支持按电商平台筛选与平台单号批量查询
- 列表新增「电商平台」列(优先用落库的平台名称,缺失时按编码映射中文名),详情面板同口径展示
- 筛选新增电商平台多选(platform_codes)与平台单号批量精确匹配(platform_order_nos,最多 200 个)
- 平台单号批量查询复用 MultiValueFilter:收起时英文逗号拼接、展开后一行一个,与店铺商品的商家编码一致
- 订单导出同步支持这两个筛选,并新增「电商平台」导出列
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 00:28:42 +08:00 |
|
liufumingren
|
3a4eebb71d
|
feat(shop): 店铺所在区刷新与解绑自动禁用,禁用时作废待审核订单
- 新增 shopAreaSync:按账号拉一次商家列表(同账号多店铺共享,PageSize=200 翻页),
把最新商家结构(FxUserId、分区声明 DbAreas)写回 shops.external_data;
商家已不在合作列表时自动把店铺置为禁用,并写明原因
- 手动刷新入口:POST /api/shops/{id}/refresh-area(货主权限)、
POST /api/external-print-accounts/{id}/refresh-shops-area(集团权限)
- 新增定时任务 refreshExternalShopAreas:每小时巡检,按账号 6 小时刷新一次
(DGJ_AREA_REFRESH_HOURS 可调),自动禁用店铺后不再参与自动拉单与一键拉单
- 新增 shopOrderGuard:店铺禁用立即作废该店铺待审核订单
(void_reason 前缀「店铺已禁用,暂停处理」),重新启用时只恢复因此暂停的订单;
禁用店铺再拉单直接拒绝,避免又拉回待审核单
- externalPrintOrder 待审核单核对改用 LogicOrderId 批量回读(50 单/批,最多 300 单)
- orderStatus.restore 支持显式 principalId,供无登录态的系统任务调用
- 前端:店铺列表新增「所在区」列与行内/详情「刷新所在区」按钮,
系统自动禁用的店铺状态带原因提示,启停与刷新后提示作废/恢复了多少订单
- 文档:新增 §4.2.2「所在区」刷新、§4.2.3 店铺禁用/启用与待审核订单
(原 LastWaybillCode 小节顺延为 §4.2.4,WMS 对接文档引用同步)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 00:19:02 +08:00 |
|
liufumingren
|
f5b717f612
|
perf(print): 店管家拉单按「待发货+商家」过滤,时间窗对齐平台 15 天
- NewOrder/List 带上 ErpState=waitsellersend 与商家 FxUserId 过滤,只拉待发货单
- 老分区不支持过滤(返回「服务器繁忙」)时退化为按时间窗全量,窗口封顶 15 天;
分区能力用进程内缓存记住,避免每小时反复撞接口
- 按商家分区声明 DbAreas[].IsNewSystem 跳过该平台的老分区,不再白拉迁移前的历史数据
- 首次拉单回看天数 7 → 15 天(对齐平台「待发货订单」页默认下单时间范围),
一键拉单/单店拉单前端下拉新增「最近 15 天(平台默认)」并默认选中
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-07 00:18:53 +08:00 |
|
liufumingren
|
74ddeca3c0
|
feat(shop): 店铺支持设置默认发货仓库,拉单与未审核订单自动带仓库
- shops 新增 default_warehouse_id(迁移 + 模型 + 契约),仓库须存在、启用且属于店铺货主
- 新增 PUT /api/shops/:id/default-warehouse 单独维护该字段,外部打单平台店铺的货主权限也可配置
- 新增 shopWarehouse 服务:保存后把该店铺待审核订单中仓库为空或是旧默认值的订单回填为新仓库(手工改过的不覆盖)
- 打单平台与数据库店铺拉单落待审核时自动带上默认仓库(含 warehouse_code 快照);一键拉单店铺查询补 default_warehouse_id
- 前端:店铺列表新增「默认仓库」列与配置弹窗,新增/编辑表单增加默认发货仓库下拉(按货主过滤),详情面板展示
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-06 22:23:23 +08:00 |
|
liufumingren
|
fe97be2893
|
feat(shop-product): 店铺商品支持店铺/平台类型/商家编码多值筛选
- 列表接口支持 shop_ids / platform_types / outer_codes(逗号分隔或数组,去重、上限 200),店铺与平台类型为 IN 条件,商家编码为多值精确匹配;保留单值 shop_id 与关键词模糊查询
- 前端:店铺改为多选虚拟下拉、新增平台类型多选、新增商家编码多值控件(收起英文逗号拼接、展开一行一个)
- 导出同步支持多值筛选(多选控件按 CSV 提交)并补上「平台类型」列
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-06 22:22:41 +08:00 |
|
liufumingren
|
262d9d4203
|
feat(order): 一键拉单进度在订单页卡片头部持续显示
- 新增 useOrderSyncTask 组合式函数:拉单任务轮询从弹窗抽为模块级单例,弹窗关闭后仍继续轮询
- 订单页卡片头部在任务进行中显示进度条与店铺进度,结束后自动隐藏并刷新列表;刷新页面可恢复进度
- OrderSyncDialog 复用共享状态,去掉自持 timer 与 done 事件;StatusPanel 改为订阅任务结束通知
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-06 22:22:18 +08:00 |
|
liufumingren
|
adfc48d8bf
|
fix(order-sync): 一键拉单查询店铺时补上 external_data,修复提示缺少商家 FxUserId
resolveShops 的字段白名单漏了 external_data,导致异步拉单任务拿到的店铺实例没有商家原始结构(店管家 FxUserId / 分区 DbAreas),逐店拉单统一报「店铺缺少商家 FxUserId」;单店手动拉取与定时拉单用全字段查询,故不受影响。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-06 19:56:31 +08:00 |
|
liufumingren
|
809d1e9feb
|
feat(shop-product): 店铺商品列表展示平台商品图片,支持点击大图预览
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-06 19:34:38 +08:00 |
|
liufumingren
|
137a3ed1f3
|
feat(principal): 主体启用/停用改为仅数据库维护,页面与接口不可操作
- PUT /api/principals/{id} 不再接受 status 变更(变更时返回 403「主体的启用/停用只能由平台运维在数据库中维护」)
- POST /api/principals 状态固定为启用,创建时传 status=0 直接 403;其它非白名单字段忽略
- 集团设置页面状态改为只读展示并提示由平台运维维护(去掉启用/禁用开关)
- 前端 updatePrincipal 类型移除 status,接口契约说明同步更新
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-06 00:21:52 +08:00 |
|
liufumingren
|
463b7cd1bc
|
feat(employee): 新增员工邮箱改为选填,支持临时账号与微信扫码绑定已有账号
- 新增员工不填邮箱时创建临时账号:自动生成 tmp_ 前缀登录名、邮箱留空、返回初始密码(temporary 标记)
- 员工档案绑定微信:该微信已绑定过账号则把员工切换到该账号(同主体已存在则冲突提示),
原临时账号无任何主体关联时自动禁用;该微信未绑定账号时直接绑定到员工当前(临时)账号
- 员工编辑支持为临时账号补填邮箱(已绑定邮箱的账号需员工自行在个人设置维护)
- 列表邮箱列对临时账号显示「临时账号」标记;新增结果弹窗提示扫码绑定/补填邮箱
- 接口契约与前端类型同步更新
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-05 23:58:53 +08:00 |
|
liufumingren
|
e49c25cd19
|
feat: 主体停用后下拉置灰不可切换、数据只读、定时任务跳过
- principalCheck 中间件加载主体状态:停用主体只放行读请求(GET/HEAD/OPTIONS)与导出任务提交,
其余写操作(新建/编辑/推送/删除)一律 403「主体已停用,仅可查看与导出」
- 可选主体列表包含停用主体并按「启用优先」排序;/api/auth/profile 返回 status/disabled
- 顶栏主体下拉显示「xxx(已停用)」且不可选择;当前主体停用时在顶栏下方显示只读提示条
- 定时任务跳过停用主体:自动拉单、订单推送 WMS、发货推送、出库推送、发货结果回传平台、一键拉单任务
- 主体自身的 GET/PUT 未加主体状态校验,运维仍可通过接口重新启用
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-05 23:31:45 +08:00 |
|
liufumingren
|
739506da58
|
feat: 仓库接口配置一仓库一份、员工微信绑定管理、停用员工不再展示主体
1) 仓库接口配置
- 新增时校验同一仓库只允许一份接口配置(含唯一索引兜底,迁移会先清理历史重复数据)
- 接口配置页在有配置时禁用「新增配置」并提示
2) 员工档案微信绑定
- 列表返回 wechat_bound / 脱敏 openid / 绑定时间,页面新增「微信」列
- 新增员工微信绑定码、轮询结果、解绑接口(按员工系统账号绑定,绑定码仅操作人可轮询)
- 导出增加「微信绑定」列
3) 停用员工后不再展示该主体
- 主体ID列表与可选主体列表只取启用(status=1)的关联,停用后登录不显示该主体且无该主体权限
- 权限解析对停用关联直接返回空权限兜底
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-05 18:11:11 +08:00 |
|
liufumingren
|
426e6e9e7b
|
fix(express): 自定义快递编码列表因字符集排序规则不一致导致 500
- 列表/详情不再用 Sequelize include 关联 express_companies(该 JOIN 在两边排序规则不同时报
ER_CANT_AGGREGATE_2COLLATIONS),改为一次 IN 查询后在内存组装,响应仍保留 expressCompany/express_name
- 新增迁移把未显式指定字符集的字典/任务表统一为 utf8mb4 / utf8mb4_unicode_ci
(custom_express_codes、external_print_express_interfaces、warehouse_express_mappings、
waybill_fetch_records、order_sync_tasks、shop_database_configs、operation_logs、openapi_request_idempotency)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-05 17:33:27 +08:00 |
|
liufumingren
|
4cba1a152a
|
feat(shop): 新增线下店铺类型,平台店铺平台改为必填
- 店铺类型新增 4 线下店铺(手工建单用,无自动拉单/平台对接)
- 线下店铺不展示也不保存自动拉取订单与拉取间隔,平台字段一并清空
- 平台店铺新增/编辑都强制校验平台必填(前后端一致)
- 列表与详情的「自动拉取」「平台」列对线下店铺显示为 -
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-05 17:07:23 +08:00 |
|
liufumingren
|
797bbbcd82
|
feat(shop): 数据库店铺商品表/订单表支持拉取状态过滤(可填多个状态值)
- shop_database_configs 增加 product_filter_column/values、order_filter_column/values
- 配置弹窗在商品表、订单表下新增「状态字段 + 状态值」:状态字段选源表列,状态值可填多个(回车追加)
- 拉取时按状态列 IN (多个状态值) 过滤,订单表与时间窗条件同时生效;未配置状态列表示不过滤
- 保存时校验状态列存在、填了状态列必须至少填一个状态值(最多 100 个)
- 修复 DATASETS 数据集缺失 key 导致过滤校验窜到订单明细表的问题
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-05 16:54:36 +08:00 |
|
liufumingren
|
873527d556
|
style(shop): 数据库配置弹窗固定高度,内容在窗口内滚动
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-05 16:36:39 +08:00 |
|