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
|
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
|
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
|
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
|
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
|
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
|
23a7715dc9
|
feat(shop): 数据库店铺新增回传单号设置,发货确认后把运单号写回客户库
- shop_database_configs 增加回传设置:方式(不回传/写回字段/写回行)、目标表、运单号字段、定位字段、间隔符、写回行字段映射
- 配置弹窗新增「回传单号」区块:写回字段选表+字段+定位字段+间隔符;写回行按回传值(订单号/运单号/快递公司编码/快递公司名称/回传时间)逐项选列
- 保存时校验回传表与列在客户库中存在,回传行必填项(订单号、运单号)
- 发货确认(WMS 回推运单号)后自动回传:写回字段按间隔符合并写单值,写回行按订单号先删后插保证幂等;失败只记日志不影响发货确认
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-05 16:33:15 +08:00 |
|
liufumingren
|
eb8c94eacf
|
feat(shop): 新增数据库店铺类型与连接/选表/字段映射配置
- 迁移 shop_database_configs:一店一条,存数据库类型/IP/端口/库名/账号/密码、
商品表/订单表/订单明细表名、三份字段映射与最近校验结果
- 新增 shopDatabase 控制器与 lib:服务端用 mysql2 连接客户库(8s 超时、utf8mb4),
提供配置读取/保存、测试连通、连接拉表、拉表列表与表字段;表名走白名单校验
- 保存时连得上则校验表与列真实存在(不存在拒绝保存),连不上则保存并提示未校验
- 店铺新增支持 type=3 数据库店铺;删除店铺时一并清理数据库配置
- 前端:新增店铺可选「数据库店铺」,创建后自动打开配置弹窗;列表对数据库店铺
显示「配置」,弹窗内填写连接信息、测试连通、连接拉表、选三张表并逐个字段映射
- 契约与路由:补数据库店铺配置相关接口定义
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-05 15:44:06 +08:00 |
|
liufumingren
|
9774ee1414
|
feat(stock): 出入库单/记录增加货主并按货主隔离,创建人显示员工名称
- 迁移:inbound_orders / outbound_orders 增加 subsidiary_id 与索引,按仓库回填
- 单据货主由仓库决定:创建写入、改仓库同步,接口不接受直写 subsidiary_id
- 入库单/出库单列表返回 subsidiary_name 并新增货主筛选;详情/编辑/删除/审核/
推送/完成/取消/恢复/作废/驳回与明细接口统一加货主越界 403
- 出入库记录按仓库归属货主:列表与导出收窄、返回 subsidiary_id/subsidiary_name、
新增货主列与筛选
- 导出:入库单/出库单/出入库记录新增货主列并按所在公司权限收窄
- 新增 resolveAccountNameMap:列表/详情返回 creator_name/auditor_name/voider_name,
创建人展示员工名称(principal_users.name),不再回退成邮箱账号
- 前端:三个列表新增货主列与筛选,创建人/作废人展示改为员工名称
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-05 15:13:22 +08:00 |
|
liufumingren
|
4e56077770
|
feat(stock): 出入库单仓库与商品按货主双向限制并校验防注入
- 新增 app/lib/billOwnerScope.js:仓库可访问性(主体 + 所在公司)、明细商品/组合
与仓库同货主校验、按单据仓库取货主
- 入库单/出库单 create:仓库可访问且明细商品必须与仓库同货主
(原明细校验未带 principal_id,一并修正)
- 入库单/出库单 update:改仓库时校验新仓库可访问且已有明细同货主
- 明细接口(stock_items create/update):按所属单据仓库货主校验商品,堵住
单据建好后再塞入其它货主商品的路径
- 前端新增 useWarehouseGoodsScope:仓库与商品双向约束(先选仓库限制商品、
先选商品限制仓库、同单明细不得跨货主)
- 入库/出库创建页与单据明细编辑区接入该约束并给出提示
- ProductSelect 新增 beforeSelect 前置校验与受控显示值,校验不通过时回滚显示
|
2026-11-05 15:02:12 +08:00 |
|
liufumingren
|
2d2f781f09
|
feat(order): 订单关联货主与越界操作拦截
- order_index 与各订单状态表新增 subsidiary_id(跟随店铺货主),历史数据按店铺回填
- 订单列表/详情/导出按货主范围过滤,货主权限仅可见自己所属公司的订单
- 订单 id 级操作统一在 _loadIndexRows 校验货主:审核/推送/驳回/取消/作废/恢复/改仓库物流/删除/明细维护越界返回 403
- 新建订单货主跟随店铺,货主权限只能为自己公司店铺建单;平台拉单写入时同步店铺货主
- 内部任务/平台回调无登录态时按系统操作处理,不受货主范围限制
- 订单列表与导出新增货主列
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-05 02:15:46 +08:00 |
|
liufumingren
|
9c9a81f168
|
feat: 商品属性(分类/品牌/单位)关联货主
- product_categories / product_brands / product_units 新增 subsidiary_id(NULL 表示主体级、全集团共用)
- 列表与下拉按货主范围过滤:货主权限仅可见「主体级 + 自己所属公司」,并支持按货主筛选
- 新增/编辑支持选择货主,货主权限只能选主体或自己所属公司;同货主范围内名称唯一
- 详情/更新/删除对越权属性返回 403;导出新增货主列并收窄到可见范围
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-05 02:15:25 +08:00 |
|
liufumingren
|
839b81f661
|
feat: 商品与外部仓库关联所属货主(下属公司)
- products、warehouses 新增 subsidiary_id(下属公司),创建/更新必填并校验归属当前主体
- 商品批量导入新增「所属货主」列,按下属公司名称匹配,缺失时报错
- 商品、外部仓库列表与导出新增所属货主列、筛选与下拉控件
- 仓库下拉与详情接口返回 subsidiary_id / subsidiary_name
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-05 00:50:27 +08:00 |
|
liufumingren
|
e1e3bb638f
|
feat(order): 拉单任务、外部发货同步与取号记录
- 拉单任务:新增 order_sync_tasks 异步任务池,按店铺逐店拉取外部打单平台订单,前端轮询进度
- 外部发货同步:配送后把发货结果同步回店管家,提供数量统计与批量重试(externalSendSync)
- 取号:新增 waybill_fetch_records 记录取号过程,外部快递接口补充菜鸟授权信息
- 补齐相关迁移、订单页同步入口/状态展示,并新增对接说明文档
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-04 20:53:35 +08:00 |
|
liufumingren
|
eaf957ed14
|
feat(express): 外部打单快递接口、自定义快递编码与回 OMS 取号
- 外部打单平台快递接口:按账号同步平台模板、绑定快递编码、查看模板明细;打开列表只读库,仅「从平台同步数据」时拉取
- 系统管理新增自定义快递编码字典,订单改快递 / 物流下拉合并系统与自定义编码,推送奇门沿用订单上的编码
- 新增 OpenAPI deliveryorder.getwaybill:WMS 批量回取号(单次≤100、并发4、逐单结果),快递编码只取 WMS 报文,取消/作废/归档返回失败,已取号直接复用
- 新增 openapi_request_idempotency 请求级幂等:request_id 回放、报文摘要校验、30 分钟 stale 接管、7 天定时清理
- 外部打单平台订单按平台 fetch_waybill_no 下发 need_oms_waybill,推送时实时判定并回写单据
- 店铺、打单账号平台配置与「平台+编码→模板」绑定走 Redis 缓存,绑定/账号变更主动失效,避免批量推送与取号逐单查库
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-04 04:10:37 +08:00 |
|
liufumingren
|
69b26bf7cc
|
feat(platform): 统一系统预设平台编码,外部平台标识按预设转换
- 新增 app/lib/platformCode.js:17 个预设平台(1688/DW/DYCS/DYGX/DYXD/JD/KS/MAOCHAO/
MTYYJK/OFFLINE/OTHER/PDD/SPH/TB/TGC/TM/XHS)+ 别名表(中英文、大小写)+ 未知落 OTHER
- 店管家硬编码 PlatformType → 预设映射(Pinduoduo→PDD、TouTiao→DYXD、WxVideo→SPH、
Alibaba→1688、Taobao→TB、KuaiShou→KS、Tmall→TM、JingDong→JD…)
- 拉单落库统一:orders.platform_type、order_status_*.source_platform_code/name
写预设编码与本系统中文名(推 WMS 的 sourcePlatformCode/Name 同源)
- 店铺商品 platform_type 同样落预设编码
- 新增 scripts/migrate-platform-codes.js(npm run platforms:migrate):
按同一口径迁移历史数据,默认 dry-run;已执行迁移 14 类(订单 27 / 店铺商品 44 / 状态表 15+13)
- 前端新增 constants/platform.ts(code→中文名):店铺商品「平台类型」列显示中文名,
订单详情新增「来源平台」行
- 新增 platformCode 单测(5 项,含未知平台落 OTHER)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-03 17:31:44 +08:00 |
|
liufumingren
|
e6d3f1ba8d
|
fix(external-print): 来源订单号改用店管家系统编号(LogicOrderId)
问题:外部打单平台订单的来源订单号 / 去重键取的是 PlatformOrderId(平台单号),
但平台单号并不唯一(同一平台单可拆成多条逻辑单),唯一标识是店管家的「系统编号」LogicOrderId。
例如 订单编号 261023-105376715090914 的系统编号是 695351624597601813。
- normalizeOrder:external_order_id / order_no 改用 LogicOrderId(缺失时回落平台单号),
平台单号以 platform_order_no 单独带出
- 订单表 extend_props 增加 platform_order_no,便于按店管家「订单编号」对账
- 订单详情抽屉新增「平台订单号」一行(有值才显示)
- 新增 scripts/migrate-logic-order-id.js(npm run orders:migrate-logic-id):
把历史订单的来源订单号从平台单号迁移到系统编号,同时改写 orders / order_index /
各状态表 / order_status_items / 配送单,并补写 extend_props.platform_order_no;默认 dry-run
- 修正 orders.external_order_id、order_index.parent_order_no、orderFields 的字段注释
已执行迁移 20 条(备份见会话 files/backup-before-logic-order-id-migration.json),
迁移后重新拉单 created=0 / updated=14,确认不会产生重复订单。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-03 04:36:14 +08:00 |
|
liufumingren
|
107b81bb6a
|
feat(external-print): 支持「全部待处理」拉单,修复订单分页 500 条截断
背景:店管家「待发货」页的条件是 ErpState=waitsellersend(+ IsPdd/OrderByField),
但实测该 Filters 仅 fxali 域名接受,fxdd / fxpdd 会返回「登录信息过期,请重新登录」,
无法直接复用服务端过滤;改为「宽时间窗拉取 + 本地按平台发货状态过滤」,结果与平台一致。
- 手动拉单新增「全部待处理(不限下单时间)」(days=0):覆盖店铺历史积压的未发货订单
- 修复分页截断:平台不返回 PageCount(多为 null),原逻辑只取第一页,
任何分区超过 500 单时会被静默截断;改为以 Total + 满页判断翻页
- 拉单遇「登录信息过期 / token is invalid」自动重新登录并重试一次,
避免定时任务因会话到期整天失败
- 契约与头部注释同步更新
实测店铺 19(意洁):全部待处理 → 未发货 18 单(PDD 11 / Alibaba 4 / KuaiShou 1 / Taobao 2),
跳过平台已发货 3637 单;与逐分区直连平台的统计完全一致(18 单)。
DB 待审核合计 20 单(含店铺 18 的 2 单 WxVideo)。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-03 04:32:57 +08:00 |
|
liufumingren
|
a4213bfd0d
|
fix(external-print): 拉单只取平台未发货订单,已发货/已终结不再进待审核
问题:店管家 /NewOrder/List 只支持按时间窗查询,不提供发货状态过滤,
原实现仅按 UpFxUserId 归属就整批入库,导致 sended/success/close 的订单
全部堆进「待审核」(实测店铺 19 近 7 天平台返回 385 单,真正待发货只有 11 单)。
- dgj 新增 isOrderFinished():ErpState∈sended/success/close(及各平台等价状态)、
有 OnlineSendTime、面单 IsSended=true、LogisticStatus>0 任一命中即视为已处理;
PrintState/ExpressPrintTime 仅表示已打印面单,不作为判定依据
- listOrders 过滤未发货订单,返回 skipped 与 finished 列表
- externalPrintOrder.syncOrders 新增 voidFinishedOrders():本地仍处于待审核、
平台侧已发货的副本自动作废(写 void_at/void_reason + 操作日志),已审核订单不动
- orderStatus.voidOrder 支持 principalId(定时任务无登录态)
- 手动/自动拉单消息、接口返回、接口契约、前端提示补充「跳过已发货 / 自动作废」统计
- 新增 scripts/cleanup-shipped-pending-orders.js(npm run orders:cleanup-shipped):
按同一口径清理历史脏单,默认 dry-run,--apply 才删除
- 新增 isOrderFinished 单测(7 项)
已清理历史脏单 103 条(备份见会话 files/backup-shipped-pending-orders.json),
清理后待审核仅剩 2 单真实的平台待发货订单。
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-03 04:14:02 +08:00 |
|
liufumingren
|
7f0651ed37
|
feat(product): 商品批量导入(12 字段,编码存在则更新)
- 后端新增 app/lib/productImport.js:模板列定义(含表头别名)、xlsx 解析、行校验、金额解析
- 新增 GET /api/products/import-template(下载仅含表头的模板)
- 新增 POST /api/products/import:同主体下商品编码已存在则更新(空单元格不覆盖原值,
软删除的会恢复),否则新建;文件内重复编码按最后一行处理;未知列在结果中返回
- 导入结果返回 total/created/updated/restored/failed/duplicated/errors/ignored_columns,
并写入操作日志、对更新的商品触发待审核订单明细重算
- multipart 白名单增加 .xlsx
- 前端商品页新增「批量导入」:下载模板、选择 xlsx、展示导入结果与失败明细
- .eslintrc 为 config 目录放开 no-restricted-modules(config 需要 path 等核心模块)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-03 03:57:11 +08:00 |
|
liufumingren
|
ab630e7c01
|
feat(external-print): 订单拉取与定时同步,组合商品拆分为最小单位
后端能力:
- 接入店管家订单接口(/NewOrder/List),明细归一化后按店铺商品匹配系统商品/组合商品
- 新增 service/externalPrintOrder:手动与定时拉单共用入库逻辑,同时写入待审核状态分表
- 新增 schedule/fetchExternalShopOrders:按店铺配置的间隔自动拉单(最小 3 分钟,起点重叠 10 分钟)
- 新增 lib/orderItemExpand + service/orderItemResolve:平台行与最小单位行互转;
绑定组合商品时按「数量 = 平台数量 x 组合内数量、单价取子商品零售价」拆成子商品行,解绑可还原
- 明细新增 platform_snapshot,保留平台原样(编码/名称/规格/图片/原行号/原数量/原单价)
- 店铺商品列表支持 has_unbound_order 筛选,订单列表支持 exclude_unbound(均已同步导出定义)
- 店铺商品只读化:移除新增/编辑/删除动作,仅保留查询与绑定;
同步商品时平台已不存在的商品自动清理(未绑定且未被订单引用直接删除,已绑定或被引用仅下架)
- 新增 scripts/rebuild-order-items 存量明细重建脚本,新增 orderItemExpand 单测(8 项)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-03 03:29:09 +08:00 |
|
liufumingren
|
969c68f5f9
|
feat(external-print): 新增外部打单平台与账号管理(接入店管家登录)
- 新增 external_print_platforms(平台基础资料,开发者维护)与 external_print_accounts(账号/密码/cookie/token/登录状态)
- 新增平台账号 CRUD、登录态检查、登录接口;店铺管理下新增「外部打单平台」菜单
- 平台服务按 code 独立存放于 app/lib/printPlatform(dgj.js 实现店管家登录与 GetUserInfo 登录态检查)
- 平台接口 401 自动记录账号登录状态,前端展示状态并支持检查/登录
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-02 18:02:34 +08:00 |
|
liufumingren
|
1847e17ba7
|
feat(auth): 接入微信扫码登录与微信绑定
- 新增网关客户端与通知验签(sha256(appSecret) 派生 HMAC-SHA256,5 分钟防重放),
扫码会话与一次性结果存 Redis,openid 仅服务端保存
- 新增 user_wechat_binds 表与迁移:openid 唯一(一个微信只绑一个账号)、
user_id 唯一(重新绑定覆盖旧微信)
- 新增 /api/auth/wechat/* 接口与 /api/wx/notify 网关回调;登录二维码按 IP 限流,
未配置网关时相关接口返回 400 提示,不影响账号密码 / 邮箱验证码登录
- 前端:「微信登录」tab(二维码 + 倒计时 + 轮询)与「我的」页微信绑定 / 解绑
- 开发与生产各出一份 WX_GATEWAY_* 配置样板,生产权威副本走 shared-config 覆盖
- 同步补充 swagger 契约与请求日志脱敏字段(bind_code / sign)
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-11-01 23:17:11 +08:00 |
|
liufumingren
|
6c03a20364
|
feat(backend): 订单状态分表、WMS 推送与归档
- 新增 order_index 索引表 + 6 张同构状态表(待审核/异常/委外中/配送/已作废/已取消)与历史表,
订单 ID 全局唯一,状态由业务事务推动:审核、驳回、取消、作废、恢复、归档
- 明细表 order_status_items、收件人文本智能解析、批量切换仓库/店铺并刷新快照
- WMS deliveryorder.create 推送(单条/批量)、推送失败定时重试、订单归档定时任务
- 迁移:建表、旧发货单数据迁入新表、菜单合并与迁移记录清理
- routes / swagger contract 补充订单状态接口
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-10-30 23:06:18 +08:00 |
|
liufumingren
|
d22f3e1f0a
|
feat(backend): 新增商品分类/品牌/单位字典与属性菜单
- 按主体隔离的分类/品牌/单位 CRUD 与 /select 下拉接口
- 商品模型增加 brand_id / unit_id,属性被商品引用时禁止删除(attributeUsage)
- 迁移:建三张字典表、商品表加字段、种子属性菜单、is_system 保护内置项
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
|
2026-10-30 23:06:09 +08:00 |
|
liufumingren
|
489563a4b2
|
feat(backend): 仪表盘报表接口、配置裁剪、单号 5 位与账号名称/头像
- 仪表盘报表:新增 app/service/dashboard.js + app/controller/dashboard.js +
app/lib/billStatus.js,注册 GET /api/dashboard/report(jwtAuth + principalCheck),
一次聚合返回概览指标、发货单/入库单/出库单状态分布与待办、近 N 天单据量与
出入库数量趋势、库存 Top 商品、最近出入库流水;warehouse_id 只过滤单据与流水
(product_stocks 无仓库维度);契约 dashboard* 同步到 swagger
- 接口配置裁剪:仓库接口配置只保留 api_version 与 item_name_with_spec;
历史 warehouse_apis.extra 冗余键、owner_code 配置、递交/回传设置一并清理
(迁移 20260915002400~02800)
- 入库/出库/发货单报文与字段对齐 WMS 标准:去掉 ownerCode、operatorCode 等多余字段,
入库明细补 itemId;发货单明细去掉无意义的 owner_code(迁移 20260915002600)
- 单号 5 位起:四张单据表 AUTO_INCREMENT 提到 10000(迁移 20260915002900)
- 账号名称/头像按主体维护:principal_users 增 name/avatar 并回填(迁移 20260915003000/03100),
新增 app/lib/accountProfile.js(关联表名称/头像 → users 兜底);审核人写入 operator/operator_name;
register 不再写 nickname、updateProfile 仅接受邮箱/手机号
- 出库单推送/锁库存链路的配套调整(outboundOrderPush、订单与发货单控制器)
Co-Authored-By: GitHub Copilot <noreply@github.com>
|
2026-09-14 16:09:35 +08:00 |
|
liufumingren
|
5329aa8003
|
fix(backend): 出库单确认/取消时同步清空 stock_locked
- stockout.confirm 完成出库时置 stock_locked=0(与 stock_deducted 同步)
- order.cancel 回调:单据已推送(3)、或推送未成功但已锁定库存(stock_locked=1),且尚未扣减时释放锁定并置 0
|
2026-09-14 01:00:20 +08:00 |
|
liufumingren
|
39c19a4de7
|
feat(backend): 出入库记录与库存锁定链路、出库单快递/收件人与推送队列
- 出入库记录(库存流水):新增 stock_records 表/模型/只读接口(列表 + 业务动作选项)与「出入库记录」菜单;
库存变动统一收敛到 app/utils/stockRecord.js#applyStockChange,与流水写入同事务(含变动前后总/锁定/可用数量)
- 发货单:审核(1→2) 按明细锁定库存、发货确认(3→4) 扣减、推送失败退回/驳回/取消/作废释放(新增 stock_locked 列);
恢复(9→1) 时曾推送过的单据换号(WMS 取消后原单号仍被占用,沿用旧号重推会被判「订单已存在」)
- 出库单:新增快递(express_code/express_name)、收件人(receiver_*) 与多运单号(express_codes) 字段;
推送报文补齐 logisticsCode/receiverInfo;新增出库单推送服务与定时任务
- 快递:多运单号回填、仓库快递映射(warehouse_express_mappings) 与快递字典补录等迁移
- 契约:补充出入库记录、出库单快递/收件人等定义(swagger.json 为本地生成、不入库)
|
2026-09-14 00:59:23 +08:00 |
|
liufumingren
|
0a9ee3c593
|
feat(backend): 对外通用回调接口 /openapi 与回调日志
- POST /openapi 入口(controller/openapi.js),协议与 WMS openapi 对齐(method/app_key/sign)
- 方法注册表 lib/openapiMethods.js:index.ping、entryorder.confirm/match、deliveryorder.confirm、stockout.confirm、order.cancel
- 单据处理公共逻辑 lib/orderCallback.js;请求/响应封装 lib/apiResponse.js、lib/openapiCallback.js
- WMS 回调入口 controller/wmsNotify.js 改为复用公共模块
- 回调日志:callback_logs 表 + lib/callbackLog.js(脱敏、fire-and-forget)
|
2026-09-13 02:23:49 +08:00 |
|
liufumingren
|
11e7b26ced
|
feat(backend): 发货单模块与 WMS 定时推送队列
- 发货单主表/明细表(order_deliveries / order_delivery_items)控制器与模型
- 表头金额与明细派生字段重算(utils/recalcOrderDelivery.js)
- 状态流转:审核/驳回/取消/恢复/作废、批量审核、批量切换仓库
- 审核入队 + 定时推送:service/orderDeliveryPush.js(乐观锁 CAS 防重、失败重试上限 3 次、业务失败退回待审核)+ schedule/orderDeliveryPush.js
- 收件人 AI 智能识别(service/ai.js,DeepSeek)
- 相关迁移:建表、站内字段、明细表、订单类型默认值、快递字典、菜单种子、历史数据搬迁
|
2026-09-13 02:23:47 +08:00 |
|
liufumingren
|
ec81f8b3cd
|
feat(backend): 入库单/出库单全流程与 WMS 对接
- 入库单、出库单控制器与模型(状态流转、审核、驳回换号、作废、删除约束)
- 明细共用 stock_items:应/已数量、行级库存类型 ZP/CC、明细锁定
- lib/wms:单据类型常量(orderTypes)、奇门/openapi 客户端(qimenClient)、签名(sign)
- 库存联动:utils/stock.js、utils/completeInbound.js(入库完成加库存,幂等)
- 驳回换号:utils/rejectBillNo.js;旧 orders 模块同步调整
- 相关迁移:入库单 WMS 字段/审核/推送结果、明细计划与实际数量、单据类型落 WMS 编码、出库库存扣减标记等
|
2026-09-13 02:23:44 +08:00 |
|
liufumingren
|
cbd16752a5
|
feat(backend): 商品、店铺、组合商品、仓库与库存模块
- 商品/商品图片、店铺、店铺商品、组合商品及明细
- 仓库、仓库商品(WMS itemId 映射)、仓库接口配置与字段定义(warehouseApi/warehouseApiField)
- 库存:stock_items、product_stocks(ZC/CC 双维度)与库存重算工具(utils/recalcStock.js)
- 库存单据与对接日志:stock orders、api_outbound_logs
- 相关迁移:shops/shop_products/stock_orders/warehouses/warehouse_apis/warehouse_products/product_stocks/files-images 等表与字段
|
2026-09-13 02:23:39 +08:00 |
|
liufumingren
|
8597cf5ac9
|
feat(backend): 用户鉴权、菜单权限、主体与系统基础模块
- 登录/邮箱验证码/密码流程(controller/auth.js、lib/emailCode.js、middleware/jwt_auth.js)
- 主体(principal)隔离与主体用户、对外接口配置模块及 principalCheck 中间件
- 菜单、用户、文件上传、快递公司字典(express_companies)等基础模块
- 通用工具:分页(lib/pagination.js)、缓存(service/cache.js)
- 全量接口契约(contract/index.js)与路由注册(router.js)、config.default.js 配置
- 相关迁移:菜单组件调整与菜单种子、创建 files 表
|
2026-09-13 02:23:34 +08:00 |
|
liufumingren
|
b1f90b1c15
|
refactor: relocate backend into backend/ directory
|
2026-09-09 20:00:54 +08:00 |
|